Einführung in File Trigger

Prozessentwicklung

Ossi Galkin avatarGeschrieben vonOssi Galkin Vor über einer Woche aktualisiertTable of contents

Datei-Trigger

Wenn Sie einen Prozess starten möchten, wenn eine bestimmte Datei in einem Verzeichnis erscheint, können Sie den Dateitrigger verwenden. Dateitrigger werden ausgelöst, wenn eine Datei, die dem Dateifilter entspricht, im zu überwachenden Verzeichnispfad gespeichert wird.

Der Trigger überwacht, ob neue Dateien zu den überwachten Verzeichnissen hinzugefügt werden. Eine neu erstellte Datei führt beispielsweise dazu, dass der Trigger einen Prozess startet. Wenn die Datei jedoch im Verzeichnis verbleibt und geändert wird, wird keine neue Ausführung ausgelöst. Die Dateiüberwachung überprüft die Dateien im Verzeichnis außerdem alle 10 Sekunden.

Der Trigger verfolgt Dateien, die er bereits verarbeitet hat, anhand ihrer Dateinamen. Das bedeutet, dass er nicht bemerkt, wenn Sie beispielsweise die Datei überschreiben oder eine Datei schnell löschen und dann eine neue mit demselben Namen erstellen. Es kann bis zur maximalen Polling-Verzögerung von 10 Sekunden dauern, bis er bemerkt, dass eine Datei entfernt wurde.

Es wird empfohlen, die Dateien nach der Verarbeitung immer aus den überwachten Verzeichnissen zu löschen, da die Nachverfolgung Ressourcen beansprucht. Wenn Sie Tausende von Dateien im Ordner haben, kann die Verarbeitung langsamer werden.

In einer HA-Agentengruppe sollte das überwachte Verzeichnis von allen Agenten in derselben Agentengruppe aus zugänglich sein. Andernfalls erkennen die anderen Agenten die Datei als im überwachten Ordner fehlend und entfernen sie aus der Nachverfolgung, sodass die Datei erneut verarbeitet werden muss.

Für den Dateitrigger können folgende Parameter definiert werden.Verzeichnisist der Verzeichnispfad, aus dem die Dateien abgerufen werden.Dateifilterdefiniert die Maske (z.B. '*.xml') mitdie möglichen Platzhalter. DerUnterverzeichnisse einbeziehenWenn das Flag aktiviert ist, ruft der Trigger alle passenden Dateien aus den Unterverzeichnissen ab.Maximale Anzahl gleichzeitig zu verarbeitender Dateiendefiniert die maximale Anzahl gleichzeitig zu verarbeitender Dateien, wobei das Maximum 1000 beträgt.Poll-Intervall in Sekundenist die Zeit, bevor die Dateien erneut verarbeitet werden.Ruhezeit in Sekundenist die Wartezeit in Sekunden seit dem letzten Schreiben in eine Datei vor der Verarbeitung einer Datei.BenutzernameUndPasswortsind zu verwenden, wenn der Trigger nicht die Anmeldeinformationen des Frends Agent-Kontos verwendet, um auf das Verzeichnis zuzugreifen.

Datei-Trigger-Parameter, insbesondereNameUndVerzeichnissind keine Text- oder Ausdrucksfelder, wie man sie von den anderen Prozesselementen kennt. Stattdessen verhalten sie sich wie Textfelder, mit der Ausnahme, dass Sie Umgebungsvariablen ohne Handlebars verwenden können. Wenn Sie beispielsweiseC:\EaiFilesin Umgebungsvariable gespeichert#env.EAI, dann könnten SieVerzeichniskonfiguriert als#env.EAI\In. Es würde dann den Ordner überwachenC:\EaiFiles\In.

Verweisen auf Triggerparameterwerte

Sobald der Prozess durch eine Datei ausgelöst wird, stehen die Dateipfade dem Prozess über die#trigger.data.filePaths. Es handelt sich um ein Array System.Object[], das Strings (Dateipfade) enthält. Für weitere Details gibt es auch die#trigger.daten.dateienReferenz, die ein Array von Objekten mit den folgenden Eigenschaften zurückgibt:FileChangeType, VollständigerPfad, Dateiname.

Der nächste Artikel istEinführung in API Trigger


Verwandte ArtikelDatei-TriggerEinführung in Trigger bei FreundenEinführung in API TriggerEinführung in HTTP-TriggerEinführung in bedingte Trigger