DocumentatieExperience PlatformGids voor Source Connectors

Een Salesforce basisverbinding maken met de Flow Service API

Last update: Tue Aug 06 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Onderwerpen:

Gemaakt voor:

  • Ontwikkelaar

Een basisverbinding vertegenwoordigt de geverifieerde verbinding tussen een bron en Adobe Experience Platform.

Dit leerprogramma begeleidt u door de stappen om een basisverbinding voor Salesforce tot stand te brengen 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.

De volgende secties bevatten aanvullende informatie die u moet weten om Platform met de API Flow Service te kunnen verbinden met een Salesforce -account.

Vereiste referenties verzamelen

De Salesforce -bron ondersteunt basisverificatie en OAuth2 Client Credential.

Basisauthentificatie

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.

OAuth 2 de Credentials van de Cliënt

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.

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.

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.

Als u een basis-verbindings-id wilt maken, vraagt u een POST naar het /connections -eindpunt en geeft u de Salesforce -verificatiegegevens op in de aanvraaginstantie.

API formaat

POST /connections

Verzoek

Basisauthentificatie

Met de volgende aanvraag wordt een basisverbinding voor Salesforce gemaakt met behulp van basisverificatie:

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 basic authentication",
      "auth": {
          "specName": "Basic Authentication",
          "params":
            "environmentUrl": "https://acme-enterprise-3126.my.salesforce.com",
            "username": "acme-salesforce",
            "password": "xxxx",
            "securityToken": "xxxx"
        }
      },
      "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
Eigenschap Beschrijving
auth.params.environmentUrl De URL van de instantie Salesforce .
auth.params.username De gebruikersnaam die aan uw Salesforce -account is gekoppeld.
auth.params.password Het wachtwoord dat aan uw Salesforce account is gekoppeld.
auth.params.securityToken Het beveiligingstoken dat aan uw Salesforce -account is gekoppeld.
connectionSpec.id The Salesforce connection specification ID: cfc0fee1-7dc0-40ef-b73e-d8b134c436f5 .
OAuth 2 de Credentials van de Cliënt

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"
        }
      },
      "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
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.
connectionSpec.id The Salesforce connection specification ID: cfc0fee1-7dc0-40ef-b73e-d8b134c436f5 .

Reactie

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

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

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
337b99bb-92fb-42ae-b6b7-c7042161d089