FME Flow:2025.1

FMEWorkspace Abonné

Le FMEworkspace l'abonné s'abonne à unFME Formworkspace à unService de notification sujet. Le spécifiéworkspace s'exécute chaque fois qu'il reçoit une notification du sujet spécifié. Leworkspace doit déjà être téléchargé surFME Flow. Pour utiliser le contenu de la notification dans leworkspace, spécifiez unworkspace paramètre publié pour obtenir ses données à partir de la notification. Vous pouvez également utiliser des lecteurs, des rédacteurs ou des transformateurs équipés pour recevoir des notifications au format JSON.

NoteSoutien à la FMEworkspace abonné dans leFME FlowAPI REST commence dans la version 3 (REST v3), disponible avec leFME Flow Sortie 2016. Leworkspace l'abonné n'est pas pris en charge dans les versions antérieures duFME Flow API REST.

Configuration de l'abonné

  1. In the FME Flow Web User Interface, select Notifications > Subscriptions, and click Create.
  2. Fournir unNompour l'abonnement
  3. Dans leProtocolemenu déroulant, sélectionnezFMEWorkspace.
  4. Précisez leThèmes vous souhaitez vous abonner en utilisant le sélecteur déroulant. Pour créer un sujet et l'utiliser immédiatement, cliquez sur+.

  5. Dépôt: Spécifiez le référentiel dans lequel leworkspace réside.
  6. Workspace: Specify the workspace you want to subscribe.
  7. Si le spécifiéworkspace a des paramètres publiés, configurez les paramètres que vous désirez lorsque leworkspace court.
    • Tirer profit du message du sujet: Ce paramètre s'applique à tous les paramètres publiés qui représentent un fichier source. Lorsque cette option est cochée, le contenu de la notification est écrit dans un fichier et le paramètre publié obtient ses données à partir du fichier.
    • Si la notification contient uncontenu_abonné mot-clé, la valeur est écrite dans le fichier sans aucune analyse. Cette approche est un bon moyen d’envoyer n’importe quel contenu de notification arbitraire à unworkspace. Sinon, la notification complète est analysée et écrite dans le fichier au format JSON.

      Une pratique courante consiste à exposer l'ensemble de données source d'un fichier texte ou d'un lecteur JSON en tant que paramètre publié. Lorsque cette option est cochée, les fonctionnalités produites par le lecteur sont disponibles via le contenu de la notification ou peuvent être lues dans un transformateur tel que AttributeFileReader.

      NoteLes notifications sont écrites dans le dossier Système > temp > abonnements dansRessources. Dans leworkspace, la notification est également accessible via le FME_TOPIC_MESSAGEworkspace paramètre.
    • Envoyer les données de résultat dans le message de sujet de réussite: Ce paramètre s'applique à tous les paramètres publiés qui représentent un fichier de destination. Lorsque cette option est cochée, les résultats du paramètre publié sont écrits dans un fichier de sortie, qui peut être analysé en XML, JSON ou texte. Le contenu du fichier est inclus dans la notification envoyée au sujet spécifié parPublier sur le sujet sur le succès (ci-dessous).
    • NoteLe fichier de sortie est écrit dans le dossier Système > temp > abonnements dansRessources.
  8. Configurez les sujets pour les notifications de réussite/échec, comme vous le souhaitez. Pour plus d'informations, voirSurveillance du FMEWorkspace Abonnés ci-dessous.
  9. NoteWorkspaces qui sont exécutés à partir duworkspace les abonnés génèrent des notifications de réussite et d'échec uniquement via ce mécanisme. Les notifications configurées via les services Job Submitter ou Data Download ne sont pas générées lorsqu'unworkspace est exécuté à partir duworkspace abonné.
  10. Configurez les paramètres avancés comme vous le souhaitez. Ces paramètres affectent tous les travaux exécutés par ceworkspace, lorsqu'il est déclenché par l'abonné :
    • File d'attente des tâches (facultatif) : la file d'attente dans laquelle exécuter le travail. La file d'attente spécifiée remplace la file d'attente qui serait autrement attribuée en fonction deQueue Control règles de routage des tâches. Si non spécifié, les règles de routage des tâches s'appliquent. Pour afficher les files d'attente auxquelles les moteurs FME sont affectés, ouvrez leEngines page.
    • Heure d'expiration des tâches en file d'attente (facultatif) : la durée après laquelle un travail en attente dans la file d'attente ne s'exécute pas. Si le travail ne s'exécute pas avant que ce délai ne soit atteint, il reste dans la file d'attente jusqu'à ce qu'il soit prêt à être exécuté, mais l'exécution n'est pas tentée. Cette directive est utile pour les tâches sensibles au temps que vous ne souhaitez pas exécuter une fois le délai spécifié dépassé.
    • Heure d'expiration du travail en cours d'exécution (facultatif) : la durée pendant laquelle un travail restera en cours d'exécution. Cette directive est utilisée pour garantir qu'un travail ne se bloque pas et ne bloque pas un moteur FME indéfiniment. La valeur minimale autorisée est 1.
    • Exécuter jusqu'à annulation: Si cette option est cochée, le travail s'exécute en continu, même après un arrêt ou un crash du serveur, jusqu'à ce qu'il soit explicitement annulé.
    • NoteDans la mesure du possible, exécutez les tâches en continu via leFlux interface à la place.
  11. Cliquez sur OK .

Surveillance du FMEWorkspace Abonnés

Vous pouvez surveiller le succès ou l’échec deworkspace abonnés en publiant des notifications sur les sujets lorsque l'un des événements suivants se produit :

  • UNworkspace l'abonné reçoit avec succès une notification d'un sujet.
  • UNworkspace l'abonné ne parvient pas à recevoir une notification d'un sujet.

Après avoir spécifié les sujets, vous devez configurer unabonnement pour recevoir la notification. Pour traiter la notification dans le corps du message de l'abonnement, utilisez les mots-clés du modèle JSON généré pour chaque type de notification, comme suit :

Modèle de notification d'échec d'abonné

{

"abonnement" : <subscriptionName>,

"statut" : "échec",

"msg" : <failureMsg>

}

Modèle de notification de réussite de l'abonné :

{

"abonnement" : <subscriptionName>,

"statut" : "succès",

"msg" : <successMsg>

}

Pour un exemple de configuration d'un SMTPAbonné par e-mail en utilisant des mots-clés de modèle de notification dans le corps du message électronique, voir Langue du modèle d'e-mail.

Pour plus d'informations, voir SurveillanceFME Flow Événements de Topics .