Salesforce模組

在Adobe Workfront Fusion案例中,您可以自動化使用Salesforce的工作流程,並將其連線至多個協力廠商應用程式和服務。

如需Salesforce聯結器的簡介影片,請參閱:

如果您需要有關建立案例的指示,請參閱在 Adobe Workfront Fusion中建立案例。

如需模組的相關資訊,請參閱 Adobe Workfront Fusion🔗中的模組。

NOTE
  • 並非所有Salesforce版本都有API存取權。 如需詳細資訊,請參閱Salesforce社群網站上具有API存取許可權的Salesforce版本相關資訊。
  • 有關從Salesforce API傳回的特定錯誤的資訊,請參閱Salesforce API檔案。 您也可以檢查Salesforce API的狀態,瞭解是否有任何可能的服務中斷。

存取需求

您必須具有下列存取權才能使用本文中的功能:

Adobe Workfront 計畫*
Pro或更高版本
Adobe Workfront 授權*
計畫,工作
Adobe Workfront Fusion 授權**

目前授權需求:無Workfront Fusion授權需求。

舊版授權需求:Workfront Fusion for Work Automation and Integration

產品

目前產品需求:如果您有Select或Prime Adobe Workfront計畫,您的組織必須購買Adobe Workfront Fusion及Adobe Workfront,才能使用本文所述的功能。 Workfront Fusion包含在Ultimate Workfront計畫中。

舊版產品需求:您的組織必須購買Adobe Workfront Fusion及Adobe Workfront,才能使用本文所述的功能。

若要瞭解您擁有的計畫、授權型別或存取權,請連絡您的Workfront管理員。

如需Adobe Workfront Fusion授權的相關資訊,請參閱Adobe Workfront Fusion 授權

先決條件

若要使用Salesforce模組,您必須有Salesforce帳戶。

關於搜尋Salesforce物件

搜尋物件時,您可以輸入個別搜尋字詞,或使用萬用字元和運運算元建立更複雜的查詢:

  • 使用星號萬用字元(*)取代零或更多字元。 例如,搜尋Ca*會尋找以Ca開頭的專案
  • 使用問號萬用字元(?) 取代單一字元。 例如,搜尋Jo?n會尋找含有John或Joan字詞,但不包含Jon字詞的專案
  • 使用引號運運算元(「 」)尋找完全相符的片語。 例如:「星期一會議」

如需有關搜尋可能性的詳細資訊,請參閱Salesforce有關SOQL和SOSL的開發人員檔案。

Salesforce模組及其欄位

觸發器

觀看記錄

此觸發器模組會在物件中的記錄建立或更新時執行案例。 模組會傳回與一個或多個記錄相關聯的所有標準欄位,以及連線存取的任何自訂欄位和值。 您可以在情境中的後續模組中對應此資訊。

當您設定此模組時,會顯示下列欄位。

Connection
如需有關將您的Salesforce帳戶連線到Workfront Fusion的指示,請參閱建立與Adobe Workfront Fusion的連線 — 基本指示
型別
選取您希望模組觀看的Salesforce記錄型別。
記錄欄位
選取您希望模組觀看的欄位。 可用欄位取決於記錄型別。
最大記錄數
輸入或對應您希望模組在每個案例執行週期中傳回的最大記錄數。
手錶
決定您要案例只監視所選型別的新記錄,還是隻監視所選型別的新記錄以及該型別記錄的所有其他變更。

觀看傳出訊息

有人傳送訊息時,此觸發模組會執行案例。 模組會傳回與一個或多個記錄相關聯的所有標準欄位,以及連線存取的任何自訂欄位和值。 您可以在情境中的後續模組中對應此資訊。

此模組需要一些額外的設定:

  1. 前往Salesforce設定頁面。

    若要存取設定頁面,請尋找並按一下Salesforce帳戶右上角標示為「設定」的按鈕。 從Salesforce設定頁面,找到左側的快速尋找/搜尋列。 搜尋「工作流程規則」。

  2. 按一下​ 工作流程規則

  3. 在顯示的工作流程規則頁面上,按一下​ 新增規則,然後選取規則將套用到的物件型別(例如,Opportunity (如果您正在監視機會記錄的更新)。

  4. 按一下​ 下一步

  5. 設定規則名稱、評估條件和規則條件,然後按一下[儲存] 和[下一步]

  6. 按一下​ 完成

  7. 從新建立的工作流程規則中,按一下​ 編輯

  8. 從​ 新增工作流程動作 ​下拉式清單中,選取​ 新增傳出訊息

  9. 指定名稱、說明、端點URL以及要納入新傳出訊息的欄位,然後按一下[儲存]。

    端點URL ​欄位包含在Workfront Fusion中的Salesforce 傳出訊息上提供的URL。

  10. 設定以傳出訊息事件開頭的情境。

  11. 按一下右下角的​ </> ​圖示,並複製提供的URL。

  12. 返回​ 工作流程規則 ​頁面,找到新建立的規則,然後按一下​ 啟動

當您設定此模組時,會顯示下列欄位。

Webhook

選取您要用來觀看外寄郵件的webhook。 若要新增webhook,請按一下 新增 並輸入webhook的名稱和連線。

如需有關將您的Salesforce帳戶連線到Workfront Fusion的說明,請參閱建立與Adobe Workfront Fusion的連線 — 基本說明

記錄型別
選取您希望模組監視傳出訊息的Salesforce記錄型別。
欄位
選取您希望模組監視傳出訊息的欄位。 可用欄位取決於記錄型別。

觀看欄位

此觸發模組會在Salesforce中更新欄位時啟動案例。

Connection
如需有關將您的Salesforce帳戶連線到Workfront Fusion的指示,請參閱建立與Adobe Workfront Fusion的連線 — 基本指示
記錄型別
選取記錄型別,其中包含您要模組觀看的欄位。 您必須選擇在Salesforce設定中開啟欄位歷程記錄的記錄型別。 如需詳細資訊,請參閱Salesforce檔案中的欄位歷程記錄追蹤
欄位
選取您希望模組監視變更的欄位。
限制
輸入或對應您希望模組在每個案例執行週期中傳回的最大欄位數。

動作

建立記錄

此動作模組會在物件中建立新記錄。

模組可讓您選取可在模組中取得哪些物件欄位。 這可減少設定模組時必須捲動瀏覽的欄位數。

模組會傳回記錄ID及任何關聯欄位,連同連線存取的任何自訂欄位和值。 您可以在情境中的後續模組中對應此資訊。

當您設定此模組時,會顯示下列欄位。

Connection
如需有關將您的Salesforce帳戶連線到Workfront Fusion的指示,請參閱建立與Adobe Workfront Fusion的連線 — 基本指示
記錄型別
選取您要模組建立的Salesforce記錄型別。 根據記錄型別欄位中所選的記錄型別,欄位將變為可用。 這些欄位是以Salesforce API為基礎。
選擇要對應的欄位

選取建立新記錄時您希望模組設定的欄位。 必填欄位位於清單頂端。

您選取的欄位會在此欄位下方開啟。 您現在可以在這些欄位中輸入值。

讀取記錄

此動作模組會從Salesforce中的單一物件讀取資料。

您指定記錄的ID。

模組會傳回記錄ID及任何關聯欄位,連同連線存取的任何自訂欄位和值。 您可以在情境中的後續模組中對應此資訊。

當您設定此模組時,會顯示下列欄位。

Connection
如需有關將您的Salesforce帳戶連線到Workfront Fusion的指示,請參閱建立與Adobe Workfront Fusion的連線 — 基本指示
記錄型別
選取您希望模組[action].read的Salesforce記錄型別。
記錄欄位
選取您希望模組讀取的欄位。 您必須至少選取一個欄位。
ID

輸入或對應您要模組讀取之記錄的唯一Salesforce識別碼。

若要取得ID,請在瀏覽器中開啟Salesforce物件,並複製URL結尾處最後一個正斜線(/)之後的文字。 例如: https://eu5.salesforce.com/<object ID>

刪除記錄

此動作模組會刪除物件中的現有記錄。

您指定記錄的ID。

模組會傳回記錄ID及任何關聯欄位,連同連線存取的任何自訂欄位和值。 您可以在情境中的後續模組中對應此資訊。

當您設定此模組時,會顯示下列欄位。

Connection
如需有關將您的Salesforce帳戶連線到Workfront Fusion的指示,請參閱建立與Adobe Workfront Fusion的連線 — 基本指示
記錄型別
選取您要模組刪除的Salesforce記錄型別。
ID

輸入或對應您要模組刪除之記錄的唯一Salesforce識別碼。

若要取得ID,請在瀏覽器中開啟Salesforce物件,並複製URL結尾處最後一個正斜線(/)之後的文字。 例如: https://eu5.salesforce.com/<object ID>

自訂API呼叫

此動作模組可讓您對Salesforce API進行自訂的已驗證呼叫。 如此一來,您就可以建立其他Salesforce模組無法完成的資料流程自動化。

模組傳回以下內容:

  • 狀態碼 (數字):這表示您的HTTP要求成功或失敗。 這些是您可在網際網路上查閱的標準程式碼。

  • Headers (物件):與輸出本文無關之回應/狀態代碼的更詳細內容。 並非顯示在回應標題中的所有標題都是回應標題,因此某些標題可能對您並不實用。

    回應標題取決於您在設定模組時選擇的HTTP請求。

  • 內文 (物件):根據您在設定模組時所選擇的HTTP要求,您可能會收到一些傳回的資料。 該資料(例如GET請求的資料)包含在此物件中。

當您設定此模組時,會顯示下列欄位。

選取設定API呼叫所需的HTTP要求方法。 如需詳細資訊,請參閱Adobe Workfront Fusion中的HTTP要求方法。

Connection
如需有關將您的Salesforce帳戶連線到Workfront Fusion的指示,請參閱建立與Adobe Workfront Fusion的連線 — 基本指示
URL

輸入相對於 <Instance URL>/services/data/v46.0/的路徑。

如需可用端點的清單,請參閱Salesforce REST API開發人員指南

方法
Headers
以標準JSON物件的形式新增要求的標頭。例如,{"Content-type":"application/json"}。 Workfront Fusion會為您新增授權標頭。
查詢字串
以標準JSON物件的形式新增API呼叫的查詢。例如: {"name":"something-urgent"}
Body

以標準JSON物件的形式新增API呼叫的內文內容。

注意:

在JSON中使用條件陳述式(例如if)時,請將引號放在條件陳述式之外。

INFO

範例: ​下列API呼叫傳回您Salesforce帳戶中的所有使用者清單:

- URLquery- 方法: GET- 查詢字串:- 索引鍵q- SELECT Id, Name, CreatedDate, LastModifiedDate FROM User LIMIT 10

在​ 組合 > 內文 > 記錄 ​下的模組輸出中,可找到搜尋的相符專案。

在我們的範例中,傳回6個使用者:

上傳附件/檔案

此動作模組會上傳檔案並將其附加至您指定的記錄,或上傳檔案。

模組會傳回附件或檔案的ID以及任何關聯欄位,連同連線存取的任何自訂欄位和值。 您可以在情境中的後續模組中對應此資訊。

當您設定此模組時,會顯示下列欄位。

如需有關將您的Salesforce帳戶連線到Workfront Fusion的指示,請參閱建立與Adobe Workfront Fusion的連線 — 基本指示

上傳型別
選取您要模組上傳附件還是檔案。
ID
輸入或對應您要上傳附件的物件ID。
資料夾
選取包含您要模組上傳之檔案的資料夾。
Source檔案
從先前的模組中選取來源檔案,或對應來源檔案的名稱和資料。

下載附件/檔案

此動作模組會從記錄下載檔案或附件。

您可以指定記錄的ID以及您想要的下載型別。

模組會傳回附件或檔案的ID以及任何關聯欄位,連同連線存取的任何自訂欄位和值。 您可以在情境中的後續模組中對應此資訊。

當您設定此模組時,會顯示下列欄位。

Connection
如需有關將您的Salesforce帳戶連線到Workfront Fusion的指示,請參閱建立與Adobe Workfront Fusion的連線 — 基本指示
下載型別

指定您要從Salesforce下載的檔案型別。

  • 附件
  • 檔案
  • ContentDocument (這是已在Saleforce CRM Content或Salesforce Files中上傳至檔案庫的檔案)。

ID /

附件ID /

ContentDocument ID

輸入或對應您要模組下載之記錄的唯一Salesforce識別碼。

若要取得ID,請在瀏覽器中開啟Salesforce物件,並複製URL結尾處最後一個正斜線(/)之後的文字。 例如: https://eu5.salesforce.com/<object ID>

更新記錄

此動作模組會編輯物件中的記錄。

模組可讓您選取可在模組中取得哪些物件欄位。 這可減少設定模組時必須捲動瀏覽的欄位數。

模組會傳回記錄ID及任何關聯欄位,連同連線存取的任何自訂欄位和值。 您可以在情境中的後續模組中對應此資訊。

當您設定此模組時,會顯示下列欄位。

Connection
如需有關將您的Salesforce帳戶連線到Workfront Fusion的指示,請參閱建立與Adobe Workfront Fusion的連線 — 基本指示
ID
輸入或對應您要更新的記錄ID。
記錄型別
選取您希望模組更新的Salesforce記錄型別。 根據在「記錄型別」欄位中選取的記錄型別,欄位將變為可用。 這些欄位是以Salesforce API為基礎。
選擇要對應的欄位

選取建立新記錄時您希望模組設定的欄位。 必填欄位位於清單頂端。

您選取的欄位會在此欄位下方開啟。 您現在可以在這些欄位中輸入值。

搜尋

使用查詢搜尋

此搜尋模組會在Salesforce中尋找符合您指定之搜尋查詢的物件記錄。 您可以在情境中的後續模組中對應此資訊。

當您設定此模組時,會顯示下列欄位。

Connection
如需有關將您的Salesforce帳戶連線到Workfront Fusion的指示,請參閱建立與Adobe Workfront Fusion的連線 — 基本指示
搜尋型別

選取您要模組執行的搜尋型別:

  • Simple

  • 使用SOSL (Salesforce物件搜尋語言)的

  • 使用SOQL (Salesforce物件查詢語言)的

型別
如果您選取簡單搜尋型別,請選擇您要模組搜尋的Salesforce記錄型別。
Query / SOSL Query / SOQL Query

輸入搜尋依據的查詢。

如需有關SOSL的詳細資訊,請參閱Salesforce檔案中的Salesforce物件搜尋語言(SOSL)

如需有關SOQL的詳細資訊,請參閱Salesforce檔案中的Salesforce物件查詢語言(SOQL)

注意:請注意,引數RETURNING 的值會影響模組的輸出。 如果您使用LIMIT,Fusion將會忽略最大記錄計數欄位中的設定。 如果您未設定任何限制,Fusion將會插入值LIMIT =最大記錄計數。

最大記錄數
輸入或對應您希望模組在每個案例執行週期中傳回的最大記錄數。

搜尋

此動作模組會擷取符合指定條件的所有記錄。

Connection
如需有關將您的Salesforce帳戶連線到Workfront Fusion的指示,請參閱建立與​ Adobe Workfront Fusion的連線 — 基本指示
型別
選取您要搜尋的物件型別。
搜尋條件
選取您要搜尋的欄位、要在查詢中使用的運運算元,以及要在欄位中搜尋的值。 您可以使用AND或OR來連線查詢。
輸出
選取您要納入模組輸出的欄位。
結果集
選取您希望模組傳回「所有比對記錄」,還是隻傳回「第一個比對記錄」。
Maximal
輸入或對應您希望模組在每個案例執行週期中擷取的記錄數上限。
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43