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模組中,按一下[連線]方塊旁的​ 新增

  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
    連線名稱 輸入新連線的名稱。
    環境 選取要連線到生產或非生產環境。
    型別 選取您要連線到服務帳戶還是個人帳戶。
    使用者端ID 輸入您的Salesforce使用者端ID。
    使用者端密碼 輸入您的Salesforce使用者端密碼。
    Sandbox 如果這是沙箱環境,則啟用此選項。
    API版本 輸入您要使用的Salesforce API版本。 預設版本為62.0。
  3. 按一下​ 繼續 ​以儲存連線並返回模組。

Salesforce模組及其欄位

觸發程序

觀看欄位

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

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

觀看記錄

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

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

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

觀看傳出訊息

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

此模組需要一些額外的設定。 必須為傳出訊息設定流量。

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

Webhook

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

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

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

動作

建立記錄

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

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

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

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

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

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

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

自訂API呼叫

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

模組傳回以下內容:

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

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

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

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

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

Connection
如需有關將您的Salesforce帳戶連線到Workfront Fusion的說明,請參閱本文中的建立與Salesforce的連線
URL

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

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

方法
選取設定API呼叫所需的HTTP要求方法。 如需詳細資訊,請參閱HTTP要求方法
Headers
以標準JSON物件的形式新增請求的標頭。 例如 {"Content-type":"application/json"}。Workfront Fusion會為您新增授權標頭。
查詢字串
以標準JSON物件的形式新增API呼叫的查詢。 例如: {"name":"something-urgent"}
Body

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

注意:

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

recommendation-more-help

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

  • URLquery

  • 方法: GET

  • 查詢字串

  • 索引鍵q

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

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

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

符合搜尋

刪除記錄

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

您指定記錄的ID。

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

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

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

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

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

下載附件/檔案

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

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

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

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

Connection
如需有關將您的Salesforce帳戶連線到Workfront Fusion的說明,請參閱本文中的建立與Salesforce的連線
下載型別

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

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

ID /

附件ID /

ContentDocument ID

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

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

讀取記錄

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

您指定記錄的ID。

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

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

Connection
如需有關將您的Salesforce帳戶連線到Workfront Fusion的說明,請參閱本文中的建立與Salesforce的連線
記錄型別
選取您希望模組讀取的Salesforce記錄型別。
記錄欄位
選取您希望模組讀取的欄位。 您必須至少選取一個欄位。 可用欄位取決於記錄型別。
ID

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

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

更新記錄

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

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

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

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

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

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

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

上傳附件/檔案

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

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

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

Connection
如需有關將您的Salesforce帳戶連線到Workfront Fusion的說明,請參閱本文中的建立與Salesforce的連線
上傳型別
選取您要模組上傳附件還是檔案。
ID
輸入或對應您要上傳附件的物件ID。
資料夾
選取您要上傳檔案的資料夾。
Source檔案
從先前的模組中選取來源檔案,或對應來源檔案的名稱和資料。

上傳檔案

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

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

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

  • 檢視器許可權

    使用者可以檢視檔案。

  • 共同作業人員許可權

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

  • 推斷的許可權

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

可見性

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

  • 所有使用者

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

  • 內部使用者

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

  • 共用使用者

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

搜尋

搜尋

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

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

使用查詢搜尋

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

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

Connection
如需有關將您的Salesforce帳戶連線到Workfront Fusion的說明,請參閱本文中的建立與Salesforce的連線
搜尋型別

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

  • Simple

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

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

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

輸入搜尋依據的查詢。

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

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

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

最大記錄數
輸入或對應您希望模組在每個案例執行週期中傳回的最大記錄數。
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3