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 de l’ Flow Service API.
Commencer
- 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 l’ authentification et accès aux API Experience Platform.
- Pour plus d’informations sur la configuration de Postman pour les API Platform, consultez le tutoriel sur la configuration de la console de développement et Postman.
- Pour faciliter le processus de test et de débogage, téléchargez la collecte de vérification des sources en libre-service et l’environnement ici et suivez les étapes décrites ci-dessous.
Test de votre source
Pour tester votre source, vous devez exécuter la collecte et environnement de vérification des sources en libre-service sur Postman tout en fournissant les variables d’environnement appropriées relatives à votre source.
Pour commencer les tests, 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écifier authSpecName
Une fois que vous avez saisi l’identifiant de spécification de connexion, vous devez spécifier le authSpecName
que vous utilisez pour votre connexion de base. Selon votre choix, il peut s’agir de OAuth 2 Refresh Code
ou de Basic Authentication
. Une fois que vous avez spécifié votre authSpecName
, vous devez inclure ses informations d’identification requises dans votre environnement. Par exemple, si vous spécifiez authSpecName
comme OAuth 2 Refresh Code
, vous devez fournir les informations d’identification requises pour OAuth 2, qui sont host
et accessToken
.
Spécifier 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 l’exemple MailChimp Members ci-dessous, la seule propriété requise est listId
, ce qui signifie listId
et sa valeur d’identifiant correspondante à votre environnement Postman.
"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
, consultez le tutoriel sur l’ authentification et accès aux API Experience Platform .c8d9a2f5c1e03789bd22e8efdd1bdc1b
x-gw-ims-org-id
x-gw-ims-org-id
.ABCEH0D9KX6A7WA7ATQE0TE@adobeOrg
authorizationToken
authorizationToken
, consultez le tutoriel sur l’ authentification et accès aux API Experience Platform .Bearer authorizationToken
schemaId
https://ns.adobe.com/{TENANT_ID}.schemas.0ef4ce0d390f0809fad490802f53d30b
schemaVersion
application/vnd.adobe.xed-full-notext+json; version=1
schemaAltId
meta:altId
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 l’interface Postman. Dans l’interface Postman, sélectionnez les ellipses (…) en regard de Sources SSSs Verification Collection, puis sélectionnez Exécuter la collection.
L’interface Runner s’affiche, vous permettant de configurer l’ordre d’exécution de votre flux de données. Sélectionnez Exécuter 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.