Verbind Salesforce met Experience Platform gebruikend Flow Service API
Lees deze gids om te leren hoe u uw Salesforce bronrekening met Adobe Experience Platform kunt verbinden gebruikend Flow Service API.
Aan de slag
Deze handleiding vereist een goed begrip van de volgende onderdelen van Adobe Experience Platform:
- Bronnen: Experience Platform staat gegevens toe om van diverse bronnen worden opgenomen terwijl het voorzien van u van de capaciteit om, inkomende gegevens te structureren te etiketteren en te verbeteren gebruikend Platform diensten.
- Sandboxen: Experience Platform verstrekt virtuele zandbakken die één enkele Platform instantie in afzonderlijke virtuele milieu's verdelen helpen digitale ervaringstoepassingen ontwikkelen en ontwikkelen.
Platform-API's gebruiken
Voor informatie over hoe te om vraag aan Platform APIs met succes te maken, zie de gids op begonnen wordt met Platform APIs.
Verbinden Salesforce met Experience Platform op Azure azure
Lees de onderstaande stappen voor informatie over hoe u de Salesforce -bron kunt verbinden met het Experience Platform op Azure .
Vereiste referenties verzamelen
De Salesforce -bron ondersteunt basisverificatie en OAuth2 Client Credential.
Als u uw Salesforce -account wilt verbinden met Flow Service via basisverificatie, geeft u 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 6-row-2 | |
---|---|
Credentials | Beschrijving |
environmentUrl |
De URL van de broninstantie Salesforce . De notatie voor environmentUrl is https://[domain].my.salesforce.com . |
username |
De gebruikersnaam voor de gebruikersaccount van Salesforce . |
password |
Het wachtwoord voor de Salesforce -gebruikersaccount. |
securityToken |
Het beveiligingstoken voor de gebruikersaccount van Salesforce . |
apiVersion |
(Optioneel) De REST API-versie van de instantie Salesforce die u gebruikt. De waarde voor de API-versie moet met een decimaal worden opgemaakt. Als u bijvoorbeeld API-versie 52 gebruikt, 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 is: cfc0fee1-7dc0-40ef-b73e-d8b134c436f5 . |
Voor meer informatie bij begonnen worden, bezoek dit document van Salesforce.
Als u uw Salesforce -account wilt verbinden met Flow Service via OAuth 2 Client Credential, geeft u 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 broninstantie Salesforce . De notatie voor environmentUrl is https://[domain].my.salesforce.com |
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 namens uw account werken door uw toepassing aan te duiden op Salesforce . |
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 namens uw account werken door uw toepassing aan te duiden op Salesforce . |
apiVersion |
De REST API-versie van de instantie Salesforce die u gebruikt. De waarde voor de API-versie moet met een decimaal worden opgemaakt. Als u bijvoorbeeld API-versie 52 gebruikt, 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 is: cfc0fee1-7dc0-40ef-b73e-d8b134c436f5 . |
Voor meer informatie bij het gebruiken van OAuth voor Salesforce, lees de Salesforce gids over de Stroom van de Vergunning OAuth.
Een basisverbinding maken voor Salesforce in Experience Platform op Azure
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.
Als u een basisverbinding wilt maken en uw Salesforce -account wilt verbinden met een Experience Platform op Azure , vraagt u een POST naar het /connections
-eindpunt en geeft u de Salesforce verificatiegegevens op in de aanvraaginstantie.
API formaat
POST /connections
accordion | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
verzoek | ||||||||||||||||
Met de volgende aanvraag wordt een basisverbinding voor Salesforce gemaakt met behulp van basisverificatie:
|
accordion | ||
---|---|---|
Response | ||
Een geslaagde reactie retourneert de nieuwe basisverbinding samen met de unieke id.
|
accordion | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
verzoek | ||||||||||||||||
Met de volgende aanvraag wordt een basisverbinding voor Salesforce gemaakt met OAuth 2 Client Credential:
|
accordion | ||
---|---|---|
Response | ||
Een geslaagde reactie retourneert de nieuwe basisverbinding samen met de unieke id.
|
Verbinding maken Salesforce met Experience Platform op Amazon Web Services (AWS) aws
Lees de onderstaande stappen voor informatie over hoe u de Salesforce -bron kunt verbinden met het Experience Platform op AWS.
Vereisten
Voor informatie over hoe te opstelling uw Salesforce rekening om met Experience Platform op AWS te kunnen verbinden, lees het Salesforce overzicht.
Een basisverbinding maken voor Salesforce op Experience Platform op AWS
Als u een basisverbinding wilt maken en uw Salesforce -account wilt verbinden met het Experience Platform op AWS, dient u een verzoek in bij de POST naar het /connections
-eindpunt en geeft u de juiste waarden voor uw referenties op.
API formaat
POST /connections
Verzoek
Met de volgende aanvraag wordt een basisverbinding voor de Salesforce -bron in Experience Platform op AWS gemaakt.
code language-shell |
---|
|
Voor informatie over hoe te om uw Salesforce terug te winnen jwtToken
, lees de gids op hoe te opstelling a Salesforce bron om met Experience Platform op AWSte verbinden.
Reactie
Een geslaagde reactie retourneert de nieuwe basisverbinding samen met de unieke id.
code language-json |
---|
|
De verbindingsstatus controleren
Om uw verbindingsstatus te verifiëren, doe een verzoek van de GET aan het /connections
eindpunt en verstrek identiteitskaart van de basisverbinding die in de aanmaakstap werd geproduceerd.
API formaat
GET /connections
Verzoek
Met de volgende aanvraag wordt informatie opgehaald voor de id van de basisverbinding: 3e908d3f-c390-482b-9f44-43d3d4f2eb82
.
code language-shell |
---|
|
Reactie
accordion | ||
---|---|---|
Selecteren om reactievoorbeeld weer te geven | ||
In het volgende antwoord wordt informatie weergegeven voor de basis-verbindings-id:
|
accordion | ||
---|---|---|
Selecteren om reactievoorbeeld weer te geven | ||
In het volgende antwoord wordt informatie weergegeven voor de basis-verbindings-id:
|
Volgende stappen
Aan de hand van deze zelfstudie hebt u een Salesforce basisverbinding gemaakt met de Flow Service API. U kunt deze basis verbindings-id in de volgende zelfstudies gebruiken: