Anypoint Studio を使用した Microsoft Dynamics 365 for Finance and Operations Connector 3.1 の設定 - Mule 4

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

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

Studio で初めてコネクタを設定する場合は、​「Anypoint Studio を使用したコネクタの設定」​を参照してください。このトピックを参照した後、コネクタ項目についての詳細情報が必要な場合は、​「Microsoft Dynamics 365 for Finance and Operations リファレンス」​を参照してください。

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

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

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

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

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

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

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

  2. [Add Dependencies to Project (連動関係をプロジェクトに追加)]​ で、検索項目に「​dynamics finance​」と入力します。

  3. [Available modules (使用可能なモジュール)]​ で、そのコネクタ名をクリックします。

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

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

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

ソースの設定

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

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

  • Scheduler+ 時間ベースの条件が満たされたときにフローを開始する

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

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

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

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

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

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

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

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

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

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

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

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

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

Microsoft Dynamics 365 for Operations Connector の操作を追加する手順は、次のとおりです。

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

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

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

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

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

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

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

  3. [General (一般)]​ タブの ​[Connection (接続)]​ で、設定する認証方式を選択します。

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

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

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

OAuth Client Credentials (OAuth クライアントログイン情報)

[Global Element Properties (グローバル要素のプロパティ)]​ 画面の ​[General (一般)]​ タブに次の必須情報を入力して、​[OAuth Client Credentials (OAuth クライアントログイン情報)]​ 認証を設定します。

項目 説明

Resource (リソース)

Web API のアプリケーション ID URI

Client Id (クライアント ID)

サービスプロバイダーに登録されている OAuth クライアント ID

Client Secret (クライアントシークレット)

サービスプロバイダーに登録されている OAuth クライアントシークレット

OAuth 2.0

OAuth 2.0 を使用して、ユーザーアカウントをホストするサービスにユーザー認証を委任します。詳細は、​「コネクタの OAuth 2.0 の設定」​または​「CloudHub でのコネクタの OAuth 2.0 の設定」​を参照してください。

[Global Element Properties (グローバル要素のプロパティ)]​ 画面の ​[General (一般)]​ タブで次の情報を入力し、​[OAuth 2.0]​ 認証を設定します。

項目 説明

Resource (リソース)

OAuth エンドポイント URL。

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

アプリケーションを Azure Active Directory に登録したときに割り当てられたアプリケーション ID。この ID は Azure Portal (portal.azure.com) で確認できます。​[Active Directory]​ をクリックして、ディレクトリをクリックし、アプリケーションを選択してから ​[Configure (設定)]​ をクリックします。

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

アプリケーション登録ポータルでアプリケーション用に作成したシークレット。クライアントシークレットは信頼のおける方法でデバイスに保存できないためネイティブアプリケーションで使用しないでください。クライアントシークレットは Web アプリケーションと Web API で必要です (クライアントシークレットをサーバー側で安全に保存できます)。この ID は Azure Portal (portal.azure.com) で確認できます。クライアントシークレットは、アプリケーションと Azure サーバーのみに公開されている数値であり、これによりアプリケーションにアクセスできます。

Authorization URL (認証 URL)

テナント固有の OAuth2.0 エンドポイント。​https://login.microsoftonline.com/{tenant}/oauth2/authorize​ の形式です (エンドポイントの具体的な情報の取得方法については、以前のリンク先に記載されている手順に従ってください)。

Access token URL (アクセストークン URL)

アクセストークンを要求するためのテナント固有のエンドポイント。​https://login.microsoftonline.com/{tenant}/oauth2/token​ の形式です (エンドポイントの具体的な情報の取得方法については、以前のリンク先に記載されている手順に従ってください)。

Listener config (リスナー設定)

Anypoint Studio のフローで作成された HTTP リスナーインスタンスの名前。

Callback path (コールバックパス)

アプリケーションが認証応答の送受信に使用できる URL。

Authorize path (認証パス)

OAuth メカニズムをトリガーする URL。

External callback URL (外部コールバック URL)

コールバック URL に直接アクセスできない場合 (例: プロキシを使用する場合) にのみ必須。コールバックパスでは、​http://localhost:8081/callback​ の形式を使用します。

+ image::microsoft-365-ops-as-oauth2.png["Microsoft Dynamics for Finance and Operations Connector の OAuth 2.0 設定項目"]