メインコンテンツへスキップ

Microsoft Dynamics 365 コネクタを追加

Microsoft Dynamics 365 への認証

コネクタを追加したら、必要なプロパティを設定します。 Organizational URL: Microsoft Dynamics 365 組織のURL(例:https://abc123.cloudax.dynamics.com )を入力します。 CData Sync supports authenticating to Microsoft Dynamics 365 in several ways. Select your authentication method below to proceed to the relevant section that contains the authentication details.

Azure Active Directory

Azure Managed Service Identity

Azure Service Principal

Azure サービスプリンシパルとクライアントシークレットで接続するには、次のプロパティを設定します:

  • Auth Scheme:AzureServicePrincipal を選択。
  • Azure Tenant:接続するMicrosoft Online テナントを入力。
  • OAuth Client Id:OAuth 認証サーバーにアプリケーションを登録した際に割り当てられたクライアントId を入力。
  • OAuth Client Secret:OAuth 認証サーバーにアプリケーションを登録した際に割り当てられたクライアントシークレットを入力。

アプリケーションのOAuth クライアントId およびクライアントシークレットを取得するには:

  1. Azure ポータルにログインします。
  2. 左ナビゲーションペインですべてのサービスを選択します。次にアプリの登録を検索し選択します。
  3. 新規登録をクリックします。
  4. アプリケーションの名前を入力して任意のAzure AD ディレクトリ - マルチテナントを選択します。
  5. アプリケーションを作成したら、概要セクションに表示されるアプリケーション (クライアント) ID の値をコピーします。この値をOAuth クライアントId として使用します。
  6. 証明書とシークレットセクションに移動して、アプリケーションの新しいクライアント シークレットを選択します。
  7. 有効期間を指定してクライアントシークレットを保存します。保存するとキーの値が表示されます。
  8. 値は一度しか表示されないので、コピーしておきます。この値をOAuth クライアントシークレットとして使用します。
  9. 認証タブで、必ずアクセストークン (暗黙的なフローに使用) を選択します。

Azure Service Principal Certificate

Azure サービスプリンシパルとクライアント証明書で接続するには、次のプロパティを設定します:

  • Auth Scheme:AzureServicePrincipalCert を選択。
  • Azure Tenant:接続するMicrosoft Online テナントを入力。
  • OAuth Client Id:OAuth 認証サーバーにアプリケーションを登録した際に割り当てられたクライアントId を入力。
  • OAuth JWT Cert:Java web token(JWT)証明書ストアを入力。
  • OAuth JWT Cert Type:JWT 証明書を格納するキーストアの種類を入力。デフォルトの種類はPEMKEY_BLOB です。
  • (オプション)OAuth JWT Cert Password:OAuth JWT 証明書のパスワードを入力。
  • (オプション)OAuth JWT Cert Subject:OAuth JWT 証明書のサブジェクトを入力。

アプリケーションのOAuth 証明書を取得するには:

  1. Azure ポータルにログインします。
  2. 左ナビゲーションペインですべてのサービスを選択します。次にアプリの登録を検索し選択します。
  3. 新規登録をクリックします。
  4. アプリケーションの名前を入力して任意のAzure AD ディレクトリ - マルチテナントを選択します。
  5. アプリケーションを作成したら、概要セクションに表示されるアプリケーション (クライアント) ID の値をコピーします。この値をOAuth クライアントId として使用します。
  6. 証明書とシークレットセクションに移動して、証明書のアップロードを選択します。次に、ローカルマシンからアップロードする証明書を選択します。
  7. 有効期間を指定してクライアントシークレットを保存します。保存するとキーの値が表示されます。
  8. 値は一度しか表示されないので、コピーしておきます。この値をOAuth クライアントシークレットとして使用します。
  9. 認証タブで、必ずアクセストークン (暗黙的なフローに使用) を選択します。

接続を完了する

接続を完了するには:
  1. Edition で、お使いのバージョンのMicrosoft Dynamics 365 のエディションを選択します。
    • CustomerService
    • FieldService
    • Marketing
    • ProjectOperations
    • Sales
    • Commerce
    Note: FinOpsOnline、FinOpsOnPremise、HumanResources エディションは、Microsoft Dynamics 365 同期先をサポートしていません。
  2. 高度な設定 タブで詳細な接続設定を定義します。(ただし、ほとんどの場合、これらの設定は必要ありません。)
  3. AzureAd で認証する場合は、Microsoft Dynamics 365 への接続をクリックしてMicrosoft Dynamics 365 アカウントに接続します。
  4. 作成およびテストをクリックして接続を作成します。

代替キーの作成

代替キーの使用は、CData Sync のリバースETL ワークフローの重要な要素であり、データ統合を簡素化します。Microsoft Dynamics 365 はデータをMicrosoft Dataverse テーブルに格納するため、代替キーは Sync とMicrosoft Dynamics 365 間のデータ移動を円滑にする上で重要な役割を果たします。これらのキーは、Dataverse のグローバル一意識別子(GUID)が利用できない場合に、レコードを照合するための信頼できる手段となります。Salesforce が外部Id をレコード識別に使用するのと同様に、代替キーによって、主キーとなる識別子(Id)に依存することなく、シームレスな同期とデータ更新が保証されます。 Dataverse テーブルの代替キーを作成すると、そのキーはSync のリバースETL ジョブのカラムマッピングタブにカラムとして表示されます。 代替キーを作成するには:
  1. Microsoft Power Apps にサインインし、Dataverse テーブルに移動します。
  2. テーブル(例:Account テーブル)を選択します。テーブルビューが開きます。
  3. テーブルビューで、Keys を選択して代替キービューを開きます。
  4. Keys ページで、次の手順を実行します:
    1. New Key をクリックします。右側にポップアップダイアログボックスが開きます。
    2. Key ダイアログボックスで、次の情報を指定します:
      • Display Name: このキーの名前を入力します。この名前は、Sync アプリケーションのID マッピングセクションに表示されるラベルになります。
      • Columns: 代替キーとして使用するカラムを選択します。代替キーは一意である必要があり、Microsoft Dynamics 365 のドキュメントに記載されている要件を満たす必要があることに注意してください。要件を満たすカラムがない場合は、使用するカラムを手動で追加できます。 Note: 外部識別子(Id)として使用する新しいカラムを追加する場合は、意図しない重複を防ぐため、使用する前に一意の値を設定してください。
    3. Save をクリックして代替キーを作成し、Sync ジョブのカラムマッピングタブに表示します。
  5. カラムマッピングタブで代替キーの名前を選択し、Sync のソースの適切なカラムにマッピングします。

詳細について