[Version Beta]{class="badge informative"}

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

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

Le tutoriel suivant décrit les étapes à suivre pour créer un SAP Commerce connexion source à apporter SAP Facturation d’abonnement contacts et 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 vous connecter SAP Commerce pour 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 à partir de la clé de service.
Secret client
La valeur de clientSecret à partir de la clé de service.
Point de terminaison du jeton
La valeur de url à partir de la clé de service, la variable https://subscriptionbilling.authentication.eu10.hana.ondemand.com.
Région
Emplacement de votre centre de données. La région est présente dans la variable url et a une valeur similaire à eu10 ou us10. Par exemple, si la variable url is https://eu10.revenue.cloud.sap/api vous aurez besoin de eu10.

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

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

Avant de créer un SAP Commerce connexion source, vous devez également vous assurer de créer au préalable un schéma Experience Platform à utiliser pour votre source. Voir le tutoriel sur création d’un schéma Platform 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 , eCommerce catégorie, sélectionnez SAP Commerce, puis sélectionnez Ajouter des données.

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

La variable Connexion au 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.

Capture 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 Clients comme type d’objet, puis sélectionnez Suivant.

Capture 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 les 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 contiennent des ressources supplémentaires auxquelles vous pouvez vous référer lors de l’utilisation de la variable SAP Commerce source.

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, voir la section Guide de l’interface utilisateur de la préparation de 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 la variable clients et la variable relations client-contact points de fin de la variable SAP Business Partners API pour récupérer les données

Voici un exemple de configurations de mappage pour SAP Commerce flux de données 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 la variable contacts point d’entrée du SAP Business Partners API pour récupérer les données.

Voici un exemple de configurations de mappage pour SAP Commerce flux de données 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