Salesforce

連線設定範例

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

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

實體、作業和動作

所有整合連接器都會為所連應用程式的物件提供抽象層。您只能透過這個抽象化程序存取應用程式的物件。抽象化會以實體、作業和動作的形式呈現。

• 實體： 實體可以視為已連結應用程式或服務中的物件，或是屬性集合。實體的定義因連接器而異。舉例來說，在資料庫連接器中，資料表是實體；在檔案伺服器連接器中，資料夾是實體；在訊息系統連接器中，佇列是實體。

  不過，連接器可能不支援或沒有任何實體，在這種情況下，Entities 清單會是空白。

• 作業： 作業是指您可以在實體上執行的活動。您可以對實體執行下列任一操作：
  • 列出
  • 取得
  • 建立
  • 更新
  • 刪除

  從可用清單中選取實體，系統會產生該實體可用的作業清單。如需作業的詳細說明，請參閱 Connectors 工作的實體作業。 不過，如果連接器不支援任何實體作業，系統就不會在 Operations 清單中列出這些不支援的作業。

• 動作： 動作是透過連接器介面提供給整合的第一類函式。動作可讓您變更一或多個實體，且因連接器而異。一般來說，動作會有一些輸入參數和輸出參數。不過，連接器可能不支援任何動作，此時 Actions 清單會是空白。

動作

這個連接器可讓您對 Salesforce 資料執行插入、刪除、更新和讀取作業。如要執行自訂 SQL 查詢，連接器提供「執行自訂查詢」動作。

如要建立自訂查詢，請按照下列步驟操作：

1. 請按照詳細說明 新增連接器工作。
2. 設定連接器工作時，請在要執行的動作類型中選取「動作」。
3. 在「動作」清單中，選取「執行自訂查詢」，然後按一下「完成」。

   

4. 展開「Task input」(工作輸入) 區段，然後執行下列操作：
   1. 在「Timeout after」(逾時時間) 欄位中，輸入查詢執行前的等待秒數。

      預設值：180 秒。

   2. 在「資料列數量上限」欄位中，輸入要從資料庫傳回的資料列數量上限。

      預設值為 25。

   3. 如要更新自訂查詢，請按一下「編輯自訂指令碼」。「指令碼編輯器」對話方塊隨即開啟。

      

   4. 在「指令碼編輯器」對話方塊中輸入 SQL 查詢，然後按一下「儲存」。

      您可以在 SQL 陳述式中使用問號 (?) 代表單一參數，該參數必須在查詢參數清單中指定。舉例來說，下列 SQL 查詢會從 Employees 資料表選取與 LastName 資料欄指定值相符的所有資料列：

      SELECT * FROM Employees where LastName=?

   5. 如果您在 SQL 查詢中使用問號，請為每個問號點按「+ 新增參數名稱」，加入參數。執行整合時，這些參數會依序取代 SQL 查詢中的問號 (?)。舉例來說，如果您新增了三個問號 (?)，就必須依序新增三個參數。

      

      如要新增查詢參數，請按照下列步驟操作：

      1. 在「類型」清單中，選取參數的資料類型。
      2. 在「值」欄位中輸入參數值。
      3. 如要新增多個參數，請按一下「+ 新增查詢參數」。

Salesforce 連接器不支援 OFFSET 子句的參數化值，且無法使用查詢參數動態取代。不過，WHERE 子句支援查詢參數。

本節列出 Salesforce 連接器支援的動作。如要瞭解如何設定動作，請參閱「動作範例」。

CreateJobv2 動作

使用這項動作建立工作。

CreateJobV2 動作的輸入參數

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

UploadJobDataV2 動作

使用這項動作，將 CSV 格式的作業檔案上傳至 Salesforce。

UploadJobDataV2 動作的輸入參數

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

CreateBatch 動作

這項動作會建立 Salesforce 批次。

CreateBatch 動作的輸入參數

CreateBatch 動作的輸出參數

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

CreateJob 動作

這項動作會新增 Salesforce 物件項目。

CreateJob 動作的輸入參數

CreateJob 動作的輸出參數

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

GetBatch 動作

這項動作會取得 Salesforce 批次相關資訊。

GetBatch 動作的輸入參數

GetBatch 動作的輸出參數

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

GetJob 動作

這項動作會取得 Salesforce 工作的相關資訊。

GetJob 動作的輸入參數

GetJob 動作的輸出參數

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

UploadAttachment 動作

這項動作會上傳附件，並將其與 Salesforce 中的實體建立關聯。

UploadAttachment 動作的輸入參數

UploadAttachment 動作的輸出參數

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

GetBatchResults 動作

這項動作會取得 Salesforce 批次作業的結果。

GetBatchResults 動作的輸入參數

GetBatchResults 動作的輸出參數

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

動作範例

範例 - CreateJobV2

這個範例會建立 Job。

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

    {
     "ObjectName": "Contact",
     "Action": "insert"
    }

如果動作成功，CREATEJOBV2 工作項目的 connectorOutputPayload 回應參數會包含類似下列內容的值：

 
  [{
  "ID": "750dM000005HjdnQAC",
  "State": "Open",
  "JobType": null,
  "ContentUrl": "services/data/v43.0/jobs/ingest/750dM000005HjdnQAC/batches",
  "ContentType": "CSV",
  "CreatedDate": "2024-08-07T09:16:16.000+0000",
  "CreatedById": "005dM0000061WSFQA2",
  "ConcurrencyMode": "Parallel",
  "SystemModStamp": "2024-08-07T09:16:16.000+0000"
  }] 

範例 - UploadJobDataV2

這個範例會將工作檔案上傳至 Salesforce。

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

    {
     "Content":   "FirstName,LastName,Email,MobilePhone,External_Id__c\\nGinelle,Merioth,gmerioth0@example.com,851-555-8435,4d13cac0-2c11-48e9-891d-49ee9508a6c7\\nDalli,Tumilson,dtumilson1@example.com,881-555-6742,38bcb24b-247f-498b-9502-c98995a1e04b\\nRobbin,Purveys,rpurveys2@example.com,732-555-6909,35d96c7a-3856-4809-8c49-35ddb9fa7dd9\\nLothaire,Ivanchenkov,livanchenkov3@example.com,144-555-1959,75f63f26-6f4a-406f-a9f4-807f4a8a7b51",
     "ContentUrl": "services/data/v43.0/jobs/ingest/750dM000005HjdnQAC/batches"
    }

如果動作成功，UploadJobDataV2 工作項目的 connectorOutputPayload 回應參數會包含類似下列內容的值：

 
  [{
  "Uploaded": "true"
  }]

範例 - CreateBatch

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 CreateBatch 動作，然後按一下「完成」。
3. 在「資料對應」區段中 Open Data Mapping Editor，然後在「Input」欄位中輸入類似下列的值：

   {
   "JobId": "750dL000007EipxQAC",
   "Aggregate": "\n    Walter\n    White\n  \n  \n    Rob\n    Brown\n  \n",
   "ContentType": "XML"
   }

如果動作成功，CreateBatch 工作項目的 connectorOutputPayload 回應參數會包含類似下列內容的值：

 
[{
  "ID": "751dL000003ziC5QAI",
  "JobID": "750dL000007EipxQAC",
  "ApexProcessingTime": "0",
  "ApiActiveProcessingTime": "0",
  "CreatedDate": "2024-09-03T04:48:53.000Z",
  "NumberRecordsFailed": "0",
  "NumberRecordsProcessed": "0",
  "State": "Queued",
  "StateMessage": null,
  "SystemModstamp": "2024-09-03T04:48:53.000Z",
  "TotalProcessingTime": "0"
}]

範例 - CreateJob

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 CreateJob 動作，然後按一下「完成」。
3. 在「資料對應」區段中 Open Data Mapping Editor，然後在「Input」欄位中輸入類似下列的值：

   {
     "ObjectName": "Campaign",
     "Action": "insert"
   }

如果動作成功，CreateJob 工作項目的 connectorOutputPayload 回應參數會包含類似下列內容的值：

 
 [{
  "ID": "750dL000007GgD7QAK",
  "JobID": "750dL000007GgD7QAK",
  "ObjectName": "Campaign",
  "Operation": "insert",
  "ApiVersion": "56.0",
  "ApexProcessingTime": "0",
  "ApiActiveProcessingTime": "0",
  "AssignmentRuleId": null,
  "ConcurrencyMode": "Parallel",
  "ContentType": "XML",
  "CreatedById": "005dL000007CalFQAS",
  "CreatedDate": "2024-09-03T05:31:41.000Z",
  "ExternalIdFieldName": null,
  "NumberBatchesCompleted": "0",
  "NumberBatchesQueued": "0",
  "NumberBatchesFailed": "0",
  "NumberBatchesInProgress": "0",
  "NumberBatchesTotal": "0",
  "NumberRecordsFailed": "0",
  "NumberRecordsProcessed": "0",
  "NumberRetries": "0",
  "State": "Open",
  "SystemModStamp": "2024-09-03T05:31:41.000Z",
  "TotalProcessingTime": "0"
}]

範例 - GetBatch

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 GetBatch 動作，然後按一下「完成」。
3. 在「資料對應」區段中 Open Data Mapping Editor，然後在「Input」欄位中輸入類似下列的值：

   {
     "BatchId": "751dL000003yKlJQAU",
     "JobId": "750dL000007EipxQAC"
   }

如果動作成功，GetBatch 工作項目的 connectorOutputPayload 回應參數會包含類似下列內容的值：

 
[{
  "ID": "751dL000003yKlJQAU",
  "JobID": "750dL000007EipxQAC",
  "ApexProcessingTime": "0",
  "ApiActiveProcessingTime": "0",
  "CreatedDate": "2024-09-02T11:44:15.000Z",
  "NumberRecordsFailed": "0",
  "NumberRecordsProcessed": "0",
  "State": "Failed",
  "StateMessage": "InvalidBatch : Failed to parse XML. Unexpected XML element 'sObject' found at  START_TAG seen ... @1:9 it should be 'sObjects'",
  "SystemModstamp": "2024-09-02T11:44:15.000Z",
  "TotalProcessingTime": "0"
}]

範例 - GetJob

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 GetJob 動作，然後按一下「完成」。
3. 在「資料對應」區段中 Open Data Mapping Editor，然後在「Input」欄位中輸入類似下列的值：

   {
     "JobId": "750dL000007EipxQAC"
   } 

如果動作成功，GetJob 工作項目的 connectorOutputPayload 回應參數會包含類似下列內容的值：

 
[{
  "ID": "750dL000007EipxQAC",
  "JobID": "750dL000007EipxQAC",
  "ObjectName": "Campaign",
  "Operation": "insert",
  "ApiVersion": "56.0",
  "ApexProcessingTime": "0",
  "ApiActiveProcessingTime": "0",
  "AssignmentRuleId": null,
  "ConcurrencyMode": "Parallel",
  "ContentType": "XML",
  "CreatedById": "005dL000007CalFQAS",
  "CreatedDate": "2024-09-02T11:17:42.000Z",
  "ExternalIdFieldName": null,
  "NumberBatchesCompleted": "0",
  "NumberBatchesQueued": "0",
  "NumberBatchesFailed": "2",
  "NumberBatchesInProgress": "0",
  "NumberBatchesTotal": "2",
  "NumberRecordsFailed": "0",
  "NumberRecordsProcessed": "0",
  "NumberRetries": "0",
  "State": "Open",
  "SystemModStamp": "2024-09-02T11:17:42.000Z",
  "TotalProcessingTime": "0"
}]

範例 - UploadAttachment

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 UploadAttachment 動作，然後按一下「完成」。
3. 在「資料對應」區段中 Open Data Mapping Editor，然後在「Input」欄位中輸入類似下列的值：

   {
     "ObjectId": "001dL00000SC6j7QAD",
     "FileName": "My files/salesforce/con.csv",
     "Base64Data": "Y29ubmVjdG9ycyBpcyBiYWNr"
   }

如果動作成功，UploadAttachment 工作項目的 connectorOutputPayload 回應參數會包含類似下列內容的值：

 
[{
  "Id": "00PdL000000EJUDUA4"
}]

範例 - GetBatchResults

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 GetBatchResults 動作，然後按一下「完成」。
3. 在「資料對應」區段中 Open Data Mapping Editor，然後在「Input」欄位中輸入類似下列的值：

   {
     "BatchId": "751dL000004D17FQAS",
     "JobId": "750dL000007XKUhQAO",
     "ContentType": "XML"
   }

如果動作成功，GetBatchResults 工作項目的 connectorOutputPayload 回應參數會包含類似下列內容的值：

 
[{
  "ID": null,
  "Created": "false",
  "Success": "false",
  "Errors_Fields": "LastName",
  "Errors_Message": "Account: bad field names on insert/update call: FirstName, LastName",
  "Errors_StatusCode": "INVALID_FIELD_FOR_INSERT_UPDATE"
}, {
  "ID": null,
  "Created": "false",
  "Success": "false",
  "Errors_Fields": "LastName",
  "Errors_Message": "Account: bad field names on insert/update call: FirstName, LastName",
  "Errors_StatusCode": "INVALID_FIELD_FOR_INSERT_UPDATE"
}]

實體作業範例

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

範例 - 建立附件

實體建立附件只會建立附件，其中不含內容檔案。如要新增檔案，我們需要在輸入內容中提供檔案內容，然後執行「上傳附件」動作。

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

   {
     "Name": "New Attachment",
     "Description": "New created attachment",
     "ParentId": "001dL00000SC6j7QAD",
     "Body": "Body"
   }
   

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

   {
     "Id": "00PdL000000EJKXUA4"
   }
   

範例 - 更新附件

實體更新附件只會更新附件名稱或說明。如要新增檔案，我們需要在輸入內容中提供檔案內容，然後執行「上傳附件」動作。

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

   {
     "Name": "New Attachment",
     "Description": "New updated attachment",
     "Body": "Body"
   }
   

或者，您也可以將 filterClause 設為 00PdL000000EJKXUA4，而非指定 entityId。

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

   {
     "Id": "00PdL000000EJKXUA4"
   }