使用Salesforce API連線Flow Service至Experience Platform
閱讀本指南,瞭解如何使用SalesforceAPIFlow Service 將您的來源帳戶連結至Adobe Experience Platform。
快速入門
本指南需要您深入了解下列 Adobe Experience Platform 元件:
使用Experience Platform API
如需如何成功呼叫Experience Platform API的詳細資訊,請參閱Experience Platform API快速入門指南。
將Salesforce連線至Azure上的Experience Platform azure
請閱讀下列步驟,以瞭解如何將Salesforce來源連線至Azure上的Experience Platform。
收集必要的認證
Salesforce來源支援基本驗證和OAuth2使用者端認證。
若要使用基本驗證將您的Salesforce帳戶連線到Flow Service,請提供下列認證的值:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 | |
---|---|
認證 | 說明 |
environmentUrl |
Salesforce來源執行個體的網址。 environmentUrl 的格式為https://[domain].my.salesforce.com 。 |
username |
Salesforce使用者帳戶的使用者名稱。 |
password |
Salesforce使用者帳戶的密碼。 |
securityToken |
Salesforce使用者帳戶的安全性權杖。 |
apiVersion |
選用性)您正在使用的Salesforce執行個體的REST API版本。 API版本的值必須使用小數點格式化。 例如,如果您使用API版本52 ,則必須以52.0 的形式輸入值。 如果此欄位留空,Experience Platform將自動使用最新可用版本。 |
connectionSpec.id |
連線規格會傳回來源的聯結器屬性,包括與建立基礎連線和來源連線相關的驗證規格。 Salesforce的連線規格識別碼為: cfc0fee1-7dc0-40ef-b73e-d8b134c436f5 。 |
如需開始使用的詳細資訊,請瀏覽此Salesforce檔案。
若要使用OAuth 2使用者端認證將您的Salesforce帳戶連線至Flow Service,請提供下列認證的值:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 | |
---|---|
認證 | 說明 |
environmentUrl |
Salesforce來源執行個體的網址。 environmentUrl 的格式為https://[domain].my.salesforce.com |
clientId |
使用者端ID會與使用者端密碼搭配使用,作為OAuth2驗證的一部分。 使用者端ID和使用者端密碼可讓您的應用程式透過向Salesforce識別您的應用程式,以代表您的帳戶運作。 |
clientSecret |
使用者端密碼會與使用者端ID搭配使用,做為OAuth2驗證的一部分。 使用者端ID和使用者端密碼可讓您的應用程式透過向Salesforce識別您的應用程式,以代表您的帳戶運作。 |
apiVersion |
您正在使用的Salesforce執行個體的REST API版本。 API版本的值必須使用小數點格式化。 例如,如果您使用API版本52 ,則必須以52.0 的形式輸入值。 如果此欄位留空,Experience Platform將自動使用最新可用版本。 此值是OAuth2使用者端認證驗證的必要專案。 |
includeDeletedObjects |
布林值,用來判斷是否包含軟性刪除的記錄。 若設為True,軟刪除的記錄可包含在您的Salesforce查詢中,並從您的帳戶擷取到Experience Platform中。 如果您未指定設定,此值預設為false 。 |
connectionSpec.id |
連線規格會傳回來源的聯結器屬性,包括與建立基礎連線和來源連線相關的驗證規格。 Salesforce的連線規格識別碼為: cfc0fee1-7dc0-40ef-b73e-d8b134c436f5 。 |
如需針對Salesforce使用OAuth的詳細資訊,請參閱OAuth授權流程Salesforce 的指南。
在Salesforce上的Experience Platform中為Azure建立基底連線
基本連線會保留來源與Experience Platform之間的資訊,包括來源的驗證認證、連線的目前狀態,以及唯一的基本連線ID。 基礎連線ID可讓您從來源內部探索及導覽檔案,並識別您要擷取的特定專案,包括其資料型別和格式的資訊。
若要建立基底連線並將您的Salesforce帳戶連線到Azure上的Experience Platform,請對/connections
端點發出POST要求,並在要求內文中提供您的Salesforce驗證認證。
API格式
POST /connections
accordion | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
要求 | ||||||||||||||||
下列要求使用基本驗證建立Salesforce的基本連線:
|
accordion | ||
---|---|---|
回應 | ||
成功的回應會傳回您新建立的基本連線及其唯一ID。
|
accordion | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
要求 | ||||||||||||||||||
以下要求使用OAuth 2使用者端認證為Salesforce建立基礎連線:
|
accordion | ||
---|---|---|
回應 | ||
成功的回應會傳回您新建立的基本連線及其唯一ID。
|
將Salesforce連線到Amazon Web Services (AWS)上的Experience Platform aws
請閱讀下列步驟,以瞭解如何將Salesforce來源連線至AWS上的Experience Platform。
先決條件
如需如何設定您的Salesforce帳戶以便在AWS上連線到Experience Platform的詳細資訊,請閱讀Salesforce 總覽。
在AWS上的Experience Platform上為Salesforce建立基礎連線
若要建立基礎連線並將您的Salesforce帳戶連線至AWS上的Experience Platform,請對/connections
端點發出POST要求,並提供您認證的適當值。
API格式
POST /connections
要求
下列請求會在AWS上的Experience Platform中建立Salesforce來源的基礎連線。
code language-shell |
---|
|
如需如何擷取您的Salesforce jwtToken
的詳細資訊,請閱讀上的指南如何設定 Salesforce 來源以連線到AWS上的Experience Platform。
回應
成功的回應會傳回您新建立的基本連線及其唯一ID。
code language-json |
---|
|
驗證您的連線狀態
若要驗證您的連線狀態,請向/connections
端點發出GET請求,並提供在建立步驟中產生的基本連線ID。
API格式
GET /connections
要求
下列要求會擷取基底連線識別碼的資訊: 3e908d3f-c390-482b-9f44-43d3d4f2eb82
。
code language-shell |
---|
|
回應
accordion | ||
---|---|---|
選取以檢視回應範例 | ||
下列回應顯示基底連線識別碼的資訊:
|
accordion | ||
---|---|---|
選取以檢視回應範例 | ||
下列回應顯示基底連線識別碼的資訊:
|
後續步驟
依照此教學課程,您已使用Salesforce API建立Flow Service基礎連線。 您可以在下列教學課程中使用此基本連線ID: