Workiva 支援中心

透過 Salesforce® 連接器，您可以使用指令 與 Salesforce 作為連鎖的一部分進行互動。例如，使用此連接器，您可以

• 透過 SOQL 和大量作業在 Salesforce 上傳、擷取和刪除資料
• 建立和管理 Salesforce 物件
• 在 Salesforce 中更新和建立記錄

連接器可與所有版本的 Salesforce Sales Cloud 互動：

• Salesforce Essentials®
• Salesforce Net Zero Cloud
• Lightning® Professional
• 閃電企業
• 閃電無限

註: 此連接器由 Workiva 建立並連接至第三方系統。雖然我們的支援團隊可協助您在工作區內設定此連接器，但我們無法排除故障或以其他方式協助解決源自 Workiva 平台之外的任何問題。

要求

若要在您的組織中使用連接器，org 安全管理員必須先啟用 。

然後，您可以使用下列其中一種方法來確保與 Salesforce 連線的安全性：

• Salesforce OAuth 身份驗證，使用用戶端 ID、密碼和範圍
• 基本驗證，使用使用者名稱和密碼
• 用戶端認證，僅使用用戶端 ID 和密碼
  

Salesforce OAuth 認證

若要連線至 Workiva，您將需要來自 Salesforce 的client ID 和secret ，以及連線應用程式的OAuth 範圍。

OAuth 驗證還需要使用 Salesforce 連接的應用程式。若要在 Salesforce 中建立此設定， ，請設定應用程式，並設定以下必要設定：

• 對於 Callback URL，請輸入與 AppSpot 相符的以下內容之一：
  • 美國、中美洲、南美洲： https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback
  • 亞太地區： https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback
  • 加拿大： https://h.ca.wdesk.com/s/wdata/oc/app/oauth/callback
  • 歐洲、中東和非洲： https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback
• 在Selected OAuth Scopes 下，包括随时代表您执行请求 (refresh_token，offline_access) 和至少一个其他范围 。
   

基本驗證

若要連線至 Workiva，您需要整合使用者的使用者名稱、密碼和來自 Salesforce 的安全代碼 。

除了與連接器將執行的任何任務相關的權限外，基本驗證要求整合使用者具有啟用 API 的權限。

註： 若要在 Salesforce 中設定整合使用者的權限，請選擇Administer,Manage Users,Profiles, 並選擇其設定檔。

1. 在 Administrator Permissions下，選取 已啟用 API。
2. 若要啟用連線器執行指令，使用者至少需要對其相關資料具有讀取 的權限。 
3. 若要對 Salesforce 物件執行大量更新，使用者需要編輯 物件的權限。
    

用戶端憑證認證

若要連線至 Workiva，您將需要來自 Salesforce 的client ID 和secret 。

用戶端認證驗證需要使用 Salesforce 連結應用程式。若要在 Salesforce 中建立此， 使用 用戶端憑證流程 設定應用程式 ] 。

為 OAuth 身份驗證設定 Salesforce 連接器

OAuth 身份驗證允許您使用用戶端 ID 和秘密存取 Salesforce。與用戶端憑證登入方法不同，OAuth 身份驗證包含一個刷新標記，並且需要一個範圍。

建議使用此方法執行較長時間的指令，否則使用用戶端憑證方法會超時。

1. 從 Chain Builder中，按一下左側邊欄中的 compare_arrowsConnections ，然後按一下右上角的 compare_arrowsCreate 。
2. 在Connector Connection 下 ，選擇Salesforce 和預設 CloudRunner。
3. 在Basic Info 下，輸入唯一的名稱和描述以協助識別連線器。

4. 在 屬性下，輸入要連線的 Salesforce 執行個體或自訂網域：

   摘要資訊	詳細資料
   執行個體	輸入要連接至的 Salesforce 實例。如果您的組織使用自訂 Salesforce 網域，請將此欄位保留空白。 注意： 在您的 Salesforce URL 中，salesforce.com前的字符 - 如na73- 代表实例。
   自訂網域	輸入要連接的自訂 Salesforce 網域 (如果使用)。 註： 若要在 Salesforce 中檢視您的自訂網域，請選擇公司設定,我的網域 。自訂網域通常以.my.salesforce.com 結尾。

5. 對於驗證類型，選擇Salesforce OAuth 。

6. 在 Authentication下輸入用戶端 ID、密碼和範圍，然後按一下 Connect。
   

   注意： 當與 Salesforce 的連結成功時，連接器的 重新整理權杖 和 存取權杖將自動填入。如果連線失敗，請按一下Stop 並等待再次連線。

   注意： 所有敏感憑證都會自動加密，並以 AES-256 加密方式儲存。

7. 選擇連接使用的環境，然後按一下儲存 。
8. 若要測試連線，，使用連接器的List Reports 指令 建立並執行連線 ，並驗證它是否傳回有效的輸出。

為基本驗證設定 Salesforce 連接器

基本驗證允許您使用整合使用者的使用者名稱和密碼登入 Salesforce。

1. 從 Chain Builder中，按一下左側邊欄中的 compare_arrowsConnections ，然後按一下右上角的 compare_arrowsCreate 。
2. 在Connector Connection 下 ，選擇Salesforce 和預設 CloudRunner。
3. 在Basic Info 下，輸入唯一的名稱和描述以協助識別連線器。

4. 在 屬性下，輸入要連線的 Salesforce 執行個體或自訂網域：

   摘要資訊	詳細資料
   執行個體	輸入要連接至的 Salesforce 實例。如果您的組織使用自訂 Salesforce 網域，請留空。 注意： 在您的 Salesforce URL 中，salesforce.com前的字符 - 如na73- 代表实例。
   自訂網域	輸入要連接的自訂 Salesforce 網域 (如果使用)。 註： 若要在 Salesforce 中檢視您的自訂網域，請選擇公司設定,我的網域 。自訂網域通常以.my.salesforce.com 結尾。

5. 對於驗證類型，請選擇Basic Auth 。

6. 在Authentication 下，輸入整合使用者的使用者名稱、密碼和安全標記。

   注意：所有敏感認證都會自動加密並以進階加密標準 (AES)-256 加密方式儲存。

7. 選擇連接使用的環境，然後按一下儲存 。
8. 若要測試連線，，使用連接器的List Reports 指令 建立並執行連線 ，並驗證它是否傳回有效的輸出。
    

設定用戶端憑證的 Salesforce 連接器

用戶端憑證認證允許您使用用戶端 ID 和秘密存取 Salesforce。這與 OAuth 登入方法的不同之處在於它不需要範圍，而且您不需要透過Connect 按鈕認證進入 Salesforce。 

警告 ：此驗證方法不包含刷新標記。因此，它不適合長時間執行的指令，並可能導致某些連鎖中的超時。

1. 從 Chain Builder中，按一下左側邊欄中的 compare_arrowsConnections ，然後按一下右上角的 compare_arrowsCreate 。
2. 在Connector Connection 下 ，選擇Salesforce 和預設 CloudRunner。
3. 在Basic Info 下，輸入唯一的名稱和描述以協助識別連線器。

4. 在 屬性下，輸入要連線的 Salesforce 執行個體或自訂網域：

   摘要資訊	詳細資料
   執行個體	輸入要連接至的 Salesforce 實例。如果您的組織使用自訂 Salesforce 網域，請留空。 注意： 在您的 Salesforce URL 中， salesforce.com 之前的字元，例如 na73— 代表執行個體。
   自訂網域	輸入要連接的自訂 Salesforce 網域 (如果使用)。 註： 若要在 Salesforce 中檢視您的自訂網域，請選擇公司設定,我的網域 。自訂網域通常以.my.salesforce.com 結尾。

5. 針對驗證類型，選擇Client Credentials 。

6. 在Authentication 下 ，輸入用戶端 ID 和秘密。

   注意： 所有敏感憑證都會自動加密，並以 AES-256 加密方式儲存。

7. 選擇連接使用的環境，然後按一下儲存 。
8. 若要測試連線，，使用連接器的List Reports 指令 建立並執行連線 ，並驗證它是否傳回有效的輸出。

疑難排解

如果與 Salesforce 的連線失敗，您可以根據驗證類型檢查幾個組態設定。

 

OAuth2 身份驗證

如果當您首次按一下連線 時，與 Salesforce 連線應用程式的連線失敗，請按一下停止 ，並等待再次連線。如果使用 OAuth2 身份验证时连接仍然失败：

• 確認已為連接器輸入正確的 Salesforce 範例或自訂網域。
• 檢查連接器使用的 Salesforce 連接應用程式的用戶端 ID 和秘密。
• 在 Salesforce 連接的應用程式中：
  • 驗證回傳 URL 是否正確：
  • 美國、中美洲、南美洲： https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback
  • 亞太地區： https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback
  • 加拿大： https://h.ca.wdesk.com/s/wdata/oc/app/oauth/callback
  • 歐洲、中東和非洲： https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback
  • 確保其選擇的 OAuth 範圍包括隨時代表您執行請求 (refresh_token、offline_access) 和至少一個其他範圍 。

如果連接器失去與 Salesforce 應用程式的連線：

1. 從 Chain Builder按一下左側邊欄中的 compare_arrowsConnections ，然後為連線按一下 Edit （鉛筆圖示）。
2. 在OAuth 下 ，單擊Reset 。
3. 要啟用連線器連接至 Salesforce，請按一下Allow 。
    

基本驗證

如果使用基本驗證連線失敗：

• 驗證整合使用者的登入憑證和安全代碼。若要在 Salesforce 中申請新的安全代碼，請登入為整合使用者，並選擇Settings,My Personal Information ，然後按一下Reset security token 。
• 確認已為連接器輸入正確的 Salesforce 範例或自訂網域。
• 確保整合使用者擁有API Enabled 權限，以及與連接器執行的任何任務相關的權限。
   

用戶端憑證認證

如果使用用戶端憑證身份驗證連接失敗：

• 確認已為連接器輸入正確的 Salesforce 範例或自訂網域。
• 檢查連接器使用的 Salesforce 連接應用程式的用戶端 ID 和秘密。