SAP Hybris C4C

SAP Hybris C4C 連接器可讓您對 SAP Hybris 資料執行插入、刪除、更新和讀取作業。

支援的版本

這個連接器支援 SAP Cloud API 1.0 版。

事前準備

在 Google Cloud 專案中,執行下列工作:

  • 確認已設定網路連線。如要瞭解網路模式,請參閱「網路連線」。
  • roles/connectors.admin IAM 角色授予設定連結器的使用者。
  • roles/secretmanager.viewerroles/secretmanager.secretAccessor IAM 角色授予要用於連接器的服務帳戶
  • 啟用下列服務:
    • secretmanager.googleapis.com (Secret Manager API)
    • connectors.googleapis.com (Connectors API)

    如要瞭解如何啟用服務,請參閱「啟用服務」。如果先前未啟用這些服務或權限,系統會在您設定連結器時提示啟用。

設定連接器

連線專屬於資料來源。也就是說,如果您有多個資料來源,則必須為每個資料來源建立個別的連線。如要建立連線,請按照下列步驟操作:

  1. Cloud 控制台中,前往「Integration Connectors」>「Connections」頁面,然後選取或建立 Google Cloud 專案。

    前往「連線」頁面

  2. 按一下「+ 建立新連線」,開啟「建立連線」頁面。
  3. 在「位置」部分中,選擇連線位置。
    1. 區域:從下拉式清單中選取位置。

      如需所有支援的地區清單,請參閱「位置」一文。

    2. 點按「下一步」
  4. 在「連線詳細資料」部分,完成下列步驟:
    1. 連接器:從可用連接器的下拉式清單中選取「SAP Hybris C4C」
    2. 連接器版本:從可用版本的下拉式清單中選取連接器版本。
    3. 在「連線名稱」欄位中,輸入連線執行個體的名稱。

      連線名稱必須符合下列條件:

      • 連線名稱可使用英文字母、數字或連字號。
      • 字母必須為小寫。
      • 連線名稱開頭須為英文字母,結尾則須為英文字母或數字。
      • 連結名稱不得超過 49 個字元。
    4. 視需要輸入連線執行個體的「Description」(說明)
    5. 或者,可啟用 Cloud Logging,然後選取記錄層級。記錄層級預設為 Error
    6. 服務帳戶:選取具備必要角色的服務帳戶。
    7. 租戶:要建立連線的 SAP Cloud 執行個體。
    8. 使用用戶端分頁:如要在 SAP Cloud 的 ADO.NET 供應商中啟用用戶端分頁,請啟用這個選項。
    9. 使用自訂服務:如要啟用自訂 SAP Cloud OData 服務,請啟用這個選項。
    10. 使用者定義的檢視區塊:指定包含自訂檢視區塊的 JSON 設定檔路徑。
    11. 視需要設定「連線節點設定」

      • 節點數量下限:輸入連線節點數量下限。
      • 節點數量上限:輸入連線節點數量上限。

      節點是用來處理交易的連線單位 (或備用資源)。連線處理的交易量越多,就需要越多節點;反之,處理的交易量越少,需要的節點就越少。如要瞭解節點對連接器定價的影響,請參閱「 連線節點定價」。如未輸入任何值,系統預設會將節點下限設為 2 (提高可用性),節點上限則設為 50。

    12. (選用) 如要為連線設定 Proxy 伺服器,請選取「使用 Proxy」並輸入 Proxy 詳細資料。
      • Proxy 驗證機制:選取與 Proxy 伺服器進行驗證的驗證類型。系統支援下列驗證類型:
        • 基本:基本 HTTP 驗證。
        • 摘要:摘要 HTTP 驗證。
      • Proxy 使用者:用於向 Proxy 伺服器驗證的使用者名稱。
      • Proxy Password:使用者的密碼 Secret Manager 密鑰。
      • Proxy SSL Type:連線至 Proxy 伺服器時要使用的 SSL 類型。系統支援下列驗證類型:
        • 自動:預設設定。如果網址是 HTTPS 網址,則會使用「通道」選項。如果網址是 HTTP 網址,系統會使用「永不」選項。
        • 一律:連線一律啟用 SSL。
        • 從未:連線未啟用 SSL。
        • 通道:連線是透過通道 Proxy 建立。Proxy 伺服器會開啟與遠端主機的連線,流量則會透過 Proxy 來回傳輸。
      • 在「Proxy 伺服器」部分中,輸入 Proxy 伺服器的詳細資料。
        1. 按一下「+ 新增目的地」
        2. 選取「目的地類型」
          • 主機位址:指定目的地的 IP 位址或主機名稱。

            如要與後端系統建立私人連線,請按照下列步驟操作:

    13. 選用:按一下「+ 新增標籤」,以鍵/值組合的形式為連線新增標籤。
    14. 點按「下一步」
  5. 在「目的地」部分,輸入要連線的遠端主機 (後端系統) 詳細資料。
    1. 目的地類型:選取目的地類型
      • 如要指定目的地主機名稱或 IP 位址,請選取「主機地址」,然後在「主機 1」欄位中輸入地址。
      • 如要建立私人連線,請選取「Endpoint attachment」(端點連結),然後從「Endpoint Attachment」(端點連結) 清單中選擇所需連結。

      如要建立與後端系統的公開連線,並加強安全性,建議為連線設定靜態輸出 IP 位址,然後設定防火牆規則,只允許特定靜態 IP 位址。

      如要輸入其他目的地,請按一下「+新增目的地」

    2. 點按「下一步」
  6. 在「Authentication」(驗證) 部分中,輸入驗證詳細資料。
    1. 選取「驗證類型」並輸入相關詳細資料。

      SAP Hybris C4C 連線支援下列驗證類型:

      • 使用者名稱和密碼
    2. 如要瞭解如何設定這些驗證類型,請參閱「設定驗證」。

    3. 點按「下一步」
  7. 檢查:檢查連線和驗證詳細資料。
  8. 點選「建立」

設定驗證機制

根據要使用的驗證方式輸入詳細資料。

  • 使用者名稱和密碼
    • 使用者名稱:輸入使用者名稱,向 SAP Cloud 進行驗證。
    • 密碼:指定 Secret Manager 密鑰,內含 SAP Cloud 帳戶的相關聯密碼。

連線設定範例

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

使用者名稱和密碼連線類型

欄位名稱 詳細資料
位置 asia-east1
連接器 SAP Hybris C4C
連接器版本 1
連線名稱 sap-hybris-c4c-c4codataapi-conn
啟用 Cloud Logging
服務帳戶 my-service-account@my-project.iam.gserviceaccount.com
用戶群 my335480.crm.ondemand.com
節點數量下限 2
節點數量上限 50
主機地址 https://192.0.2.0
驗證 使用者密碼
使用者名稱 使用者名稱
密碼 密碼
密鑰版本 1

系統限制

SAP Hybris C4C 連接器每秒最多可處理 4 筆交易 (每個節點),並節流任何超出此限制的交易。根據預設,Integration Connectors 會為連線分配 2 個節點 (以提高可用性)。

如要瞭解 Integration Connectors 適用的限制,請參閱「限制」一文。

在整合中,使用 SAP Hybris C4C 連線

建立連線後,Apigee Integration 和 Application Integration 都會提供該連線。您可以在整合中透過「連接器」工作使用連線。

  • 如要瞭解如何在 Apigee Integration 中建立及使用「連線器」工作,請參閱「連線器工作」。
  • 如要瞭解如何在 Application Integration 中建立及使用「連線器」工作,請參閱「連線器工作」。

實體作業範例

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

範例 - 列出「leads」集合中的所有待開發客戶

  1. 在「Configure connector task」對話方塊中,按一下 Entities
  2. Entity 清單中選取 LeadCollection。
  3. 選取「LIST」作業,然後按一下「完成」
  4. 在「連線器」工作的「工作輸入」部分,您可以設定 filterClause,根據任何資料欄篩選記錄。您必須以單引號傳遞篩選子句的值。

範例 - 從待開發客戶集合取得待開發客戶

  1. 在「Configure connector task」對話方塊中,按一下 Entities
  2. Entity 清單中選取 LeadCollection。
  3. 選取「Get」作業,然後按一下「完成」
  4. 將實體 ID 設為「C1A464ABFE7D1EEFACB0E27B8F791046」,這是要傳遞的金鑰。如要設定實體 ID,請在「資料對應」的「資料對應器」部分,按一下「開啟資料對應編輯器」,然後在「輸入值」欄位中輸入 "C1A464ABFE7D1EEFACB0E27B8F791046",並選擇 EntityId 做為本機變數。
  5. 直接傳遞實體 ID 的值,例如「C1A464ABFE7D1EEFACB0E27B8F791046」,這是唯一的 Primary Key 值。如果實體有兩個複合鍵,請使用篩選子句並傳遞值,例如 ObjectID ='C1A464ABFE7D1EEFACB0E27B8F791046'

範例 - 從待開發客戶集合中刪除待開發客戶

  1. 在「Configure connector task」對話方塊中,按一下 Entities
  2. Entity 清單中選取 LeadCollection。
  3. 選取「Delete」作業,然後按一下「完成」
  4. 將實體 ID 設為「C1A464ABFE7D1EEFACB0E27B8F791046s」,這是要傳遞的金鑰。如要設定實體 ID,請在「資料對應」的「資料對應器」部分,按一下「開啟資料對應編輯器」,然後在「輸入值」欄位中輸入 "C1A464ABFE7D1EEFACB0E27B8F791046",並選擇 EntityId 做為本機變數。

    如果實體有兩個複合式商家或主鍵,而非指定 entityId,您也可以將 filterClause 設為 ObjectID ='C1A464ABFE7D1EEFACB0E27B8F791046'

範例 - 在待開發客戶集合中建立待開發客戶

  1. 在「Configure connector task」對話方塊中,按一下 Entities
  2. Entity 清單中選取 LeadCollection
  3. 選取「Create」作業,然後按一下「完成」
  4. 在「資料對應」工作的「資料對應器」部分,按一下 Open Data Mapping Editor,然後在 Input Value 欄位中輸入類似下列的值,並選擇 EntityId/ConnectorInputPayload 做為本機變數。
    { "Name": "Googlecloud_Testing", "AccountPartyID": "8000000070" }
    

    如果整合成功,LeadCollection 工作的 connectorOutputPayload 回應參數值會類似以下內容:

    { "ObjectID": "C1A464ABFE7D1EEFAF8D279CA432116F" }
    

範例 - 在商機集合中建立商機

  1. 在「Configure connector task」對話方塊中,按一下 Entities
  2. Entity 清單中選取 OpportunityCollection。
  3. 選取「Create」作業,然後按一下「完成」
  4. 在「資料對應」工作的「資料對應器」部分,按一下 Open Data Mapping Editor,然後在 Input Value 欄位中輸入類似下列的值,並選擇 EntityId/ConnectorInputPayload 做為本機變數。
    { "Name": "Charlie", "ProspectPartyID": "1", "MainEmployeeResponsiblePartyID": "TESTUPDATEXYZ" }
    

    如果整合成功,OpportunityCollection 工作的 connectorOutputPayload 回應參數值會類似以下內容:

    { "ObjectID": "C1A464ABFE7D1EEFB0A6F0AD1ACA91B5" }
    

範例 - 在商品集合中建立顧客訂單

  1. 在「Configure connector task」對話方塊中,按一下 Entities
  2. Entity 清單中選取 CustomerOrderItemCollection。
  3. 選取「Create」作業,然後按一下「完成」
  4. 在「資料對應」工作的「資料對應器」部分,按一下 Open Data Mapping Editor,然後在 Input Value 欄位中輸入類似下列的值,並選擇 EntityId/ConnectorInputPayload 做為本機變數。
    { "Description": "This is Customer Order Collection", "ParentObjectID": "D3542BF960751EEFADE1140D7614A0C7", "ProductID": "128" }
    

    如果整合成功,CustomerOrderItemCollection 工作的 connectorOutputPayload 回應參數值會類似以下內容:

    { "ObjectID": "C1A464ABFE7D1EEFB1C28BC1781A71FE" }
    

範例 - 在合約集合中建立合約

  1. 在「Configure connector task」對話方塊中,按一下 Entities
  2. Entity 清單中選取 ContractCollection。
  3. 選取「Create」作業,然後按一下「完成」
  4. 在「資料對應」工作的「資料對應器」部分,按一下 Open Data Mapping Editor,然後在 Input Value 欄位中輸入類似下列的值,並選擇 EntityId/ConnectorInputPayload 做為本機變數。
    { "Name": "Contract Collection AK" }
    

    如果整合成功,ContractCollection 工作的 connectorOutputPayload 回應參數值會類似以下內容:

    { "ObjectID": "C1A464ABFE7D1EEFAFF6ED3FF1EE119E" }
    

範例 - 在銷售報價集合中建立銷售報價

  1. 在「Configure connector task」對話方塊中,按一下 Entities
  2. Entity 清單中選取 SalesQuoteCollection。
  3. 選取「Create」作業,然後按一下「完成」
  4. 在「資料對應」工作的「資料對應器」部分,按一下 Open Data Mapping Editor,然後在 Input Value 欄位中輸入類似下列的值,並選擇 EntityId/ConnectorInputPayload 做為本機變數。
    { "Name": "Charlie Cruz" }
    

    如果整合成功,SalesQuoteCollection 工作的 connectorOutputPayload 回應參數值會類似以下內容:

    { "ObjectID": "C1A464ABFE7D1EEFAE8A044BF41C112F" }
    

範例 - 在 customers 集合中建立個別客戶

  1. 在「Configure connector task」對話方塊中,按一下 Entities
  2. Entity 清單中選取 IndividualCustomerCollection。
  3. 選取「Create」作業,然後按一下「完成」
  4. 在「資料對應」工作的「資料對應器」部分,按一下 Open Data Mapping Editor,然後在 Input Value 欄位中輸入類似下列的值,並選擇 EntityId/ConnectorInputPayload 做為本機變數。
    { "RoleCode": "BUP002", "FirstName": "Charlie", "LastName": "Cruz" }
    

    如果整合成功,IndividualCustomerCollection 工作的 connectorOutputPayload 回應參數值會類似以下內容:

    { "ObjectID": "C1A464ABFE7D1EEFB0A0ECAD1B1691B5" }
    

範例 - 在帳戶集合中建立公司帳戶

  1. 在「Configure connector task」對話方塊中,按一下 Entities
  2. Entity 清單中選取 CorporateAccountCollection。
  3. 選取「Create」作業,然後按一下「完成」
  4. 在「資料對應」工作的「資料對應器」部分,按一下 Open Data Mapping Editor,然後在 Input Value 欄位中輸入類似下列的值,並選擇 EntityId/ConnectorInputPayload 做為本機變數。
    { "Name": "Charlie S", "RoleCode": "CRM000" }
    

    如果整合成功,CorporateAccountCollection 工作的 connectorOutputPayload 回應參數值會類似以下內容:

    { "ObjectID": "C1A464ABFE7D1EEFB0901EC0786A51A9" }
    

範例 - 在合作夥伴集合中建立合作夥伴

  1. 在「Configure connector task」對話方塊中,按一下 Entities
  2. Entity 清單中選取 PartnerCollection。
  3. 選取「Create」作業,然後按一下「完成」
  4. 在「資料對應」工作的「資料對應器」部分,按一下 Open Data Mapping Editor,然後在 Input Value 欄位中輸入類似下列的值,並選擇 EntityId/ConnectorInputPayload 做為本機變數。
    { "HouseNumber": "B-5", "Name": "Charlie", "CountryCode": "US", "City": "Muzzfanagar", "StateCode": "AZ", "POBoxPostalCode": "12345", "StreetPostalCode": "56789", "POBox": "MS" }
    

    如果整合成功,PartnerCollection 工作的 connectorOutputPayload 回應參數值會類似以下內容:

    { "ObjectID": "C1A464ABFE7D1EEFB1CCA349FF68B204" }
    

範例 - 在競爭對手集合中建立競爭對手

  1. 在「Configure connector task」對話方塊中,按一下 Entities
  2. Entity 清單中選取 CompetitorCollection。
  3. 選取「Create」作業,然後按一下「完成」
  4. 在「資料對應」工作的「資料對應器」部分,按一下 Open Data Mapping Editor,然後在 Input Value 欄位中輸入類似下列的值,並選擇 EntityId/ConnectorInputPayload 做為本機變數。
    { "Name": "Charlie Cruz", "Phone": "1213446464" }
    

    如果整合成功,CompetitorCollection 工作的 connectorOutputPayload 回應參數值會類似以下內容:

    { "ObjectID": "C1A464ABFE7D1EEFAE82734673233121" }
    

範例 - 在參考集合中建立商業交易文件

  1. 在「Configure connector task」對話方塊中,按一下 Entities
  2. 從「Entity」清單中選取「OpportunityBusinessTransactionDocumentReferenceCollection」。
  3. 選取「Create」作業,然後按一下「完成」
  4. 在「資料對應」工作的「資料對應器」部分,按一下 Open Data Mapping Editor,然後在 Input Value 欄位中輸入類似下列的值,並選擇 EntityId/ConnectorInputPayload 做為本機變數。
    {
      "ParentObjectID": "07D09F6BEB401EEFB683B9BFCBD63CA1",
      "OpportunityID": "11",
      "ID": "17",
      "TypeCode": "30",
      "BusinessTransactionDocumentRelationshipRoleCode": "2"
    }
    

    如果整合成功,連接器工作 connectorOutputPayload 回應參數的值會類似於下列內容:

    { "ObjectID": "C1A464ABFE7D1EEFAE8A044BF41C112F" }
    

範例 - 在商機集合中建立附件

  1. 在「Configure connector task」對話方塊中,按一下 Entities
  2. Entity 清單中選取 OpportunityAttachmentFolderCollection。
  3. 選取「Create」作業,然後按一下「完成」
  4. 在「資料對應」工作的「資料對應器」部分,按一下 Open Data Mapping Editor,然後在 Input Value 欄位中輸入類似下列的值,並選擇 EntityId/ConnectorInputPayload 做為本機變數。
    {
      "ParentObjectID": "0B7E0B7275361EEFB59B682026F83C0B",
      "TypeCode": "10001",
      "Name": "AttachMs.csv",
      "MimeType": "text/csv",
      "Binary": "c2FtcGxlIHRleHQgaW5zZXJ0"
    }
    

    如果整合成功,連接器工作 connectorOutputPayload 回應參數的值會類似於下列內容:

    { "ObjectID": "C1A464ABFE7D1EEFAE8A044BF41C112F" }
    
  5. 變更檔案的 MIME 類型和二進位檔,即可新增 .png、.jpeg、.csv、.jpg、.pdf、.docx、.xlsx、.ppt 和 .gif 等檔案。

範例 - 更新待開發客戶集合中的待開發客戶

  1. 在「Configure connector task」對話方塊中,按一下 Entities
  2. Entity 清單中選取 LeadCollection。
  3. 選取「Update」作業,然後按一下「完成」
  4. 在「資料對應」工作的「資料對應器」部分中,按一下 Open Data Mapping Editor,然後在 Input Value 欄位中輸入類似下列的值,並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。
    { "Name": "Charlie Cruz" }
    
  5. 在資料對應工具中,將實體 ID 設為 LeadCollection 的實體。如要設定實體 ID,請按一下 Open Data Mapping Editor,然後在 Input Value 欄位中輸入類似下列的值,並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。

    除了指定 entityId,您也可以將 filterClause 設為 id ='C1A464ABFE7D1EEFB0A54EA52EF251B5'

    執行這個範例後,Connector 工作的 connectorOutputPayload 輸出變數會傳回類似下列內容的回應:

    { "ObjectID": "C1A464ABFE7D1EEFB0A54EA52EF251B5" }
    

範例 - 更新 opportunities 集合中的商機

  1. 在「Configure connector task」對話方塊中,按一下 Entities
  2. Entity 清單中選取 OpportunityCollection。
  3. 選取「Update」作業,然後按一下「完成」
  4. 在「資料對應」工作的「資料對應器」部分中,按一下 Open Data Mapping Editor,然後在 Input Value 欄位中輸入類似下列的值,並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。
    { "Name": "Charlie Cruz", "ProspectPartyID": "1", "MainEmployeeResponsiblePartyID": "TESTUPDATEXYZ" }
    
  5. 在資料對應工具中,將實體 ID 設為 OpportunityCollection 的實體。如要設定實體 ID,請按一下 Open Data Mapping Editor,然後在 Input Value 欄位中輸入類似下列的值,並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。

    除了指定 entityId,您也可以將 filterClause 設為 id ='C1A464ABFE7D1EEFB0A6F0AD1ACA91B5'

    執行這個範例後,Connector 工作的 connectorOutputPayload 輸出變數會傳回類似下列內容的回應:

    { "ObjectID": "C1A464ABFE7D1EEFB0A6F0AD1ACA91B5" }
    

範例 - 更新銷售報價集合中的銷售報價

  1. 在「Configure connector task」對話方塊中,按一下 Entities
  2. Entity 清單中選取 SalesQuoteCollection。
  3. 選取「Update」作業,然後按一下「完成」
  4. 在「資料對應」工作的「資料對應器」部分中,按一下 Open Data Mapping Editor,然後在 Input Value 欄位中輸入類似下列的值,並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。
    { "Name": "Charlie Cruz" }
    
  5. 在資料對應工具中,將實體 ID 設為 SalesQuoteCollection 的實體。如要設定實體 ID,請按一下 Open Data Mapping Editor,然後在 Input Value 欄位中輸入類似下列的值,並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。

    除了指定 entityId,您也可以將 filterClause 設為 id ='C1A464ABFE7D1EEFAE8A044BF41C112F'

    執行這個範例後,Connector 工作的 connectorOutputPayload 輸出變數會傳回類似下列內容的回應:

    { "ObjectID": "C1A464ABFE7D1EEFAE8A044BF41C112F" }
    

範例 - 更新合約集合中的合約

  1. 在「Configure connector task」對話方塊中,按一下 Entities
  2. Entity 清單中選取 ContractCollection。
  3. 選取「Update」作業,然後按一下「完成」
  4. 在「資料對應」工作的「資料對應器」部分中,按一下 Open Data Mapping Editor,然後在 Input Value 欄位中輸入類似下列的值,並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。
    { "Name": "Updated Contract Collection" }
    
  5. 在資料對應工具中,將實體 ID 設為 ContractCollection 的實體。如要設定實體 ID,請按一下 Open Data Mapping Editor,然後在 Input Value 欄位中輸入類似下列的值,並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。

    除了指定 entityId,您也可以將 filterClause 設為 id ='C1A464ABFE7D1EEFAE8A044BF41C112F'

    執行這個範例後,Connector 工作的 connectorOutputPayload 輸出變數會傳回類似下列內容的回應:

    { "ObjectID": "C1A464ABFE7D1EEFAFF6ED3FF1EE119E" }
    

範例 - 更新 customers 集合中的個別顧客

  1. 在「Configure connector task」對話方塊中,按一下 Entities
  2. Entity 清單中選取 IndividualCustomerCollection。
  3. 選取「Update」作業,然後按一下「完成」
  4. 在「資料對應」工作的「資料對應器」部分中,按一下 Open Data Mapping Editor,然後在 Input Value 欄位中輸入類似下列的值,並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。
    { "Email": "baklavainthebalkans@gmail.com", "Mobile": "7037251086" }
    
  5. 在資料對應工具中,將實體 ID 設為 IndividualCustomerCollection 的實體。如要設定實體 ID,請按一下 Open Data Mapping Editor,然後在 Input Value 欄位中輸入類似下列的值,並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。

    除了指定 entityId,您也可以將 filterClause 設為 id ='C1A464ABFE7D1EEFB0A0ECAD1B1691B5'

    執行這個範例後,Connector 工作的 connectorOutputPayload 輸出變數會傳回類似下列內容的回應:

    { "ObjectID": "C1A464ABFE7D1EEFB0A0ECAD1B1691B5" }
    

範例 - 更新問卷調查集合中的問卷調查

  1. 在「Configure connector task」對話方塊中,按一下 Entities
  2. Entity 清單中選取 SurveyCollection。
  3. 選取「Update」作業,然後按一下「完成」
  4. 在「資料對應」工作的「資料對應器」部分中,按一下 Open Data Mapping Editor,然後在 Input Value 欄位中輸入類似下列的值,並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。
    { "Name": "Updated survey from MS" }
    
  5. 在資料對應工具中,將實體 ID 設為 SurveyCollection 的實體。如要設定實體 ID,請按一下 Open Data Mapping Editor,然後在 Input Value 欄位中輸入類似下列的值,並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。

    除了指定 entityId,您也可以將 filterClause 設為 id ='C1A464ABFE7D1EEFB0EFB26D09DF91D4'

    執行這個範例後,Connector 工作的 connectorOutputPayload 輸出變數會傳回類似下列內容的回應:

    { "ObjectID": "C1A464ABFE7D1EEFB0EFB26D09DF91D4" }
    

範例 - 更新合作夥伴集合中的合作夥伴

  1. 在「Configure connector task」對話方塊中,按一下 Entities
  2. Entity 清單中選取 PartnerCollection。
  3. 選取「Update」作業,然後按一下「完成」
  4. 在「資料對應」工作的「資料對應器」部分中,按一下 Open Data Mapping Editor,然後在 Input Value 欄位中輸入類似下列的值,並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。
    { "City": "Paris" }
    
  5. 在資料對應工具中,將實體 ID 設為 PartnerCollection 的實體。如要設定實體 ID,請按一下 Open Data Mapping Editor,然後在 Input Value 欄位中輸入類似下列的值,並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。

    除了指定 entityId,您也可以將 filterClause 設為 id ='C1A464ABFE7D1EEFB1CCA349FF68B204'

    執行這個範例後,Connector 工作的 connectorOutputPayload 輸出變數會傳回類似下列內容的回應:

    { "ObjectID": "C1A464ABFE7D1EEFB1CCA349FF68B204" }
    

範例 - 更新服務要求集合中的服務單

  1. 在「Configure connector task」對話方塊中,按一下 Entities
  2. Entity 清單中選取 ServiceRequestCollection。
  3. 選取「Update」作業,然後按一下「完成」
  4. 在「資料對應」工作的「資料對應器」部分中,按一下 Open Data Mapping Editor,然後在 Input Value 欄位中輸入類似下列的值,並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。
    { "Name": "Charlie Cruz 3" }
    
  5. 在資料對應工具中,將實體 ID 設為 ServiceRequestCollection 的實體。如要設定實體 ID,請按一下 Open Data Mapping Editor,然後在 Input Value 欄位中輸入類似下列的值,並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。

    除了指定 entityId,您也可以將 filterClause 設為 id ='C1A464ABFE7D1EEFB0A358A79B9DD1B5'

    執行這個範例後,Connector 工作的 connectorOutputPayload 輸出變數會傳回類似下列內容的回應:

    { "ObjectID": "C1A464ABFE7D1EEFB0A358A79B9DD1B5" }
    

向 Google Cloud 社群尋求協助

如要發布問題及討論這個連接器,請前往 Cloud 論壇的 Google Cloud 社群。

後續步驟