Travailler avec les attributs de sortie dans les workflows d'automatisation

Les messages transmettent les composants des flux de travail d'automatisation, des déclencheurs aux actions en passant par les actions externes, sous la forme de paires clé-valeur au format JSON ou d'attributs dansFME. Ces attributs représentent diverses propriétés dérivées des composants du flux de travail et forment le contenu du message. Chaque attribut généré par un composant peut être envoyé en aval au composant suivant, puis finalement généré par le flux de travail vers une application réceptrice.

Vous pouvez travailler avec les attributs de sortie des messages de workflow des manières suivantes :

• Afficher les attributs, désactiver et activer les attributs et créer des attributs personnalisés.
• Créer des paramètres d’automatisation globaux.
• Travailler avec des niveaux d'imbrication dans les attributs.
• Filtrer la présence d'une chaîne dans une valeur d'attribut.

Affichage des attributs, désactivation/activation des attributs et création d'attributs personnalisés

Lorsque vous créez un flux de travail d'automatisation, vous pouvez contrôler les attributs qui sont envoyés aux composants en aval d'un flux de travail et qui sont finalement inclus dans la sortie du message final. Dans le volet Détails d'un déclencheur, d'une action ou d'une action externe, sélectionnez l'optionAttributs de sortie languette. Ici, vous pouvez :

• Affichez les attributs générés par le composant. Le cas échéant, le composant génère des ensembles distincts d'attributs de sortie pour la réussite (✔) et l'échec (x) ports d'un composant. Exécutez unWorkspaceactions qui font référenceworkspaces configuré avecFME Flow Les rédacteurs d'automatisations génèrent également des attributs de sortie pour chaque type de fonctionnalité de rédacteur. Pour plus d'informations, voir Données de routage deWorkspaces .
ConseilPour afficher les attributs de sortie des composants en amont, cliquez surAfficher les attributs en amont.
• Désactiver ou activer les attributs. Par défaut, tous les attributs applicables sont activés dans le message sortant lors de son passage en aval.
• Créez des attributs personnalisés avec des noms définis par l'utilisateur et préfixés par leutilisateur. étiqueter. Vous pouvez attribuer la valeur d'un attribut personnalisé à partir d'un attribut existant, d'un paramètre duMagasin de paramètres de déploiement, ou une constante.

Le principal avantage de la désactivation des attributs ou de la création d’attributs personnalisés est d’empêcher leur écrasement, si nécessaire. Les valeurs des objets JSON avec les mêmes chaînes d’attributs sont écrasées lorsqu’elles passent par un flux de travail. Par exemple, considérons un flux de travail qui contient deux ExécuterWorkspace actions en séquence. Les deux actions passent unjob.timeStarted attribut, mais la valeur que cet attribut produit dans la première action est écrasée par la deuxième action. Si vous souhaitez conserver uniquement lesjob.timeStarted valeur du premierworkspace, vous pouvez désactiver le job.timeStarted attribut dans la configuration de la deuxième action, et le conserver dans la première.

Mais que se passerait-il si vous vouliez préserver les deux ?job.timeStarted valeurs? Dans ce cas, vous pouvez créer un attribut personnalisé dans les deuxworkspaces, donnez-leur à chacun des noms uniques et basez leurs valeurs surjob.timeStarted. En option, vous pouvez également désactiverjob.timeStarted dans les deuxworkspaces.

Vous pouvez utiliser des attributs personnalisés n’importe où dans un flux de travail qui vous permet de spécifier un attribut pour une valeur de paramètre.

Création de paramètres d'automatisation globaux

Vous pouvez créer vos propres paramètres d'automatisation, préfixés par lemondial. étiqueter. Les paramètres d'automatisation vous permettent de référencer une valeur dans plusieurs composants d'un workflow sans avoir à la définir explicitement à chaque fois. Vous pouvez utiliser des paramètres d’automatisation n’importe où dans un flux de travail qui vous permet de spécifier un attribut de sortie pour une valeur de paramètre.

Vous pouvez créer des paramètres d’automatisation des manières suivantes :

• Dans la barre d’outils Automatisations, cliquez sur le bouton Éditeur de paramètres d’automatisation.
• Dynamiquement, lorsquespécification d'une valeur de paramètre dans un flux de travail. Dans une liste déroulante de paramètres applicable, sélectionnezAjouter aux paramètres d'automatisation.

Dans l'éditeur de paramètres d'automatisation, cliquez sur+ pour commencer une nouvelleParamètre d'automatisation, entrez un nom (mondial.<votre_nom>), spécifiez unValeur, et cliquezD'ACCORD. Vous pouvez spécifier unValeurmanuellement, ou sélectionnez-en un dans la listeMagasin de paramètres de déploiement.

Travailler avec des niveaux d'imbrication dans les attributs

Lorsqu'une automatisation rencontre des messages avec des attributs contenant plusieurs niveaux d'imbrication, l'automatisation analyse les 0e, 1er, 2e et 3e niveaux les plus internes d'un attribut pour résoudre ou créer des attributs de sortie.

Par exemple, considérons un attribut de message{route.apple} valeur attribuéepomme. Le message suivant n'a aucun niveau d'attribut imbriqué :

{

"{route.apple}"

}

Ce message résout la valeurpommecomme attribut de sortie.

Le message suivant contient 0 à 4 niveaux d’attributs imbriqués :

{

"{route.{route.{route.{route.{route.apple}}}}}"

}

Ce message résout la valeurroute.apple en tant qu'attribut de sortie car le niveau imbriqué le plus externe, ou 4ème, n'est pas résolu.

Filtrage sur un attribut de sortie

Vous pouvez utiliser leFiltrer les messages action pour tester la présence d'une chaîne dans un attribut de sortie et acheminer les messages dans votre flux de travail en conséquence. Par exemple, si leemail.objet attribut d'unCourriel - SMTP Si le déclencheur contient une chaîne spécifique, vous pouvez choisir d'acheminer le message différemment des autres e-mails qui ne contiennent pas cette chaîne.