Directory Watch Publisher

Der Directory Watch-Publisher überwacht die Aktivitäten auf einem Ressourcen-Ordner oder anderen Speicherort und veröffentlicht Nachrichten zu dieser Aktivität in FME Flow-Themen Die Aktivität kann das Hinzufügen, Ändern und Löschen von Dateien und Ordnern umfassen.

Hinweis  Sie können keinen Amazon Web Services (AWS) S3-Bucket mit dem Directory Watch-Publisher überwachen.

Konfigurieren des Publishers

  1. Wählen Sie in der FME Flow-Web-Benutzeroberfläche die Option Benachrichtigungen > Publikationen und klicken Sie auf Neu.
  2. Geben Sie einen Namen für die Publikation an.
  3. Protokoll: Wählen Sie "Directory Watch".

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

  5. Zu überwachendes Verzeichnis: Um ein Ressourcen-Verzeichnis zu überwachen, klicken Sie auf die Auslassungspunkte (...) und wählen Sie ein Verzeichnis aus, das Sie überwachen möchten. Um ein anderes Verzeichnis zu überwachen, geben Sie ein lokales Dateisystem oder einen Netzwerkpfad (UNC) direkt in das Textfeld ein.
    6. Hinweis  Das Benutzerkonto, unter dem der FME Flow Core Service ausgeführt wird, muss über Lese-/ Schreibrechte (Windows) oder Leserechte (Linux) für alle Verzeichnisse verfügen, die nicht als FME Flow-Ressourcen verwaltet werden. Informationen zum Hinzufügen von Verzeichnissen als Ressourcen finden Sie hier.
  6. Unterverzeichnisse überwachen: Um Aktivitäten im ausgewählten Verzeichnis und allen Unterverzeichnissen zu überwachen, geben Sie Ja an. Um Aktivitäten nur im ausgewählten Verzeichnis und nicht in dessen Unterverzeichnissen anzuzeigen, geben Sie Nein an. Diese Einstellung gilt auch für Verzeichnisse, die dem überwachten Verzeichnis hinzugefügt werden. Falls dieser Parameter auf Nein eingestellt ist, werden für Dateien in einem hinzugefügten Verzeichnis keine separaten Benachrichtigungen generiert.
  7. Benachrichtigungen für Ordner empfangen: Wenn dieser Parameter auf Ja eingestellt ist, überwacht der Publisher die Aktivitäten von Dateien und Ordnern. Wenn dieser Parameter auf Nein gesetzt ist, überwacht der Publisher nur die Aktivitäten von Dateien.
  8. Filter: Standardmäßig werden alle Aktionen im angegebenen Verzeichnis überwacht, einschließlich Hinzufügen (CREATE), Ändern (MODIFY) und Löschen (DELETE) von Dateien (und ggf. von Ordnern). Um nur eine oder zwei dieser Aktionen zu überwachen, klicken Sie auf das "x" neben der Aktion, die Sie nicht überwachen möchten, um sie zu entfernen. Um nach dem Entfernen eine Aktion hinzuzufügen, klicken Sie in die Dropbox und wählen Sie diese aus.

    9. Hinweis  Ereignisse werden aufgrund von Änderungen des Dateidatums ausgelöst. Wenn eine Datei überschrieben wird, wird ein MODIFY-Ereignis ausgelöst.

  9. Abfrageintervall: Gibt an, wie oft (in Minuten) das angegebene Verzeichnis nach Aktivitäten abgefragt wird.
    1. Initiale Aktion

      2. Wenn eine Aktion (CREATE, MODIFY, DELETE) stattfindet, tritt sie in das aktuelle Abfrageintervall ein, das teilweise abgelaufen ist.

    2. Benachrichtigung
      • DELETE-Aktionen: Nach Ablauf des aktuellen Abfrageintervalls wird eine Benachrichtigung gesendet.
      • CREATE- und MODIFY-Aktionen: Ein zusätzliches Abfrageintervall findet statt. Wenn die Aktion nach dem zusätzlichen Abfrageintervall abgeschlossen ist, wird eine Benachrichtigung gesendet. Andernfalls findet ein weiteres Abfrageintervall statt, und es wird eine Benachrichtigung gesendet, ob die Aktion abgeschlossen ist.
        • Hinweis  Das Senden der Benachrichtigung nach maximal zwei zusätzlichen Abfrageintervallen fungiert als Zeitüberschreitung, falls der Publisher nicht feststellen kann, ob die Aktion abgeschlossen ist. In einigen Fällen wird die Benachrichtigung als verfrüht betrachtet und kann bei nachfolgenden Workflows Probleme verursachen. Um diese Situation zu vermeiden, empfiehlt es sich, den Parameter Abfrageintervalllänger einzustellen als die Zeit, die benötigt wird, um eine Aktion abzuschließen.

      Hinweis  Eine CREATE- und MODIFY-Aktion für dieselbe Datei innerhalb eines einzelnen Abfrageintervalls löst nur eine CREATE-Benachrichtigung aus. Eine CREATE-, MODIFY- und DELETE-Aktion für dieselbe Datei innerhalb eines einzelnen Abfrageintervalls löst keine Benachrichtigung aus.
      Warnhinweis  Wenn eine unter Linux laufende FME Flow-Instanz ein bereitgestelltes Windows-Laufwerk überwacht und eine CREATE-Aktion auftritt, wird eine Benachrichtigung gesendet, sobald die erste Abfrage erfolgt, unabhängig davon, ob die Aktion abgeschlossen ist. Diese Benachrichtigung kann dazu führen, dass ein Subscriber (z. B. ein FME Workspace Subscriber) die Datei verwendet, bevor sie vollständig übertragen wurde, was zu einem Fehler führt.

  10. Klicken Sie auf OK.

Beispiele für Benachrichtigungs-Schemata

Um die eingehende JSON-Nachricht aus dem Directory Watch-Publisher zu parsen, verwenden Sie das benutzerdefinierte Format Directory Watch Reader in Ihrem FME Workbench-Workspace. Weitere Informationen und die Möglichkeit zum Herunterladen des Readers finden Sie im FME Hub unter https://hub.safe.com/.

Wenn eine Datei gelöscht wird

{

"dirwatch_publisher_path": "C:\\apps\\FMEFlow\\Temp\\sample_file.txt",

"dirwatch_publisher_content": "ENTRY_DELETE C:\\apps\\FMEFlow\\Temp\\sample_file.txt",

"dirwatch_publisher_action": "DELETE",

"fns_type": "dirwatch_publisher"

}

Wenn eine Datei geändert wird (z. B. hinzugefügter Inhalt)

{

"dirwatch_publisher_path": "C:\\apps\\FMEFlow\\Temp\\sample_file.txt",

"dirwatch_publisher_content": "ENTRY_MODIFY C:\\apps\\FMEFlow\\Temp\\sample_file.txt",

"dirwatch_publisher_action": "MODIFY",

"fns_type": "dirwatch_publisher"

}

Wenn eine Datei hinzugefügt wird

{

"dirwatch_publisher_path": "C:\\apps\\FMEFlow\\Temp\\sample_file.txt",

"dirwatch_publisher_content": "ENTRY_CREATE C:\\apps\\FMEFlow\\Temp\\sample_file.txt",

"dirwatch_publisher_action": "CREATE",

"fns_type": "dirwatch_publisher"

}