若要作為連鎖的一部分與 Salesforce® 內的資料互動,請新增具有 Salesforce 連線指令的步驟。例如:
- 透過 SOQL 和大量作業載入、抽取和刪除資料
- 建立和管理 Salesforce 物件
- 更新和建立記錄
要啟用這些指令,IT 管理員首先建立 Salesforce 連接器 。該連接器透過 REST API 與所有版本的 Salesforce Sales Cloud-Salesforce Essentials®、Lightning® Professional、Lightning Enterprise 和 Lightning Unlimited 進行交互。
批量刪除
若要根據逗號分隔值 (CSV) 檔案刪除大量記錄,請使用Bulk delete 指令。
注意: 如果記錄刪除失敗,命令會返回 CSV,列出失敗記錄的行號,以及失敗原因。您可以在指令失敗時使用分支執行動作,或將失敗記錄載入 Google® Drive 供稍後分析。
摘要資訊
| 摘要資訊 |
詳細資訊 |
| 並發模式 |
選擇同時或依序處理記錄。
- 若要同時處理記錄,請選擇 Parallel(平行)。
- 若要依序處理記錄,請選擇串列。
註記: 對於非常大型的工作,請選擇序列,因為資料庫連線的數量可能會導致工作在平行模式下失敗。但是,Serial 模式可能會導致更長的處理時間。 |
| SObject 名稱 |
輸入要執行操作的 SObject 類型。 |
| 輸入檔 |
輸入包含要刪除記錄的檔案。 |
| 檔案格式 |
選擇輸入檔案 是否為 CSV、JSON 或 XML。 |
| 大小上限 |
輸入每批要處理的記錄數。我們建議您保留預設值。 |
| 等待完成 |
若要輪詢 Salesforce,並僅在處理完所有記錄後才移至下一個指令,請勾選此方塊。若要觸發指令並立即移至下一步,請取消勾選此方塊。 |
输出
退出代碼
| 代碼 |
類型 |
詳細資訊 |
| 0 |
成功 |
成功 |
| 1 |
錯誤 |
一般故障 |
大量插入
若要根據 CSV 檔案插入大量記錄,請使用Bulk insert 指令。
注意: 如果記錄插入失敗,命令會返回 CSV,列出失敗記錄的行號以及失敗原因。您可以在指令失敗時使用分支執行動作,或將失敗記錄載入 Google® Drive 供稍後分析。
摘要資訊
| 摘要資訊 |
詳細資訊 |
| 並發模式 |
選擇同時或依序處理記錄。
- 若要同時處理記錄,請選擇 Parallel(平行)。
- 若要依序處理記錄,請選擇串列。
註記: 對於非常大型的工作,請選擇序列,因為資料庫連線的數量可能會導致工作在平行模式下失敗。但是,Serial 模式可能會導致更長的處理時間。 |
| SObject 名稱 |
輸入要執行操作的 SObject 類型。 |
| 輸入檔 |
輸入包含要插入記錄的檔案。 |
| 檔案格式 |
選擇輸入檔案 是否為 CSV、JSON 或 XML。 |
| 大小上限 |
輸入每批要處理的記錄數。我們建議您保留預設值。 |
| 等待完成 |
若要輪詢 Salesforce,並僅在處理完所有記錄後才移至下一個指令,請勾選此方塊。若要觸發指令並立即移至下一步,請取消勾選此方塊。 |
输出
退出代碼
| 代碼 |
類型 |
詳細資訊 |
| 0 |
成功 |
成功 |
| 1 |
錯誤 |
一般故障 |
大量查詢
若要查詢大量記錄,請使用大量查詢 指令。
摘要資訊
| 摘要資訊 |
詳細資訊 |
| 並發模式 |
選擇同時或依序處理記錄。
- 若要同時處理記錄,請選擇 Parallel(平行)。
- 若要依序處理記錄,請選擇串列。
註記: 對於非常大型的工作,請選擇序列,因為資料庫連線的數量可能會導致工作在平行模式下失敗。但是,Serial 模式可能會導致更長的處理時間。 |
| SObject 名稱 |
輸入要執行操作的 SObject 類型。 |
| SOQL 查詢 |
輸入要執行的 SOQL 查詢。 |
输出
退出代碼
| 代碼 |
類型 |
詳細資訊 |
| 0 |
成功 |
成功 |
| 1 |
錯誤 |
一般故障 |
大量更新
若要更新大量記錄,請使用Bulk update 指令。
注意: 如果記錄更新失敗,指令會傳回 CSV,列出失敗記錄的行號,以及失敗原因。您可以在指令失敗時使用分支執行動作,或將失敗記錄載入 Google® Drive 供稍後分析。
摘要資訊
| 摘要資訊 |
詳細資訊 |
| 並發模式 |
選擇同時或依序處理記錄。
- 若要同時處理記錄,請選擇 Parallel(平行)。
- 若要依序處理記錄,請選擇串列。
註記: 對於非常大型的工作,請選擇序列,因為資料庫連線的數量可能會導致工作在平行模式下失敗。但是,Serial 模式可能會導致更長的處理時間。 |
| SObject 名稱 |
輸入要執行操作的 SObject 類型。 |
| 輸入檔 |
輸入包含要更新記錄的檔案。 |
| 檔案格式 |
選擇輸入檔案 是否為 CSV、JSON 或 XML。 |
| 大小上限 |
輸入每批要處理的記錄數。我們建議您保留預設值。 |
| 等待完成 |
若要輪詢 Salesforce,並僅在處理完所有記錄後才移至下一個指令,請勾選此方塊。若要觸發指令並立即移至下一步,請取消勾選此方塊。 |
输出
退出代碼
| 代碼 |
類型 |
詳細資訊 |
| 0 |
成功 |
成功 |
| 1 |
錯誤 |
一般故障 |
大量upsert
若要對大量記錄執行 upsert(更新現有記錄或根據外部 ID 創建新記錄),請使用Bulk upsert 命令。
注意: 如果記錄無法上載,指令會傳回 CSV,列出失敗記錄的行號,以及失敗原因。您可以在指令失敗時使用分支執行動作,或將失敗記錄載入 Google® Drive 供稍後分析。
摘要資訊
| 摘要資訊 |
詳細資訊 |
| 並發模式 |
選擇同時或依序處理記錄。
- 若要同時處理記錄,請選擇 Parallel(平行)。
- 若要依序處理記錄,請選擇串列。
註記: 對於非常大型的工作,請選擇序列,因為資料庫連線的數量可能會導致工作在平行模式下失敗。但是,Serial 模式可能會導致更長的處理時間。 |
| SObject 名稱 |
輸入要執行操作的 SObject 類型。 |
| 輸入檔 |
輸入包含要插入記錄的檔案。 |
| 檔案格式 |
選擇輸入檔案 是否為 CSV、JSON 或 XML。 |
| 大小上限 |
輸入每批要處理的記錄數。我們建議您保留預設值。 |
| 等待完成 |
若要輪詢 Salesforce,並僅在處理完所有記錄後才移至下一個指令,請勾選此方塊。若要觸發指令並立即移至下一個步驟,請取消勾選此方塊。 |
| 外部 ID |
要識別記錄是否已經存在或需要建立,請輸入上移涉及的物件所需的外部 ID 欄位。 |
输出
退出代碼
| 代碼 |
類型 |
詳細資訊 |
| 0 |
成功 |
成功 |
| 1 |
錯誤 |
一般故障 |
建立記錄
若要在 Salesforce 中建立新記錄,請使用Create record 指令。
摘要資訊
| 摘要資訊 |
詳細資訊 |
| 名稱 |
輸入要在 SObject 下建立記錄的名稱。 |
| 欄位 |
輸入要更新的記錄欄位,格式為FIELD_NAME:VALUE 。 |
输出
退出代碼
| 代碼 |
類型 |
詳細資訊 |
| 0 |
成功 |
成功 |
| 1 |
錯誤 |
一般故障 |
刪除記錄
若要根據 ID 刪除 Salesforce 中的記錄,請使用刪除記錄 指令。
摘要資訊
| 摘要資訊 |
詳細資訊 |
| ID |
輸入要刪除記錄的 ID。如果 ID 不詳,請輸入格式為EXTERNAL_ID_NAME:VALUE 的外部 ID,例如Name:John 。 |
| 名稱 |
輸入要刪除記錄的 SObject 的名稱。 |
输出
無
退出代碼
| 代碼 |
類型 |
詳細資訊 |
| 0 |
成功 |
成功 |
| 1 |
錯誤 |
一般故障 |
下載報告
要以逗號分隔值 (CSV) 檔下載自訂報告,請使用Download report 指令。
摘要資訊
| 摘要資訊 |
詳細資訊 |
| 報表 ID |
輸入要下載的自訂報表的 ID。 |
输出
退出代碼
| 代碼 |
類型 |
詳細資訊 |
| 0 |
成功 |
成功 |
| 1 |
錯誤 |
一般故障 |
取得物件元資料
要檢索與 Salesforce 物件相關的欄位和元資料,請使用Get object metadata 指令。
摘要資訊
| 摘要資訊 |
詳細資訊 |
| 物件 |
輸入要擷取元資料的物件名稱。 |
輸出
退出代碼
| 代碼 |
類型 |
詳細資訊 |
| 0 |
成功 |
成功 |
| 1 |
錯誤 |
一般故障 |
取得記錄
若要根據 ID 從 Salesforce 擷取記錄,請使用Get record 指令。
摘要資訊
| 摘要資訊 |
詳細資訊 |
| ID |
輸入要擷取記錄的 ID。 |
| 名稱 |
輸入要擷取記錄的 SObject 名稱。 |
| 欄位 |
輸入要包含的報告欄位(可選)。 |
输出
退出代碼
| 代碼 |
類型 |
詳細資訊 |
| 0 |
成功 |
成功 |
| 1 |
錯誤 |
一般故障 |
列出登入
若要列出 Salesforce 環境中的登入資訊,請使用List logins 指令。
摘要資訊
無
输出
退出代碼
| 代碼 |
類型 |
詳細資訊 |
| 0 |
成功 |
成功 |
| 1 |
錯誤 |
一般故障 |
列出物件
若要從 Salesforce 列出 SObjects,請使用List objects 指令。
摘要資訊
無
输出
退出代碼
| 代碼 |
類型 |
詳細資訊 |
| 0 |
成功 |
成功 |
| 1 |
錯誤 |
一般故障 |
列出報告
若要從 Salesforce 列出報告,請使用List reports 指令。
摘要資訊
無
输出
退出代碼
| 代碼 |
類型 |
詳細資訊 |
| 0 |
成功 |
成功 |
| 1 |
錯誤 |
一般故障 |
SOQL 查詢
若要執行 SOQL 查詢並將其結果產生為 CSV 檔案,請使用SOQL 查詢 指令。
注意: SOQL 語法 與 SQL 非常相似。SOQL Query 指令可以抽取大量資料,並一次傳回 100 萬筆或更多記錄的資料集。如果命令因查詢不正確或引用不存在的物件而失敗,命令的輸出將會通知您。
摘要資訊
| 摘要資訊 |
詳細資訊 |
| 查詢 |
輸入要執行的 SOQL 查詢。 |
| 查詢指令 |
選擇是否包含已刪除的記錄。
- 若要排除 已刪除的記錄,請選擇查詢。
- 若要包括 已刪除的記錄,請選擇 QueryAll。
|
输出
退出代碼
| 代碼 |
類型 |
詳細資訊 |
| 0 |
成功 |
成功 |
| 1 |
錯誤 |
一般故障 |
SObject - 建立
若要在 Salesforce 中建立新的 SObject,請使用SOjbect- create 指令。
摘要資訊
| 摘要資訊 |
詳細資訊 |
| 名稱 |
輸入新 SObject 的名稱。為了表示這是自訂物件,Salesforce 會自動附加__c 。 |
| 欄位 |
輸入要建立的記錄欄位,格式為FIELD_NAME:TYPE ,其中TYPE 對應於 Salesforce 欄位類型。 |
输出
無
退出代碼
| 代碼 |
類型 |
詳細資訊 |
| 0 |
成功 |
成功 |
| 1 |
錯誤 |
一般故障 |
SObject - 刪除
若要刪除 Salesforce 中的 SObject,請使用SObject - delete 指令。
摘要資訊
| 摘要資訊 |
詳細資訊 |
| 名稱 |
輸入要建立的 SObjects 的名稱。 |
输出
無
退出代碼
| 代碼 |
類型 |
詳細資訊 |
| 0 |
成功 |
成功 |
| 1 |
錯誤 |
一般故障 |
更新記錄
若要更新 Salesforce 中記錄的欄位值,請使用更新記錄 指令。
摘要資訊
| 摘要資訊 |
詳細資訊 |
| ID |
輸入要更新記錄的 ID。 |
| 名稱 |
輸入要更新記錄的 SObject 名稱。 |
| 欄位 |
輸入要更新的記錄欄位,格式為FIELD_NAME:VALUE 。 |
输出
無
退出代碼
| 代碼 |
類型 |
詳細資訊 |
| 0 |
成功 |
成功 |
| 1 |
錯誤 |
一般故障 |
<!--## Recipes
### Extract Data from Salesforce to Anaplan
To extract data from Salesforce as a CSV file and upload it directly to Anaplan®:
1. Create the chain:
1. In **Chains**, click **Add**.
2. Enter a unique name to identify the chain.
3. Click **Save**.
2. To execute a SOQL query to extract data from Salesforce as the first step of the chain:
3. Click **Add a command**.
4. Select **Salesforce**, **SOQL Query**.
4. Select the Salesforce connector.
5. Enter the query and its parameters.
6. Click **Save**.
3. To load the CSV output into Anaplan as the second step:
1. Click **Add a command**, and in **Run Condition**, select Success.
2. Select **Anaplan**, **Upload file**.
3. Select the Anaplan connector.
4. Enter the properties of the command. For **Source File**, select **SOQL Query Output**.
5. Click **Save**.
4. Click **Publish**.
-->