Microsoft Dynamics OData 設定

データ統合

Microsoft Dynamics は、顧客関係管理(CRM)および企業資源計画(ERP)用のソフトウェアで、顧客の口座や連絡先、潜在顧客、顧客機会、顧客事例を作成して管理する企業ソリューションを提供します。Experience Manager Forms データ統合は、Forms をオンラインサーバーとオンプレミスMicrosoft Dynamicsサーバーの両方と統合するための OData クラウドサービス設定を提供します。これにより、Microsoft Dynamics サービスで定義されているエンティティ、属性、サービスに基づいて、フォームデータモデルを作成できるようになります。フォームデータモデルを使用して、Microsoft Dynamics サーバーと連携するアダプティブフォームを作成することにより、ビジネスワークフローを使用できるようになります。次に例を示します。

  • Microsoft Dynamics サーバーに対してデータに関するクエリを実行し、アダプティブフォームに事前入力する
  • アダプティブフォームの送信時に、データを Microsoft Dynamics に書き込む
  • フォームデータモデル内で定義されているカスタムエンティティを使用して、データを Microsoft Dynamics に書き込む(またはその逆の動作)
MS Dynamics OData Cloud Service (OData Service) is available with all run modes. For more information on configuring run modes for an Experience Manager instance, see [Run Modes](/docs/experience-manager-cloud-service/implementing/deploying/overview.html?lang=ja#runmodes).

前提条件

Microsoft Dynamics の設定を開始する前に、次のことを確認してください。

登録された Microsoft Dynamics アプリケーションの応答 URL を設定

以下の手順で、登録された Microsoft Dynamics アプリケーションの応答 URL を設定します。

メモ

この手順は、Experience Manager Forms をオンラインの Microsoft Dynamics サーバーと統合する場合にのみ使用してください。

  1. Microsoft Azure Active Directory アカウントに移動し、登録済みアプリケーションの「応答 URL」設定に以下のクラウドサービス設定の URL を追加します。

    https://[server]:[port]/libs/fd/fdm/gui/components/admin/fdmcloudservice/createcloudconfigwizard/cloudservices.html

    Azure ディレクトリ

  2. 設定を保存します。

IFD 用に Microsoft Dynamics を設定

Microsoft Dynamics の外部ユーザーは、Microsoft Dynamics でクレームベース認証を使用して、CRM サーバー上のデータにアクセスすることができます。この機能を有効にするには、以下の手順により、インターネット接続展開(IFD)用に Microsoft Dynamics を有効にして、クレーム設定をします。

メモ

この手順は、Experience Manager Forms をオンプレミスの Microsoft Dynamics サーバーと統合する場合にのみ使用してください。

  1. Microsoft Dynamics の IFD 設定」の説明に従って、IFD の Microsoft Dynamics オンプレミスインスタンスを設定します。

  2. Windows PowerShell を使用して以下のコマンドを実行し、IFD が有効になっている Microsoft Dynamics でクレームを設定します。

    Add-PSSnapin Microsoft.Crm.PowerShell
     $ClaimsSettings = Get-CrmSetting -SettingType OAuthClaimsSettings
     $ClaimsSettings.Enabled = $true
     Set-CrmSetting -Setting $ClaimsSettings
    

    詳しくは、「CRM オンプレミス(IFD)のアプリ登録」を参照してください。

AD FS マシンで OAuth クライアントを設定する

OAuth クライアントを Active Directory Federation Services(AD FS)マシンに登録し、AD FS マシンでアクセス権限を設定するには、以下の手順を実行します。

メモ

この手順は、Experience Manager Forms をオンプレミスの Microsoft Dynamics サーバーと統合する場合にのみ使用してください。

  1. 次のコマンドを実行します。

    Add-AdfsClient -ClientId “<Client-ID>” -Name "<name>" -RedirectUri "<redirect-uri>" -GenerateClientSecret

    各パラメーターの意味は次のとおりです。

    • Client-ID は、任意の GUID ジェネレーターを使用して生成できるクライアント ID です。
    • redirect-uri は、Experience Manager Forms 上の Microsoft Dynamics OData クラウドサービスに対する URL です。Experience Manager Forms と共にインストールされるデフォルトのクラウドサービスは、次の URL にデプロイされます。
      https://'[server]:[port]'/libs/fd/fdm/gui/components/admin/fdmcloudservice/createcloudconfigwizard/cloudservices.html
  2. 以下のコマンドを実行して、AD FS マシン上でアクセス権を設定します。

    Grant-AdfsApplicationPermission -ClientRoleIdentifier “<Client-ID>” -ServerRoleIdentifier <resource> -ScopeNames openid

    各パラメーターの意味は次のとおりです。

    • resource は Microsoft Dynamics 組織の URL です。
  3. Microsoft Dynamics では、HTTPS プロトコルが使用されます。Forms サーバーから AD FS エンドポイントを呼び出すには、Experience Manager Forms を実行しているコンピューターで keytool コマンドを使用して、Microsoft Dynamics のサイト証明書を Java 証明書ストアにインストールします。

Microsoft Dynamics サービス用にクラウドサービスを設定する

OData サービスは、そのサービスのルート URL によって識別されます。Experience Manager as a Cloud Service で OData サービスを設定するには、そのサービスのルート URL を確認して、以下の手順を実行します。

メモ

オンライン環境またはオンプレミス環境で Microsoft Dynamics 365 を設定する詳しい手順については、Microsoft Dynamics OData 設定を参照してください。

  1. ツール/Cloud Services/データソース​に移動します。クラウド設定の作成対象となるフォルダーをタップして選択します。

    クラウドサービス設定用フォルダーの作成方法と構成方法については、「クラウドサービス設定用フォルダーの構成」を参照してください。

  2. 作成」をタップして、データソース設定を作成​ウィザードを開きます。設定の名前と、必要に応じて設定のタイトルを指定し、「サービスタイプ」ドロップダウンで「OData サービス」を選択します。必要な場合は、設定のサムネール画像を選択して「次へ」をタップします。「認証設定」タブで、次のように設定します。

    1. サービスルート」フィールドの値を入力します。Dynamics インスタンスの「開発者向けリソース」に移動し、「サービスルート」フィールドの値を表示します。例えば、https://<tenant-name>/api/data/v9.1/ です。

    2. 認証のタイプとして「OAuth 2.0」を選択します。

    3. クライアント ID」(「アプリケーション ID」とも呼ばれます)、「クライアントの秘密鍵」、「OAuth URL」、「更新トークン URL」、「トークン URL にアクセス」、「リソース」の各フィールドのデフォルト値を、 サービス設定の値と置き換えます。Microsoft Dynamicsフォームデータモデルで Microsoft Dynamics を設定するには、「リソース」フィールドで Dynamics インスタンスの URL を指定する必要があります。サービスルート URL を使用して、Dynamics インスタンスの URL を取得します。例えば、https://org.crm.dynamics.com です。

    4. Microsoft Dynamics の認証プロセス用の「認証範囲」フィールドで、「openid」を指定します。

      認証設定
      フォームデータモデル

  3. OAuth に接続」をクリックします。Microsoft Dynamics のログインページにリダイレクトされます。

  4. Microsoft Dynamics の資格情報を使用してログインし、クラウドサービス設定を使用して Microsoft Dynamics サービスに接続することに同意します。これは、クラウドサービスとサービスの間でフォームデータモデルを確立する 1 回限りのタスクです。

    クラウドサービス設定のページに切り替わります。このページには、OData の設定が正常に保存されたことを示すメッセージが表示されます。

これで、MS Dynamics OData Cloud Service(OData サービス)がクラウドサービスとして設定され、Dynamics サービスに接続されます。フォームデータモデル フォームデータモデル

フォームデータモデルの作成

MS Dynamics OData Cloud Service(OData サービス)をクラウドサービスとして設定した後、フォームデータモデルの作成時にこのサービスを使用できます。詳しくは、「フォームデータモデルの作成」を参照してください。

次に、フォームデータモデルに基づいてアダプティブフォームを作成し、次のような様々なアダプティブフォームの使用例で使用できます。

  • Microsoft Dynamics のエンティティとサービスに対してクエリを実行し、取得した情報を使用してアダプティブフォームに事前入力する
  • アダプティブフォームのルールを使用して、フォームデータモデル内で定義された Microsoft Dynamics サーバーの操作を呼び出す。
  • 送信されたフォームデータを Microsoft Dynamics のエンティティに書き込む

ビジネスワークフローでのフォームデータモデルの作成および使用について詳しくは、「データ統合」を参照してください。

このページ