Créer une connexion source SAP Commerce dans l’interface utilisateur

Le tutoriel suivant vous guide tout au long des étapes de création d’une connexion source SAP Commerce pour importer les contacts SAP Facturation des abonnements et les données client à l’aide de l’interface utilisateur de Adobe Experience Platform.

Prise en main getting-started

Ce tutoriel nécessite une compréhension du fonctionnement des composants suivants d’Adobe Experience Platform :

Si vous disposez déjà d’un compte SAP Commerce, vous pouvez ignorer le reste de ce document et passer au tutoriel expliquant comment Configurer un flux de données.

Collecter les informations d’identification requises gather-credentials

Pour connecter SAP Commerce à Experience Platform, vous devez fournir des valeurs pour les propriétés de connexion suivantes :

Informations d’identification
Description
Identifiant client
Valeur de clientId à partir de la clé de service.
Secret client
Valeur de clientSecret à partir de la clé de service.
Point d’entrée du jeton
La valeur de url de la clé de service sera similaire à https://subscriptionbilling.authentication.eu10.hana.ondemand.com.
Région
L’emplacement de votre centre de données. La région est présente dans le url et a une valeur similaire à eu10 ou us10. Par exemple, si le url est https://eu10.revenue.cloud.sap/api, vous aurez besoin de eu10.

Pour plus d’informations, reportez-vous à la SAP Commerce documentation.

Création d’un schéma Experience Platform create-platform-schema

Avant de créer une connexion source SAP Commerce, vous devez également vous assurer de créer d’abord un schéma Experience Platform à utiliser pour votre source. Pour obtenir des instructions complètes sur la création d’un schéma consultez le tutoriel sur lacréation d’un schéma Experience Platform).

Développez la section suivante pour afficher un exemple de schéma.

Afficher l’exemple de schéma
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"
}

Connecter votre compte SAP Commerce connect-account

Dans l’interface utilisateur d’Experience Platform, sélectionnez Sources dans la barre de navigation de gauche pour accéder à l’espace de travail Sources. L’écran Catalogue affiche diverses sources avec lesquelles vous pouvez créer un compte.

Vous pouvez sélectionner la catégorie appropriée dans le catalogue sur le côté gauche de votre écran. Vous pouvez également trouver la source spécifique à utiliser à l’aide de l’option de recherche.

Dans la catégorie eCommerce, sélectionnez SAP Commerce, puis Ajouter des données.

Capture d’écran de l’interface utilisateur Experience Platform pour le catalogue avec la carte SAP Commerce

La page Connecter le compte SAP Commerce s’affiche. Sur cette page, vous pouvez utiliser de nouvelles informations d’identification ou des informations d’identification existantes.

Compte existant existing-account

Pour utiliser un compte existant, sélectionnez le compte SAP Commerce avec lequel vous souhaitez créer un flux de données, puis sélectionnez Suivant pour continuer.

Capture d’écran de l’interface utilisateur d’Experience Platform pour connecter le compte SAP Commerce à un compte existant

Nouveau compte new-account

Si vous créez un compte, sélectionnez Nouveau compte, puis fournissez un nom, une description facultative et vos informations d’identification. Lorsque vous avez terminé, sélectionnez Se connecter à la source puis attendez que la nouvelle connexion s’établisse.

Capture d’écran de l’interface utilisateur d’Experience Platform pour connecter le compte SAP Commerce à un nouveau compte

Sélectionner les données select-data

Enfin, vous devez sélectionner le type d’objet à ingérer dans Experience Platform.

Type d’objet
Description
Customers
Entités disposant d’abonnements.
Contacts
Coordonnées des clients.
Clients

Pour ingérer des données client, sélectionnez Clients comme type d’objet, puis sélectionnez Suivant.

Capture d’écran de l’interface utilisateur Experience Platform pour SAP Commerce montrant la configuration avec l’option Clients sélectionnée

Contacts

Pour ingérer des données de contact, sélectionnez Contacts comme type d’objet, puis sélectionnez Suivant.

Capture d’écran de l’interface utilisateur Experience Platform pour SAP Commerce montrant la configuration avec l’option Contacts sélectionnée

Étapes suivantes next-steps

En suivant ce tutoriel, vous avez établi une connexion à votre compte SAP Commerce. Vous pouvez maintenant passer au tutoriel suivant et configurer un flux de données pour importer des données dans Experience Platform.

Ressources supplémentaires additional-resources

Les sections ci-dessous fournissent des ressources supplémentaires auxquelles vous pouvez vous référer lors de l’utilisation de la source SAP Commerce.

Mappage mapping

Experience Platform fournit des recommandations intelligentes pour les champs mappés automatiquement en fonction du schéma ou du jeu de données cible que vous avez sélectionné. Vous pouvez ajuster manuellement les règles de mappage en fonction de vos cas d’utilisation. Selon vos besoins, vous pouvez choisir de mapper directement des champs ou d’utiliser des fonctions de préparation de données pour transformer les données sources afin d’obtenir des valeurs informatisées ou calculées. Pour obtenir des instructions complètes sur l’utilisation de l’interface du mappeur et des champs calculés, consultez le Guide de l’interface utilisateur de la préparation des données.

Les configurations de mappage de votre flux de données varient en fonction de votre schéma et du type d’objet que vous choisissez d’ingérer.

Clients

Pour les données client, SAP Commerce utilise les points d’entrée clients et relations client-contact de l’API SAP Business Partners pour récupérer les données

Voici un exemple de configuration de mappage pour SAP Commerce flux de données des données client :

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
Champ cible Description
customerNumber Numéro du client.
corporateInfo Numéro du client.
customerType Type de client.
createdAt Horodatage indiquant la date et l’heure de création du client.
changedAt Date et heure de la dernière mise à jour du client.
markets[*].country Les marchés clients, récupérés sous la forme d’un objet de tableau .
addresses[*].email E-mails associés aux différentes adresses du client, récupérés sous la forme d’un objet de tableau.
addresses[*].city Villes associées aux adresses multiples du client, récupérées en tant qu’objet tableau .
addresses[*].addressUUID ID associés aux adresses multiples du client, récupérés sous la forme d’un objet de tableau .
externalObjectReferences[*].externalSystemId Données supplémentaires, récupérées en tant qu’objet de tableau.
externalObjectReferences[*].externalId Données supplémentaires, récupérées en tant qu’objet de tableau.
customReferences[*].id Données supplémentaires, récupérées en tant qu’objet de tableau.
customReferences[*].typeCode Données supplémentaires, récupérées en tant qu’objet de tableau.

Étape de mappage du workflow des sources.

Contacts

Pour les données de contact, SAP Commerce utilise le point d’entrée contacts de l’API SAP Business Partners pour récupérer les données.

Voici un exemple de configuration de mappage pour SAP Commerce flux de données des données de contact :

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
Champ cible Description
contactNumber Numéro du contact.
createdAt Date et heure de création du contact.
changedAt Date et heure de la dernière mise à jour du contact.
personalInfo.lastName Nom du contact.
personalInfo.firstName Prénom du contact.
externalObjectReferences[*].externalSystemId Données supplémentaires, récupérées en tant qu’objet de tableau.
externalObjectReferences[*].externalId Données supplémentaires, récupérées en tant qu’objet de tableau.
externalObjectReferences[*].externalIdTypeCode Données supplémentaires, récupérées en tant qu’objet de tableau.

Étape de mappage du workflow des sources.

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