[Version bêta]{class="badge informative"}

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

NOTE
La source SAP Commerce est en version Beta. Pour plus d’informations sur l’utilisation de sources étiquetées bêta, consultez la présentation des sources .

Le tutoriel suivant vous guide tout au long des étapes à suivre pour créer une connexion source SAP Commerce afin d’importer des contacts SAP Subscription Billing et des 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
La valeur de clientId de la clé de service.
Secret client
La valeur de clientSecret de la clé de service.
Point de terminaison du jeton
La valeur de url de la clé de service sera similaire à https://subscriptionbilling.authentication.eu10.hana.ondemand.com.
Région
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 url est https://eu10.revenue.cloud.sap/api, vous aurez besoin de eu10.

Pour plus d'informations, consultez la SAP Commerce documentation.

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

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

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

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 de Platform, sélectionnez Sources à partir de 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.

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

Copie d’écran de l’interface utilisateur de Platform pour le catalogue avec 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.

Copie d’écran de l’interface utilisateur de Platform pour connecter un 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.

Copie d’écran de l’interface utilisateur de Platform pour connecter un 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 Platform.

Type d’objet
Description
Customers
Les entités qui ont des abonnements.
Contacts
Les coordonnées des clients.
Clients

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

Copie d’écran de l’interface utilisateur de 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.

Copie d’écran de l’interface utilisateur de 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 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

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 diffèrent selon votre schéma et le 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 customer-contacts de l’API SAP Business Partners pour récupérer les données.

Voici un exemple de configurations de mappage pour le flux de données SAP Commerce pour les 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 quand le client a été créé.
changedAt Horodatage indiquant quand le client a été mis à jour pour la dernière fois.
markets[*].country Les marchés clients, récupérés sous la forme d’un objet de tableau .
addresses[*].email Emails 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 plusieurs adresses du client, récupérées sous la forme d’un objet de tableau.
addresses[*].addressUUID Identifiants associés aux différentes adresses du client, récupérés sous la forme d’un objet de tableau.
externalObjectReferences[*].externalSystemId Données supplémentaires, récupérées sous la forme d’un objet de tableau.
externalObjectReferences[*].externalId Données supplémentaires, récupérées sous la forme d’un objet de tableau.
customReferences[*].id Données supplémentaires, récupérées sous la forme d’un objet de tableau.
customReferences[*].typeCode Données supplémentaires, récupérées sous la forme d’un objet de tableau.

L’é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 configurations de mappage pour le flux de données SAP Commerce pour les 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 Horodatage indiquant quand le contact a été créé.
changedAt Horodatage indiquant quand le contact a été mis à jour pour la dernière fois.
personalInfo.lastName Nom du contact.
personalInfo.firstName Prénom du contact.
externalObjectReferences[*].externalSystemId Données supplémentaires, récupérées sous la forme d’un objet de tableau.
externalObjectReferences[*].externalId Données supplémentaires, récupérées sous la forme d’un objet de tableau.
externalObjectReferences[*].externalIdTypeCode Données supplémentaires, récupérées sous la forme d’un objet de tableau.

L’étape de mappage du workflow des sources.

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