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”是唯一的主键值。

   如果由于存在两个复合键而导致传递单个实体 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 作为本地变量。

   如果实体具有两个复合商家键或主键，您也可以将 filterClause 设置为 id='841c04f9-3391-ef11-8a6b-002248d4e29e'，而不是指定 entityId。

示例 - 创建销售订单

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 作为本地变量。

   您也可以将 filterClause 设置为 id ='5e9226d3-1c7b-ef11-a671-6045bdaef76c'，而不是指定 entityId。

示例 - 更新销售订单明细

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 作为本地变量。

   您也可以将 filterClause 设置为 id ='35535130-d09d-ef11-8a6b-002248d4cc93'，而不是指定 entityId。

示例 - 更新销售报价

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 作为本地变量。

   您也可以将 filterClause 设置为 id='2116bd4e-3ba3-ef11-8a6b-6045bdacfb5e'，而不是指定 entityId。

示例 - 更新采购订单

1. 在 Configure connector task 对话框中，点击 Entities。
2. 从 Entity 列表中选择 purchaseOrders。
3. 选择 Update 操作，然后点击完成。
4. 在数据映射任务的数据映射器部分，点击 Open Data Mapping Editor，然后在 Input Value 字段中输入类似于以下内容的值，并选择 EntityId/ConnectorInputPayload/FilterClause 作为本地变量。

   {
        "shipToName": "Charlie Cruz"
        }
        

5. 将数据映射器中的实体 ID 设置为 purchaseOrders 的实体。如需设置实体 ID，请点击 Open Data Mapping Editor，然后在 Input Value 字段中输入类似于以下内容的值，并选择 EntityId/ConnectorInputPayload/FilterClause 作为本地变量。

   您也可以将 filterClause 设置为 id ='6b88738e-3891-ef11-8a6b-002248d4e29e'，而不是指定 entityId。

示例 - 更新商品

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 作为本地变量。

   您也可以将 filterClause 设置为 id ='fad09437-8d9e-ef11-8a6b-000d3af0e092'，而不是指定 entityId。