Créer des brouillons de vos entités Flow Service à l’aide de l’API
Utilisez le paramètre de requête mode=draft
dans l’API Flow Servicepour définir vos entités Flow Service telles que vos connexions de base, connexions source, connexions cible et flux de données au statut brouillon.
Les brouillons peuvent être mises à jour plus tard avec de nouvelles informations, puis publiés une fois qu’ils sont prêts, à l’aide du paramètre de requête op=publish
.
Ce tutoriel décrit les étapes à suivre pour définir vos entités Flow Service au statut brouillon. Vous pouvez ainsi suspendre et enregistrer vos workflows en vue de les poursuivre plus tard.
Prise en main
Ce tutoriel nécessite une compréhension du fonctionnement des composants suivants d’Adobe Experience Platform :
- Sources : Experience Platform permet d’ingérer des données provenant de diverses sources tout en vous offrant la possibilité de structurer, de libeller et d’améliorer les données entrantes à l’aide des services de Platform.
- Sandbox : Experience Platform fournit des sandbox virtuels qui divisent une instance de plateforme unique en environnements virtuels distincts pour favoriser le développement et l’évolution d’applications d’expérience digitale.
Utiliser les API Platform
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.
Vérifier la prise en charge du mode brouillon
Vous devez également vérifier si l’identifiant de spécification de connexion et l’identifiant de spécification de flux correspondant de la source que vous utilisez sont activés pour le mode brouillon.
accordion | ||
---|---|---|
Requête | ||
La requête suivante récupère les informations sur la spécification de connexion pour Azure File Storage :
|
accordion | ||
---|---|---|
Réponse | ||
Une réponse réussie renvoie les informations sur la spécification de connexion de votre source. Pour vérifier si le mode brouillon est pris en charge pour votre source, assurez-vous que le paramètre
|
accordion | ||
---|---|---|
Requête | ||
La requête suivante récupère les détails de spécification de flux pour une source d’espace de stockage :
|
accordion | ||
---|---|---|
Réponse | ||
Une réponse réussie renvoie les informations de spécification de flux pour votre source. Pour vérifier si le mode brouillon est pris en charge pour votre source, assurez-vous que le paramètre
|
Créer un brouillon de connexion de base create-a-draft-base-connection
Pour créer un brouillon de connexion de base, envoyez une requête POST au point d’entrée /connections
de l’API Flow Service et indiquez mode=draft
comme paramètre de requête.
Format d’API
POST /connections?mode=draft
mode
mode
sur draft
.Requête
La requête suivante crée un brouillon de connexion de base pour la source Azure File Storage :
curl -X POST \
'https://platform.adobe.io/data/foundation/flowservice/connections?mode=draft' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'Content-Type: application/json' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-d '{
"name": "ACME Azure File Storage Base Connection",
"description": "Azure File Storage base connection for ACME data (DRAFT)",
"auth": {
"specName": "Basic Authentication",
"params": {
"host": "{HOST}",
"userId": "{USER_ID}",
"password": "{PASSWORD}"
}
},
"connectionSpec": {
"id": "be5ec48c-5b78-49d5-b8fa-7c89ec4569b8",
"version": "1.0"
}
}'
Réponse
Une réponse réussie renvoie l’identifiant de connexion de base et l’etag correspondant à votre brouillon de connexion de base. Vous pouvez utiliser cet identifiant plus tard pour mettre à jour et publier votre connexion de base.
{
"id": "f9377f50-607a-4818-b77f-50607a181860",
"etag": "\"2f0276fa-0000-0200-0000-5eab3abb0000\""
}
Publier votre brouillon de connexion de base publish-your-draft-base-connection
Une fois que votre brouillon est prêt à être publié, envoyez une requête POST au point d’entrée /connections
et indiquez l’identifiant du brouillon de connexion de base que vous souhaitez publier, ainsi qu’une opération d’action pour la publication.
Format d’API
POST /connections/{BASE_CONNECTION_ID}/action?op=publish
op
op
sur publish
.Requête
La requête suivante publie le brouillon de connexion de base pour Azure File Storage, qui a été créé lors d’une étape précédente.
curl -X POST \
'https://platform.adobe.io/data/foundation/flowservice/connections/f9377f50-607a-4818-b77f-50607a181860/action?op=publish' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'Content-Type: application/json' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
Réponse
Une réponse réussie renvoie l’identifiant et l’etag correspondant à votre connexion de base publiée.
{
"id": "f9377f50-607a-4818-b77f-50607a181860",
"etag": "\"2f0276fa-0000-0200-0000-5eab3abb0000\""
}
Créer un brouillon de connexion source create-a-draft-source-connection
Pour créer un brouillon de connexion source, envoyez une requête POST au point d’entrée /sourceConnections
de l’API Flow Service et indiquez mode=draft
comme paramètre de requête.
Format d’API
POST /sourceConnections?mode=draft
mode
mode
sur draft
.Requête
curl -X POST \
'https://platform.adobe.io/data/foundation/flowservice/sourceConnections?mode=draft' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'Content-Type: application/json' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-d '{
"name": "ACME Azure File Storage Source Connection",
"description: "Azure File Storage source connection for ACME data (DRAFT)",
"baseConnectionId": "f9377f50-607a-4818-b77f-50607a181860",
"data": {
"format": "delimited",
},
"params": {
"path": "/acme/summerCampaign/account.csv",
"type": "file"
},
"connectionSpec": {
"id": "be5ec48c-5b78-49d5-b8fa-7c89ec4569b8",
"version": "1.0"
}
}'
Réponse
Une réponse réussie renvoie l’identifiant de connexion source et l’etag correspondant à votre brouillon de connexion source. Vous pouvez utiliser cet identifiant plus tard pour mettre à jour et publier votre connexion source.
{
"id": "26b53912-1005-49f0-b539-12100559f0e2",
"etag": "\"11004d97-0000-0200-0000-5f3c3b140000\""
}
Publier votre brouillon de connexion source publish-your-draft-source-connection
Une fois que votre brouillon est prêt à être publié, envoyez une requête POST au point d’entrée /sourceConnections
et indiquez l’identifiant du brouillon de la connexion source que vous souhaitez publier, ainsi qu’une opération d’action pour la publication.
Format d’API
POST /sourceConnections/{SOURCE_CONNECTION_ID}/action?op=publish
op
op
sur publish
.Requête
La requête suivante publie le brouillon de la connexion source pour Azure File Storage, créé lors d’une étape précédente.
curl -X POST \
'https://platform.adobe.io/data/foundation/flowservice/connections/26b53912-1005-49f0-b539-12100559f0e2/action?op=publish' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'Content-Type: application/json' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
Réponse
Une réponse réussie renvoie l’identifiant et l’etag correspondant à votre connexion source publiée.
{
"id": "26b53912-1005-49f0-b539-12100559f0e2",
"etag": "\"11004d97-0000-0200-0000-5f3c3b140000\""
}
Créer un brouillon de connexion cible create-a-draft-target-connection
Pour créer un brouillon de connexion cible, envoyez une requête POST au point d’entrée /targetConnections
de l’API Flow Service et indiquez mode=draft
comme paramètre de requête.
Format d’API
POST /targetConnections?mode=draft
mode
mode
sur draft
.Requête
curl -X POST \
'https://platform.adobe.io/data/foundation/flowservice/targetConnections?mode=draft' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'Content-Type: application/json' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-d '{
"name": "ACME Azure File Storage Target Connection",
"description": "Azure File Storage target connection ACME data (DRAFT)",
"data": {
"schema": {
"id": "{SCHEMA_ID}",
"version": "application/vnd.adobe.xed-full+json;version=1"
}
},
"params": {
"dataSetId": "{DATASET_ID}"
},
"connectionSpec": {
"id": "c604ff05-7f1a-43c0-8e18-33bf874cb11c",
"version": "1.0"
}
}'
Réponse
Une réponse réussie renvoie l’identifiant de connexion cible et l’etag correspondant à votre brouillon de connexion cible. Vous pouvez utiliser cet identifiant plus tard pour mettre à jour et publier votre connexion cible.
{
"id": "dbc5c132-bc2a-4625-85c1-32bc2a262558",
"etag": "\"8e000533-0000-0200-0000-5f3c40fd0000\""
}
Publier votre brouillon de connexion cible publish-your-draft-target-connection
Une fois que votre brouillon est prêt à être publié, envoyez une requête POST au point d’entrée /targetConnections
et indiquez l’identifiant du brouillon de connexion cible que vous souhaitez publier, ainsi qu’une opération d’action pour la publication.
Format d’API
POST /targetConnections/{TARGET_CONNECTION_ID}/action?op=publish
op
op
sur publish
.Requête
La requête suivante publie le brouillon de connexion cible pour Azure File Storage, créé lors d’une étape précédente.
curl -X POST \
'https://platform.adobe.io/data/foundation/flowservice/connections/dbc5c132-bc2a-4625-85c1-32bc2a262558/action?op=publish' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'Content-Type: application/json' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
Réponse
Une réponse réussie renvoie l’identifiant et l’etag correspondant à votre connexion cible publiée.
{
"id": "dbc5c132-bc2a-4625-85c1-32bc2a262558",
"etag": "\"8e000533-0000-0200-0000-5f3c40fd0000\""
}
Créer un brouillon de flux de données create-a-draft-dataflow
Pour définir un flux de données en tant que brouillon, envoyez une requête POST au point d’entrée /flows
et indiquez le paramètre de requête mode=draft
. Vous pouvez ainsi créer un flux de données et l’enregistrer en tant que brouillon.
Format d’API
POST /flows?mode=draft
mode
mode
sur draft
.Requête
La requête suivante permet de créer un brouillon de flux de données.
'https://platform.adobe.io/data/foundation/flowservice/flows?mode=draft' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'Content-Type: application/json' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-d '{
"name": "ACME Azure File Storage Dataflow",
"description": "Azure File Storage dataflow for ACME data (DRAFT)",
"sourceConnectionIds": [
"26b53912-1005-49f0-b539-12100559f0e2"
],
"targetConnectionIds": [
"dbc5c132-bc2a-4625-85c1-32bc2a262558"
],
"flowSpec": {
"id": "9753525b-82c7-4dce-8a9b-5ccfce2b9876",
"version": "1.0"
}
}'
Réponse
Une réponse réussie renvoie l’identifiant de flux et l’etag correspondant à votre brouillon de flux de données. Vous pouvez utiliser cet identifiant plus tard pour mettre à jour et publier votre flux de données.
{
"id": "c9751426-dff8-49b0-965f-50defcf4187b",
"etag": "\"69057131-0000-0200-0000-640f48320000\""
}
Publier votre brouillon de flux de données publish-your-draft-dataflow
Une fois que votre brouillon est prêt à être publié, envoyez une requête POST au point d’entrée /flows
et indiquez l’identifiant du brouillon de flux de données que vous souhaitez publier, ainsi qu’une opération d’action pour la publication.
Format d’API
POST /flows/{FLOW_ID}/action?op=publish
op
op
sur publish
.Requête
La requête suivante permet de publier le brouillon de flux de données.
curl -X POST \
'https://platform.adobe.io/data/foundation/flowservice/flows/c9751426-dff8-49b0-965f-50defcf4187b/action?op=publish' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'Content-Type: application/json' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
Réponse
Une réponse réussie renvoie l’identifiant et l’etag
correspondant du flux de données.
{
"id": "c9751426-dff8-49b0-965f-50defcf4187b",
"etag": "\"69057131-0000-0200-0000-640f48320000\""
}
Étapes suivantes
En suivant attentivement ce tutoriel, vous avez appris à créer des brouillons de vos entités Flow Service et à les publier. Pour plus d’informations sur les sources, consultez la vue d’ensemble des sources.