Beta

Een bronverbinding en gegevensstroom maken voor SAP Commerce met de Flow Service API

Laatst bijgewerkt: 14 januari 2025
  • Onderwerpen:

Gemaakt voor:

  • Ontwikkelaar
NOTE
De bron SAP Commerce is in bèta. Zie het overzicht van bronnenvoor meer informatie bij het gebruiken van bèta-geëtiketteerde bronnen.

Het volgende leerprogramma begeleidt u door de stappen om een SAP Commerce bronverbinding en een dataflow tot stand te brengen om SAP het Factureren van het Abonnementcontacten en klantengegevens te brengen aan Adobe Experience Platform gebruikend Flow Service API.

Aan de slag

Deze handleiding vereist een goed begrip van de volgende onderdelen van het 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 de diensten van het Platform.
  • Sandboxes: Experience Platform verstrekt virtuele zandbakken die één enkele instantie van het Platform in afzonderlijke virtuele milieu's verdelen helpen digitale ervaringstoepassingen ontwikkelen en ontwikkelen.

In de volgende secties vindt u aanvullende informatie die u moet weten voordat u verbinding kunt maken met SAP Commerce via de Flow Service API.

Vereiste referenties verzamelen

Als u SAP Commerce wilt verbinden met een Experience Platform, moet u waarden opgeven voor de volgende verbindingseigenschappen:

CredentialsBeschrijving
clientIdDe waarde van clientId in de servicetoets.
clientSecretDe waarde van clientSecret in de servicetoets.
tokenEndpointDe waarde van url in de servicesleutel komt overeen met https://subscriptionbilling.authentication.eu10.hana.ondemand.com .
regionDe locatie van uw datacenter. Het gebied is aanwezig in de url en heeft een waarde vergelijkbaar met eu10 of us10 . Als de waarde url bijvoorbeeld https://subscriptionbilling.authentication.eu10.hana.ondemand.com is, hebt u eu10 nodig.

Voor meer informatie over deze geloofsbrieven, gelieve te verwijzen naar de SAP Commerce documentatie.

Verbinding maken SAP Commerce met platform met behulp van de Flow Service API

In het volgende voorbeeld worden de stappen beschreven die u moet uitvoeren om de SAP Commerce -bron te verifiëren, een bronverbinding te maken en een gegevensstroom te maken om uw accounts en contactgegevens naar het Experience Platform te brengen.

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 SAP Commerce -verificatiegegevens op als onderdeel van de aanvraaginstantie.

API formaat

POST /connections

Verzoek

Met de volgende aanvraag wordt een basisverbinding voor SAP Commerce gemaakt:

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": "SAP Commerce base connection",
      "description": "Authenticated base connection for SAP Commerce",
      "connectionSpec": {
          "id": "d8ee38de-7ae9-4058-9610-c79ce75f8e92",
          "version": "1.0"
      },
      "auth": {
          "specName": "OAuth2 Client Credential",
          "params": {
              "region": "{REGION}",
              "clientId": "{CLIENT_ID}",
              "clientSecret": "{CLIENT_SECRET}"
              "tokenEndpoint": "{TOKEN_ENDPOINT}"
          }
      }
  }'
EigenschapBeschrijving
nameDe naam van uw basisverbinding. Zorg ervoor dat de naam van uw basisverbinding beschrijvend is aangezien u dit kunt gebruiken om op informatie over uw basisverbinding te zoeken.
descriptionEen optionele waarde die u kunt opnemen voor meer informatie over uw basisverbinding.
connectionSpec.idDe verbindingsspecificatie-id van uw bron. Deze id kan worden opgehaald nadat de bron is geregistreerd en goedgekeurd via de API van Flow Service .
auth.specNameHet verificatietype dat u gebruikt om uw bron te verifiëren bij Platform.
auth.params.regionDe locatie van uw datacenter. Het gebied is aanwezig in de url en heeft een waarde vergelijkbaar met eu10 of us10 . Als de waarde url bijvoorbeeld https://subscriptionbilling.authentication.eu10.hana.ondemand.com is, hebt u eu10 nodig.
auth.params.clientIdDe waarde van clientId in de servicetoets.
auth.params.clientSecretDe waarde van clientSecret in de servicetoets.
auth.params.tokenEndpointDe waarde van url in de servicesleutel komt overeen met https://subscriptionbilling.authentication.eu10.hana.ondemand.com .

Reactie

Een succesvolle reactie keert de pas gecreëerde basisverbinding, met inbegrip van zijn unieke verbindings herkenningsteken (id) terug. Deze id is vereist om de bestandsstructuur en inhoud van uw bron in de volgende stap te verkennen.

{
     "id": "5f6d6022-3f64-400c-ba01-d4010de2d8ff",
     "etag": "\"f8018de1-0000-0200-0000-6482d7210000\""
}