Een Salesforce Service Cloud bronverbinding met de Flow Service API
Een basisverbinding vertegenwoordigt de geverifieerde verbinding tussen een bron en Adobe Experience Platform.
Lees deze zelfstudie om te leren hoe u een basisverbinding maakt voor Salesforce Service Cloud met de Flow Service API.
Aan de slag
Deze handleiding vereist een goed begrip van de volgende onderdelen van Adobe Experience Platform:
- Bronnen: Met Experience Platform kunnen gegevens uit verschillende bronnen worden ingepakt en kunt u inkomende gegevens structureren, labelen en verbeteren met Platform diensten.
- Sandboxen: Experience Platform biedt virtuele sandboxen die één enkele partitie maken Platform in afzonderlijke virtuele omgevingen om toepassingen voor digitale ervaringen te ontwikkelen en te ontwikkelen.
De volgende secties bevatten aanvullende informatie die u nodig hebt om verbinding te kunnen maken met Salesforce Service Cloud met de Flow Service API.
Vereiste referenties verzamelen
De Salesforce Service Cloud De bron steunt basisauthentificatie en de Credentials van de Cliënt OAuth2.
Als u verbinding wilt maken met uw Salesforce Service Cloud account aan Flow Service het gebruiken van basisauthentificatie, verstrek waarden voor de volgende geloofsbrieven:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 | |
---|---|
Credentials | Beschrijving |
environmentUrl |
De URL van de Salesforce Service Cloud broninstantie. |
username |
De gebruikersnaam voor de Salesforce Service Cloud gebruikersaccount. |
password |
Het wachtwoord voor de Salesforce Service Cloud gebruikersaccount. |
securityToken |
De beveiligingstoken voor de Salesforce Service Cloud gebruikersaccount. |
apiVersion |
(Optioneel) De REST API-versie van de Salesforce Service Cloud -instantie die u gebruikt. De waarde voor de API-versie moet met een decimaal worden opgemaakt. Als u bijvoorbeeld API-versie gebruikt 52 vervolgens moet u de waarde invoeren als 52.0 . Als dit veld niet wordt ingevuld, gebruikt het Experience Platform automatisch de meest recente beschikbare versie. |
connectionSpec.id |
De verbindingsspecificatie keert de schakelaareigenschappen van een bron, met inbegrip van authentificatiespecificaties met betrekking tot het creëren van de basis en bronverbindingen terug. De verbindingsspecificatie-id voor Salesforce Service Cloud is: cfc0fee1-7dc0-40ef-b73e-d8b134c436f5 . |
Ga voor meer informatie over aan de slag gaan dit Salesforce-document.
Als u verbinding wilt maken met uw Salesforce Service Cloud account aan Flow Service Gebruik OAuth 2 Client Credential en geef waarden op voor de volgende referenties:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 | |
---|---|
Credentials | Beschrijving |
environmentUrl |
De URL van de Salesforce Service Cloud broninstantie. |
clientId |
De client-id wordt gebruikt in combinatie met het clientgeheim als onderdeel van OAuth2-verificatie. Met de client-id en het clientgeheim kan uw toepassing samen voor uw account werken door uw toepassing te identificeren voor Salesforce Service Cloud. |
clientSecret |
Het clientgeheim wordt gebruikt in combinatie met de client-id als onderdeel van OAuth2-verificatie. Met de client-id en het clientgeheim kan uw toepassing samen voor uw account werken door uw toepassing te identificeren voor Salesforce Service Cloud. |
apiVersion |
De REST API-versie van de Salesforce Service Cloud -instantie die u gebruikt. De waarde voor de API-versie moet met een decimaal worden opgemaakt. Als u bijvoorbeeld API-versie gebruikt 52 vervolgens moet u de waarde invoeren als 52.0 . Als dit veld niet wordt ingevuld, gebruikt het Experience Platform automatisch de meest recente beschikbare versie. Deze waarde is verplicht voor OAuth2 Client Credential-verificatie. |
connectionSpec.id |
De verbindingsspecificatie keert de schakelaareigenschappen van een bron, met inbegrip van authentificatiespecificaties met betrekking tot het creëren van de basis en bronverbindingen terug. De verbindingsspecificatie-id voor Salesforce Service Cloud is: cfc0fee1-7dc0-40ef-b73e-d8b134c436f5 . |
Voor meer informatie over het gebruik van OAuth voor Salesforce Service Cloud, lees de Salesforce Service Cloud handleiding over OAuth Authorization Flows.
Platform-API's gebruiken
Voor informatie over hoe te om vraag aan Platform APIs met succes te maken, zie de gids op aan de slag met platform-API's.
Een basisverbinding maken
Een basisverbinding behoudt informatie tussen uw bron en Platform, met inbegrip van de de authentificatiegeloofsbrieven van uw bron, de huidige staat van de verbinding, en uw unieke identiteitskaart van de basisverbinding. Met de ID van de basisverbinding kunt u bestanden verkennen en door bestanden navigeren vanuit uw bron en kunt u de specifieke items identificeren die u wilt opnemen, inclusief informatie over hun gegevenstypen en indelingen.
Om een identiteitskaart van de basisverbinding te creëren, doe een verzoek van de POST aan /connections
als u uw Salesforce Service Cloud verificatiereferenties als onderdeel van de aanvraagparameters.
API-indeling
POST /connections
Verzoek
Met de volgende aanvraag wordt een basisverbinding gemaakt voor Salesforce Service Cloud basisverificatie gebruiken:
code language-shell |
---|
|
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 | |
---|---|
Parameter | Beschrijving |
auth.params.environmentUrl |
De URL van uw Salesforce Service Cloud -instantie. |
auth.params.username |
De gebruikersnaam die aan uw Salesforce Service Cloud account. |
auth.params.password |
Het wachtwoord dat aan uw Salesforce Service Cloud account. |
auth.params.securityToken |
Het veiligheidstoken verbonden aan uw Salesforce Service Cloud account. |
connectionSpec.id |
De Salesforce Service Cloud Verbindingsspecificatie-id: cb66ab34-8619-49cb-96d1-39b37ede86ea |
Met de volgende aanvraag wordt een basisverbinding gemaakt voor Salesforce Service Cloud gebruik van OAuth 2 Client Credential:
code language-shell |
---|
|
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 | |
---|---|
Eigenschap | Beschrijving |
auth.params.environmentUrl |
De URL van uw Salesforce Service Cloud -instantie. |
auth.params.clientId |
De client-id die aan uw Salesforce Service Cloud account. |
auth.params.clientSecret |
Het clientgeheim dat aan uw Salesforce Service Cloud account. |
auth.params.apiVersion |
De REST API-versie van de Salesforce Service Cloud -instantie die u gebruikt. |
connectionSpec.id |
De Salesforce Service Cloud Verbindingsspecificatie-id: cb66ab34-8619-49cb-96d1-39b37ede86ea . |
Antwoord
Een geslaagde reactie retourneert de nieuwe basisverbinding samen met de unieke id.
{
"id": "4267c2ab-2104-474f-a7c2-ab2104d74f86",
"etag": "\"0200f1c5-0000-0200-0000-5e4352bf0000\""
}
Volgende stappen
Aan de hand van deze zelfstudie hebt u een Salesforce Service Cloud basisverbinding met de Flow Service API. U kunt deze basis verbindings-id in de volgende zelfstudies gebruiken: