Automatismes

Les automatisations vous permettent de concevoir des flux de travail de messagerie JSON qui prennent en charge un riche ensemble de protocoles de communication. Avec un ensemble d'outils simples, vous pouvez tirer parti de votreFME Flow pour recevoir et envoyer des messages et exécuterworkspaces sur demande. Cette puissante combinaison vous permet de contrôler des modèles de flux de données complexes dans votre entreprise.

Les automatisations sont composées de trois composants principaux :

• Déclencheurs:Écouter et recevoir des messages provenant de clients externes ou internesFME Flow.

Protocoles pris en charge

• Actions externes: Envoyer des messages à des clients externes ou internesFME Flow.

Protocoles pris en charge

• Actes: Traiter les messages entre les déclencheurs et les actions externes, soit dans un FMEworkspace, ou via un autre outil.

Actions prises en charge

L'exemple ci-dessous illustre un flux de travail simple composé d'un déclencheur qui reçoit un e-mail, d'une action pour exécuter unworkspace, et un ensemble d'actions externes qui envoient des e-mails en fonction de laworkspace résultats. UnE-mail reçu (IMAP) le déclencheur envoie des messages à unCourirWorkspaceaction à chaque fois qu'un e-mail provenant d'un hôte de serveur IMAP spécifié est reçu. Leworkspace valide les fonctionnalités dans un fichier joint à l'e-mail et lit les fonctionnalités qui passent la validation dans une base de données. L'automatisation se déroule de manière séparéeEnvoyer un e-mail actions externes basées sur les résultats de la validation dans leCourirWorkspaceaction. Un e-mail envoie des détails sur les fonctionnalités qui ont passé la validation et ont été lues dans la base de données, y compris des détails sur les attributs de type de fonctionnalité. Un autre e-mail envoie des détails sur les fonctionnalités qui ont échoué à la validation. De plus, deux courriels supplémentaires sont envoyés selon que leworkspace terminé avec succès ou non. Enfin, des métadonnées sur toutE-mail reçu les déclencheurs qui ne parviennent pas à récupérer les e-mails sont enregistrés.

Passez la souris pour voir :

Premiers pas avec les automatisations

Démarrez un nouveau flux de travail d’automatisations à partir de la page Démarrer, Créer une automatisation ou Gérer les automatisations. (Pour utiliser une automatisation existante comme point de départ, sélectionnez-la dans la page Gérer les automatisations, cliquez surActes>Double, et ouvrez l'automatisation dupliquée.)

Pour commencer, un déclencheur non défini et une « action suivante » (qui peut être une action ou une action externe) sont placés dans la zone de flux de travail. Au fur et à mesure que vous continuez à définir le flux de travail, des composants « Action suivante » supplémentaires sont ajoutés.

Alternativement, pour ajouter des composants supplémentaires, développez. Double-cliquez ou cliquez et faites glisser l'une des icônes applicables.

1. Définir les composants

Définissez des déclencheurs, des actions et des actions externes, comme vous le souhaitez.

Pour définir un déclencheur

Double-cliquez sur l’icône de déclencheur que vous souhaitez définir. Sous Détails du déclencheur, développezSélectionnez un événement déclencheur et faire une sélection. Pour plus d'informations sur chaque déclencheur, y compris comment le configurer, consultezDéclencheurs d'automatisations.

Configurez les éléments suivants :

• Paramètres:Les paramètres requis pour que le déclencheur fonctionne comme souhaité.
ConseilLe cas échéant, cliquez surValiderpour tester que vos paramètres fonctionnent comme prévu.
• Attributs de sortie: Les paires clé-valeur JSON à inclure dans le message sortant. Par défaut, tous les attributs sont inclus. En option, vous pouvez créer vos propres attributs. Pour plus d'informations, voir Travailler avec les attributs de sortie dans les workflows d'automatisation .

Pour plus d'informations, consultez la documentation du déclencheur spécifié sousDéclencheurs d'automatisations.

Pour définir une action

Double-cliquez sur leProchaine action icône. Sous Détails de l'action suivante, développezSélectionnez une action et faites une sélection sous Actions. Pour plus d'informations sur chaque action, y compris comment la configurer, consultezActions d'automatisation.

Le canevas connecte automatiquement votre action au composant précédent du workflow. Toutefois, si les connexions ne sont pas spécifiées, cliquez sur un port de sortie d'un composant en amont et sur un port d'entrée de l'action. Vous pouvez également cliquer et faire glisser une ligne de connexion entre les ports.

ConseilCréez des connexions aux actions avant de configurer les paramètres. De cette façon, vous aurez accès à tous les paramètres entrants, le cas échéant. Pour plus d'informations, voir Travailler avec des paramètres dans les workflows d'automatisation .

Configurez les éléments suivants, le cas échéant :

• Paramètres: Les paramètres requis pour que l'action fonctionne comme souhaité.
• Attributs de sortie: Les paires clé-valeur JSON à inclure dans le message sortant. Par défaut, tous les attributs sont inclus. En option, vous pouvez créer vos propres attributs. Pour plus d'informations, voir Travailler avec les attributs de sortie dans les workflows d'automatisation .
• Avancé: Options d'exécution pourworkspaces.
• Réessayer: Paramètres qui contrôlent les tentatives d'exécution de l'action à nouveau en cas d'échec de connexion à une ressource externe.

Pour plus d'informations, consultez la documentation de l'action spécifiée sousActions d'automatisation.

Définir une action externe

Double-cliquez sur leProchaine action icône. Sous Détails de l'action suivante, développezSélectionnez une action et faites une sélection sous Actions externes. Pour plus d'informations sur chaque action externe, y compris comment la configurer, consultezAutomatisations Actions externes.

Le canevas connecte automatiquement votre action externe au composant précédent du workflow. Toutefois, si les connexions ne sont pas spécifiées, cliquez sur un port de sortie d'un composant en amont et sur un port d'entrée de l'action externe. Vous pouvez également cliquer et faire glisser une ligne de connexion entre les ports.

ConseilCréez des connexions à des actions externes avant de configurer les paramètres. De cette façon, vous aurez accès à tous les paramètres entrants, le cas échéant. Pour plus d'informations, voir Travailler avec des paramètres dans les workflows d'automatisation .

Configurez les éléments suivants :

• Paramètres:Les paramètres requis pour que l'action externe fonctionne comme souhaité.
ConseilLe cas échéant, cliquez surValiderpour tester que vos paramètres fonctionnent comme prévu.
• Attributs de sortie: Les paires clé-valeur JSON à inclure dans le message sortant. Par défaut, tous les attributs sont inclus. En option, vous pouvez créer vos propres attributs. Pour plus d'informations, voir Travailler avec les attributs de sortie dans les workflows d'automatisation .
• Réessayer: Paramètres qui contrôlent les tentatives d'exécution de l'action à nouveau en cas d'échec de connexion à une ressource externe.

Pour plus d'informations, consultez la documentation relative à l'action externe spécifiée sousAutomatisations Actions externes.

2. Enregistrer, nommer et étiqueter le flux de travail

Cliquez sur l'icône Enregistrer ou sélectionnezMenu>Enregistrer sous. Dans la boîte de dialogue Enregistrer sous, spécifiez unNom et un ou plusieursMots clés(facultatif), et cliquez surD'ACCORD.

ConseilSi vous avez de nombreux flux de travail, utilisez des balises pour les organiser en catégories significatives. Lorsque vous affichez les flux de travail sur la page Gérer les automatisations, vous pouvez filtrer par balises.
3. Démarrer le flux de travail

Les flux de travail n'écoutent pas les messages entrants et ne s'exécutent pas tant que vous ne les démarrez pas. Vous pouvez démarrer une automatisation directement depuis la page de build ou depuis lePage Gérer les automatisations.

Pour démarrer une automatisation à partir de la page de construction, cliquez surCommencerouDéboguer:

• Commencer (recommandé) : Ce mode écritfichiers journaux d'automatisation auJournaux>Automatismes dossier dansRessources, qui sont enregistrés selon les paramètres de nettoyage du système (voirConfiguration de la durée de conservation des journaux d'automatisation du mode de démarrage , ci-dessous).
• Déboguer:Fichiers journaux d'automatisation écrire à laFME FlowBase de données. Les journaux de débogage sont effacés à chaque redémarrage de l'automatisation, quel que soit le mode. Ce mode n'est pas recommandé pour exécuter des automatisations dans un environnement de production.

Note
• Une automatisation s'exécute sous le nom de l'utilisateur qui l'a démarrée. En plus de Runautorisation sur l'automatisation, cet utilisateur doit avoir l'autorisation d'exécution sur n'importe quelworkspace au sein de l'automatisation, ainsi que les autorisations sur toutes les autres dépendances.
• Vous ne pouvez pas modifier un flux de travail à moins qu'il ne soit arrêté. CliquezArrêt ou Arrêter le débogage.

Autres tâches - Création de flux de travail

Pour exécuter un workflow à la demande

Vous pouvez créer un flux de travail qui ne répond à aucun message entrant ni à aucune planification, mais qui s'exécute à la demande et vous permet de transmettre des exemples de données JSON. Ce type de flux de travail utilise unDéclencheur manuel à la place de l’une des autres options de déclenchement. Les déclencheurs manuels sont utiles lorsque vous souhaitez tester un flux de travail avant d'en créer un qui reçoit de vrais messages entrants.

Pour activer la boucle dans les flux de travail

Lorsque la boucle est activée, vous pouvez établir des connexions à partir des ports de sortie en aval vers les ports d'entrée des composants en amont. La boucle est un mécanisme utile pour créer des modèles de gestionnaire de processus dans vos flux de travail. Pour plus d'informations, voir Boucle de données entreWorkspaces . Sur la toile, les boucles apparaissent comme des lignes de connexion en pointillés.

Pour activer la boucle, sélectionnezActiver la boucle depuis le menu toile. Ce paramètre s'applique au flux de travail actuel, ainsi qu'aux flux de travail ultérieurs que vous ouvrez.

Pour désactiver la boucle, sélectionnezDésactiver la boucle depuis le menu toile. Toutes les boucles existantes restent en place.

Pour annoter un flux de travail

Annotez votre flux de travail avec des commentaires. Sélectionnez un composant, faites un clic droit et sélectionnezAjouter une annotation. Alternativement, développez et faites glisser depuis l'icône Annotation vers le composant. Pour ajouter une annotation qui n’est pas connectée à un composant, désélectionnez tous les composants et ajoutez une annotation sur une zone vide du canevas.

Pour ajouter des signets à un flux de travail

Regroupez les composants liés dans des signets. Faites un clic droit sur la toile et sélectionnezAjouter un signet, ou développer et faites glisser l'icône Signet vers le canevas. Mettez à jour le texte de l'en-tête du signet, faites glisser le signet sur les composants que vous souhaitez regrouper et redimensionnez-le comme vous le souhaitez. Pour changer la couleur du signet, faites un clic droit et sélectionnezChanger de couleur.

Pour couper, copier, coller ou supprimer des composants dans un flux de travail

Sur le canevas, faites un clic droit sur les composants et sélectionnezCouper, Copie,Coller, ouSupprimer. Les raccourcis clavier standard basés sur le navigateur, tels que Ctrl + c, peuvent également s'appliquer.

Pour désactiver ou réactiver des composants dans un flux de travail

Les composants désactivés ne s'exécutent pas dans le cadre d'un flux de travail. Sur le canevas, sélectionnez un ou plusieurs composants, faites un clic droit et sélectionnezDésactiver. Pour réactiver, faites un clic droit et sélectionnezActiver.

Pour ajouter ou supprimer une balise d'un flux de travail

Sur la toile, sélectionnezMenu >Enregistrer sous. Dans la boîte de dialogue Enregistrer sous, configurez les balises comme vous le souhaitez, puis cliquez surD'ACCORD.

Alternativement, sur la page Gérer les automatisations, sélectionnez un ou plusieurs flux de travail, puis sélectionnezActes>Modifier les balises.

Gestion des automatisations

Pour démarrer ou arrêter un flux de travail

Les flux de travail n'écoutent pas les messages entrants et ne s'exécutent pas tant qu'ils ne sont pas démarrés, et ils ne peuvent pas être modifiés tant qu'ils ne sont pas arrêtés.

Sur la page Gérer les automatisations, sélectionnez un flux de travail et cliquez surActions > Démarrer ouDéboguer:

• Commencer (recommandé) : Ce mode écritfichiers journaux d'automatisation auJournaux>Automatismesdossier dansRessources, qui sont enregistrés selon les paramètres de nettoyage du système (voirConfiguration de la durée de conservation des journaux d'automatisation du mode de démarrage , ci-dessous). Dans ce mode, vous pouvez sélectionner plusieurs automatisations à démarrer.
• Déboguer:Fichiers journaux d'automatisation écrire à laFME FlowBase de données. Les journaux de débogage sont effacés à chaque redémarrage de l'automatisation, quel que soit le mode. Ce mode n'est pas recommandé pour exécuter des automatisations dans un environnement de production. Dans ce mode, vous ne pouvez sélectionner qu'une seule automatisation à démarrer.

Une automatisation s'exécute sous le nom de l'utilisateur qui l'a démarrée. En plus de Runautorisation sur l'automatisation, cet utilisateur doit avoir l'autorisation d'exécution sur n'importe quelworkspace au sein de l'automatisation, ainsi que les autorisations sur toutes les autres dépendances.

Pour arrêter un flux de travail

Sur la page Gérer les automatisations, sélectionnez un flux de travail et cliquez surActions > Arrêter ouArrêter le débogage, selon le mode d'exécution du flux de travail. Vous pouvez sélectionner plusieurs automatisations exécutées en mode Démarrer pour les arrêter. Vous ne pouvez sélectionner qu'une seule automatisation exécutée en mode débogage pour l'arrêter.

Pour afficher le nombre d'événements

FME Flowenregistre le nombre de fois qu'un nœud de votre automatisation s'exécute. Les nombres d'événements sont visibles sur les lignes de connexion. Dans cet exemple, à la fois leFME Flow Déclencheur de planification et exécution d'unWorkspace l'action a été exécutée dix fois depuis le début de l'automatisation :

Le nombre d'événements s'actualise automatiquement toutes les dix secondes. Pour accélérer une actualisation, cliquez surRafraîchir.

Une fois qu'une automatisation est arrêtée, le nombre d'événements finaux s'affiche. Ces comptes finaux sont supprimés et réinitialisés lorsque l’un des événements suivants se produit :

• L'automatisation est redémarrée.
• Une connexion est mise à jour ou supprimée. Seuls les nombres d’événements des nœuds en aval sont affectés.
• Les paramètres d'un nœud sont mis à jour ou un nœud est supprimé, désactivé ou activé. Seuls les nombres d’événements des nœuds en aval sont affectés.

Pour ouvrir ou modifier un flux de travail existant

Sur la page Gérer les automatisations, cliquez sur le flux de travail que vous souhaitez ouvrir ou modifier.

Pour modifier le nom d'un flux de travail

• Sur la page Gérer les automatisations, sélectionnez un flux de travail, puis sélectionnezActions > Renommer.
• Sur la page Créer d’un workflow :
  • Cliquez sur le nom du workflow (à côtéMenu) à modifier.
  • SélectionnerMenu > Renommer.

Pour supprimer un flux de travail

Sur la page Gérer les automatisations, sélectionnez un flux de travail, puis sélectionnezActions > Supprimer.

Pour partager un flux de travail

Sur la page Gérer les automatisations, cliquez sur l’icône Partager avec d’autres. Ou, sur la page Créer d'un workflow, sélectionnezMenu>Partager. Grâce au partage, vous pouvez accorder des niveaux d’autorisations sur un élément à d’autres utilisateurs. Vous pouvez partager un élément si vous en êtes propriétaire ou si vous êtes un utilisateur disposant de l'autorisation Gérer dans Sécurité, comme un administrateur. Pour plus d'informations sur le partage et la propriété, voirContrôle d'accès basé sur les rôles et les utilisateurs.

Le partage d'une automatisation peut nécessiter l'octroi d'autorisations supplémentaires à d'autres composants de l'automatisation, comme l'accès à un référentiel pour exécuter une tâche.workspace. Si ces autorisations ne sont pas déjà accordées,FME Flow tente de les accorder. Dans la boîte de dialogue Options de partage, vous pouvez afficher les autorisations supplémentaires requises sur l'automatisation.

Pour afficher les tâches déclenchées par un flux de travail

• Sur la page Gérer les automatisations, sélectionnez un flux de travail, puis sélectionnezActions > Afficher les tâches déclenchées.
• Sur la page Créer d’un workflow, sélectionnezMenu > Afficher les tâches déclenchées.

Pour créer une application d'automatisation à partir d'un flux de travail

Sélectionnez une automatisation qui contient unDéclencheur manuel, cliquezActes, et sélectionnezCréer une application d'automatisation.

Affichage des automatisations

La page Gérer les automatisations répertorie toutes les automatisations créées sur votreFME Flow.

Les colonnes affichées sur cette page sont :

• Nom: Le nom défini par l'utilisateur de l'automatisation.
• Mots clés: Les balises attribuées à l'automatisation, le cas échéant. Pour plus d'informations, voirPour filtrer la liste des workflows , ci-dessous.
• Dernière mise à jour: L'heure à laquelle l'automatisation a été mise à jour pour la dernière fois, en utilisant la syntaxe suivante :

année-mois-jour heure:minute:seconde

• Commencé:Que l'automatisation soit démarrée ou non. Les automatisations n'écoutent pas les messages entrants et ne s'exécutent pas tant qu'elles ne sont pas explicitement démarrées.
• Propriétaire: L'utilisateur qui a créé l'automatisation et qui dispose de toutes les autorisations sur celle-ci.
• Statut: L'état actuel de l'automatisation.
• Partager: Pour partager une automatisation, cliquez sur l’icône Partager avec d’autres. Pour plus d'informations, voir Pour partager un flux de travail .
• Identifiant: L'ID généré par le système de l'automatisation. Pour copier, cliquez sur l'icône Copier sur Clickboard.

Pour filtrer la liste des workflows

• Pour appliquer un filtre:Sur la page Gérer les automatisations, développez leFiltresbar.
• Pour ajouter (ou supprimer) des balises:Utilisez des balises pour organiser les flux de travail en catégories significatives sur lesquelles vous pouvez filtrer. Sur la page Gérer les automatisations, sélectionnezGérer les balises.

Travailler avec les journaux d'automatisation

Les journaux d’automatisation enregistrent toutes les activités effectuées sur les flux de travail.

Travailler avec les journaux des automatisations exécutées en mode démarrage

Ouverture des journaux d'automatisation du mode de démarrage

Sur la page Gérer les automatisations, effectuez l’une des opérations suivantes :

• Sélectionnez un flux de travail et cliquez surActes>Afficher les fichiers journaux.
• Cliquez sur une icône d’erreur ou d’avertissement sous la colonne Statut d’un flux de travail correspondant. Le journal s'ouvre avec « Erreurs de filtre » ou « Avertissements de filtre » définis respectivement.

Sur la page Créer d’un workflow, sélectionnezAfficher les fichiers journaux du menu.

Téléchargement des journaux d'automatisation agrégés du mode de démarrage

Vous pouvez télécharger un journal d'une exécution d'automatisation en mode Démarrage qui est agrégé par une plage de dates spécifiée.

1. Effectuez l’une des opérations suivantes :
   • Depuis la page Gérer les automatisations, sélectionnez une automatisation et cliquez surActes>Télécharger les journaux.
   • Depuis la page de l'automatisation qui est ouverte, sélectionnezTélécharger les journaux de laMenu.
2. Dans la boîte de dialogue Télécharger les journaux, spécifiez unDate de début etDate de fin pour la gamme de journaux que vous souhaitez télécharger.
3. Cliquez sur Télécharger .

Navigation dans les journaux d'automatisation du mode de démarrage

LeJournaux>Automatismesdossier dansRessources contient un dossier pour chaque processus pouvant comprendre n'importe quelle automatisation, y compris un dossier pour chaque type de déclencheur, d'action, d'action externe et d'autres composants. Ces journaux contiennent des métadonnées sur le composant particulier, y compris son nom d'automatisation respectif, son ID d'automatisation, son ID d'événement (le cas échéant) et son message.

Le tableau suivant décrit certains de ces dossiers, mais pas tous :

Dossier du journal d'automatisation	Description
fmeautomations.log	Contient des métadonnées sur l'assemblage d'une automatisation, le démarrage et l'arrêt d'une automatisation et l'exécution de tâches.
action_fmelogaction	Contient des métadonnées surEnregistrer un message actes. NotePour ouvrir ce journal directement depuis leEnregistrer un message action d'un automatisme, ouvrir leEnregistrer un message action depuis la page de construction de l'automatisation, puis cliquez surAccéder au journal de débogage.

Configuration de la durée de conservation des journaux d'automatisation du mode de démarrage

Utilisez leSupprimer les journaux de production d'automatisationtâche pour configurer la durée de conservation des journaux d'automatisation du mode de démarrage. Par défaut, les messages datant de plus d'une semaine sont supprimés.

Voir aussi

• À propos des fichiers journaux dansFME Flow

Travailler avec les journaux des automatisations exécutées en mode débogage

Le journal d'une automatisation en mode débogage n'est disponible que jusqu'au redémarrage de l'automatisation, quel que soit le mode.

Ouverture des journaux d'automatisation du mode débogage

Sur la page Gérer les automatisations, effectuez l’une des opérations suivantes :

• Sélectionnez un flux de travail et cliquez surActes>Afficher le journal de débogage.
• Cliquez sur l’icône Afficher le journal de débogage sous la colonne Démarré d’un flux de travail correspondant.
• Cliquez sur une icône d’erreur ou d’avertissement sous la colonne Statut d’un flux de travail correspondant. Le journal s'ouvre avec « Erreurs de filtre » ou « Avertissements de filtre » définis respectivement.

Sur la page Créer d’un workflow, sélectionnezAfficher le journal de débogage depuis le menu ou, si l'automatisation est toujours en cours d'exécution, depuis la bannière du mode débogage.

Si l'automatisation contient unEnregistrer un message action, vous pouvez ouvrir le journalaction_fmelogaction directement depuis la page de build de l'automatisation. Ouvrez leEnregistrer un message action et clicAccéder au journal de débogage.

Affichage des journaux d'automatisation du mode débogage

Sur la page de journal d'une automatisation, utilisez la barre d'outils pour filtrer le journalEnregistrer un message messages d'action, d'erreur, d'avertissement ou d'information. Vous pouvez également :

• Téléchargez le journal.
• Masquer ou afficher les horodatages.
• Inverser l’ordre chronologique des messages du journal.
• Actualiser l'affichage du journal.

Configuration de la durée de conservation des journaux d'automatisation du mode débogage

Sur leNettoyages programmés page, vous pouvez configurer la durée de conservation des messages du journal de débogage d'automatisation qui n'ont pas déjà été effacés par un redémarrage de l'automatisation. Par défaut, les messages datant de plus de deux semaines sont supprimés.