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 運算，然後按一下「Done」。
4. 將實體 ID 設為「841c04f9-3391-ef11-8a6b-002248d4e29e」，這是要傳遞的鍵。如要設定實體 ID，請在「資料對應」的「資料對應器」專區中，按一下「開啟資料對應編輯器」，然後在「輸入值」欄位中輸入 "841c04f9-3391-ef11-8a6b-002248d4e29e"，並選擇 EntityId 做為區域變數。

   如果實體有兩個複合式商務或主鍵，而非指定 entityId，您也可以將 filterClause 設為 id='841c04f9-3391-ef11-8a6b-002248d4e29e'。

範例：建立銷售訂單

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 salesOrders。
3. 選取 Create 運算，然後按一下「Done」。
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 運算，然後按一下「Done」。
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 運算，然後按一下「Done」。
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 運算，然後按一下「Done」。
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 運算，然後按一下「Done」。
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 運算，然後按一下「Done」。
4. 在「資料對應」任務的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。

   {
        "phoneNumber": "7764872993"
        }
        

5. 將 Data Mapper 中的實體 ID 設為 salesOrders 實體。如要設定實體 ID，請按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為區域變數。

   您也可以將 entityId 設為 id ='5e9226d3-1c7b-ef11-a671-6045bdaef76c'，而非指定 entityId。

範例：更新銷售訂單明細

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 salesOrderLines。
3. 選取 Update 運算，然後按一下「Done」。
4. 在「資料對應」任務的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。

   {
        "description": "Test from Altostrat"
        }
        

5. 將 Data Mapper 中的實體 ID 設為 salesOrderLines 的實體。如要設定實體 ID，請按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。

   您也可以將 entityId 設為 id ='35535130-d09d-ef11-8a6b-002248d4cc93'，而非指定 entityId。

範例：更新銷售報價

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 salesQuotes。
3. 選取 Update 運算，然後按一下「Done」。
4. 在「資料對應」任務的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。

   {
        "currencyCode": "USD"
        }
        

5. 將 Data Mapper 中的實體 ID 設為 salesQuotes 的實體。如要設定實體 ID，請按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。

   您也可以將 entityId 設為 id='2116bd4e-3ba3-ef11-8a6b-6045bdacfb5e'，而非指定 entityId。

範例：更新訂購單

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 purchaseOrders。
3. 選取 Update 運算，然後按一下「Done」。
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 設為 id ='6b88738e-3891-ef11-8a6b-002248d4e29e'，而非指定 entityId。

範例：更新商品

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 items。
3. 選取 Update 運算，然後按一下「Done」。
4. 在「資料對應」任務的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。

   {
        "displayName": "Updates Altostrat name"
        }
        

5. 將 Data Mapper 中的實體 ID 設為項目實體。如要設定實體 ID，請按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為區域變數。

   您也可以將 entityId 設為 id ='fad09437-8d9e-ef11-8a6b-000d3af0e092'，而非指定 entityId。