Dynamics 365 Business Central

接続構成のサンプル

このセクションでは、接続を作成するときに構成するさまざまなフィールドのサンプル値を示します。

OAuth 2.0 - クライアント認証情報の接続タイプ

アクセスキーの接続タイプ

Azure AD 接続の種類

Dynamics 365 Business Central ワークスペースの作成方法については、Dynamics 365 Business Central へようこそをご覧ください。

Dynamics 365 Business Central API の詳細については、Dynamics365BusinessCentral API リファレンスをご覧ください。

エンティティ オペレーションの例

このセクションでは、このコネクタでエンティティ オペレーションの一部を実行する方法について説明します。

例 - すべての販売注文を一覧表示する

1. [Configure connector task] ダイアログで、[Entities] をクリックします。
2. Entity から salesOrders を選択します。
3. [List] オペレーションを選択し、[完了] をクリックします。
4. [コネクタ] タスクの [タスク入力] セクションで、filterClause を設定できます。

フィルタ句の値は単一引用符（'）で囲む必要があります。フィルタ句を使用すると、列に基づいてレコードをフィルタできます。

例 - 販売注文を取得する

1. [Configure connector task] ダイアログで、[Entities] をクリックします。
2. Entity から salesOrders を選択します。
3. [Get] オペレーションを選択し、[完了] をクリックします。
4. エンティティ ID を「841c04f9-3391-ef11-8a6b-002248d4e29e」に設定します。これは渡されるキーです。エンティティ ID を設定するには、[データ マッピング] の [データ マッパー] セクションで [データ マッピング エディタを開く] をクリックし、[入力値] フィールドに "841c04f9-3391-ef11-8a6b-002248d4e29e" を入力し、EntityId をローカル変数として選択します。

   エンティティ ID の値は直接渡す必要があります（「841c04f9-3391-ef11-8a6b-002248d4e29e」など）。ここで、「841c04f9-3391-ef11-8a6b-002248d4e29e」は一意の主キー値です。

   2 つの複合キーが存在するため、単一のエンティティ ID を渡すとエラーが発生する場合は、フィルタ句を使用して値を渡すことができます。

例 - 販売注文を削除する

1. [Configure connector task] ダイアログで、[Entities] をクリックします。
2. Entity から salesOrders を選択します。
3. [DELETE] オペレーションを選択し、[完了] をクリックします。
4. エンティティ ID を「841c04f9-3391-ef11-8a6b-002248d4e29e」に設定します。これは渡されるキーです。エンティティ ID を設定するには、[データ マッピング] の [データ マッパー] セクションで [データ マッピング エディタを開く] をクリックし、[入力値] フィールドに "841c04f9-3391-ef11-8a6b-002248d4e29e" を入力し、EntityId をローカル変数として選択します。

   エンティティに 2 つの複合ビジネスキーまたは主キーがあり、entityId を指定する代わりに、filterClause を id='841c04f9-3391-ef11-8a6b-002248d4e29e' に設定することもできます。

例 - 販売注文を作成する

1. [Configure connector task] ダイアログで、[Entities] をクリックします。
2. Entity から salesOrders を選択します。
3. [Create] オペレーションを選択し、[完了] をクリックします。
4. [データ マッピング] タスクの [データ マッパー] セクションで、Open Data Mapping Editor をクリックし、[Input Value] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload をローカル変数として選択します。

   {
        "orderDate": "2024-10-30",
        "customerNumber": "10000",
        "currencyCode": "INR",
        "paymentTermsId": "590d75c5-f26e-ef11-a678-6045bdc89b07"
        }
        

   統合が成功すると、salesOrders タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

   {
        "id": "2e048d8a-a796-ef11-8a6b-6045bdae882d"
        }
        

例 - 販売注文行を作成する

1. [Configure connector task] ダイアログで、[Entities] をクリックします。
2. Entity から salesOrderLines を選択します。
3. [Create] オペレーションを選択し、[完了] をクリックします。
4. [データ マッピング] タスクの [データ マッパー] セクションで、Open Data Mapping Editor をクリックし、[Input Value] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload をローカル変数として選択します。

   {
        "documentId": "b747cc93-c37f-ef11-ac23-7c1e523b4365",
        "sequence": 10014,
        "itemId": "8b0f75c5-f26e-ef11-a678-6045bdc89b07",
        "lineType": "Item",
        "lineObjectNumber": "1996-S"
        }
        

   統合が成功すると、salesOrderLines タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

   {
        "id": "35535130-d09d-ef11-8a6b-002248d4cc93"
        }
        

例 - 販売見積もりを作成

1. [Configure connector task] ダイアログで、[Entities] をクリックします。
2. Entity から salesQuotes を選択します。
3. [Create] オペレーションを選択し、[完了] をクリックします。
4. [データ マッピング] タスクの [データ マッパー] セクションで、Open Data Mapping Editor をクリックし、[Input Value] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload をローカル変数として選択します。

   {
        "paymentTermsId": "590d75c5-f26e-ef11-a678-6045bdc89b07",
        "currencyCode": "INR",
        "customerNumber": "30000"
        }
        

   統合が成功すると、salesQuotes タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

   {
        "id": "2116bd4e-3ba3-ef11-8a6b-6045bdacfb5e"
        }
        

例 - 注文書を作成する

1. [Configure connector task] ダイアログで、[Entities] をクリックします。
2. Entity から purchaseOrders を選択します。
3. [Create] オペレーションを選択し、[完了] をクリックします。
4. [データ マッピング] タスクの [データ マッパー] セクションで、Open Data Mapping Editor をクリックし、[Input Value] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload をローカル変数として選択します。

   {
        "vendorId": "7e0f75c5-f26e-ef11-a678-6045bdc89b07",
        "vendorNumber": "10000"
        }
        

   統合が成功すると、purchaseOrders タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

   {
        "id": "53389ee7-a796-ef11-8a6b-6045bdae882d"
        }
        

例 - アイテムを作成する

1. [Configure connector task] ダイアログで、[Entities] をクリックします。
2. Entity から items を選択します。
3. [Create] オペレーションを選択し、[完了] をクリックします。
4. [データ マッピング] タスクの [データ マッパー] セクションで、Open Data Mapping Editor をクリックし、[Input Value] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload をローカル変数として選択します。

   {
        "number": "4000-D",
        "displayName": "Charlie Altostrat",
        "type": "Inventory",
        "itemCategoryId": "d61672cb-f26e-ef11-a678-6045bdc89b07",
        "baseUnitOfMeasureCode": "PCS"
        }
        

   統合が成功すると、items タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

   {
        "id": "fad09437-8d9e-ef11-8a6b-000d3af0e092"
        }
        

例 - 販売注文を更新する

1. [Configure connector task] ダイアログで、[Entities] をクリックします。
2. Entity から salesOrders を選択します。
3. [Update] オペレーションを選択し、[完了] をクリックします。
4. [データ マッピング] タスクの [データ マッパー] セクションで、Open Data Mapping Editor をクリックし、[Input Value] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload/FilterClause をローカル変数として選択します。

   {
        "phoneNumber": "7764872993"
        }
        

5. データマッパーでエンティティ ID を salesOrders のエンティティに設定します。エンティティ ID を設定するには、[Open Data Mapping Editor] をクリックし、[Input Value] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload/FilterClause をローカル変数として選択します。

   [entityId] を指定する代わりに、[filterClause] を id ='5e9226d3-1c7b-ef11-a671-6045bdaef76c' に設定することもできます。

例 - 販売注文行を更新する

1. [Configure connector task] ダイアログで、[Entities] をクリックします。
2. Entity から salesOrderLines を選択します。
3. [Update] オペレーションを選択し、[完了] をクリックします。
4. [データ マッピング] タスクの [データ マッパー] セクションで、Open Data Mapping Editor をクリックし、[Input Value] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload/FilterClause をローカル変数として選択します。

   {
        "description": "Test from Altostrat"
        }
        

5. データマッパーでエンティティ ID を salesOrderLines のエンティティに設定します。エンティティ ID を設定するには、[Open Data Mapping Editor] をクリックし、[Input Value] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload/FilterClause をローカル変数として選択します。

   [entityId] を指定する代わりに、[filterClause] を id ='35535130-d09d-ef11-8a6b-002248d4cc93' に設定することもできます。

例 - 販売見積もりを更新する

1. [Configure connector task] ダイアログで、[Entities] をクリックします。
2. Entity から salesQuotes を選択します。
3. [Update] オペレーションを選択し、[完了] をクリックします。
4. [データ マッピング] タスクの [データ マッパー] セクションで、Open Data Mapping Editor をクリックし、[Input Value] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload/FilterClause をローカル変数として選択します。

   {
        "currencyCode": "USD"
        }
        

5. データマッパーでエンティティ ID を salesQuotes のエンティティに設定します。エンティティ ID を設定するには、[Open Data Mapping Editor] をクリックし、[Input Value] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload/FilterClause をローカル変数として選択します。

   [entityId] を指定する代わりに、[filterClause] を id='2116bd4e-3ba3-ef11-8a6b-6045bdacfb5e' に設定することもできます。

例 - 注文書を更新する

1. [Configure connector task] ダイアログで、[Entities] をクリックします。
2. Entity から purchaseOrders を選択します。
3. [Update] オペレーションを選択し、[完了] をクリックします。
4. [データ マッピング] タスクの [データ マッパー] セクションで、Open Data Mapping Editor をクリックし、[Input Value] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload/FilterClause をローカル変数として選択します。

   {
        "shipToName": "Charlie Cruz"
        }
        

5. Data Mapper でエンティティ ID を purchaseOrders のエンティティに設定します。エンティティ ID を設定するには、[Open Data Mapping Editor] をクリックし、[Input Value] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload/FilterClause をローカル変数として選択します。

   [entityId] を指定する代わりに、[filterClause] を id ='6b88738e-3891-ef11-8a6b-002248d4e29e' に設定することもできます。

例 - アイテムを更新する

1. [Configure connector task] ダイアログで、[Entities] をクリックします。
2. Entity から items を選択します。
3. [Update] オペレーションを選択し、[完了] をクリックします。
4. [データ マッピング] タスクの [データ マッパー] セクションで、Open Data Mapping Editor をクリックし、[Input Value] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload/FilterClause をローカル変数として選択します。

   {
        "displayName": "Updates Altostrat name"
        }
        

5. データマッパーでエンティティ ID をアイテムのエンティティに設定します。エンティティ ID を設定するには、[Open Data Mapping Editor] をクリックし、[Input Value] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload/FilterClause をローカル変数として選択します。

   [entityId] を指定する代わりに、[filterClause] を id ='fad09437-8d9e-ef11-8a6b-000d3af0e092' に設定することもできます。