Créer une variable de sortie

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 3 minutes de lecture
  • Le formulaire Sorties du concepteur contient un générateur de variables pour créer des structures de données d’objets et de tableaux.

    Avant de commencer

    Rôles requis : activity_admin, activity_creator

    Pourquoi et quand exécuter cette tâche

    Les éléments de cette structure sont mappés à Créer une règle d’analyse des données spécifiques contenues dans les charges utiles renvoyées par un point de terminaison ou un hôte. Ces variables et leurs valeurs sont ensuite mises à disposition localement ou réutilisées dans d’autres activités.

    Procédure

    1. Cliquez sur l’icône + dans la colonne Sorties pour créer une variable locale ou de sortie.

      Les variables locales ne sont disponibles qu’au sein d’une activité et ne sont pas visibles dans les structures de données affichées dans l’onglet Personnalisé . Les variables de sortie peuvent être réutilisées dans d’autres activités, individuellement ou en tant que structure de données entière. Lorsque vous créez une variable de l’un ou l’autre type, le concepteur fournit un nom par défaut Local1 ou Output1.

    2. Tapez votre nouveau nom de variable dans le champ et sélectionnez un type de données.

      Les noms de variables doivent être uniques au sein d’un tableau ou d’un objet. Vous pouvez affecter un type de données Chiffré aux variables de sortie qui contiennent des données sensibles. Les données protégées par cryptage sont transmises à d’autres activités ou processus de manière cryptée et ne sont jamais affichées en texte brut.

    3. Pour modifier le nom d’une variable ou de l’un de ses attributs, double-cliquez sur la valeur, saisissez une nouvelle valeur dans le champ d’édition, puis appuyez sur Entrée.

      L’icône à gauche du nom reflète le type de données de la variable.

    4. Pour réorganiser la liste de variables, sélectionnez une ligne, puis faites glisser la ligne vers son nouvel emplacement.

      Lorsque vous sélectionnez une ligne pour la déplacer, l’icône du pointeur prend la forme d’une icône de flèche haut/bas ().

    5. Faites glisser la ligne vers un autre emplacement.
    6. Choisissez parmi les options suivantes.
      • Pour réutiliser une variable d’une autre activité, faites-la glisser de l’onglet Personnalisé de la palette vers l’en-tête Local ou Sortie en haut de la liste de variables.
      • Pour copier l’intégralité d’une structure de données, faites glisser l’objet ou le tableau parent dans l’en-tête de liste de variables.
      Le concepteur duplique la structure des données copiée dans le générateur de variables de sortie.
      Figure 1. Réutilisation des structures de données
      Réutilisation d’une variable de sortie
    7. Pour supprimer une variable, cliquez sur l’icône de suppression () de la ligne.

    Sorties du modèle du concepteur d’activité

    Les variables de sortie contiennent des messages renvoyés d’une destination qui sont disponibles pour d’autres activités dans un workflow ou en interne à l’activité.

    Tableau 1. Champs de sortie de Concepteur d’activité
    Champ Description
    Nom de variable Nom d’une variable, locale ou sortie, transmise par cette activité.
    Local Variable qui contient une valeur utilisée dans une activité. Par exemple, utilisez une variable locale pour identifier les métadonnées traitées au sein d’une activité avant que la valeur finale ne soit exportée vers une variable de sortie.
    Sortie Variable qui contient une valeur transmise à d’autres activités du workflow.

    Mapper un champ de sortie

    Le mappage est configuré avec des règles d’analyse qui vous permettent de créer des expressions dans le format de données approprié pour la charge utile sélectionnée.

    Avant de commencer

    Rôle requis : activity_admin, activity_creator

    Pourquoi et quand exécuter cette tâche

    Lorsque vous avez terminé de créer la structure de données de sortie, mappez chaque variable aux données spécifiques que vous souhaitez extraire de l’hôte cible.

    Procédure

    Pour mapper une variable, faites-la glisser à partir du générateur de variables Sorties et déposez-la dans un champ Nom de variable vide dans la section Règles d’analyse.

    Reportez-vous à la section Créer une règle d’analyse pour obtenir des instructions sur la configuration de l’analyse des variables de sortie.

    Mappage d’un champ de sortie