> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sync.cdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Microsoft Dynamics 365

CData Sync アプリケーションからMicrosoft Dynamics 365 コネクタを使用して、サポートされている任意のデータソースから同期先のMicrosoft Dynamics 365 へデータを移動できます。これを行うには、コネクタを追加し、コネクタへの認証を行い、接続を完了する必要があります。

## Microsoft Dynamics 365 コネクタを追加

Sync でMicrosoft Dynamics 365 のデータを使用できるようにするには、まず以下の手順でコネクタを追加する必要があります：

<ol>
  <li>Sync のダッシュボードから**接続**ページを開きます。</li>
  <li>**接続を追加**をクリックして**コネクタを選択**ページを開きます。</li>
  <li>**同期先**タブをクリックして
  **Microsoft Dynamics 365** 行に移動します。</li>

  <li>
    行末にある**接続を設定**アイコンをクリックして、**新しい接続**ページを開きます。この操作により、
    **接続を追加**ダイアログボックスが開きます。

    **Note：** **接続を設定**アイコンが表示されない場合は、**コネクタをダウンロード**アイコンをクリックして Microsoft Dynamics 365 コネクタをインストールしてください。
  </li>

  <li>**接続を追加**ダイアログボックスに接続名を入力します。</li>
  <li>**追加**をクリックして、コネクタの**設定**タブを開きます。</li>
</ol>

新しいコネクタのインストールについての詳細は、
[接続](https://docs.sync.cdata.com/26.4/ja/connections/connections.md)を参照してください。

## Microsoft Dynamics 365 への認証

コネクタを追加したら、必要なプロパティを設定します。

**Organizational URL：** Microsoft Dynamics 365 組織のURL（例：[https://abc123.cloudax.dynamics.com](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.

* [**AzureAD**](#azure-active-directory)（デフォルト）
* [**AzureMSI**](#azure-managed-service-identity)
* [**AzureServicePrincipal**](#azure-service-principal)
* [**AzureServicePrincipalCert**](#azure-service-principal-certificate)

### Azure Active Directory

Azure Active Directory（AD）ユーザーアカウントで接続するには、**Auth Scheme** で**AzureAD** を選択します。CData Sync は、接続するための組み込みOAuth アプリケーションを提供するため、追加のプロパティは必要ありません。

### Azure Managed Service Identity

Azure 仮想マシン上でCData Sync が実行されている場合にAzure マネージドサービスID（MSI）を利用するには、**Auth Scheme** で**Azure MSI** を選択します。追加のプロパティは必要ありません。

### Azure Service Principal

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

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

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

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

### Azure Service Principal Certificate

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

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

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

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

## 接続を完了する

接続を完了するには：

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 のソースの適切なカラムにマッピングします。

## 詳細について


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.