DocumentatieExperience PlatformHandleiding Source-connectors

Verbinding maken met Experience Platform via de Flow Service APISalesforce

Laatst bijgewerkt: 24 mei 2026

Gemaakt voor:

  • Developer

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 ​: Met Experience Platform kunt u gegevens uit verschillende bronnen invoegen en binnenkomende gegevens structureren, labelen en verbeteren met Experience Platform -services.
  • ​ Sandboxes ​: Experience Platform biedt virtuele sandboxen die één Experience Platform -instantie in afzonderlijke virtuele omgevingen verdelen om toepassingen voor digitale ervaringen te ontwikkelen en te ontwikkelen.

Experience Platform API’s gebruiken

Voor informatie over hoe te om vraag aan Experience Platform APIs met succes te maken, zie de gids op ​ begonnen wordt met Experience Platform APIs ​.

Verbinding maken Salesforce met Experience Platform op Azure azure

Lees de onderstaande stappen voor informatie over hoe u de Salesforce -bron kunt verbinden met Experience Platform op Azure .

Vereiste referenties verzamelen

De Salesforce -bron ondersteunt verificatie via OAuth2 Client Credential.

Als u uw Salesforce -account wilt verbinden met Flow Service via OAuth 2 Client Credential, geeft u waarden op voor de volgende referenties:

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 Experience Platform automatisch de meest recente beschikbare versie. Deze waarde is verplicht voor OAuth2 Client Credential-verificatie.
includeDeletedObjects
Een booleaanse waarde die wordt gebruikt om te bepalen of zachte verwijderde records moeten worden opgenomen. Als deze optie is ingesteld op true, kunnen elektronisch verwijderde records worden opgenomen in uw Salesforce -query en vanuit uw account worden opgenomen in Experience Platform. Als u de configuratie niet opgeeft, wordt deze waarde standaard ingesteld op false .
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 Experience Platform, met inbegrip van de verificatiereferenties van uw bron, de huidige status 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 op Azure wilt verbinden met Experience Platform, dient u een POST-aanvraag in bij het /connections -eindpunt en geeft u de Salesforce verificatiereferenties op in de hoofdtekst van de aanvraag.

API formaat

POST /connections
Selecteren om aanvraag weer te geven

Met de volgende aanvraag wordt een basisverbinding voor Salesforce gemaakt met OAuth 2 Client Credential:

code language-shell 
curl -X POST \
  'https://platform.adobe.io/data/foundation/flowservice/connections' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
      "name": "ACME Salesforce account",
      "description": "Salesforce account using OAuth 2",
      "auth": {
          "specName": "OAuth2 Client Credential",
          "params":
            "environmentUrl": "https://acme-enterprise-3126.my.salesforce.com",
            "clientId": "xxxx",
            "clientSecret": "xxxx",
            "apiVersion": "60.0",
            "includeDeletedObjects": true
        }
      },
      "connectionSpec": {
          "id": "cfc0fee1-7dc0-40ef-b73e-d8b134c436f5",
          "version": "1.0"
      }
  }'
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
Eigenschap Beschrijving
auth.params.environmentUrl De URL van de instantie Salesforce .
auth.params.clientId De client-id die aan uw Salesforce -account is gekoppeld.
auth.params.clientSecret Het clientgeheim dat aan uw Salesforce -account is gekoppeld.
auth.params.apiVersion De REST API-versie van de instantie Salesforce die u gebruikt.
auth.params.includeDeletedObjects Een booleaanse waarde die wordt gebruikt om te bepalen of zachte verwijderde records moeten worden opgenomen.
connectionSpec.id De Salesforce connection specification-id: cfc0fee1-7dc0-40ef-b73e-d8b134c436f5 .
Selecteren om reactie weer te geven

Een geslaagde reactie retourneert de nieuwe basisverbinding samen met de unieke id.

code language-json 
{
    "id": "4cb0c374-d3bb-4557-b139-5712880adc55",
    "etag": "\"1700df7b-0000-0200-0000-5e3b424f0000\""
}

Verbinding maken Salesforce met Experience Platform op Amazon Web Services (AWS) aws

AVAILABILITY
Deze sectie is van toepassing op implementaties van Experience Platform die op Amazon Web Services (AWS) worden uitgevoerd. Experience Platform die op AWS wordt uitgevoerd, is momenteel beschikbaar voor een beperkt aantal klanten. Meer over de gesteunde infrastructuur van Experience Platform leren, zie het ​ multi-wolkenoverzicht van Experience Platform ​.

Lees de onderstaande stappen voor informatie over hoe u uw Salesforce -bron kunt verbinden met 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 Experience Platform op AWS, dient u een POST-aanvraag in bij het /connections -eindpunt en geeft u de juiste waarden voor uw referenties op.

API formaat

POST /connections

Verzoek

Selecteren om aanvraag weer te geven

Met de volgende aanvraag wordt een basisverbinding voor de Salesforce -bron in Experience Platform op AWS gemaakt.

code language-shell 
curl -X POST \
  'https://platform.adobe.io/data/foundation/flowservice/connections' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'Content-Type: application/json' \
  -d '{
      "name": "ACME Salesforce account on AWS",
      "description": "ACME Salesforce account on AWS",
      "auth": {
          "specName": "OAuth2 JWT Token Credential",
          "params":
            "jwtToken": "{JWT_TOKEN},
            "clientId": "xxxx",
            "clientSecret": "xxxx",
            "instanceUrl": "https://acme-enterprise-3126.my.salesforce.com"
        }
      },
      "connectionSpec": {
          "id": "cfc0fee1-7dc0-40ef-b73e-d8b134c436f5",
          "version": "1.0"
      }
  }'

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 AWS ​ te verbinden.

Reactie

Selecteren om reactie weer te geven

Een geslaagde reactie retourneert de nieuwe basisverbinding samen met de unieke id.

code language-json 
{
    "id": "3e908d3f-c390-482b-9f44-43d3d4f2eb82",
    "etag": "\"1700df7b-0000-0200-0000-5e3b424f0000\""
}

De verbindingsstatus controleren

Om uw verbindingsstatus te verifiëren, doe een GET verzoek aan het /connections eindpunt en verstrek identiteitskaart van de basisverbinding die in de aanmaakstap werd geproduceerd.

API formaat

GET /connections

Verzoek

Selecteren om aanvraag weer te geven

Het volgende verzoek wint informatie voor identiteitskaart van de basisverbinding terug: 3e908d3f-c390-482b-9f44-43d3d4f2eb82.

code language-shell 
curl -X GET \
  'https://platform.adobe.io/data/foundation/flowservice/connections/3e908d3f-c390-482b-9f44-43d3d4f2eb82' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'Content-Type: application/json' \

Reactie

initialiserend
accordion
Selecteren om reactievoorbeeld weer te geven

In de volgende reactie wordt informatie weergegeven voor basis-verbindings-id: 3e908d3f-c390-482b-9f44-43d3d4f2eb82 in de status initializing .

code language-json 
{
  "items": [
    {
      "id": "3e908d3f-c390-482b-9f44-43d3d4f2eb82",
      "createdAt": 1736506325115,
      "updatedAt": 1736506325717,
      "createdBy": "acme@techacct.adobe.com",
      "updatedBy": "acme@techacct.adobe.com",
      "createdClient": "{CREATED_CLIENT}",
      "updatedClient": "{UPDATED_CLIENT}",
      "sandboxId": "{SANDBOX_ID}",
      "sandboxName": "{SANDBOX_NAME}",
      "imsOrgId": "{ORG_ID}",
      "name": "JWT Token Auth Authentication E2E-1736506322",
      "description": "Base Connection for salesforce E2E",
      "connectionSpec": {
        "id": "cfc0fee1-7dc0-40ef-b73e-d8b134c436f5",
        "version": "1.0"
      },
      "state": "initializing",
      "auth": {
        "specName": "OAuth2 JWT Token Credential",
        "params": {
          "jwtToken": "{JWT_TOKEN}",
          "clientId": "{CLIENT_ID}",
          "clientSecret": "{CLIENT_SECRET}",
          "instanceUrl": "https://acme-enterprise-3126.my.salesforce.com"
        }
      }
    }
  }
]
Toegelaten
accordion
Selecteren om reactievoorbeeld weer te geven

In de volgende reactie wordt informatie weergegeven voor basis-verbindings-id: 3e908d3f-c390-482b-9f44-43d3d4f2eb82 in de status enabled .

code language-json 
{
  "items": [
      {
        "id": "3e908d3f-c390-482b-9f44-43d3d4f2eb82",
        "createdAt": 1736506325115,
        "updatedAt": 1736506413299,
        "createdBy": "acme@techacct.adobe.com",
        "updatedBy": "acme@AdobeID",
        "createdClient": "{CREATED_CLIENT}",
        "updatedClient": "acme",
        "sandboxId": "{SANDBOX_ID}",
        "sandboxName": "{SANDBOX_NAME}",
        "imsOrgId": "{ORG_ID}",
        "name": "JWT Token Auth Authentication E2E-1736506322",
        "description": "Base Connection for salesforce E2E",
        "connectionSpec": {
          "id": "cfc0fee1-7dc0-40ef-b73e-d8b134c436f5",
          "version": "1.0"
        },
        "state": "enabled",
        "auth": {
          "specName": "OAuth2 JWT Token Credential",
          "params": {
            "jwtToken": "{JWT_TOKEN}",
            "clientId": "{CLIENT_ID}",
            "clientSecret": "{CLIENT_SECRET}",
            "instanceUrl": "https://adb8-dev-ed.develop.my.salesforce.com",
            "orgId": "00DdL000001iPRxUAM"
          }
        },
        "version": "\"6d27f305-40be-41c3-97d4-a701827c34df\"",
        "etag": "\"6d27f305-40be-41c3-97d4-a701827c34df\""
    }
  ]
}

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:

recommendation-more-help
experience-platform-help-sources