Salesforce模組

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

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

如需建立情境的說明,請參閱建立情境:文章索引下的文章。

如需有關模組的資訊,請參閱模組:文章索引下的文章。

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

存取需求

展開以檢視本文中功能的存取需求。

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

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Adobe Workfront套件 任何
Adobe Workfront授權

新增:標準

目前:工作或以上

Adobe Workfront Fusion授權**

目前:無Workfront Fusion授權需求。

舊版:Workfront Fusion for Work Automation and Integration

產品

新增:

  • 選取或Prime Workfront套件:您的組織必須購買Adobe Workfront Fusion。
  • Ultimate Workfront套件:包含Workfront Fusion。

目前:您的組織必須購買Adobe Workfront Fusion。

如需此表格中資訊的詳細資訊,請參閱檔案🔗中的存取需求。

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

先決條件

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

Salesforce API資訊

Salesforce聯結器會使用以下專案:

基礎URL
{{connection.instanceUrl}}
API版本
v62.0
API標籤
v1.15.14

關於搜尋Salesforce物件

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

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

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

建立與Salesforce的連線

若要為您的Salesforce模組建立連線:

  1. 在任何Salesforce模組中,按一下[連線]方塊旁的​ Add

  2. 填寫下列欄位:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 layout-auto html-authored no-header
    Connection name 輸入新連線的名稱。
    Environment 選取要連線到生產或非生產環境。
    Type 選取您要連線到服務帳戶還是個人帳戶。
    Client ID 輸入您的Salesforce使用者端ID。
    Client Secret 輸入您的Salesforce使用者端密碼。
    Sandbox 如果這是沙箱環境,則啟用此選項。
    API Version 輸入您要使用的Salesforce API版本。 預設版本為62.0。
  3. 按一下​ Continue ​以儲存連線並返回模組。

Salesforce模組及其欄位

觸發程序

Watch a field

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

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

Watch for Records

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

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

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

Watch Outbound Messages

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

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

  1. 前往Salesforce設定頁面。

    若要存取設定頁面,請尋找並按一下Salesforce帳戶右上角標示為"Setup"的按鈕。 從Salesforce設定頁面,找到左側的"Quick Find / Search"列。 搜尋"Workflow Rules"。

  2. 按一下​ Workflow Rules

  3. 在出現的Workflow Rules頁面上,按一下​ New Rule ​並選取規則將套用到的物件型別(例如,"Opportunity" (如果您正在監視機會記錄的更新)。

  4. 按一下​ Next

  5. 設定規則名稱、評估條件和規則條件,然後按一下​ Save ​和​ Next

  6. 按一下​ Done

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

  8. 從​ Add Workflow Action ​下拉式清單中,選取​ New Outbound Message

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

    Endpoint URL ​欄位包含在Workfront Fusion的Salesforce Outbound Message上提供的URL。

  10. 設定以Outbound Message事件開頭的案例。

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

  12. 返回​ Workflow Rules ​頁面,找到新建立的規則,然後按一下​ Activate

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

Webhook

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

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

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

動作

Create a Record

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

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

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

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

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

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

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

Custom API Call

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

模組傳回以下內容:

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

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

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

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

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

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

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

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

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

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

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

注意:

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

Delete a Record

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

您指定記錄的ID。

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

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

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

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

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

Download Attachment/Document

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

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

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

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

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

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

  • Attachment
  • Document
  • ContentDocument (此檔案已在Saleforce CRM Content或Salesforce Files中上傳至資料庫。)

ID /

Attachment ID /

ContentDocument ID

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

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

Read a Record

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

您指定記錄的ID。

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

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

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

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

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

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

  • 方法: GET

  • 查詢字串

  • 索引鍵q

  • SELECT Id, Name, CreatedDate, LastModifiedDate FROM User LIMIT 10

在​ Bundle> Body >records ​下模組的輸出中找到搜尋的相符專案。
在我們的範例中,傳回6個使用者:
符合搜尋

Update a Record

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

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

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

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

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

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

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

Upload Attachment/Document

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

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

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

Connection
如需有關將您的Salesforce帳戶連線到Workfront Fusion的指示,請參閱建立與Adobe Workfront Fusion的連線 — 基本指示
Type of Upload
選取您要模組上傳附件還是檔案。
ID
輸入或對應您要上傳附件的物件ID。
Folder
選取包含您要模組上傳之檔案的資料夾。
Source File
從先前的模組中選取來源檔案,或對應來源檔案的名稱和資料。

上傳檔案

此動作模組會將單一檔案上傳至Salesforce。

搜尋

Search with Query

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

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

Connection
如需有關將您的Salesforce帳戶連線到Workfront Fusion的指示,請參閱建立與​ Adobe Workfront Fusion的連線 — 基本指示
Source file
從先前的模組中選取來源檔案,或對應來源檔案的名稱和資料。
Document linking
選取是否要套用內容檔案連結。
linkedEntityId
如果使用檔案連結,請輸入或對應連結物件的ID。
ShareType

如果使用檔案連結,請選取檔案的許可權。

  • 檢視器許可權

    使用者可以檢視檔案。

  • 共同作業人員許可權

    使用者可以檢視及編輯檔案。

  • 推斷的許可權

    許可權取決於使用者對相關記錄(例如程式庫)的許可權。

Visibility

如果使用檔案連結,請輸入或對映檔案的可見度。

  • 所有使用者

    適用於所有具有許可權的使用者

  • 內部使用者

    可供擁有許可權的內部使用者使用。

  • 共用使用者

    可供可以檢視已張貼檔案之摘要的使用者使用。

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

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

  • Simple

  • Using SOSL (Salesforce Object Search Language)

  • Using SOQL (Salesforce Object Query Language)

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

輸入搜尋依據的查詢。

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

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

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

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

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

Connection
如需有關將您的Salesforce帳戶連線到Workfront Fusion的指示,請參閱建立與​ Adobe Workfront Fusion的連線 — 基本指示
Type
選取您要搜尋的物件型別。
Search criteria
選取您要搜尋的欄位、要在查詢中使用的運運算元,以及要在欄位中搜尋的值。 您可以使用AND或OR來連線查詢。
Outputs
選取您要納入模組輸出的欄位。
Result set
選取您希望模組傳回「所有比對記錄」,還是隻傳回「第一個比對記錄」。
Maximal
輸入或對應您希望模組在每個案例執行週期中擷取的記錄數上限。
recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3