Microsoft Dynamics OData 設定 microsoft-dynamics-odata-configuration
Microsoft Dynamics は、顧客関係管理(CRM)および企業資源計画(ERP)用のソフトウェアで、顧客の口座や連絡先、潜在顧客、顧客機会、顧客事例を作成して管理する企業ソリューションを提供します。Experience Manager Forms データ統合は、Forms をオンラインサーバーとオンプレミスMicrosoft Dynamicsサーバーの両方と統合するための OData クラウドサービス設定を提供します。これにより、Microsoft Dynamics サービスで定義されるエンティティ、属性、サービスに基づいて、フォームデータモデル(FDM)を作成できるようになります。フォームデータモデル(FDM)を使用して、Microsoft Dynamics サーバーと連携するアダプティブフォームを作成することにより、ビジネスワークフローを使用できるようになります。次に例を示します。
- Microsoft Dynamics サーバーに対してデータに関するクエリを実行し、アダプティブフォームに事前入力する
- アダプティブフォームの送信時に、データを Microsoft Dynamics に書き込む
- フォームデータモデル(FDM)で定義されているカスタムエンティティを通じて、データを Microsoft Dynamics に書き込む(または書き出す)
AEM as a Cloud Service では、フォーム送信を処理するための様々な送信アクションが標準で提供されます。これらのオプションについて詳しくは、 アダプティブフォーム送信アクションの記事を参照してください。
前提条件 prerequisites
Microsoft Dynamics の設定を開始する前に、次のことを確認してください。
-
Microsoft Dynamics 365 がオンライン環境で設定されているか、以下のいずれかの Microsoft Dynamics バージョンのインスタンスがインストールされていること:
- Microsoft Dynamics 365 オンプレミス
- Microsoft Dynamics 2016 オンプレミス
-
Microsoft Dynamics オンラインサービス用アプリケーションを Microsoft Azure Active Directory に登録しました。登録済みサービスのクライアント ID(アプリケーション ID)とクライアントの秘密鍵の値を書き留めてください。これらの値は Microsoft Dynamics サービス用にクラウドサービスを設定する時に使用します。
登録された Microsoft Dynamics アプリケーションの応答 URL を設定 set-reply-url-for-registered-microsoft-dynamics-application
以下の手順で、登録された Microsoft Dynamics アプリケーションの応答 URL を設定します。
-
Microsoft Azure Active Directory アカウントに移動し、登録済みアプリケーションの「応答 URL」設定に以下のクラウドサービス設定の URL を追加します。
https://[server]:[port]/libs/fd/fdm/gui/components/admin/fdmcloudservice/createcloudconfigwizard/cloudservices.html
-
設定を保存します。
IFD 用に Microsoft Dynamics を設定 configure-microsoft-dynamics-for-ifd
Microsoft Dynamics の外部ユーザーは、Microsoft Dynamics でクレームベース認証を使用して、CRM サーバー上のデータにアクセスすることができます。この機能を有効にするには、以下の手順により、インターネット接続展開(IFD)用に Microsoft Dynamics を有効にして、クレーム設定をします。
-
「 Microsoft Dynamics の IFD 設定」の説明に従って、IFD の Microsoft Dynamics オンプレミスインスタンスを設定します。
-
Windows PowerShell を使用して以下のコマンドを実行し、IFD が有効になっている Microsoft Dynamics でクレームを設定します。
code language-shell Add-PSSnapin Microsoft.Crm.PowerShell $ClaimsSettings = Get-CrmSetting -SettingType OAuthClaimsSettings $ClaimsSettings.Enabled = $true Set-CrmSetting -Setting $ClaimsSettings
詳しくは、「CRM オンプレミス(IFD)のアプリ登録」を参照してください。
AD FS マシンで OAuth クライアントを設定する configure-oauth-client-on-ad-fs-machine
OAuth クライアントを Active Directory Federation Services(AD FS)マシンに登録し、AD FS マシンでアクセス権限を設定するには、以下の手順を実行します。
-
次のコマンドを実行します。
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
-
以下のコマンドを実行して、AD FS マシン上でアクセス権を設定します。
Grant-AdfsApplicationPermission -ClientRoleIdentifier “<Client-ID>” -ServerRoleIdentifier <resource> -ScopeNames openid
各パラメーターの意味は次のとおりです。
resource
は Microsoft Dynamics 組織の URL です。
-
Microsoft Dynamics では、HTTPS プロトコルが使用されます。Forms サーバーから AD FS エンドポイントを呼び出すには、Experience Manager Forms を実行しているコンピューターで
keytool
コマンドを使用して、Microsoft Dynamics のサイト証明書を Java 証明書ストアにインストールします。
Microsoft Dynamics サービス用にクラウドサービスを設定する configure-cloud-service-for-your-microsoft-dynamics-service
OData サービスは、そのサービスのルート URL によって識別されます。Experience Manager as a Cloud Service で OData サービスを設定するには、そのサービスのルート URL を確認して、以下の手順を実行します。
-
ツール/クラウドサービス/データソース に移動します。クラウド設定の作成対象となるフォルダーを選択します。
クラウドサービス設定用フォルダーの作成方法と構成方法については、「クラウドサービス設定用フォルダーの構成」を参照してください。
-
「作成」を選択して、データソース設定を作成 ウィザードを開きます。設定の名前と、必要に応じて設定のタイトルを指定し、サービスタイプ ドロップダウンで「OData サービス」を選択します。必要な場合は、設定のサムネール画像を参照および選択して「次へ」を選択します。
「認証設定」タブで、次のように設定します。-
「サービスルート」フィールドの値を入力します。Dynamics インスタンスの「開発者向けリソース」に移動し、「サービスルート」フィールドの値を表示します。例えば、https://<tenant-name>/api/data/v9.1/ です。
-
認証のタイプとして「OAuth 2.0」を選択します。
-
「クライアント ID」(「アプリケーション ID」とも呼ばれます)、「クライアントの秘密鍵」、「OAuth URL」、「更新トークン URL」、「トークン URL にアクセス」、「リソース」の各フィールドのデフォルト値を、 サービス設定の値と置き換えます。Microsoft DynamicsMicrosoft Dynamics をフォームデータモデル(FDM)で設定するには、「リソース」フィールドで Dynamics インスタンスの URL を指定する必要があります。サービスルート URL を使用して、Dynamics インスタンスの URL を取得します。例えば、https://org.crm.dynamics.com です。
-
Microsoft Dynamics の認証プロセス用の「認証範囲」フィールドで、「openid」を指定します。
フォームデータモデル(FDM)
-
-
「OAuth に接続」をクリックします。Microsoft Dynamics のログインページにリダイレクトされます。
-
Microsoft Dynamics の資格情報を使用してログインし、クラウドサービス設定を使用して Microsoft Dynamics サービスに接続することに同意します。このサービスとクラウドサービスとの間にフォームデータモデル(FDM)接続を確立する操作は 1 回だけ行います。
クラウドサービス設定のページに切り替わります。このページには、OData の設定が正常に保存されたことを示すメッセージが表示されます。
これで、MS Dynamics OData Cloud Service(OData サービス)がクラウドサービスとして設定され、Dynamics サービスに接続されます。フォームデータモデル(FDM)
フォームデータモデル(FDM)の作成 create-form-data-model
MS Dynamics OData クラウドサービスを設定した後、フォームデータモデル(FDM)の作成時にこのサービスを使用できます。詳しくは、フォームデータモデル(FDM)の作成を参照してください。
次に、フォームデータモデル(FDM)に基づいてアダプティブフォームを作成し、次のような様々なアダプティブフォームの使用例で使用できます。
- Microsoft Dynamics のエンティティとサービスに対してクエリを実行し、取得した情報を使用してアダプティブフォームに事前入力する
- アダプティブフォームのルールを使用して、フォームデータモデル(FDM)内で定義された Microsoft Dynamics サーバーの操作を呼び出す
- 送信されたフォームデータを Microsoft Dynamics のエンティティに書き込む
アダプティブフォームのフォームデータモデル送信アクションを設定すると、Microsoft Dynamics OData にデータを送信できます。
ビジネスワークフローでのフォームデータモデル(FDM)の作成および使用について詳しくは、データ統合を参照してください。