[Beta]{class="badge informative"}

Erstellen eines Quell-Connectors für SAP Commerce in der Benutzeroberfläche

NOTE
Die SAP Commerce-Quelle befindet sich in der Beta-Phase. Weitere Informationen zur Verwendung von Betagekennzeichneten Quellen finden Sie„Quellen - Übersicht“ .

Das folgende Tutorial führt Sie durch die Schritte zum Erstellen einer SAP Commerce Quellverbindung, um SAP Abonnementabrechnung“, KontakteKundendaten über die Benutzeroberfläche von Adobe Experience Platform zu übertragen.

Erste Schritte getting-started

Dieses Tutorial setzt ein Grundverständnis der folgenden Komponenten von Experience Platform voraus:

  • Experience Data Model (XDM) System: Das standardisierte Framework, mit dem Experience Platform Kundenerlebnisdaten organisiert.

    • Grundlagen der Schemakomposition: Machen Sie sich mit den grundlegenden Bausteinen von XDM-Schemata vertraut, einschließlich der wichtigsten Prinzipien und Best Practices bei der Schemaerstellung.
    • Tutorial zum Schema-Editor: Erfahren Sie, wie Sie benutzerdefinierte Schemata mithilfe der Benutzeroberfläche des Schema-Editors erstellen können.
  • Real-Time Customer Profile: Bietet ein einheitliches Echtzeit-Kundenprofil, das auf aggregierten Daten aus verschiedenen Quellen basiert.

Wenn Sie bereits über ein gültiges SAP Commerce-Konto verfügen, können Sie den Rest dieses Dokuments überspringen und mit dem Tutorial zum Konfigurieren eines Datenflusses fortfahren.

Sammeln erforderlicher Anmeldedaten gather-credentials

Um SAP Commerce mit Experience Platform zu verbinden, müssen Sie Werte für die folgenden Verbindungseigenschaften angeben:

Anmeldedaten
Beschreibung
Client-ID
Der Wert von clientId aus dem Service-Schlüssel.
Client-Geheimnis
Der Wert von clientSecret aus dem Service-Schlüssel.
Token-Endpunkt
Der Wert von url aus dem Service-Schlüssel ähnelt https://subscriptionbilling.authentication.eu10.hana.ondemand.com.
Region
Ihr Rechenzentrumsstandort. Die Region befindet sich in der url und hat einen ähnlichen Wert wie eu10 oder us10. Wenn der url beispielsweise https://eu10.revenue.cloud.sap/api ist, benötigen Sie eu10.

Weitere Informationen finden Sie in der SAP Commerce Dokumentation.

Erstellen eines Platform-Schemas create-platform-schema

Bevor Sie eine SAP Commerce Quellverbindung erstellen, müssen Sie auch sicherstellen, dass Sie zunächst ein Experience Platform-Schema für Ihre Quelle erstellen. Eine ausführliche Anleitung zum Erstellen Schemas finden SieTutorial zum Erstellen eines Platform Schemas .

Erweitern Sie den folgenden Abschnitt, um ein Beispielschema anzuzeigen.

Beispiel für ein Schema anzeigen
code language-none
{
  "_extconndev": {
    "addresses": [
      {
        "addressUUID": "{ADDRESS_UUID}",
        "city": "Burnaby",
        "country": "Canada",
        "email": "chandni@acme.com",
        "houseNumber": "27",
        "isDefault": false,
        "phone": "123-456-7890",
        "postalCode": "V3J 1X9",
        "state": "British Columbia",
        "street": "Beresford"
      }
    ],
    "changedAt": "1687204041",
    "changedBy": "vero@acme.com",
    "contactNumber": "123-456-7980",
    "corporateInfo": {
      "company": "acme"
    },
    "createAt": "1687204041",
    "createdBy": "vero@acme.com",
    "customReferences": [
      {
        "id": "Sample value",
        "typeCode": "Sample value"
      }
    ],
    "customerNumber": "Sample value",
    "customerType": "Sample value",
    "defaultAddress": {
      "addressUUID": "Sample value",
      "city": "North Vancouver",
      "country": "Canada",
      "email": "chandni@acme.come",
      "houseNumber": "34",
      "isDefault": false,
      "phone": "123-456-7890",
      "postalCode": "V7H 2P1",
      "state": "British Columbia",
      "street": "Maple"
    },
    "externalObjectReferences": [
      {
        "externalId": "{EXTERNAL_ID}",
        "externalIdTypeCode": "{EXTERNAL_ID_TYPE_CODE}",
        "externalSystemId": "{EXTERNAL_SYSTEM_ID}"
      }
    ],
    "markets": [
      {
        "active": false,
        "country": "USA",
        "currency": "USD",
        "marketId": "Sample value",
        "priceinfo": {
          "incoterms": "{INCO_TERMS}",
          "incotermsLocation": "{INCO_TERMS_LOCATION}",
          "priceGroup": "{PRICE_GROUP}",
          "priceListType": "{PRICE_LIST_TYPE}"
        },
        "salesArea": {
          "distributionChannel": "{DISTRIBUTION_CHANNEL}",
          "division": "{DIVISION}",
          "salesOrganization": "{SALES_ORGANIZATION}"
        }
      }
    ],
    "personalInfo": {
      "firstName": "Chandni",
      "lastName": "Kaur"
    }
  },
  "_id": "/uri-reference",
  "_repo": {
    "createDate": "2004-10-23T12:00:00-06:00",
    "modifyDate": "2004-10-23T12:00:00-06:00"
  },
  "createdByBatchID": "/uri-reference",
  "modifiedByBatchID": "/uri-reference",
  "personID": "{PERSON_ID}",
  "repositoryCreatedBy": "kevin@acme.com",
  "repositoryLastModifiedBy": "kevin@acme.com"
}

Verbinden Ihres SAP Commerce-Kontos connect-account

Wählen Sie in der Platform-Benutzeroberfläche die Option Quellen in der linken Navigationsleiste, um auf den Arbeitsbereich Quellen zuzugreifen. Die Katalog zeigt eine Vielzahl von Quellen an, mit denen Sie ein Konto erstellen können.

Sie können die gewünschte Kategorie aus dem Katalog auf der linken Bildschirmseite auswählen. Alternativ können Sie die gewünschte Quelle mithilfe der Suchoption finden.

Wählen Sie unter eCommerce-Kategorie die Option SAP Commerce und dann Daten hinzufügen.

Screenshot der Platform-Benutzeroberfläche für den Katalog mit der SAP Commerce-Karte

Die Verbinden des SAP Commerce-Kontos wird angezeigt. Auf dieser Seite können Sie entweder neue oder vorhandene Anmeldedaten verwenden.

Vorhandenes Konto existing-account

Um ein vorhandenes Konto zu verwenden, wählen Sie das SAP Commerce-Konto, mit dem Sie einen neuen Datenfluss erstellen möchten, und klicken Sie dann auf Weiter, um fortzufahren.

Screenshot der Platform-Benutzeroberfläche zum Verbinden des SAP Commerce-Kontos mit einem bestehenden Konto

Neues Konto new-account

Wenn Sie ein neues Konto erstellen, wählen Sie Neues Konto und geben Sie dann einen Namen, eine optionale Beschreibung und Ihre -Anmeldeinformationen an. Wenn Sie fertig sind, wählen Sie Mit Quelle verbinden und warten Sie, bis die neue Verbindung hergestellt ist.

Screenshot der Platform-Benutzeroberfläche zur Verbindung des SAP Commerce-Kontos mit einem neuen Konto

Daten auswählen select-data

Schließlich müssen Sie den Objekttyp auswählen, den Sie in Platform aufnehmen möchten.

Objekttyp
Beschreibung
Customers
Die Entitäten, die Abonnements haben.
Contacts
Die Kontaktdaten für Kunden.
Kunden

Um Kundendaten aufzunehmen, wählen Sie Kunden als Objekttyp aus und klicken Sie dann auf Weiter.

Screenshot der Platform-Benutzeroberfläche für SAP Commerce mit Konfiguration mit ausgewählter Option „Kunden“

Kontakte

Um Kontaktdaten aufzunehmen, wählen Sie Kontakte als Objekttyp aus und klicken Sie dann auf Weiter.

Screenshot der Platform-Benutzeroberfläche für SAP Commerce mit Konfiguration mit ausgewählter Option „Kontakte“

Nächste Schritte next-steps

Mithilfe dieses Tutorials haben Sie eine Verbindung zu Ihrem SAP Commerce-Konto hergestellt. Sie können jetzt mit dem nächsten Tutorial fortfahren und einen Datenfluss konfigurieren, um Daten in Platform zu importieren.

Zusätzliche Ressourcen additional-resources

Die folgenden Abschnitte enthalten zusätzliche Ressourcen, auf die Sie bei Verwendung der SAP Commerce verweisen können.

Zuordnung mapping

Platform bietet intelligente Empfehlungen für automatisch zugeordnete Felder, die auf dem von Ihnen ausgewählten Zielschema oder Datensatz basieren. Sie können die Zuordnungsregeln manuell an Ihre Anwendungsfälle anpassen. Je nach Bedarf können Sie wahlweise Felder direkt zuordnen oder mithilfe von Datenvorbereitungsfunktionen Quelldaten transformieren, um berechnete oder anderweitig ermittelte Werte abzuleiten. Eine ausführliche Anleitung zur Verwendung der Zuordnungsschnittstelle und berechneter Felder finden Sie im Handbuch zur Datenvorbereitungs-Benutzeroberfläche.

Die Zuordnungskonfigurationen für Ihren Datenfluss unterscheiden sich je nach Schema und Objekttyp, den Sie aufnehmen möchten.

Kunden

Für Kundendaten verwendet SAP Commerce die Endpunkte Kunden und der Beziehungen zwischen Kunden und) der SAP Business Partners-API, um die Daten abzurufen

Im Folgenden finden Sie ein Beispiel für Zuordnungskonfigurationen für SAP Commerce Datenfluss für Kundendaten:

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 12-row-2 13-row-2
Zielfeld Beschreibung
customerNumber Die Kundennummer.
corporateInfo Die Kundennummer.
customerType Der Kundentyp.
createdAt Ein Zeitstempel, der angibt, wann der Kunde erstellt wurde.
changedAt Ein Zeitstempel, der angibt, wann der Kunde zuletzt aktualisiert wurde.
markets[*].country Die Kunden vermarkten als Array-Objekt abgerufen.
addresses[*].email E-Mails, die mit den mehreren Adressen des Kunden verknüpft sind und als Array-Objekt abgerufen werden.
addresses[*].city Städte, die mit den mehreren Adressen des Kunden verknüpft sind und als Array-Objekt abgerufen werden.
addresses[*].addressUUID IDs, die mit den mehreren Adressen des Kunden verknüpft sind und als Array-Objekt abgerufen werden.
externalObjectReferences[*].externalSystemId Zusätzliche Daten, als Array-Objekt abgerufen.
externalObjectReferences[*].externalId Zusätzliche Daten, als Array-Objekt abgerufen.
customReferences[*].id Zusätzliche Daten, als Array-Objekt abgerufen.
customReferences[*].typeCode Zusätzliche Daten, als Array-Objekt abgerufen.

Der Zuordnungsschritt des Quell-Workflows.

Kontakte

Für Kontaktdaten verwendet SAP Commerce den Endpunkt Kontakte der SAP Business Partners-API, um die Daten abzurufen.

Im Folgenden finden Sie ein Beispiel für Zuordnungskonfigurationen für SAP Commerce Datenfluss für Kontaktdaten:

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2
Zielfeld Beschreibung
contactNumber Die Nummer des Kontakts.
createdAt Ein Zeitstempel, der angibt, wann der Kontakt erstellt wurde.
changedAt Ein Zeitstempel, der angibt, wann der Kontakt zuletzt aktualisiert wurde.
personalInfo.lastName Der Nachname des Kontakts.
personalInfo.firstName Der Vorname des Kontakts.
externalObjectReferences[*].externalSystemId Zusätzliche Daten, als Array-Objekt abgerufen.
externalObjectReferences[*].externalId Zusätzliche Daten, als Array-Objekt abgerufen.
externalObjectReferences[*].externalIdTypeCode Zusätzliche Daten, als Array-Objekt abgerufen.

Der Zuordnungsschritt des Quell-Workflows.

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089