Envoyer votre source
La dernière étape de l’intégration de votre nouvelle source à Adobe Experience Platform à l’aide de sources en libre-service (SDK par lots) consiste à tester votre source pour vérification. Une fois l’opération terminée, vous pouvez envoyer votre nouvelle source en contactant votre représentant Adobe.
Le document suivant décrit les étapes à suivre pour tester et déboguer votre source à l’aide du Flow Service API.
Prise en main
- Pour plus d’informations sur la manière d’effectuer des appels vers les API Platform, consultez le guide Prise en main des API Platform.
- Pour plus d’informations sur la génération de vos informations d’identification pour les API Platform, consultez le tutoriel sur authentification et accès aux API Experience Platform.
- Pour plus d’informations sur la configuration Postman pour les API Platform, consultez le tutoriel sur configuration de Developer Console et Postman.
- Pour faciliter le processus de test et de débogage, téléchargez la Collecte et environnement de vérification des sources en libre-service ici et suivez les étapes décrites ci-dessous.
Test de votre source
Pour tester votre source, vous devez exécuter la variable Collecte et environnement de vérification des sources en libre-service on Postman tout en fournissant les variables d’environnement appropriées qui se rapportent à votre source.
Pour commencer le test, vous devez d’abord configurer la collection et l’environnement sur Postman. Indiquez ensuite l’identifiant de spécification de connexion que vous souhaitez tester.
Spécifiez les authSpecName
Une fois que vous avez saisi votre identifiant de spécification de connexion, vous devez alors spécifier la variable authSpecName
que vous utilisez pour votre connexion de base. Selon votre choix, il peut s’agir de OAuth 2 Refresh Code
ou Basic Authentication
. Une fois que vous avez spécifié votre authSpecName
, vous devez ensuite inclure les informations d’identification requises dans votre environnement. Par exemple, si vous spécifiez authSpecName
as OAuth 2 Refresh Code
, vous devez ensuite fournir les informations d’identification requises pour OAuth 2, qui sont host
et accessToken
.
Spécifiez les sourceSpec
Une fois vos paramètres de spécification d’authentification ajoutés, vous devez ajouter les propriétés requises de votre spécification source. Vous trouverez les propriétés requises dans sourceSpec.spec.properties
. Dans le cas de la fonction MailChimp Members exemple ci-dessous, la seule propriété requise est listId
, ce qui signifie listId
et qu’il s’agit de la valeur d’identifiant correspondante à votre Postman environnement.
"spec": {
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"description": "Define user input parameters to fetch resource values.",
"properties": {
"listId": {
"type": "string",
"description": "listId for which members need to fetch."
}
}
}
Une fois les paramètres d’authentification et de spécification source fournis, vous pouvez commencer à renseigner le reste des variables d’environnement. Voir le tableau ci-dessous à titre de référence :
flowSpecificationId
et targetConnectionSpecId
, qui sont des valeurs fixes.x-api-key
x-api-key
.c8d9a2f5c1e03789bd22e8efdd1bdc1b
x-gw-ims-org-id
x-gw-ims-org-id
informations.ABCEH0D9KX6A7WA7ATQE0TE@adobeOrg
authorizationToken
authorizationToken
.Bearer authorizationToken
schemaId
https://ns.adobe.com/{TENANT_ID}.schemas.0ef4ce0d390f0809fad490802f53d30b
schemaVersion
application/vnd.adobe.xed-full-notext+json; version=1
schemaAltId
meta:altId
qui est renvoyé avec le schemaId
lors de la création d’un nouveau schéma._{TENANT_ID}.schemas.0ef4ce0d390f0809fad490802f53d30b
dataSetId
5f3c3cedb2805c194ff0b69a
mappings
[{"destinationXdmPath":"person.name.firstName","sourceAttribute":"email.email_id","identity":false,"version":0},{"destinationXdmPath":"person.name.lastName","sourceAttribute":"email.activity.action","identity":false,"version":0}]
mappingId
bf5286a9c1ad4266baca76ba3adc9366
connectionSpecId
2e8580db-6489-4726-96de-e33f5f60295f
flowSpecificationId
RestStorageToAEP
. Il s’agit d’une valeur fixe.6499120c-0b15-42dc-936e-847ea3c24d72
targetConnectionSpecId
c604ff05-7f1a-43c0-8e18-33bf874cb11c
verifyWatTimeInSecond
40
startTime
1597784298
Une fois que vous avez fourni toutes vos variables d’environnement, vous pouvez commencer à exécuter la collection à l’aide de la variable Postman . Dans le Postman , sélectionnez les ellipses (…) en regard de Sources SSSs Verification Collection puis sélectionnez Exécution de la collection.
Le Runner s’affiche, ce qui vous permet de configurer l’ordre d’exécution de votre flux de données. Sélectionner Exécution de la collection de vérification SSS pour exécuter la collection.
Envoyer votre source
Une fois que votre source a pu terminer l’ensemble du workflow, vous pouvez contacter votre représentant d’Adobe et envoyer votre source pour l’intégration.