FME Workspace Subscriber

Der FME Workspace Subscriber abonniert einen FME Form-Workspace für ein Notification Service-Thema. Der angegebene Workspace wird jedes Mal ausgeführt, wenn er eine Benachrichtigung von dem festgelegten Thema erhält. Der Workspace muss bereits auf FME Flow hochgeladen sein. Um den Inhalt der Benachrichtigung im Workspace zu verwenden, geben Sie einen offengelegten Workspace-Parameter an, um dessen Daten aus der Benachrichtigung zu erhalten. Verwenden Sie alternativ Reader, Writer oder Transformer, die auf den Empfang von JSON-formatierten Benachrichtigungen ausgerichtet sind.

Hinweis  Unterstützung für den FME Workspace Subscriber in der FME Flow REST-API beginnt in Version 3 (REST v3), verfügbar in FME Flow 2016. Der Workspace Subscriber wird in früheren Versionen der FME Flow REST-API nicht unterstützt.

Konfigurieren des Subscribers

  1. Wählen Sie in der FME Flow-Web-Benutzeroberfläche die Option Benachrichtigungen > Subskriptionen und klicken Sie auf Neu.
  2. Geben Sie einen Namen für die Subskription an
  3. Wählen Sie im Dropdown-Menü Protokoll die Option FME-Workspace.

  4. Legen Sie die Themen fest, für die Sie die Subskription vornehmen wollen, indem Sie den Dropdown-Selektor verwenden. Um ein Thema zu erstellen, das Sie direkt verwenden können, klicken Sie auf +.

  5. Repository: Geben Sie den Namen des Repositorys an, in dem sich der Workspace befindet.
  6. Workspace: Geben Sie den Workspace an, den Sie abonnieren möchten.
  7. Wenn der angegebene Workspace über offengelegte Parameter verfügt, konfigurieren Sie die gewünschten Einstellungen, wenn der Workspace ausgeführt wird.
    • Wert von Themen-Nachricht erhalten: Diese Einstellung gilt für alle offengelegten Parameter, die eine Quelldatei repräsentieren. Wenn diese Option aktiviert ist, werden die Benachrichtigungsinhalte in eine Datei geschrieben und der offengelegte Parameter erhält seine Daten aus der Datei.

      • Wenn die Benachrichtigung ein Schlüsselwort subscriber_content enthält, wird der Wert direkt in die Datei geschrieben. Auf diese Weise können beliebige Benachrichtigungsinhalte an einen Workspace gesendet werden. Andernfalls wird die vollständige Benachrichtigung analysiert und im JSON-Format in die Datei geschrieben.

      Es ist üblich, den Quelldatensatz eines Textdatei- oder JSON-Readers als offengelegten Parameter bereitzustellen. Wenn diese Option aktiviert ist, stehen die vom Reader erzeugten Features durch den Benachrichtigungsinhalt zur Verfügung oder sie können in einem Transformer wie dem AttributeFileReader gelesen werden.

      Hinweis  Benachrichtigungen werden in den Ordner "System > temp > subscriptions" in Ressourcen geschrieben. Im Workspace kann auf die Benachrichtigung auch über den Workspace-Parameter FME_TOPIC_MESSAGE zugegriffen werden.
    • Ergebnisdaten in Erfolgsthema-Nachricht versenden: Diese Einstellung gilt für alle offengelegten Parameter, die eine Zieldatei darstellen. Wenn diese Option aktiviert ist, werden die Ergebnisse der offengelegten Parameter in eine Ausgabedatei geschrieben, die als XML, JSON oder Text geparst werden kann. Der Inhalt der Datei ist in der Benachrichtigung enthalten, die an das im ParameterBei Erfolg an Thema senden (unten) angegebene Ziel gesendet wird.
      • Hinweis  Die Ausgabedatei wird in den Ordner "System > temp > subscriptions" in Ressourcen geschrieben.
  8. Konfigurieren Sie nach Bedarf Themen für Erfolgs- / Fehlerbenachrichtigungen. Weitere Informationen finden Sie unter Überwachen des FME Workspace Subscribers weiter unten.
    9. Hinweis  Workspaces, die vom Workspace Subscriber ausgeführt werden, generieren Erfolgsbenachrichtigungen nur über diesen Mechanismus. Benachrichtigungen, die über den Job Submitter- oder Data Download-Dienst konfiguriert werden, werden nicht generiert, wenn ein Workspace vom Workspace Subscriber ausgeführt wird.
  9. Konfigurieren Sie die erweiterten Einstellungen wie gewünscht. Diese Einstellungen wirken sich auf alle Jobs aus, die von diesem Workspace ausgeführt werden, wenn sie vom Subscriber ausgelöst werden:
    • Job-Warteschlange (optional): Die Warteschlange, in der der Job ausgeführt wird. Die angegebene Warteschlange hat Vorrang vor der Warteschlange, die andernfalls auf der Grundlage von Job-Routing-Regeln, die in der Warteschlangensteuerung definiert wurden, zugewiesen werden würde. Wenn hier nichts angegeben wird, gelten die Job-Routing-Regeln. Öffnen Sie die Seite Engines, um die Warteschlangen anzuzeigen, denen FME Engines zugewiesen sind.
    • Ablaufzeit für Jobs in Warteschlange (optional): Die Zeitdauer, nach der ein Job, der sich in der Warteschlange befindet, nicht ausgeführt wird. Falls der Job vor Ablauf dieser Zeit nicht ausgeführt wurde, verbleibt er in der Warteschlange, bis er bereit für die Ausführung ist, jedoch wird keine Ausführung versucht. Diese Direktive ist für zeitkritische Jobs nützlich, die nach Ablauf einer festgelegten Zeitdauer nicht mehr ausgeführt werden sollen.
    • Ablauffrist für die Ausführung des Jobs (optional): Die Zeit, die ein Job im Ausführungsstatus verbleibt. Diese Anweisung wird verwendet, um sicherzustellen, dass ein Job eine FME Engine nicht auf unbestimmte Zeit blockiert. Der minimale erlaubte Wert ist 1.
  10. Klicken Sie auf OK.

Überwachen des FME Workspace Subscribers

Sie können den Erfolg oder Misserfolg von Workspace Subscribern überwachen, indem Sie Benachrichtigungen in Themen publizieren, wenn einer der folgenden Fälle eintritt:

  • Ein Workspace Subscriber erhält erfolgreich eine Benachrichtigung von einem Thema.
  • Ein Workspace Subscriber erhält keine Benachrichtigung von einem Thema.

Nachdem Sie die Themen festgelegt haben, müssen Sie eine Subskription konfigurieren, um die Benachrichtigung zu erhalten. Um die Benachrichtigung im Nachrichtentext der Subskription zu verarbeiten, verwenden Sie die Schlüsselwörter in der JSON-Vorlage, die für jeden Benachrichtigungstyp wie folgt generiert wird:

Benachrichtigungsvorlage für Subscriber-Fehler

{

"subscription" : <subscriptionName>,

"status" : "failure",

"msg" : <failureMsg>

}

Subscriber Success Notification Template:

{

"subscription" : <subscriptionName>,

"status" : "success",

"msg" : <successMsg>

}

Ein Beispiel für die Konfiguration eines SMTP-E-Mail-Subscribers unter Verwendung von Schlüsselwörtern für Benachrichtigungsvorlagen im Textkörper der E-Mail-Nachricht finden Sie unter Sprache der E-Mail-Vorlage.

Weitere Informationen finden Sie unter Überwachen von FME Flow-Ereignissen anhand von Themen.