|
自 2021 年 1 月起，傳統文件類型將不再可用。您可以轉換傳統檔案或下載 PDF。進一步瞭解

Workiva 支援中心

連接到 Salesforce 的連線器

連接到 Salesforce 的連線器

  • 上次更新時間：

透過 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 吻合：
    • PROD -https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback
    • EMEA -https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback
    • 亞太地區 -https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback
  • 在Selected OAuth Scopes 下，包括随时代表您执行请求 (refresh_token，offline_access) 和至少一个其他范围 。

基本驗證

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

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

註： 若要在 Salesforce 中設定整合使用者的權限，請選擇Administer,Manage Users,Profiles, 並選擇其設定檔。
  1. 在管理權限 ，選擇已啟用 API 。
  2. 若要啟用連線器執行指令，使用者至少需要對其相關資料具有讀取 的權限。 
  3. 若要對 Salesforce 物件執行大量更新，使用者需要編輯 物件的權限。

客戶端憑證認證

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

用戶端憑證認證需要使用 Salesforce 連接的應用程式。要在 Salesforce 中建立此 ，使用客戶端憑證流設定應用程式 。

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

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

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

  1. 在「鏈結產生器」中，按一下「連線」compare_arrows，然後按一下右上角的「建立」。
  2. 在Connector Connection 下 ，選擇Salesforce 和預設 CloudRunner。
  3. 在Basic Info 下 ，輸入唯一的名稱和描述以協助識別連線器。
  4. 在Properties 下 ，輸入要連接至的 Salesforce 實例或自訂網域：
    摘要資訊 詳細資料
    執行個體 輸入要連接至的 Salesforce 實例。如果您的組織使用自訂 Salesforce 網域，請留空。
    注意： 在您的 Salesforce URL 中，salesforce.com前的字符 - 如na73- 代表实例。
    自訂網域 輸入要連接的自訂 Salesforce 網域 (如果使用)。
    註： 若要在 Salesforce 中檢視您的自訂網域，請選擇公司設定,我的網域 。自訂網域通常以.my.salesforce.com 結尾。
  5. 對於驗證類型，選擇Salesforce OAuth 。
  6. 在Authentication 下輸入用戶端 ID、密碼和範圍，然後按一下Connect 。2024-06-10_11-51-18.png
    注意： 與 Salesforce 連線成功時，連接器的更新令牌 和存取令牌 會自動填入。如果連線失敗，請按一下Stop 並等待再次連線。
    請注意： 所有敏感憑證都會自動加密，並以 AES-256 加密方式儲存。
  7. 選擇要與連接一起使用的環境，然後按一下儲存 。
  8. 若要測試連線，，使用連接器的List Reports 指令 建立並執行連線 ，並驗證它會傳回有效的輸出。

為基本驗證設定 Salesforce 連接器

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

  1. 在「鏈結產生器」中，按一下「連線」compare_arrows，然後按一下右上角的「建立」。
  2. 在Connector Connection 下 ，選擇Salesforce 和預設 CloudRunner。
  3. 在Basic Info 下 ，輸入唯一的名稱和描述以協助識別連線器。
  4. 在Properties 下 ，輸入要連接至的 Salesforce 實例或自訂網域：
    摘要資訊 詳細資料
    執行個體 輸入要連接至的 Salesforce 實例。如果您的組織使用自訂 Salesforce 網域，請留空。
    注意： 在您的 Salesforce URL 中，salesforce.com前的字符 - 如na73- 代表实例。
    自訂網域 輸入要連接的自訂 Salesforce 網域 (如果使用)。
    註： 若要在 Salesforce 中檢視您的自訂網域，請選擇公司設定,我的網域 。自訂網域通常以.my.salesforce.com 結尾。
  5. 對於驗證類型，請選擇Basic Auth 。
  6. 在Authentication 下，輸入整合使用者的使用者名稱、密碼和安全標記。2024-06-10_11-41-07.png
    注意：所有敏感認證都會自動加密並以進階加密標準 (AES)-256 加密方式儲存。
  7. 選擇要與連接一起使用的環境，然後按一下儲存 。
  8. 若要測試連線，，使用連接器的List Reports 指令 建立並執行連線 ，並驗證它會傳回有效的輸出。

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

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

警告 ：此驗證方法不包含刷新標記。因此，它不適合長時間執行的指令，並可能導致某些連鎖中的超時。
  1. 在「鏈結產生器」中，按一下「連線」compare_arrows，然後按一下右上角的「建立」。
  2. 在Connector Connection 下 ，選擇Salesforce 和預設 CloudRunner。
  3. 在Basic Info 下 ，輸入唯一的名稱和描述以協助識別連線器。
  4. 在Properties 下 ，輸入要連接至的 Salesforce 實例或自訂網域：
    摘要資訊 詳細資料
    執行個體 輸入要連接至的 Salesforce 實例。如果您的組織使用自訂 Salesforce 網域，請留空。
    注意： 在您的 Salesforce URL 中，salesforce.com前的字符 - 如na73- 代表实例。
    自訂網域 輸入要連接的自訂 Salesforce 網域 (如果使用)。
    註： 若要在 Salesforce 中檢視您的自訂網域，請選擇公司設定,我的網域 。自訂網域通常以.my.salesforce.com 結尾。
  5. 針對驗證類型，選擇Client Credentials 。2024-06-10_12-32-47.png
  6. 在Authentication 下 ，輸入用戶端 ID 和秘密。
    注意： 所有敏感憑證都會自動加密，並以 AES-256 加密方式儲存。
  7. 選擇要與連接一起使用的環境，然後按一下儲存 。
  8. 若要測試連線，，使用連接器的List Reports 指令 建立並執行連線 ，並驗證它是否傳回有效的輸出。

疑難排解

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

OAuth2 身份驗證

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

  • 確認已為連接器輸入正確的 Salesforce 範例或自訂網域。
  • 檢查連接器使用的 Salesforce 連接應用程式的用戶端 ID 和秘密。
  • 在 Salesforce 連接的應用程式中：
    • 確認回呼 URL 為： PROD -
      • PROD -https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback
      • EMEA -https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback
      • APAC -https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback
    • 確保其選擇的 OAuth 範圍包括隨時代表您執行請求 (refresh_token、offline_access) 和至少一個其他範圍 。

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

  1. 從Chains ，按一下Connections compare_arrows ，選擇連線器，然後按一下Edit 。
  2. 在OAuth 下 ，單擊Reset 。
  3. 要啟用連線器連接至 Salesforce，請按一下Allow 。

基本驗證

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

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

用戶端憑證認證

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

  • 確認已為連接器輸入正確的 Salesforce 範例或自訂網域。
  • 檢查連接器使用的 Salesforce 連接應用程式的用戶端 ID 和秘密。
這篇文章是否有幫助？
1 人中有 1 人覺得有幫助
透過 Salesforce® 連接器，您可以使用指令 與 Salesforce 作為連鎖的一部分進行互動。例如，使用此連接器，您可以 透過 SOQL 和大量作業在 Salesforce 上傳、擷取和刪除資料 建立和管理 Salesf...