Configurer les nœuds de données ACB

L'application Automated Content Builder (ACB) permet la création de documents et de présentations adaptés au contexte des prospects et aux besoins spécifiques de leur secteur. Les données clients s'intègrent automatiquement dans des modèles approuvés par le marketing pour créer un contenu personnalisé et percutant en quelques secondes.

Les modèles contiennent des espaces réservés qui sont liés à des nœuds de données préconfigurés. Ces nœuds servent de connecteurs, remplaçant les espaces réservés par des données pertinentes pendant le processus de génération de document.

Les nœuds de données actuellement pris en charge sont les détails utilisateur Showpad, les formulaires, Salesforce, les sources de données (requêtes SOQL Salesforce et APIs externes), et JavaScript personnalisé.

Lorsqu'un utilisateur crée un document ou une présentation à partir d'un modèle, les données récupérées sont automatiquement insérées dans les espaces réservés du document, ce qui permet de gagner du temps et des efforts dans la création de présentations personnalisées et d'assurer le respect des normes de la marque.

Maintenant que nous avons téléchargé notre modèle dans l'Experience ACB, nous allons apprendre comment configurer les nœuds de données requis.

Découvrez à quoi ça ressemble

Vous avez besoin de cela pour réussir

Procédez étape par étape

• Contexte et exemples de configuration de nœud de données
• Configurez vos nœuds de données

Contexte et exemples de configuration de nœud de données

Pour collecter toutes les données nécessaires au modèle, vous devez créer une structure arborescente avec les nœuds de données requis.

Une structure arborescente est un flux de nœuds de données. Différents flux peuvent être créés, chacun étant représenté par une branche d'arbre. Une branche d'arbre possède un premier nœud et, éventuellement, un ou plusieurs nœuds suivants. Les nœuds suivants dépendent de l'entrée du nœud précédent pour être configurés.

Exemple d'une structure arborescente simple

Dans cet exemple, nous avons une branche avec un seul nœud de départ de type : Showpad User. Aucune action n'est requise de la part des utilisateurs lors de la génération d'un document à partir de ce modèle. Les espaces réservés mappés à ce nœud de données seront remplacés par les détails du profil Showpad de l'utilisateur générant le document.

Exemple d'une structure arborescente complexe

Dans cet exemple, il y a :

• Un nœud de données de départ de type : Formulaire. Les utilisateurs devront remplir un formulaire lors de la génération d'un document à partir de ce modèle.
• Un nœud de données de départ de type : Salesforce. Les utilisateurs doivent saisir un ID d'objet Salesforce lors de la génération d'un document à partir de ce modèle.
  Cette branche comprend des nœuds de données suivants de type : Source de données. Ces nœuds suivants dépendent des informations récupérées à partir du nœud Salesforce initial pour récupérer les données associées.

Configurez vos nœuds de données

1. Cliquez sur l'icône + (plus) dans l'onglet Configurer le modèle pour ajouter votre premier nœud de données.
2. \nSélectionnez le nœud de données que vous souhaitez ajouter :
   
   

   Salesforce

   Showpad

   Formulaire

   Source de données

   Magasin de données

   JavaScript personnalisé

   Configurer un nœud de données de type : Salesforce

   • Sélectionnez une option :
     

     Obtenir un seul type d'enregistrement	Cela renvoie un seul enregistrement. 1. Sélectionnez un objet Salesforce dans la liste déroulante. 2. Choisissez Saisie utilisateur pour permettre aux utilisateurs de saisir manuellement l'ID, ou choisissez Sélectionner un champ du nœud précédent pour utiliser l'ID Salesforce fourni dans une étape précédente.
     Liste/Recherche d'enregistrements	Cela renvoie une liste d'enregistrements à partir de l'objet Salesforce sélectionné. 1. Sélectionnez un objet Salesforce dans la liste déroulante. En sélectionnant Ajouter des champs supplémentaires, vous pouvez récupérer des champs supplémentaires à partir d'objets Salesforce associés. 2. Ajoutez des règles de filtrage pour affiner vos résultats de recherche selon des critères spécifiques. 3. Définissez une limite sur le nombre d'enregistrements pouvant être renvoyés. Par défaut, 10 enregistrements sont renvoyés, et la limite maximale est de 200. 4. Vous pouvez trier les enregistrements renvoyés par un champ de l'objet Salesforce (par ordre croissant ou décroissant).
     Informations utilisateur	Cela renvoie les informations de l'utilisateur Salesforce de la personne qui génère le document

   • Mettez à jour le nom du nœud ou conservez celui par défaut. Vous verrez le nom du nœud lors du mappage des espaces réservés aux nœuds de données.

   Remarque : Le nœud Salesforce ne s'affichera que si votre instance Salesforce a été intégrée à votre instance Showpad.
   
   De plus, vous ne pouvez sélectionner un objet que si vous avez synchronisé votre compte Showpad avec votre compte Salesforce.

   ---

   Configurer un nœud de données de type : Showpad

   Ce nœud de données utilise les informations de profil enregistrées dans Showpad de l'utilisateur qui génère le document, comme le prénom, le nom, l'adresse email, etc.

   Vous pouvez mettre à jour le nom du nœud ou conserver celui par défaut. Le nom du nœud apparaîtra lors du mappage des espaces réservés aux nœuds de données.
   
   

   ---

   Configurer un nœud de données de type : Formulaire

   Ce nœud de données permet la configuration d'un formulaire contenant un ensemble de champs que l'utilisateur générant le document devra fournir.

   • Mettez à jour le nom du formulaire ou conservez celui par défaut. Le nom du nœud apparaîtra lors du mappage des espaces réservés aux nœuds de données.
   • Ajoutez une étiquette pour informer les utilisateurs de la saisie requise, et sélectionnez un type. Les types de champs actuellement pris en charge sont :
     

     Texte	Les utilisateurs saisissent des informations textuelles telles que des noms, des numéros ou toute autre donnée textuelle requise.
     Date	Les utilisateurs doivent sélectionner une date à partir d'un calendrier.
     Image	Les utilisateurs doivent télécharger une image.
     Choix simple	Les utilisateurs doivent sélectionner une seule option dans une liste d'options multiples.
     Choix multiple	Les utilisateurs peuvent sélectionner une ou plusieurs options à partir d'une liste d'options multiples.

   • Cochez la case Obligatoire si la saisie est obligatoire, ou laissez-la décochée si le champ est facultatif. Dans ce cas, les utilisateurs peuvent générer un document sans saisir d'information dans ce champ.
   • Cliquez sur le champ Ajouter un formulaire pour ajouter une autre entrée.

    

   ---

   Configurer un nœud de données de type : Source de données

   Ce nœud de données récupère des données soit depuis Salesforce (en utilisant le langage de requête d'objet Salesforce (SOQL)), soit depuis des systèmes externes via une API.

   • Vous pouvez soit créer une nouvelle source de données en cliquant sur l'icône + (plus), soit sélectionner une source de données existante dans le menu déroulant.
     Pour créer une source de données Salesforce ou API externe, suivez les instructions dans cet article.
   • Mettez à jour le nom du nœud ou conservez celui par défaut. Vous verrez le nom du nœud lors du mappage des espaces réservés aux nœuds de données.
   • Si nécessaire, sélectionnez les champs pertinents.

    

   ---

   Configurer un nœud de données de type : Magasin de données

   Ce nœud de données récupère des données à partir de vos magasins de données préconfigurés.

   • Sélectionnez une option :
     

     Obtenir un seul type d'enregistrement

     Cela renvoie un seul enregistrement. Sélectionnez un magasin de données dans la liste déroulante. Sélectionnez l'option Obtenir un seul enregistrement et choisissez un nom de colonne dans la liste déroulante. Choisir : \nSaisie utilisateur pour permettre aux utilisateurs de rechercher manuellement par colonne, ou \nSélectionner un champ du nœud précédent pour utiliser la colonne du Data Store fournie dans une étape précédente.

     Liste/Recherche d'enregistrements

     Ceci renvoie une liste d'enregistrements à partir du magasin de données sélectionné. Sélectionnez un magasin de données dans la liste déroulante. Sélectionnez l'option Liste/Recherche d'enregistrements. Choisissez le type de recherche : Filtre : Ajoutez des règles de filtrage pour affiner vos résultats de recherche selon des critères spécifiques. Définissez une limite sur le nombre d'enregistrements pouvant être renvoyés. Par défaut, 10 enregistrements sont renvoyés, et la limite maximale est de 200. Vous pouvez trier les enregistrements retournés par un champ du Data Store (par ordre croissant ou décroissant). \nSaisie utilisateur : Sélectionnez une colonne pour permettre aux utilisateurs de rechercher manuellement plusieurs enregistrements dans la colonne.

   • Mettez à jour le nom du nœud ou conservez celui par défaut. Vous verrez le nom du nœud lors du mappage des espaces réservés aux nœuds de données.

    

   ---

   Configurer un nœud de données de type : JavaScript personnalisé

   Ce nœud de données exécute une logique ou des mappages plus complexes qui ne sont pas possibles avec le flux de configuration visuelle simple.

   Par exemple, un nœud de données peut nécessiter une variable qui n'est pas simplement la sortie d'un nœud précédent, mais le résultat d'une formule ou d'une transformation appliquée aux données d'un nœud précédent.

   • Mettez à jour le nom du nœud ou conservez celui par défaut. Vous verrez le nom du nœud lors du mappage des espaces réservés aux nœuds de données.
   • Sélectionnez l'entrée du nœud précédent à laquelle la logique s'appliquera.
   • Écrivez la formule ou la transformation. Utilisez 'input' pour transformer la valeur d'entrée. Par exemple, input.toUpperCase() écrit l'entrée sélectionnée en majuscules.

    

   ---

3. Vous pouvez tester la validité de votre nœud de données en cliquant sur le bouton Exécuter le flux de données dans le coin inférieur gauche. Le nom du nœud deviendra vert s'il est valide ou rouge s'il est invalide. S'il est invalide, vous recevrez également un message d'erreur décrivant le problème.
   

   Remarque : La fonctionnalité Mode débogage doit d'abord être activée dans votre Experience ACB.

4. De plus, vous pouvez ajouter :\n
   • Un autre nœud de départ. Cliquez sur l'icône + (plus).
   • Nœuds suivants. Survolez un nœud et cliquez sur l'icône + (plus) à sa droite. Notez que les nœuds suivants dépendent généralement de l'entrée du nœud précédent pour être configurés.
   • Un ancien nœud. Survolez un nœud et cliquez sur l'icône + (plus) à gauche du nœud.
5. Vous pouvez sauvegarder votre progression en cliquant sur Enregistrer comme brouillon dans le coin supérieur droit.

Passez à l'article suivant pour associer les espaces réservés aux nœuds de données préconfigurés.