File Connector

Pro Ausführung wird eine Datei im angegebenen Verzeichnis gelesen (wenn deren Name dem Muster entspricht, das im Feld Datei > Name angegeben ist). Welche Datei gelesen wird, hängt von Ihren Angaben bei Lesereihenfolge ab.

Es werden alle Dateien im angegebenen Verzeichnis gelesen (wenn deren Dateinamen dem Muster entsprechen, das im Feld Datei > Name angegeben ist). Im Verzeichnismodus wird immer eine Ausgangsnachricht (XML) erzeugt, d.h., der Technical Workflow startet in jedem Fall.

Beispiel:

Pfad zum Verzeichnis, aus dem Dateien gelesen werden sollen. Der Pfad kann absolut oder relativ zum Verzeichnis <inubit-installdir>/server/process_engine/bin angegeben werden.

Wenn markiert, dann können Sie beim Eingeben des Dateinamens eine Wildcard (Stern *) verwenden oder den Dateinamen vollständig eingeben.

Wenn markiert, dann können Sie mithilfe eines regulären Ausdrucks ein Muster angeben, dem die Dateinamen der einzulesenden Dateien entsprechen müssen.

Siehe Reguläre Ausdrücke.

Siehe Reguläre Ausdrücke.

Wenn markiert, dann wird das Muster, das für den Dateinamen angegeben wurde, umgekehrt. Damit werden alle Dateien gelesen, deren Name dem Muster nicht entspricht.

Wenn aktiviert, wird die Groß-/Kleinschreibung bei Dateinamen inklusive der Dateinamenserweiterung ignoriert.

Beispiel: Ein vorher ausgeführter File Connector wurde so konfiguriert, dass im Feld Dateiname eine Datei Test*.xml angegeben wurde. Als Ausgangsnachricht wurde vom File Connector eine Datei mit Namen Test5.xml weitergeleitet. Der Wildcard-Inhalt ist in diesem Fall das Zeichen 5. Wenn Sie im vorliegenden Connector ebenfalls eine Wildcard angegeben haben, zum Beispiel Ausgabe*.xml, so wird an Stelle der Wildcard das Zeichen 5 eingefügt. Die Ausgabe des hier konfigurierten Connectors ist daher Ausgabe5.xml.

Wenn aktiviert, werden die Dateien nach dem Lesen gelöscht. Aktivieren Sie diese Option, um alle Dateien eines Verzeichnisses nacheinander zu bearbeiten.

Wenn zusätzlich die Option Fehler erzeugen, wenn Löschvorgang fehlschlägt aktiviert ist, dann wird im Queue Manager ein Fehlereintrag für den Workflow mit diesem Modul angezeigt, falls die Datei nicht gelöscht werden kann. Wenn ein Fehlerausgang konfiguriert ist, wird dieser durchlaufen. Sonst wird die Ausführung des Moduls abgebrochen.

(Nur im Dateimodus)
Markieren Sie diese Option, um sicherzustellen, dass der File Input Connector keine Dateien liest, während diese noch von anderen Applikationen geschrieben werden. Wenn die Option markiert ist, dann prüft der File Input Connector in einem konfigurierbaren Intervall die Zeitstempel und Größen der zu lesenden Dateien und vergleicht diese. Die Dateien werden nur eingelesen, wenn sich die Angaben nicht geändert haben.

Mit der Angabe legen Sie fest, wie oft pro auslösendem Event der Workflow maximal gestartet werden soll. Auslösendes Event ist das Erreichen eines Zeitpunktes. Dann wird der Workflow so oft gestartet, bis entweder

Ist der Wert für Max. Anzahl von Ausführungen pro zeitgesteuertem Aufruf größer als 1, kann diese Option gewählt werden, um die festgelegte Anzahl an Aufrufen auch nach einem vorhergehenden Fehler fortzusetzen.

Wenn markiert, liest der File Connector zusätzlich zu den Dateien im angegebenen Verzeichnis auch das Verzeichnis selbst ein.

Löscht leere Verzeichnisse nach dem Lesen; diese Option ist sinnvoll vor allem in Kombination mit der Option Dateien nach dem Lesen löschen.

Aktivieren Sie diese Checkbox, um das Quellverzeichnis zu löschen, auch wenn es nicht leer ist. Wenn das Quellverzeichnis vorhanden ist, wird es gelöscht. Andernfalls wird das Löschen des Verzeichnisses abgebrochen.

Maximale Anzahl von Dateien, die eingelesen werden.

Die maximale Gesamtgröße, bis zu der Dateien eingelesen werden.

Wird die maximale Gesamtgröße erreicht wird, das Einlesen beendet.

Prüft, ob eine passende Datei mit einer Größe=0 vorhanden ist.

Wenn ja, wird eine XML-Datei mit dem Element <FileExists> mit dem Wert true ausgegeben. In jedem anderen Fall wird die Workflow-Ausführung mit einem Fehler abgebrochen. Die Eingabedatei wird nicht ausgegeben.

Prüft, ob eine geeignete Datei vorhanden ist oder nicht.

Ausgegeben wird eine XML-Datei mit dem Element <FileExists> und dem Wert false, wenn die angegebene Datei nicht existiert, bzw. true, wenn die angegebene Datei existiert. Die Eingabedatei wird nicht ausgegeben.

Prüft, ob eine passende Datei vorhanden ist.

Wenn nicht, wird eine XML-Datei mit dem Element <FileExists> und dem Wert false ausgegeben. In jedem anderen Fall wird die Workflow-Ausführung mit einem Fehler abgebrochen. Die Eingabedatei wird nicht ausgegeben.

Legen Sie fest, wie die Eingangsnachrichten an den Workflow übergeben werden sollen:

Legt die Kodierung des Zeichensatzes fest.

Wenn markiert, dann wird die gesamte Datei gelesen. Wenn nicht markiert, dann werden nur die Metadaten der Datei gelesenen, z.B. Name, Dateigröße und Datum.

Wenn markiert, wird der absolute Pfad der Datei in einem gesonderten Attribut path gespeichert.

Die Eingangsnachrichten sind Daten, die unverändert in eine Datei geschrieben werden sollen.

Die Eingangsnachrichten haben das Format IBISDirectory-Xml und werden in ein ausgewähltes Verzeichnis abgelegt.

Bei dieser Option erwartet der File Connector ein Zip-Archiv als Eingangsnachricht. Der File Connector entpackt dieses Archiv und speichert die entpackten Daten im angegebenen Verzeichnis.

Absoluter Pfad zu dem Verzeichnis, das der File Connector beim Schreiben von Dateien verwenden soll.

Zusätzlich können Sie dem zu erzeugenden Dateinamen ein Datum, einen Zeitstempel oder die Prozess-ID hinzufügen:

Erzeugt alle nicht-existierenden Verzeichnisse aus der Pfadangabe.

Wenn die Checkbox aktiviert ist, können Sie einen neuen Namen für das im Feld Name konfigurierte Verzeichnis angeben, um es umzubenennen.

Ist das Quellverzeichnis nicht vorhanden, wird der Workflow abgebrochen.

Ist das Zielverzeichnis vorhanden, wird das Quellverzeichnis nicht umbenannt.

Auch im Dateinamen können Sie Wildcards () verwenden, und Zeitstempel sowie Prozess-ID einfügen lassen, siehe Option *Verzeichnis > Name.

Beispiel: Ein vorher ausgeführter File Connector wurde so konfiguriert, dass im Feld Verzeichnis und Dateiname eine Datei Test*.xml angegeben wurde. Als Ausgangsnachricht wurde vom File Connector eine Datei mit Namen Test5.xml weitergeleitet. Der Wildcard-Inhalt ist in diesem Fall das Zeichen 5. Wenn Sie im aktuellen Connector ebenfalls eine Wildcard angegeben haben, zum Beispiel Ausgabe*.xml, so wird an Stelle der Wildcard das Zeichen 5 eingefügt. Die Ausgabe des hier konfigurierten Connector-Moduls ist daher Ausgabe5.xml.

Beispiel: ein vorher ausgeführter File Connector wurde so konfiguriert, das im Feld Verzeichnis und Dateiname eine Datei Test.xml angegeben wurde. Als Ausgangsnachricht wird vom File Connector eine Datei mit genau diesem Namen Test.xml weitergeleitet. Dieser Dateiname wird dann auch hier verwendet.

Diese Option stellt sicher, dass Applikationen, die auf die Datei warten, die Datei erst nach deren Fertigstellung abholen.

Wenn markiert, dann werden die Daten zunächst in eine temporäre Datei geschrieben. Wenn dieser Vorgang abgeschlossen ist, wird die temporäre Datei entsprechend dem angegebenen Namen umbenannt. Bei größeren Dateien kann das Erstellen der temporären Datei länger dauern.

Wenn bereits eine Datei mit demselben Namen existiert, dann wird diese überschrieben.

Die zu lesende Datei wird bei jeder Ausführung des Workflows an eine evtl. bereits existierende Datei angehängt. Dies ist z.B. sinnvoll, um Log-Daten kumulativ in einer Datei zu protokollieren. Diese Option kann nicht verwendet werden, wenn im Dateinamen Wildcards angegeben sind!

Überspringt das Schreiben in eine vorhandene Datei, erstellt jedoch eine neue, wenn die Datei noch nicht vorhanden ist. In der Watchpoint-Ergebnisdatei enthält die Workflowvariable fileConnector.skippedFiles die Namen der bereits existierenden Dateien.

Wenn die Option markiert ist, dann wird die Eingabedatei an nachfolgende Module weitergeleitet. Abhängig von der Größe der Eingabedateien kann diese Option die Performance Ihres Systems beeinflussen.