Anypoint Studio を使用した NetSuite Connector 11.7 の設定 - Mule 4

Anypoint Studio (Studio) エディターは、Mule アプリケーション、プロパティ、および設定ファイルの設計と更新に役立ちます。

Studio でコネクタを追加および設定する手順は、次のとおりです。

「アプリケーションログの表示」​で説明されているように、コネクタを実行するときに、アプリケーションログを表示して問題を確認できます。

Studio で初めてコネクタを設定する場合は、​「Anypoint Studio を使用したコネクタの設定」​を参照してください。このトピックを読んだ後でコネクタ項目に関する追加情報が必要な場合は、​「NetSuite リファレンス」​を参照してください。

Mule プロジェクトを作成する

Studio で、コネクタを追加および設定する新しい Mule プロジェクトを作成します。

  1. Studio で、​[File (ファイル)] > [New (新規)] > [Mule Project (Mule プロジェクト)]​ を選択します。

  2. Mule プロジェクトの名前を入力して、​[Finish (完了)]​ をクリックします。

コネクタを Mule プロジェクトに追加する

NetSuite Connector を Mule プロジェクトに追加して、XML コードにコネクタの名前空間およびスキーマの場所を自動的に入力し、プロジェクトの ​pom.xml​ ファイルに必須の連動関係を追加します。

  1. [Mule Palette (Mule パレット)]​ ビューで、​[(X) Search in Exchange ((X) Exchange 内を検索)]​ をクリックします。

  2. [Add Modules to Project (モジュールをプロジェクトに追加)]​ で、検索項目に「​netsuite​」と入力します。

  3. [Available modules (使用可能なモジュール)]​ で ​[NetSuite Connector]​ をクリックします。

  4. [Add (追加)]​ をクリックします。

  5. [Finish (完了)]​ をクリックします。

Studio でコネクタを Mule プロジェクトに追加しても、Studio ワークスペースの他のプロジェクトはそのコネクタを使用できません。

ソースの設定

ソースは、指定された条件が満たされたときにフローを開始します。次のソースのいずれかを NetSuite Connector で使用するように設定できます。

  • 設定されているホストとポートで要求を受信するたびにフローを開始する ​HTTP リスナー

  • 時間ベースの条件が成立した時点でフローを開始する ​Scheduler

たとえば、​HTTP リスナー​を設定する手順は、次のとおりです。

  1. [Mule Palette (Mule パレット)]​ ビューで、​[HTTP] > [Listener]​ を選択します。

  2. [Listener]​ を Studio キャンバスにドラッグします。

  3. [Listener (リスナー)]​ 設定画面で、必要に応じて ​[Display Name (表示名)]​ 項目の値を変更します。

  4. [Path (パス)]​ 項目の値を指定します。

  5. [Connector configuration (コネクタ設定)]​ 項目の横にあるプラス記号 (​+​) をクリックして、アプリケーション内のすべての ​HTTP Listener​ インスタンスで使用できるグローバル要素を設定します。

  6. [General (一般)]​ タブで、接続情報を指定します。

  7. [TLS]​ タブで、必要に応じて TLS 情報を指定します。

  8. [Advanced (詳細)]​ タブで、必要に応じて再接続戦略を含む再接続情報を指定します。

  9. [Test Connection (接続をテスト)]​ をクリックして、Mule が特定のサーバーに接続できることを確認します。

  10. [OK]​ をクリックします。

フローにコネクタの操作を追加する

フローにコネクタの操作を追加すると、そのコネクタで実行する特定の操作をすぐに定義できます。

NetSuite Connector の操作を追加する手順は、次のとおりです。

  1. [Mule Palette (Mule パレット)]​ ビューで ​[NetSuite]​ を選択し、目的の操作を選択します。

  2. その操作を Studio キャンバスの入力元の右にドラッグします。

コネクタのグローバル要素を設定する

コネクタを設定する場合、アプリケーション内のそのコネクタのすべてのインスタンスで使用できるグローバル要素を設定することをお勧めします。グローバル要素を設定するには、コネクタが対象の NetSuite システムにアクセスするために使用する認証ログイン情報を指定する必要があります。NetSuite Connector では、トークンベース認証がサポートされています。

NetSuite Connector のグローバル要素を設定する手順は、次のとおりです。

  1. Studio キャンバスでコネクタの名前を選択します。

  2. 操作の設定画面で、​[Connector configuration (コネクタ設定)]​ 項目の横にあるプラス記号 (​+​) をクリックし、グローバル要素設定項目にアクセスします。

  3. [General (一般)]​ タブで、​トークン認証​を設定します。トークン認証では、コンシューマーキーとトークン ID またはシークレットの組み合わせのいずれかを使用して認証が行われます。

    NetSuite 認証を設定するには、SuiteTalk NetSuite Web サービスのアカウント ID が必要です。これは、NetSuite Sandbox UI 内の ​[Setup (設定)] > [Integration (インテグレーション)] > [Web Service Preferences (Web サービスプリファレンス)]​ で確認できます。

  4. [Advanced (詳細)]​ タブで、必要に応じて再接続戦略を含む再接続情報を指定します。

  5. [Test Connection (接続をテスト)]​ をクリックして、Mule が指定されたサーバーに接続できることを確認します。

  6. [OK]​ をクリックします。

Token-Based Authentication (トークンベース認証)

トークンベース認証では、コンシューマーキーとトークン ID またはシークレットの組み合わせのいずれかを使用して認証が行われます。これらは NetSuite 環境内で確立されます。

次のスクリーンショットは、トークンベース認証の設定例を示しています。

request based authentication (要求ベース認証)

グローバル要素設定画面の ​[General (一般)]​ タブで次の情報を入力し、トークンベース認証を設定します。

パラメーター 説明

Consumer Key (コンシューマーキー)

使用するトークンベース認証対応のインテグレーションレコードのコンシューマーキー値

Consumer Secret (コンシューマーシークレット)

使用するトークンベース認証対応のインテグレーションレコードのコンシューマーシークレット値

Token ID (トークン ID)

ユーザーと NetSuite 環境内で生成されたインテグレーションレコードの一意の組み合わせを表すトークン ID

Token Secret (トークンシークレット)

ユーザーとインテグレーションレコードの各組み合わせに対するトークンシークレット

Account

SuiteTalk NetSuite Web サービスのアカウント ID

Signature algorithm (署名アルゴリズム)

ハッシュベースメッセージ認証コード (HMAC) 署名アルゴリズムの種別

アプリケーションログの表示

問題を確認するため、アプリケーションログを次の方法で表示できます。

  • アプリケーションを Anypoint Platform から実行している場合、出力は Anypoint Studio のコンソールウィンドウに表示される。

  • コマンドラインから Mule を使用してアプリケーションを実行している場合、アプリケーションログは OS コンソールに表示される。

アプリケーションのログファイル (​log4j2.xml​) でログファイルパスがカスタマイズされていない場合、デフォルトの場所 ​MULE_HOME/logs/<app-name>.log​ でアプリケーションログを表示することもできます。

次のステップ

Studio を設定したら、​「例」​トピックで詳細な設定アイデアを参照してください。