Mit dem FileInput-Knoten können Sie Nachrichten verarbeiten, die aus Dateien gelesen werden.
Aus einer einzigen Datei können eine oder mehrere Nachrichten gelesen werden. Die Nachrichten werden jeweils als separate Nachrichtenflusstransaktion weitergeleitet. Der Teil einer Datei, der eine Nachrichtenflusstransaktion generiert, wird als Datensatz bezeichnet. In einer Datei können ein oder mehrere Datensätze enthalten sein. Die Eigenschaften im Knoten geben an, wie der FileInput-Knoten die Datensätze in einer Datei bestimmt.
Der FileInput-Knoten befindet sich im Ablagefach Datei der Palette und wird in der Workbench durch folgendes Symbol dargestellt:
Der FileInput-Knoten liest Dateien aus einem angegebenen Verzeichnis (genannt Eingabeverzeichnis) und leitet auf Basis der Dateiinhalte Nachrichten weiter. Es werden nur Dateien mit Namen gelesen, die einem bestimmten Muster (Eingabemuster) entsprechen.
Sobald die Dateien verarbeitet wurden, werden sie vom FileInput-Knoten aus dem Eingabeverzeichnis gelöscht.
Optional kann der FileInput-Knoten Dateien von einem fernen FTP-Server zur Verarbeitung übertragen. Wenn die ferne Datei erfolgreich übertragen wurde, wird sie vom FTP-Server gelöscht, und die übertragene Kopie wird genau wie eine Datei im Eingabeverzeichnis verarbeitet. Es werden nur Dateien übertragen, die dem Eingabemuster entsprechen.
Der FileInput-Knoten speichert Dateien während und nach der Verarbeitung in Unterverzeichnissen. Alle diese Verzeichnisse beginnen mit dem Präfix mqsi. Zu diesen Verzeichnissen gehören das Archivverzeichnis (mqsiarchive) und das Backoutverzeichnis (mqsibackout).
Eine Datei wird standardmäßig als einzelner Datensatz behandelt und als einzelne Nachricht verarbeitet.
Wenn der FileInput-Knoten eine Nachricht weitergibt, werden die Informationen in der Nachrichtenbaumstruktur 'LocalEnvironment.File' gespeichert. Wenn die Eingabedatei leer ist, ist auch die Nachricht leer (es wird davon ausgegangen, dass Auswertungen weitergegeben werden). In der folgenden Tabelle ist die Nachrichtenbaumstruktur von 'LocalEnvironment.File' aufgeführt.
| Elementname | Elementdatentyp | Beschreibung |
|---|---|---|
| Directory | CHARACTER | Absoluter Verzeichnispfad des Eingabeverzeichnisses in der vom Dateisystem des Brokers verwendeten Form. Auf Windows-Systemen beispielsweise beginnt der Verzeichnispfad mit dem Laufwerkbuchstabenpräfix (z. B. C:). |
| Name | CHARACTER | Dateiname und Erweiterung. |
| LastModified | TIMESTAMP | Datum und Uhrzeit der letzten Änderung. |
| TimeStamp | CHARACTER | Der Zeitpunkt (Datum und Uhrzeit), zu dem der Empfangsknoten die Verarbeitung der Datei in der UTC-Zone gestartet hat, als Zeichenfolge. Anhand dieser Daten werden die Namen von Archiv- und Backout-Dateien erstellt, wenn diese Namen eine Zeitmarke enthalten. |
| Die folgenden Elemente enthalten Daten zu dem aktuellen Datensatz: | ||
| Offset | INTEGER (Ganze Zahl) | Start des Datensatzes in der Datei. Der erste Datensatz startet bei Offset 0. Ist das Element Teil einer Nachrichtenbaumstruktur 'Datenende', ist hier die Länge der Eingabedatei angegeben. |
| Record | INTEGER (Ganze Zahl) | Datensatznummer in der Datei. Der erste Datensatz startet bei Satznummer 1. Ist das Element Teil der Nachrichtenbaumstruktur 'Datenende', ist hier die Anzahl der Datensätze angegeben. |
| Begrenzer | CHARACTER | Die Zeichen, die zur Trennung dieses Datensatzes vom vorangehenden Datensatz verwendet werden, wenn für Datensatzerkennung Mit Begrenzer angegeben ist. Der erste Datensatz hat einen Begrenzer von null. Ist das Element Teil der Nachrichtenbaumstruktur 'Datenende', ist hier der auf den letzten Datensatz folgende Begrenzer angegeben, falls vorhanden. |
| IsEmpty | BOOLEAN | Gibt an, ob der vom Nachrichtenfluss weitergeleitete Datensatz leer ist. Der Parameter ist auf TRUE gesetzt, wenn der aktuelle Datensatz leer ist. Als Teil der Datenende-Nachrichtenbaumstruktur ist der Parameter immer auf TRUE gesetzt. |
Nachdem Sie eine Instanz des FileInput-Knotens in einen Nachrichtenfluss eingereiht haben, können Sie den Knoten konfigurieren; siehe Nachrichtenflussknoten konfigurieren. Die Knoteneigenschaften werden in der Eigenschaftenansicht angezeigt. Alle verbindlichen Eigenschaften, für die Sie einen Wert eingeben müssen (d. h. Eigenschaften ohne definierten Standardwert), sind mit einem Sternchen gekennzeichnet.
Konfigurieren Sie den FileInput-Knoten:
| Platzhalterzeichen | Beschreibung | Beispiel |
|---|---|---|
| * | Beliebige Folge von null oder mehr Zeichen | *.xml stimmt mit allen Dateinamen überein, deren Erweiterung xml lautet. |
| ? | Beliebiges einzelnes Zeichen | f??????.csv stimmt mit allen Dateinamen überein, die mit dem Buchstaben f beginnen, sechs weitere Zeichen umfassen und die Erweiterung .csv haben. |
Nach dem anfänglichen Suchlauf für das Verzeichnis beim Starten des Nachrichtenflusses wartet der FileInput-Knoten jeweils einen gewissen durch diese Eigenschaft definierten Zeitraum, wenn in dem Verzeichnis keine dem Eingabemuster entsprechenden Dateien gefunden werden. Somit muss der FileInput-Knoten nicht fortwährend auf das Dateisystem zugreifen, ein Vorgang, bei dem umfangreiche Systemressourcen benötigt werden.
Je kleiner der für diese Eigenschaft festgelegte Wert, desto schneller erkennt der FileInput-Knoten Dateien im Eingabeverzeichnis. Allerdings werden dafür mehr Systemressourcen benötigt. Wenn ein größerer Wert definiert ist, sind weniger Systemressourcen erforderlich, jedoch werden zu verarbeitende Dateien vom FileInput-Knoten später erkannt.
Diese Eigenschaft sollte nicht zur Arbeitsregulierung oder zur Verarbeitungsplanung eingesetzt werden. Wenn der FileInput-Knoten das Eingabeverzeichnis nur zu bestimmten Zeiten überwachen soll, sollten Sie den Nachrichtenfluss zu den entsprechenden Zeiten starten und stoppen.
Wenn Sie FTP-Verarbeitung auswählen und die Eigenschaft Scan-Verzögerung auf der Registerkarte 'FTP' einstellen, überschreibt dieser Wert die Einstellung für das Abfrageintervall.
Wenn Sie unter Datensatzerkennung die Option Gesamte Datei, Feste Länge oder Mit Begrenzer angeben, gilt für die Datensätze eine Längenbeschränkung von 100 MB. Wenn Sie unter Datensatzerkennung die Option Syntaktisch analysierte Folge angeben, führt der FileInput-Knoten keine Ermittlung der Datensatzlänge durch und beschränkt diese auch nicht. Die im Nachrichtenfluss nachgeordneten Knoten können die Datensatzlänge entweder ermitteln oder sehr lange Datensätze verarbeiten. Wenn lange Datensätze auf diese Weise verarbeitet werden sollen, müssen Sie sicherstellen, dass Ihr Broker über ausreichend Arbeitsspeicher verfügt. Eventuell müssen Sie die im Beispiel für umfangreiche Nachrichtenausgaben beschriebenen Nachrichtenflusstechniken anwenden, um den verfügbaren Arbeitsspeicher optimal zu nutzen.
In der folgenden Tabelle werden die Terminals des FileInput-Knotens beschrieben.
| Terminal | Beschreibung |
|---|---|
| Fehlerterminal | Das Ausgabeterminal, an das eine Nachricht weitergeleitet wird, wenn im Fall eines Fehlers, bevor eine Nachricht an das Ausgangsterminal weitergegeben werden kann, eine Störung weitergeleitet wird. An dieses Terminal weitergegebene Nachrichten werden nicht ausgewertet. Dies gilt selbst dann, wenn über die Eigenschaft Auswerten angegeben wurde, dass eine Auswertung stattfinden soll. |
| Ausgang | Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn sie erfolgreich aus der Eingabedatei extrahiert wurde. Wenn keine Fehler im Eingabefluss auftreten, wird die von einer externen Ressource empfangene Nachricht immer zuerst an das Ausgabeterminal gesendet. |
| Datenende | Das Ausgabeterminal, an das die Nachricht 'Dateiende' geleitet wird, nachdem alle Nachrichten in einer Datei verarbeitet wurden. Die Nachrichtenflusstransaktion 'Datenende' wird nur initialisiert, wenn dieses Terminal angeschlossen ist. |
| Catch-Terminal | Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn nachgeschaltet eine Ausnahmebedingung ausgegeben und von diesem Knoten abgefangen wurde. Ausnahmen werden nur abgefangen, wenn dieses Terminal angeschlossen ist. |
In den folgenden Tabellen werden die Knoteneigenschaften beschrieben. Die Spalte M zeigt an, ob die Eigenschaft obligatorisch ist (markiert mit einem Sternchen, wenn ein Wert eingegeben werden muss, weil kein Standardwert definiert ist). Die Spalte C zeigt an, ob die Eigenschaft konfigurierbar ist (Wert kann geändert werden, wenn der Nachrichtenfluss zur BAR-Datei hinzugefügt wird, um ihn einzusetzen).
In der folgenden Tabelle werden die Beschreibungseigenschaften des FileInput-Knotens beschrieben:
| Eigenschaft | M | C | Standardwert | Beschreibung |
|---|---|---|---|---|
| Knotenname | Nein | Nein | FileInput | Der Name des Knotens. |
| Kurzbeschreibung | Nein | Nein | None (Keinen) | Kurze Beschreibung des Knotens. |
| Ausführliche Beschreibung | Nein | Nein | None (Keinen) | Text, der den Zweck des Knotens im Nachrichtenfluss beschreibt. |
In der folgenden Tabelle werden die grundlegenden Eigenschaften des FileInput-Knotens beschrieben:
| Eigenschaft | M | C | Standardwert | Beschreibung |
|---|---|---|---|---|
| Eingabeverzeichnis | Ja | Ja | None (Keinen) | Der Pfad des Verzeichnisses, aus dem Eingabedateien verarbeitet werden. Das Verzeichnis befindet sich in dem Dateisystem, auf das der Broker Zugriff hat. |
| Dateiname oder Muster | Ja | Ja | * | Ein Dateiname oder eine Zeichenfolge mit optionalen Platzhalterzeichen (* oder ?) zur Bezeichnung der zu verarbeitenden Datei(en) aus dem Eingabeverzeichnis. |
| Maßnahme bei erfolgreicher Verarbeitung | Ja | Nein | Löschen | Die Maßnamen, die der Knoten nach erfolgreicher Verarbeitung der Inhalte ergreift. Folgende Optionen sind gültig:
|
| Doppelt vorhandene Archivdatei ersetzen | Ja | Nein | Nicht ausgewählt | Über diese Eigenschaft wird gesteuert, ob der Knoten vorhandene Archivdateien, die denselben Namen wie die Eingabedatei haben, überschreibt. Sie gilt nur, wenn für Maßnahme bei erfolgreicher Verarbeitung nicht Löschen angegeben ist. |
In der folgenden Tabelle werden die Eigenschaften von 'Syntaxanalyse der Eingabenachricht' des FileInput-Knotens beschrieben.
| Eigenschaft | M | C | Standardwert | Beschreibung |
|---|---|---|---|---|
| Nachrichtendomäne | Nein | Nein | Die Domäne für die Syntaxanalyse der ankommenden Nachricht. | |
| Nachrichtengruppe | Nein | Nein | Der Name oder die ID der Nachrichtengruppe, in der die ankommende Nachricht definiert ist. | |
| Nachrichtenart | Nein | Nein | Der Name der ankommenden Nachricht. | |
| Nachrichtenformat | Nein | Nein | Der Name des physischen Formats der ankommenden Nachricht. | |
| ID des codierten Nachrichtenzeichensatzes | Ja | Nein | Systemstandardwert des Brokers | Die ID des codierten Zeichensatzes, anhand dessen die Bytes der gerade gelesenen Datei interpretiert werden. |
| Nachrichtverschlüsselung | Ja | Nein | Systemstandardwert des Brokers | Das Codeumsetzungsschema für Zahlen und umfangreiche Zeichen, anhand dessen die Bytes der gerade gelesenen Datei interpretiert werden. Gültige Werte sind Ermitteltes Brokersystem oder ein numerischer Codierungswert. Weitere Informationen zur Codierung finden Sie unter Daten mit Nachrichtenflüssen konvertieren. |
In der folgenden Tabelle werden die Eigenschaften für die Parseroptionen des FileInput-Knotens beschrieben.
| Eigenschaft | M | C | Standardwert | Beschreibung |
|---|---|---|---|---|
| Zeitpunkt für Syntaxanalyse | Nein | Nein | Bei Bedarf | Durch diese Eigenschaft wird gesteuert, zu welchem Zeitpunkt eine Eingabenachricht syntaktisch analysiert wird.
Gültige Werte sind:
Eine vollständige Beschreibung dieser Eigenschaft finden Sie unter Bedarfsgerechte Syntaxanalyse. |
| Baumstruktur unter Verwendung von XML-Schemadatentypen erstellen | Nein | Nein | Nicht ausgewählt | Durch diese Eigenschaft wird gesteuert, ob die Syntaxelemente in der Nachrichtenbaumstruktur Datentypen aus dem XML-Schema enthalten. |
| XMLNSC-Kompaktparser für XMLNS-Domäne verwenden | Nein | Nein | Nicht ausgewählt | Durch diese Eigenschaft wird gesteuert, ob der XMLNSC-Kompaktparser für Nachrichten in der XMLNS-Domäne verwendet wird. Wenn Sie diese Eigenschaft festlegen, werden die Nachrichtendaten in Knoten, die mit dem Ausgabeterminal verbunden sind, unter XMLNSC angezeigt, wenn XMLNS die Nachrichtendomäne des MQRFH2-Eingabeheaders oder der Eigenschaft 'Syntaxanalyse der Eingabenachricht' ist. |
| Zugriff auf gemischten Inhalt | Nein | Nein | Nicht ausgewählt | Mit dieser Eigenschaft können Sie steuern, ob der XMLNSC-Parser Elemente in der Nachrichtenbaumstruktur erstellt, wenn er gemischten Text in einer Eingabenachricht feststellt. Wenn Sie das Kontrollkästchen aktivieren, werden Elemente für gemischten Text erstellt. Andernfalls wird gemischter Text ignoriert, und es werden keine Elemente erstellt. |
| Kommentare beibehalten | Nein | Nein | Nicht ausgewählt | Mit dieser Eigenschaft können Sie steuern, ob der XMLNSC-Parser Elemente in der Nachrichtenbaumstruktur erstellt, wenn er Kommentare in einer Eingabenachricht feststellt. Wenn Sie das Kontrollkästchen aktivieren, werden Elemente für Kommentare erstellt. Andernfalls werden Kommentare ignoriert, und es werden keine Elemente erstellt. |
| Verarbeitungsanweisung beibehalten | Nein | Nein | Nicht ausgewählt | Mit dieser Eigenschaft können Sie steuern, ob der XMLNSC-Parser Elemente in der Nachrichtenbaumstruktur erstellt, wenn er Verarbeitungsanweisungen in einer Eingabenachricht feststellt. Wenn Sie das Kontrollkästchen aktivieren, werden Elemente für Verarbeitungsanweisungen erstellt. Andernfalls werden Verarbeitungsanweisungen ignoriert, und es werden keine Elemente erstellt. |
| Nicht transparente Elemente | Nein | Nein | Über diese Eigenschaft wird eine Liste von Elementen in der Eingabenachricht angegeben, die vom XMLNSC-Parser nicht transparent analysiert werden sollen. |
In der folgenden Tabelle werden die Abfrageeigenschaften des FileInput-Knotens beschrieben:
| Eigenschaft | M | C | Standardwert | Beschreibung |
|---|---|---|---|---|
| Abfrageintervall (Sekunden) | Ja | Ja | 5 | Das Abfrageintervall in Sekunden. |
In der folgenden Tabelle werden die Wiederholungseigenschaften des FileInput-Knotens beschrieben:
| Eigenschaft | M | C | Standardwert | Beschreibung |
|---|---|---|---|---|
| Wiederholungsmechanismus | Ja | Nein | Fehler | Handhabung eines Flussfehlers durch den Knoten Folgende Optionen sind gültig:
|
| Wiederholungsschwellenwert | Ja | Ja | 0 | Mit diesem Wert wird angegeben, wie oft die Flusstransaktion wiederholt werden soll, wenn für Wiederholung Kurze Wiederholungszeit angegeben ist. |
| Kurzes Wiederholungsintervall | Nein | Ja | 0 | Das Intervall in Sekunden zwischen den Wiederholungen, wenn für den Wiederholungsschwellenwert ein Wert ungleich null angegeben ist. |
| Langes Wiederholungsintervall | Nein | Ja | 300 | Das Intervall zwischen den einzelnen Wiederholungen, wenn für den Wiederholungsmechanismus die Option Kurze und lange Wiederholungszeit angegeben ist und der Wiederholungsschwellenwert erreicht ist. |
| Maßnahme bei fehlgeschlagener Datei | Ja | Ja | In Unterverzeichnis für die Zurücksetzung verschieben | Die Maßname, die der Knoten für die Eingabedatei ergreift, wenn alle Versuche, den Dateiinhalt zu verarbeiten, fehlgeschlagen sind. Folgende Optionen sind gültig:
|
In der folgenden Tabelle werden die Eigenschaften 'Datensätze und Elemente' des FileInput-Knotens beschrieben:
| Eigenschaft | M | C | Standardwert | Beschreibung |
|---|---|---|---|---|
| Datensatzerkennung | Ja | Nein | Gesamte Datei | Mechanismus zur Identifikation von Datensätzen in der Eingabedatei. Folgende Optionen sind gültig:
|
| Länge | Ja | Nein | 80 | Die Länge der einzelnen Datensätze in Bytes, wenn die Datensatzerkennung Feste Länge ausgewählt ist. |
| Begrenzer | Ja | Nein | DOS- oder UNIX-Linienende | Die Art der Begrenzerbytes, mit denen die einzelnen Datensätze getrennt oder beendet werden, wenn die Datensatzerkennung Mit Begrenzer ausgewählt ist. Folgende Optionen sind gültig:
|
| Angepasster Begrenzer | Nein | Nein | Die hexadezimal ausgedrückten Begrenzerbytes, wenn die Datensatzerkennung Mit Begrenzer und Angepasster Begrenzer ausgewählt sind. Falls für die Eigenschaft Begrenzer nicht Angepasster Begrenzer festgelegt ist, ist diese Eigenschaft nicht obligatorisch. | |
| Begrenzertyp | Ja | Nein | Postfix | Position des Begrenzers, wenn die Datensatzerkennung Mit Begrenzer und Angepasster Begrenzer ausgewählt sind. Folgende Optionen sind gültig:
|
In der folgenden Tabelle werden die Validierungseigenschaften des FileInput-Knotens beschrieben.
Eine umfassende Beschreibung dieser Eigenschaften finden Sie unter Auswertungseigenschaften.
| Eigenschaft | M | C | Standardwert | Beschreibung |
|---|---|---|---|---|
| Auswertung | Nein | Ja | Keine | Durch diese Eigenschaft wird gesteuert, ob eine Auswertung stattfindet.
Gültige Werte sind:
|
| Aktion bei Fehler | Nein | Nein | Ausnahme | Durch diese Eigenschaft wird gesteuert, was beim Fehlschlagen der Auswertung
geschieht.
Gültige Werte sind:
|
In der folgenden Tabelle werden die FTP-Eigenschaften des FileInput-Knotens beschrieben:
| Eigenschaft | M | C | Standardwert | Beschreibung |
|---|---|---|---|---|
| FTP | Nein | Ja | Nicht ausgewählt | Diese Eigenschaft bestimmt, ob der Knoten die auf der Registerkarte FTP aufgeführten FTP-Eigenschaften verwendet und Dateien von einem FTP-Server liest. |
| FTP-Server und -Port | Nein | Ja | None (Keinen) | Die IP-Adresse oder der Name (und wahlweise auch die Portnummer) eines fernen FTP-Servers (z. B. ftp.server.com:21) oder der Name eines konfigurierbaren Service vom Typ 'FtpServer'. Bei Angabe des Namens eines konfigurierbaren Service können die folgenden FTP-Eigenschaften komplett oder teilweise von dem konfigurierbaren Service überschrieben werden. |
| Sicherheitsidentität | Nein | Ja | Der Name der Benutzeridentifikation für den Zugriff auf den FTP-Server. Diese Eigenschaft wird mit der Eigenschaft 'securityIdentity' im konfigurierbaren FTP-Server-Service überschrieben, falls definiert. | |
| Serververzeichnis | Nein | Ja | "." | Das Verzeichnis auf dem FTP-Server, aus dem Dateien übertragen werden sollen. Wird hierfür ein relativer Pfad angegeben, bezieht sich dieser auf das Ausgangsverzeichnis nach der Anmeldung. Diese Eigenschaft wird mit der Eigenschaft 'remoteDirectory' im konfigurierbaren FTP-Server-Service überschrieben, falls definiert. |
| Übertragungsmodus | Nein | Nein | Binär | Der FTP-Übertragungsmodus für die Übertragung von Dateidaten. Folgende Optionen sind gültig:
|
| Scan-Verzögerung | Nein | Ja | 60 | Die Verzögerung in Sekunden zwischen den Suchläufen für die fernen Verzeichnisse. Diese Eigenschaft überschreibt den Wert für Abfrageintervall, wenn das Kontrollkästchen 'FTP' markiert ist. Diese Eigenschaft wird mit der Eigenschaft 'scanDelay' im konfigurierbaren FTP-Server-Service überschrieben, falls definiert. |
In der folgenden Tabelle werden die Transaktionseigenschaften des FileInput-Knotens beschrieben:
| Eigenschaft | M | C | Standardwert | Beschreibung |
|---|---|---|---|---|
| Transaktionsmodus | Nein | Ja | Ja | Der Transaktionsmodus auf diesem Empfangsknoten ist entscheidend dafür, ob die übrigen Knoten in dem Fluss unter Verwendung eines Synchronisationspunkts ausgeführt werden. Folgende Optionen sind gültig:
|
| Eigenschaft | M | C | Standardwert | Beschreibung |
|---|---|---|---|---|
| Pool zusätzlicher Instanzen | Nein | Ja | Pool verwenden, der dem Nachrichtenfluss zugeordnet ist | Der Pool, aus dem zusätzliche Instanzen bereitgestellt werden sollen.
|
| Zusätzliche Instanzen | Nein | Ja | 0 | Die Anzahl der zusätzlichen Instanzen, die der Knoten starten kann, wenn für die Eigenschaft Pool zusätzlicher Instanzen Pool verwenden, der dem Knoten zugeordnet ist angegeben wurde. |