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.
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.
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.
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.
{
"_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"
}
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.
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.
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.
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.
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. |
Pour ingérer des données client, sélectionnez Clients comme type d’objet, puis sélectionnez Suivant.
Pour ingérer les données de contact, sélectionnez Contacts comme type d’objet, puis sélectionnez Suivant.
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.
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.
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.
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 :
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. |
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 :
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. |