SAP Ariba Procurement

連線設定範例

本節列出您在建立連線時設定的各個欄位範例值。

OAuth 2.0 - 用戶端憑證連線類型

動作

本節說明如何在這個連接器中執行部分動作。

CreateChildElementSchema 動作

這項動作會為檢視範本中的文件陣列建立結構定義檔案。

CreateChildElementSchema 動作的輸入參數

如要瞭解如何設定 CreateChildElementSchema 動作，請參閱範例。

CreateSchema 動作

為指定資料表或檢視區塊建立結構定義檔。

CreateSchema 動作的輸入參數

如要瞭解如何設定 CreateSchema 動作，請參閱範例。

動作範例

本節說明如何執行這個連接器中的部分動作範例。

範例 - 建立子元素結構定義

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取「CreateChildElementSchema」動作，然後按一下「完成」。
3. 在「connectors」任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   {
     "ViewTemplateName": "InvoiceReconciliation_SAP_createdRange",
     "ChildElement": "Payments",
     "TableName": "View_LineItems_SplitAccountings"
   }
   

如果動作成功，連接器工作的 connectorOutputPayload 回應參數值會類似以下內容：

[
  {
    "FileData": "",
    "Result": "success"
  }
]

範例 - 建立結構定義

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取「CreateSchema」動作，然後按一下「完成」。
3. 在「connectors」任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   {
     "TableName": "Views"
   }
   

如果動作成功，連接器工作 connectorOutputPayload 回應參數的值會類似於下列內容：

[
  {
    "FileData": "",
    "Result": "success"
  }
]

實體作業範例

本節說明如何使用這個連接器執行部分實體作業。

範例 - 列出所有訂單

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Orders。
3. 選取「List」作業，然後按一下「完成」。
4. 在「連結器」工作的「工作輸入」部分，您可以根據客戶需求設定 filterClause。

您必須使用單引號 (') 括住 filterClause 的值。您可以使用 filterClause，根據資料欄篩選記錄。

範例 - 列出所有委刊項

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 LineItems。
3. 選取「List」作業，然後按一下「完成」。
4. 在連接器工作的「工作輸入」部分，您可以根據客戶需求設定 filterClause。

範例 - 取得訂單詳細資料

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Orders。
3. 選取「Get」作業，然後按一下「完成」。
4. 將 entityId 設為「DO240」，這是要傳遞的鍵。如要設定 entityId，請在「資料對應」的「資料對應器」部分，按一下「開啟資料對應編輯器」，然後在「輸入值」欄位中輸入 "DO240"，並選擇 entityId 做為本機變數。

您應直接傳遞 entityId 的值，例如「DO240」。其中「DO240」是唯一主鍵值。

如果因為存在兩個複合鍵而導致傳遞單一 entityId 時發生錯誤，可以使用 filterClause 傳遞值，例如 DocumentNumber='DO240'。

範例 - 取得委刊項詳細資料

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 LineItems。
3. 選取「Get」作業，然後按一下「完成」。
4. 將 filterClause 設為 LineNumber='1' AND DocumentNumber='DO240'，這是要傳遞的複合鍵。如要設定 filterClause，請在「資料對應」的「資料對應器」專區中，按一下「開啟資料對應編輯器」，然後在「輸入值」欄位中輸入 "LineNumber='1' AND DocumentNumber='DO240'"，並選擇 filterClause 做為本機變數。

範例 - 建立檢視區塊

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Views。
3. 選取「Create」作業，然後按一下「完成」。
4. 在「資料對應」工作中的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 entityId、connectorInputPayload 或 filterClause 做為本機變數。

   {
     "ViewTemplateName": "TestView1754629881645",
     "Status": "published",
     "FilterExpressions": "[{\"name\":\"ExampleFilter\",\"field\":\"UniqueName\",\"op\":\"IN\",\"defaultValue\":[\"P011\"]}]",
     "DocumentType": "DirectOrder",
     "SelectAttributes": "[\"SubmitDate\"]"
   }
   

   執行這個範例後，連接器工作 connectorOutputPayload 輸出變數會傳回類似下列內容的回應：

   {
     "Success": true
   }
   

範例 - 更新檢視區塊

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Views。
3. 選取「Update」作業，然後按一下「完成」。
4. 在「資料對應」工作的「資料對應器」專區中，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值。

   {
     "Status": "published"
   }
   

5. 在 Data Mapper 中，將 entityId 設為 Views 的 ID。如要設定 entityId，請按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 entityId、connectorInputPayload 或 filterClause 做為本機變數。

   除了指定 entityId，您也可以將 filterClause 設為 TestView = '1754629881645'。

   執行這個範例後，連接器工作 connectorOutputPayload 輸出變數會傳回類似下列內容的回應：

   {
   }
   

   回應中的空白 JSON 物件 {} 表示更新作業成功。