Créer une liste récapitulative creating-a-summary-list
Ce cas pratique détaille la création d'un workflow permettant, à partir d'une collecte de fichiers et suite à plusieurs enrichissements de données, de créer une liste récapitulative. L'exemple est basé sur une liste de contacts ayant effectué des achats dans un magasin.
La structure de données suivante est utilisée :
Son objectif est le suivant :
- Utiliser les différentes options de l’activité d’enrichissement
- Mettre à jour des données en base suite à une réconciliation
- Créer une "vue" globale des données enrichies
Pour créer une liste récapitulative, vous devez procéder comme suit :
- Collecter et charger un fichier "Achats" dans la table de travail du workflow
- Enrichir les données importées en créant un lien vers une table de référence
- Mettre à jour la table "Achats" avec les données enrichies
- Enrichir les données "Contacts" avec un calcul d'agrégat venant de la table "Achats"
- Créer une liste récapitulative
Étape 1 : Charger le fichier et réconcilier les données importées step-1--loading-the-file-and-reconciling-the-imported-data
Les données à charger sont des données "Achats" de la forme suivante :
Product Name;Product price;Store
Computer;2000;London 3
Tablet;600;Cambridge
Computer;2000;London 5
Computer;2000;London 8
Tablet;600;Cambridge
Phone;500;London 5
Ces données sont contenues dans un fichier texte : "Achats.txt".
-
Positionnez les activités Collecteur de fichiers et Chargement(fichier) dans le workflow.
Le Collecteur de fichiers permet de collecter et d'envoyer des fichiers sur le serveur Adobe Campaign.
L’activité Chargement (fichier) permet d’alimenter la table de travail du workflow avec les données collectées. Pour plus d’informations sur cette activité, consultez cette page.
-
Configurez l'activité Collecteur de fichiers pour collecter des fichiers de type texte (*.txt) du répertoire sélectionné.
L’activité Collecteur de fichiers permet de gérer l’absence de fichier dans le répertoire source. Pour cela, cochez l’option Traiter l’absence de fichier. Dans ce workflow, une activité Attente a été ajoutée pour essayer une autre collection de fichiers si elle est absente du répertoire au moment de la collecte.
-
Paramétrez l'activité Chargement (fichier) en vous basant sur un fichier exemple ayant le même format que les données à importer.
Cliquez sur le lien Cliquez ici pour changer le format du fichier…, afin de renommer les colonnes avec les libellés et les noms internes de la table "Achats".
Une fois les données importées, l'enrichissement est effectué en créant un lien vers une table de référence correspondant au schéma "Magasins".
Positionnez l’activité d’enrichissement, puis configurez-la comme suit :
-
Sélectionnez l'ensemble principal qui est constitué des données venant de l'activité Chargement (fichier).
-
Cliquez sur Ajouter des données puis sélectionnez l'option Un lien.
-
Sélectionnez l'option Définir une collection.
-
Sélectionnez le schéma "Magasins" comme schéma cible.
Pour plus d'informations sur les différents types de liens, voir la section Enrichir/Modifier des données.
Dans la fenêtre suivante, vous devez créer une condition de jointure en sélectionnant le champ source (dans l'ensemble principal) et le champ cible (appartenant au schéma "Magasins") afin de créer une réconciliation entre les données.
Suite à la création du lien, nous allons ajouter une colonne supplémentaire à la table de travail du workflow provenant du schéma "Magasins" : le champ "ZipCode Reference".
- Ouvrez l’activité d’enrichissement.
- Cliquez sur Editer les données additionnelles.
- Ajoutez le champ "Zip Code Reference" dans les Colonnes de sortie.
Les données de la table de travail du workflow après cet enrichissement sont les suivantes :
Étape 2 : Écrire des données enrichies dans la table 'Achats' step-2--writing-enriched-data-to-the--purchases--table
Cette étape décrit comment écrire les données importées et enrichies dans la table « Achats ». Pour ce faire, nous devons utiliser une activité Mettre à jour des données.
Une réconciliation entre les données de la table de travail du workflow et la dimension de ciblage Achats doit être effectuée avant la mise à jour des données dans la table Achats.
- Cliquez sur l’onglet Réconciliation de l’activité d’enrichissement.
- Sélectionnez la dimension de ciblage, dans notre cas le schéma "Achats".
- Sélectionnez une "expression source" pour les données de la table du workflow (ici le champ "NomMag").
- Sélectionnez une "expression destination" pour les données de la table "Achats" (ici le champ "NomMag").
- Cochez l’option Conserver les données non réconciliées de la table de travail.
Dans l'activité Mise à jour de données, la configuration suivante est nécessaire :
- Sélectionnez l'option Ajouter ou mettre à jour dans le champ Type d'opération afin de ne pas créer de nouveaux enregistrements à chaque collecte du fichier.
- Sélectionnez la valeur En utilisant directement la dimension de ciblage pour l'option Identification des enregistrements.
- Sélectionnez le schéma "Achats" comme Type de document.
- Indiquez la liste des champs à mettre à jour. La colonne Destination permet de définir les champs du schéma « Achats ». La colonne Expression permet de sélectionner les champs de la table de travail pour effectuer un mapping.
- Cliquez sur l'option Générer une transition sortante.
Étape 3 : Enrichissement des données 'Contacts' step-3--enriching--contact--data-
Le schéma "Contacts" est relié par un lien physique au schéma "Achats". Il est donc possible d'utiliser une autre option de l'activité "Enrichissement" : l'ajout de données liées à la dimension de filtrage.
L'objectif de ce deuxième enrichissement est de créer un agrégat sur le schéma des achats pour calculer le montant total des achats pour chaque contact identifié.
-
Positionnez une activité Requête permettant de récupérer l'intégralité des Contacts stockés.
-
Positionnez une activité Enrichissement puis sélectionnez l'ensemble principal résultant de la requête précédente.
-
Cliquez sur Ajouter des données.
-
Cliquez sur l'option Données liées à la dimension de filtrage.
-
Cliquez sur Données liées à la dimension de filtrage dans la fenêtre Choix des données à ajouter.
-
Sélectionnez le noeud Achats puis cliquez sur Suivant.
-
Modifiez le champ Données collectées en sélectionnant l'option Agrégats.
-
Cliquez sur Suivant.
-
Ajoutez l'expression suivante pour calculer la somme des achats pour chaque contact : "Sum(@prixproduit)".
Pour préparer la liste récapitulative, il est nécessaire d'ajouter des champs provenant du schéma "Achats" ainsi que du premier enrichissement : le champ "ZipCode Reference".
-
Cliquez sur le lien Modifier les données additionnelles… dans l’activité d’enrichissement.
-
Ajoutez les champs "Achats / Nom Boutique" et "Achats / Zip Code Reference".
-
Cliquez sur l'onglet Propriétés.
-
Modifiez le deuxième lien pour ne créer qu'une seule ligne.
Étape 4 : Créer et alimenter une liste récapitulative step-4--creating-and-adding-to-a-summary-list
La dernière étape consiste à écrire toutes les données enrichies dans une liste.
- Placez une activité Mise à jour de liste dans le workflow. Cette activité doit être reliée à la transition sortante de la deuxième activité d’enrichissement.
- Sélectionnez l'option Créer la liste si besoin (Nom calculé).
- Sélectionnez une valeur pour le nom calculé. Le libellé choisi pour la liste est la date courante : <%= formatDate(new Date(), "%2D/%2M/%2Y") %>.
Une fois le workflow exécuté, la liste contient :
- une liste des contacts,
- une colonne "Somme des achats",
- une colonne "Nom de boutique",
- une colonne "Zip Code reference" remplie pour les magasins connus dans le schéma de référence des magasins.
