NetSuite に接続したNintex ワークフローの作成

こんにちは！ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。

Nintex Workflow Cloud は、コーディングなしでドラッグアンドドロップを使用して単純 / 複雑なプロセスを自動化するワークフローを設計できる、クラウドベースのプラットフォームです。CData Connect Cloud と組み合わせると、ビジネスアプリケーション用にNetSuite のデータにクラウドベースでアクセスできます。この記事では、Connect Cloud にNetSuite の仮想データベースを作成し、Nintex でNetSuite のデータから単純なワークフローを構築する方法を説明します。

CData Connect Cloud は、NetSuite にクラウドベースのインターフェースを提供し、ネイティブにサポートされているデータベースにデータを複製することなくNintex Workflow Cloud でリアルタイムNetSuite のデータからワークフローを作成できるようにします。Nintex では、SQL クエリを使用してデータに直接アクセスできます。CData Connect Cloud は、最適化されたデータ処理を使用してサポートされているすべてのSQL 操作（フィルタ、JOIN など）をNetSuite に直接プッシュし、サーバー側の処理を利用して、要求されたNetSuite のデータを高速で返します。

Connect Cloud からNetSuite に接続する

1. Connect Cloud にログインし、 Add Connection をクリックします。
2. Add Connection パネルから「NetSuite」を選択します。
3. 必要な認証情報を入力し、NetSuite に接続します。

   Netsuite への接続

   NetSuite は現在、2つの異なるAPI を提供しています。

   • SuiteTalk はNetSuite との通信に使用する、SOAP ベースのより古いサービスです。多くのエンティティを幅広くサポートし、INSERT / UPDATE / DELETE を完全にサポートします。 しかしデータの抽出用ツールは低機能で、SELECT 時のパフォーマンスは極めて低いです。テーブルを結合するよい方法もありません。データのグループ化および集計はこのAPI からは利用できず、 そのためこれらの操作をサポートするには、すべてをクライアントサイドで実行しなければなりません。
   • SuiteQL は新しいAPI です。サービスとのSQL ライクな通信方法を実現するため、JOIN の機能はより豊富になり、GROUP BY や集計機能もサポートします。 加えて、抽出したいカラムだけを取得する機能も完全にサポートします。そのため、データを抽出する際のパフォーマンスがSuiteTalk より大幅に向上しています。ただし、サポートされるのはデータの抽出のみです。

   NetSuite に接続するには、以下を行う必要があります。

   1. Schema を設定して、接続に使用するAPI を指定。データを取得するだけの場合は、SuiteQL の使用をお勧めします。データの取得および変更が必要な場合は、SuiteTalk の使用をお勧めします。
   2. 使用するAPI に適した接続オプションを設定します。（それぞれのAPI で利用可能な接続オプションが異なります。ヘルプドキュメントの「許可の設定」を参照してください。）

   Netsuite への認証

   SuiteTalk またはSuiteQL

   NetSuite は3つの形式のOAuth 認証を提供します。

   • トークンベース認証（TBA）は、基本的にOAuth 1.0 で、OAuthAccessToken とOAuthAccessTokenSecret を実行時ではなくNetSuite UI 内で作成します。 TBA は、2020.2 以降のSuiteTalk およびSuiteQL の両方で利用可能です。
   • OAuth 2.0 認証は、SuiteQL でのみ利用できます。OAuth 2.0 認証を強制するには、次のいずれかを実行します。
     • OAuthVersion を使用するAPI に明示的に設定、または
     • Schema をSuiteQL に設定
   • OAuth JWT 認証は、OAuth 2.0 クライアント認証フローであり、クライアント認証情報を含むJWT を使用してNetSuite データへのアクセスを要求します。この認証方法は、Schema がSuiteQL に設定されている場合にのみ使用できます。

   認証方法の詳細はヘルプドキュメントの「はじめに」を参照してください。

   
4. Create & Test をクリックします。
5. Edit NetSuite Connection ページのPermissions タブに移動し、ユーザーベースのアクセス許可を更新します。

パーソナルアクセストークンを追加する

OAuth 認証をサポートしないサービス、アプリケーション、プラットフォーム、フレームワークから接続する場合、パーソナルアクセストークン（Personal Access Token, PAT）を認証に使用できます。きめ細かくアクセスを管理するために、サービスごとに個別のPAT を作成するのがベストプラクティスです。

1. User Profile ページでPersonal Access Token セクションにスクロールし、 Create PAT をクリックします。
2. PAT の名前を入力して Create をクリックします。
3. パーソナルアクセストークンは作成時にしか表示されないため、必ずコピーして安全に保存してください。

接続が構成されたら、Nintex Workflow Cloud からNetSuite のデータに接続できるようになります。

Nintex からNetSuite に接続する

以下のステップは、（Connect Cloud を介して）Nintex からNetSuite のデータへの新しい接続を作成する方法の概要です。

1. Nintex Workflow Cloud にログインします。
2. Connections タブで「Add new」をクリックします。
3. コネクタとして「Microsoft SQL Server」を選択し、「Connect」をクリックします。
4. SQL Server の接続ウィザードで以下のプロパティを設定します。
   • Connection Name：a Connect Cloud
   • Username：Connect Cloud のユーザー名（例：user@mydomain.com）
   • Password：Connect Cloud のユーザーのPAT
   • Database Host：tds.cdata.com
   • Database Name：NetSuite 接続（例：NetSuite1）
   
5. 「Connect」をクリックします。
6. 接続権限を構成し、「Save permissions」をクリックします。

単純なNetSuite ワークフローを作成する

CData Connect Cloud への接続が構成され、NetSuite にアクセスする単純なワークフローを作成する準備ができました。まずは、「Create workflow」ボタンをクリックします。

開始イベントアクションを構成する

1. 開始イベントタスクをクリックし、「Form」イベントを選択します。
2. 「Design form」をクリックします。
3. 「Text - Long」エレメントをForm にドラッグし、エレメントをクリックして設定します。
   • 「Title」を「Enter SQL query」に設定します。
   • 「Required」をtrue に設定します。
4. 「Text - Short」エレメントを「Form」にドラッグし、エレメントをクリックして構成します。
   • 「Title」を「Enter desired result column」に設定します。
   • 「Required」をtrue に設定します。


「Execute a Query」アクションを構成する

1. 「Start event: Form」アクションのあとに「Execute a query」アクションを追加し、クリックしてアクションを構成します。
2. 「Start event」アクションから「SQL Script」を「Enter SQL Query」変数に設定します。
3. 「Start event」アクションから「Column to retrieve」を「Enter desired result column」変数に設定します。
4. 「Retrieved column」を新しい変数に設定します。（例：「values」）


「Send an Email」アクションを構成する

1. 「Execute a query」アクションののち、「Send an email」アクションを追加し、クリックしてアクションを構成します。
2. 「Recipient email address」を設定します。
3. 「Subject」を設定します。
4. 「Message body」を取得したカラム用に作成された変数に設定します。


アクションを構成したら、「Save」をクリックしてワークフローに名前を付け、もう一度「Save」をクリックします。これで、SQL を使用してNetSuite をクエリし、結果をメールで送信する単純なワークフローができました。

クラウドアプリケーションから直接100を超えるSaaS 、ビッグデータ、NoSQL データソースにリアルタイムアクセスする方法の詳細は、CData Connect Cloud を参照してください。無償トライアルにサインアップして、ご不明な点があればサポートチームにお問い合わせください。