Oracle Sales Cloud

連線設定範例

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

實體作業範例

本節提供範例，說明如何在這個連接器中執行實體作業。

範例 - 列出所有商機

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Opportunities。
3. 選取「List」作業，然後按一下「完成」。

如要擷取單一記錄，且實體需要多個鍵，您必須使用 List 作業和篩選子句。

範例 - 取得聯絡人

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Contacts。
3. 選取「Get」作業，然後按一下「完成」。
4. 將實體 ID 設為「聯絡人」。如要設定實體 ID，請在「資料對應」的「資料對應器」部分，按一下「開啟資料對應編輯器」，然後在「輸入值」欄位中輸入 3046，並選擇 EntityId 做為本機變數。

如果擷取單一記錄需要多個鍵，您必須在實體中使用 Get 作業和篩選子句。

範例 - 刪除商機

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Opportunities。
3. 選取「Delete」作業，然後按一下「完成」。
4. 將實體 ID 設為「Delete Opportunities」(刪除商機)。如要設定實體 ID，請在「資料對應」的「資料對應器」部分，按一下「開啟資料對應編輯器」，然後在「輸入值」欄位中輸入 203002，並選擇 EntityId 做為本機變數。

   如果擷取單一記錄需要多個鍵，您必須在實體中使用 Delete 作業和篩選條件子句。

範例 - 建立聯絡人

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Contacts。
3. 選取「Create」作業，然後按一下「完成」。
4. 在「Task」(工作) 的「Data mapper」(資料對應器) 部分，按一下 OpenDataMapping 編輯器，然後在 field: 中輸入類似下列的值：

    { "FirstName": "Googlecloud2", "LastName": "TestCreate3" }

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

   { "PartyNumber": "807006" }
   

範例 - 建立聯絡人地址

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 ContactAddresses。
3. 選取「Create」作業，然後按一下「完成」。
4. 在「Task」(工作) 的「Data mapper」(資料對應器) 部分，按一下 OpenDataMapping 編輯器，然後在 field: 中輸入類似下列的值：

   { "City": "CreatingAddGooglecloud", "State": "France", "Country": "FR", "Address1": "Googlecloud Contact Address 1", "PartyNumber": "3046" }

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

   { "AddressNumber": "411001", "PartyNumber": "3046" }
   

範例 - 建立帳戶

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取「帳戶」。
3. 選取「Create」作業，然後按一下「完成」。
4. 在「Task」(工作) 的「Data mapper」(資料對應器) 部分，按一下 OpenDataMapping 編輯器，然後在 field: 中輸入類似下列的值：

   { "OrganizationName": "Test Account7Googlecloud", "AddressLine1": "E-City", "City": "Paris", "Country": "FR" }

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

   { "PartyNumber": "804006" }
   

範例 - 建立商機

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取「商機」。
3. 選取「Create」作業，然後按一下「完成」。
4. 在「Task」(工作) 的「Data mapper」(資料對應器) 部分，按一下 OpenDataMapping 編輯器，然後在 field: 中輸入類似下列的值：

   { "Name": "OpportunityGooglecloud1" } 

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

   { "OptyNumber": "203001" }
   

範例 - 建立活動指派對象

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 ActivityAssignee。
3. 選取「Create」作業，然後按一下「完成」。
4. 在「Task」(工作) 的「Data mapper」(資料對應器) 部分，按一下 OpenDataMapping 編輯器，然後在 field: 中輸入類似下列的值：

   { "ActivityId": 300000010836710, "AssigneeId": 300000001962681, "ActivityNumber": "212380" }

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

   { "ActivityAssigneeId": 300000014424799 }
   

範例 - 建立活動聯絡人

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 ActivityContact。
3. 選取「Create」作業，然後按一下「完成」。
4. 在「Task」(工作) 的「Data mapper」(資料對應器) 部分，按一下 OpenDataMapping 編輯器，然後在 field: 中輸入類似下列的值：

   { "ActivityNumber": "212544", "ContactId": 100000001886382 }

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

   { "ActivityContactId": 300000014968493 }
   

範例 - 更新商機

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Opportunities。
3. 選取「Update」作業，然後按一下「完成」。
4. 將 EntityID 設為「Opportunities」。如要設定 EntityID，請在「Tasks」(工作) 的「Data mapper」(資料對應工具) 區段中，按一下「EntityID」，然後在指定欄位中輸入 5。
5. 在「Task」(工作) 的「Data mapper」(資料對應器) 部分，按一下 OpenDataMapping 編輯器，然後在 field: 中輸入類似下列的值：

    { "Name": "Updated Googlecloud Opportunity again" }
   

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

{ "OptyNumber": "150364" }

範例 - 更新帳戶

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Accounts。
3. 選取「Update」作業，然後按一下「完成」。
4. 將 EntityID 設為「帳戶」。如要設定 EntityID，請在「Tasks」(工作) 的「Data mapper」(資料對應工具) 區段中，按一下「EntityID」，然後在指定欄位中輸入 804006。
5. 在「Task」(工作) 的「Data mapper」(資料對應器) 部分，按一下 OpenDataMapping 編輯器，然後在 field: 中輸入類似下列的值：

    { "OrganizationName": "updated Test Account7Googlecloud" }
   

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

{ "PartyNumber": "804006" }

範例 - 更新活動

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Activities。
3. 選取「Update」作業，然後按一下「完成」。
4. 將 EntityID 設為「Activities」。如要設定 EntityID，請在「Tasks」(工作) 的「Data mapper」(資料對應工具) 區段中，按一下「EntityID」，然後在指定欄位中輸入 201001。
5. 在「Task」(工作) 的「Data mapper」(資料對應器) 部分，按一下 OpenDataMapping 編輯器，然後在 field: 中輸入類似下列的值：

   { "ActivityFunctionCode": "APPOINTMENT", "ActivityStartDate": "2025-05-27 07:10:23", "ActivityEndDate": "2025-05-27 08:10:23" }
   

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

{ "ActivityNumber": "201001" }

範例 - 更新聯絡人

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Contacts。
3. 選取「Update」作業，然後按一下「完成」。
4. 將 EntityID 設為 Contacts。如要設定 EntityID，請在「Tasks」(工作) 的「Data mapper」(資料對應工具) 區段中，按一下「EntityID」，然後在指定欄位中輸入 59。
5. 在「Task」(工作) 的「Data mapper」(資料對應器) 部分，按一下 OpenDataMapping 編輯器，然後在 field: 中輸入類似下列的值：

     { "FirstName": "GooglecloudUpdated2", "LastName": "Testlatency3" }
   

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

 { "PartyNumber": "807004" }