[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 Beta-beschrifteten Quellen finden Sie in der Quellenübersicht .

Das folgende Tutorial führt Sie durch die Schritte zum Erstellen einer Quellverbindung mit SAP Commerce, um SAP Abonnementabrechnung -Kontakte und Kundendaten über die Adobe Experience Platform-Benutzeroberfläche zu importieren.

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 Anmeldeinformationen 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 Dienstschlüssel.
Client-Geheimnis
Der Wert von clientSecret aus dem Dienstschlüssel.
Token-Endpunkt
Der Wert von url aus dem Dienstschlüssel ist ähnlich wie https://subscriptionbilling.authentication.eu10.hana.ondemand.com.
Region
Ihr Rechenzentrumsstandort. Der Bereich ist im url vorhanden und hat einen Wert ähnlich dem Wert 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 außerdem sicherstellen, dass Sie zunächst ein Experience Platform-Schema erstellen, das für Ihre Quelle verwendet werden soll. Umfassende Schritte zum Erstellen eines Schemas finden Sie im Tutorial zum Erstellen eines Platform-Schemas🔗 .

Erweitern Sie den folgenden Abschnitt, um ein Beispielschema anzuzeigen.

Schema-Beispiel 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 der Kategorie eCommerce die Option SAP Commerce und dann Daten hinzufügen aus.

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

Die Seite SAP Commerce-Konto verbinden 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 vorhandenen 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 ein. Wenn Sie fertig sind, wählen Sie Mit Quelle verbinden und warten Sie, bis die neue Verbindung hergestellt ist.

Bildschirm der Platform-Benutzeroberfläche zum Verbinden des SAP Commerce-Kontos mit einem neuen Konto

Daten auswählen select-data

Schließlich müssen Sie den Objekttyp auswählen, den Sie für Platform erfassen möchten.

Objekttyp
Beschreibung
Customers
Die Entitäten mit Abonnements.
Contacts
Die Kontaktdaten für Kunden.
Customers

Um Kundendaten zu erfassen, wählen Sie Kunden als Objekttyp und dann Weiter aus.

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

Contacts

Um Kontaktdaten zu erfassen, wählen Sie Kontakte als Objekttyp und dann Weiter aus.

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

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-Quelle verweisen können.

Zuordnung mapping

Platform bietet intelligente Empfehlungen für automatisch zugeordnete Felder, die auf dem 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. Umfassende Schritte zur Verwendung der Zuordnungsoberfläche und der berechneten Felder finden Sie im Handbuch Data Prep UI guide.

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

Customers

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

Im Folgenden finden Sie ein Beispiel für die Zuordnungskonfigurationen für den 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, werden als Array-Objekt abgerufen.
addresses[*].email E-Mails, die mit mehreren Adressen des Kunden verknüpft sind und als Array-Objekt abgerufen werden.
addresses[*].city Städte, die mit mehreren Adressen des Kunden verknüpft sind und als Array-Objekt abgerufen werden.
addresses[*].addressUUID IDs, die mit mehreren Adressen des Kunden verknüpft sind und als Array-Objekt abgerufen werden.
externalObjectReferences[*].externalSystemId Zusätzliche Daten, die als Array-Objekt abgerufen werden.
externalObjectReferences[*].externalId Zusätzliche Daten, die als Array-Objekt abgerufen werden.
customReferences[*].id Zusätzliche Daten, die als Array-Objekt abgerufen werden.
customReferences[*].typeCode Zusätzliche Daten, die als Array-Objekt abgerufen werden.

Der Zuordnungsschritt des Ursprungs-Workflows.

Contacts

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

Im Folgenden finden Sie ein Beispiel für Zuordnungskonfigurationen für den 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 Nachname des Kontakts.
personalInfo.firstName Vorname des Kontakts.
externalObjectReferences[*].externalSystemId Zusätzliche Daten, die als Array-Objekt abgerufen werden.
externalObjectReferences[*].externalId Zusätzliche Daten, die als Array-Objekt abgerufen werden.
externalObjectReferences[*].externalIdTypeCode Zusätzliche Daten, die als Array-Objekt abgerufen werden.

Der Zuordnungsschritt des Ursprungs-Workflows.

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