本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 連線至 Salesforce
<a name="connectors-salesforce"></a>

若要將 App Studio 與 Salesforce 連線，讓建置器能夠在應用程式中存取和使用 Salesforce 資源，您必須在 Salesforce 中建立和設定連線的應用程式，並在 App Studio 中建立 Salesforce 連接器。

**將 Salesforce 與 App Studio 連線**

1. 在 App Studio 的導覽窗格中，選擇**管理**區段中的**連接器**。您將前往顯示現有連接器清單的頁面，其中包含每個連接器的一些詳細資訊。

1. 選擇 **\$1 建立連接器**。

1. 從連接器類型清單中選擇 **Salesforce**，以開啟連接器建立頁面。

1. 請記下**重新導向 URL**，您會在下列步驟中使用它來設定 Salesforce。

1. 下一個步驟是在 Salesforce 中建立連線的應用程式。在另一個索引標籤或視窗中，導覽至您的 Salesforce 執行個體。

1. 在快速尋找方塊中，搜尋**App Manager**並選取 **App Manager**。

1. 選擇**新的連線應用程式**。

1. 在**連線的應用程式名稱**和 **API 名稱**中，輸入應用程式的名稱。它不必與您的 App Studio 應用程式名稱相符。

1. 視需要提供聯絡資訊。

1. 在 **API （啟用 OAuth 設定）** 區段中，啟用**啟用 OAuth 設定**。

1. 在**回呼 URL** 中，輸入您先前從 App Studio 記下的**重新導向 URL**。

1. 在**選取的 OAuth 範圍**中，從清單中新增必要的許可範圍。App Studio 可以與 Salesforce REST APIs互動，對五個物件執行 CRUD 操作：帳戶、案例、聯絡人、潛在客戶和機會。建議新增**完整存取 （完整）**，以確保您的 App Studio 應用程式具有所有相關許可或範圍。

1. 停用**支援授權流程的程式碼交換 (PKCE) 延伸需要證明金鑰**選項。App Studio 不支援 PKCE。

1. 啟用**需要秘密的 Web 伺服器流程**和**需要秘密的重新整理字符流程**，以遵循最佳安全實務。

1. App Studio 支援下列兩種身分驗證流程：
   + **用戶端登入資料流程**：非常適合server-to-server互動，其中應用程式在沒有使用者互動的情況下代表自己運作。例如，列出沒有 Salesforce 存取權的臨時員工團隊的所有潛在客戶資訊。
   + **授權碼流程**：適用於代表使用者執行動作的應用程式，例如個人資料存取或動作。例如，列出每個銷售經理的潛在客戶來源或由他們擁有，以透過此應用程式執行其他任務。
   + 對於用戶端登入資料流程：

     1. 啟用**啟用用戶端登入資料流程**。檢閱並確認訊息。

     1. 儲存應用程式。

     1. 您必須選取執行使用者，雖然流程中沒有使用者互動。透過選取執行使用者，Salesforce 會代表使用者傳回存取權杖。

        1. 在 **App Manager** 中，從應用程式清單中選擇 App Studio 應用程式的箭頭，然後選擇**管理**。

        1. 選擇**編輯政策**

        1. 在**用戶端登入資料流程中**，新增適當的使用者。
   + 針對授權碼流程，啟用**啟用授權碼和登入資料流程**

1. Salesforce 提供用戶端 ID 和用戶端秘密，必須在下列步驟中用來在 App Studio 中設定連接器。

   1. 在 **App Manager** 中，選擇 App Studio 應用程式的箭頭，然後選擇**檢視**。

   1. 在 **API （啟用 OAuth 設定）** 區段中，選擇**管理消費者詳細資訊**。這可能會傳送驗證金鑰的電子郵件，您需要輸入此金鑰以進行確認。

   1. 請注意**消費者金鑰** （用戶端 ID) 和**消費者秘密** （用戶端秘密）。

1. 返回 App Studio，填寫下列欄位來設定和建立您的連接器。

1. 在**名稱**中，輸入 Salesforce 連接器的名稱。

1. 在**描述**中，輸入 Salesforce 連接器的描述。

1. 在**基本 URL** 中，輸入 Salesforce 執行個體的基本 URL。看起來應該像這樣：`https://hostname.salesforce.com/services/data/v60.0`，將*主機名稱*取代為您的 Salesforce 執行個體名稱。

1. 在**身分驗證方法**中，確保已選取 **OAuth 2.0。**

1. 在 **OAuth 2.0 流程中**，選取 OAuth 身分驗證方法並填寫相關欄位：
   + 針對system-to-system整合，選取**用戶端登入資料流程**以用於代表自己的應用程式。

     1. 在**用戶端 ID** 中，輸入先前從 Salesforce 取得的**取用者金鑰**。

     1. 在**用戶端秘密**中，輸入先前從 Salesforce 取得的**消費者秘密**。

     1. 在**存取字符 URL** 中，輸入 OAuth 2.0 字符端點。看起來應該像這樣：`https://hostname/services/oauth2/token`，將*主機名稱*取代為您的 Salesforce 執行個體名稱。如需詳細資訊，請參閱 [Salesforce OAuth 端點](https://help.salesforce.com/s/articleView?id=sf.remoteaccess_oauth_endpoints.htm&type=5)文件。

     1. 選擇**驗證連線**以測試身分驗證和連線。
   + 選取**授權碼流程**，以用於代表使用者執行動作的應用程式。

     1. 在**用戶端 ID** 中，輸入先前從 Salesforce 取得的**取用者金鑰**。

     1. 在**用戶端秘密**中，輸入先前從 Salesforce 取得的**消費者秘密**。

     1. 在**授權 URL** 中，輸入授權端點。看起來應該像這樣：`https://hostname/services/oauth2/authorize`，將*主機名稱*取代為您的 Salesforce 執行個體名稱。如需詳細資訊，請參閱 [Salesforce OAuth 端點](https://help.salesforce.com/s/articleView?id=sf.remoteaccess_oauth_endpoints.htm&type=5)文件。

     1. 在**存取字符 URL** 中，輸入 OAuth 2.0 字符端點。看起來應該像這樣：`https://hostname/services/oauth2/token`，將*主機名稱*取代為您的 Salesforce 執行個體名稱。如需詳細資訊，請參閱 [Salesforce OAuth 端點](https://help.salesforce.com/s/articleView?id=sf.remoteaccess_oauth_endpoints.htm&type=5)文件。

1. 在**操作**中，選取連接器將支援的 Salesforce 操作。此清單中的操作是預先定義的，並代表 Salesforce 中的常見任務，例如從常見物件建立、擷取、更新或刪除記錄。

1. 選擇**建立**。新建立的連接器會出現在**連接器**清單中。