Über den FTEInput-Knoten können mithilfe von WebSphere MQ File Transfer Edition Dateien empfangen werden.
Dieses Thema ist in folgende Abschnitte eingeteilt:
Mithilfe des FTEInput-Knotens können Sie die WebSphere Message Broker Version 8.0-Unterstützung für die Dateiverarbeitung durch die Integration mit WebSphere MQ File Transfer Edition erweitern. WebSphere MQ File Transfer Edition ist ein verwaltetes Dateiübertragungsprodukt, das WebSphere MQ als Transportmethode verwendet.
Der FTEInput-Knoten befindet sich im Ablagefach Datei der Palette und wird in der WebSphere Message Broker Toolkit durch folgendes Symbol dargestellt:
Informationen zu Beispielen können nur bei Verwendung des in das WebSphere Message Broker Toolkit integrierten bzw. online verfügbaren Information Center angezeigt werden. Muster können nur ausgeführt werden, wenn das im WebSphere Message Broker Toolkit integrierte Information Center verwendet wird.
In der folgenden Tabelle werden die FTEInput-Knotenterminals beschrieben .
Terminal | Beschreibung |
---|---|
Fehlerterminal (Failure) | Das Ausgabeterminal, an das eine Nachricht weitergeleitet wird, wenn ein Fehler auftritt, bevor eine Nachricht an das Ausgangsterminal weitergegeben 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 eine Nachricht weitergeleitet 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. |
Datenendterminal | 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 Sie in einer angegebenen Registerkarte festlegen können. Die Spalte O zeigt an, ob die Eigenschaft obligatorisch ist (im Toolkit mit einem Stern markiert, wenn ein Wert eingegeben werden muss, weil kein Standardwert definiert ist). Die Spalte K zeigt an, ob die Eigenschaft konfigurierbar ist (Wert kann geändert werden, wenn der Nachrichtenfluss für die Implementierung zur BAR-Datei hinzugefügt wird).
Wenn der FTEInput-Knoten eine Nachricht weitergibt, werden die Informationen zu der Nachricht in den Nachrichtenbaumstrukturen 'LocalEnvironment.FTE' und 'LocalEnvironment.FTE.Transfer' gespeichert. Wenn die Eingabedatei leer ist, wird eine leere Nachricht verbreitet (und vorausgesetzt, dass die Datei gültig ist). Wenn Sie in der Eigenschaft Dateinamensfilter ein Dateinamensmuster mit Platzhalterzeichen angeben, kopiert der FTEInput-Knoten die Zeichen des Dateinamens, die den Platzhalterzeichen entsprechen, sowie alle dazwischen liegenden Zeichen in die Nachrichtenbaumstruktur 'LocalEnvironment.Wildcard.WildcardMatch'. Weitere Informationen finden Sie im Abschnitt Variablen der lokalen Umgebung mit Dateiknoten verwenden.
Eigenschaften Beschreibung
Eigenschaft | O | K | Standardwert | Beschreibung |
---|---|---|---|---|
Knotenname | Nein | Nein | FTEInput | Der Name des Knotens. |
Kurzbeschreibung | Nein | Nein | Ohne | Kurze Beschreibung des Knotens. |
Ausführliche Beschreibung | Nein | Nein | Ohne | Text, der den Zweck des Knotens im Nachrichtenfluss beschreibt |
Eigenschaften Grundeinstellungen
Eigenschaft | O | K | Standardwert | Beschreibung | Eigenschaft des Befehls mqsiapplybaroverride |
---|---|---|---|---|---|
Verzeichnisfilter | Nein | Ja | Ohne | Das WebSphere MQ File Transfer Edition-Verzeichnis, aus dem Eingabedateien verarbeitet werden. | inputDirectory |
Dateinamensfilter | Ja | Ja | * | Ein Dateiname oder eine Zeichenfolge mit optionalen Platzhalterzeichen (* oder ?) zur Bezeichnung der zu verarbeitenden Datei(en) aus dem Eingabeverzeichnis. | filenamePattern |
Maßnahme bei erfolgreicher Verarbeitung | Ja | Nein | Keine Aktion | Die Maßnamen, die der Knoten nach erfolgreicher Verarbeitung der Inhalte ergreift. Folgende Optionen sind gültig:
|
Eigenschaften für die Syntaxanalyse der Eingabenachricht
Eigenschaft | O | K | Standardwert | Beschreibung | Eigenschaft des Befehls mqsiapplybaroverride |
---|---|---|---|---|---|
Nachrichtendomäne | Nein | Nein | Ohne | Die Domäne für die Syntaxanalyse der ankommenden Nachricht. | |
Nachrichtengruppe | Nein | Nein | Ohne | Der Name oder die ID des Nachrichtensatzes, in dem die eingehende Nachricht definiert ist. Wenn Sie diese Eigenschaft festlegen und die Projektabhängigkeiten anschließend aktualisieren, um diesen Nachrichtensatzverweis zu entfernen, wird eine Warnung ausgegeben. Aktualisieren Sie entweder die Eigenschaft Nachrichtensatz, oder stellen Sie den Verweis auf dieses Nachrichtensatzprojekt wieder her. |
|
Nachrichtenart | Nein | Nein | Ohne | Der Name der eingehenden Nachricht. | |
Nachrichtenformat | Nein | Nein | Ohne | Der Name des physischen Formats der eingehenden Nachricht. | |
ID des codierten Nachrichtenzeichensatzes | Ja | Ja | Systemstandardwert des Brokers | Die ID des codierten Zeichensatzes, anhand dessen die Bytes der gerade gelesenen Datei interpretiert werden. | messageCodedCharSetIdProperty |
Nachrichtenverschlüsselung | Ja | Ja | Ermitteltes Brokersystem | Das Codeumsetzungsschema für Zahlen, 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 Datenkonvertierung. | messageEncodingProperty |
Eigenschaften für Parser-Optionen
Eigenschaft | O | K | Standardwert | Beschreibung |
---|---|---|---|---|
Zeitpunkt für Syntaxanalyse | Nein | Nein | Bei Bedarf | Gibt an, wann 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 | Gibt an, ob die Datentypen der Syntaxelemente in der Nachrichtenbaumstruktur dem XML-Schema entnommen wurden. |
XMLNSC-Kompaktparser für XMLNS-Domäne verwenden | Nein | Nein | Nicht ausgewählt | Gibt an, ob für Nachrichten in der XMLNS-Domäne der XMLNSC-Kompaktparser verwendet wird. Wenn Sie diese Eigenschaft festlegen, werden die Nachrichtendaten in Knoten, die mit dem Ausgabeterminal verbunden sind, unter XMLNSC angezeigt, wenn
es sich bei einem der folgenden Elemente um
XMLNS handelt:
|
Zugriff auf gemischten Inhalt | Nein | Nein | Nicht ausgewählt | Gibt an, ob der XMLNSC-Parser für gemischten Text in einer Eingabenachricht Elemente in der Nachrichtenbaumstruktur erstellt. 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 | Gibt an, ob der XMLNSC-Parser für Kommentare in einer Eingabenachricht Elemente in der Nachrichtenbaumstruktur erstellt. 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 | Gibt an, ob der XMLNSC-Parser für Verarbeitungsanweisungen in einer Eingabenachricht Elemente in der Nachrichtenbaumstruktur erstellt. 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 | Leer | Gibt eine Liste mit Elementen in der Eingabenachricht an, die vom XMLNSC-Parser auf nicht transparente Weise analysiert werden sollen. Die nicht transparente Syntaxanalyse wird nur ausgeführt, wenn keine Gültigkeitsprüfung aktiviert ist (das heißt, wenn Auswerten auf Keine gesetzt ist); Einträge, die in Nicht transparente Elemente angegeben sind, werden ignoriert, wenn die Gültigkeitsprüfung aktiviert ist. |
Eigenschaften für Wiederholen
Eigenschaft | O | K | Standardwert | Beschreibung | Eigenschaft des Befehls mqsiapplybaroverride |
---|---|---|---|---|---|
Wiederholungsmechanismus | Ja | Nein | Failure | Handhabung eines Flussfehlers durch den Knoten Folgende Optionen sind gültig:
|
|
Wiederholungsschwellenwert | Ja | Ja | 0 | Dieser Wert gibt an, wie oft die Nachrichtenflusstransaktion wiederholt werden soll, wenn die Eigenschaft Wiederholungsmechanismus auf den Wert Kurze Wiederholungszeit gesetzt ist. | retryThreshold |
Kurzes Wiederholungsintervall (Sekunden) | Nein | Ja | 0 | Das Intervall in Sekunden zwischen den einzelnen Wiederholungen, wenn für die Eigenschaft Wiederholungsschwellenwert ein Wert ungleich null angegeben ist. | shortRetryInterval |
Langes Wiederholungsintervall (Sekunden) | Nein | Ja | 300 | Das Intervall zwischen den Wiederholungen, wenn für die Eigenschaft Wiederholungsmechanismus die Option Kurze und lange Wiederholungszeit angegeben ist und der Wiederholungsschwellenwert erreicht wurde. | longRetryInterval |
Maßnahme bei fehlgeschlagener Datei | Ja | Ja | Keine Aktion | Die Maßnahme, die der Knoten für die Eingabedatei ergreift, falls alle Versuche, den Dateiinhalt zu verarbeiten, fehlschlagen.
Folgende Optionen sind gültig:
|
Eigenschaften Datensätze und Elemente
Eigenschaft | O | K | 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 | Ohne | Die hexadezimal ausgedrückten Begrenzerbytes, wenn die Datensatzerkennung Mit Begrenzer und Angepasster Begrenzer ausgewählt sind. Diese Eigenschaft ist nur obligatorisch, wenn die Eigenschaft Begrenzer auf Angepasster Begrenzer gesetzt ist. |
Begrenzertyp | Ja | Nein | Postfix | Position des Begrenzers, wenn die Datensatzerkennung
Mit Begrenzer ausgewählt ist. Folgende Optionen sind gültig:
|
Eigenschaften Auswertung
Eine umfassende Beschreibung dieser Eigenschaften finden Sie unter Auswertungseigenschaften.
Eigenschaft | O | K | Standardwert | Beschreibung | Eigenschaft des Befehls mqsiapplybaroverride |
---|---|---|---|---|---|
Auswertung | Nein | Ja | Ohne | Durch diese Eigenschaft wird gesteuert, ob eine Auswertung stattfindet. Gültige Werte sind:
|
validateMaster |
Fehlerbehebungsmaßnahme | Nein | Nein | Ausnahme | Durch diese Eigenschaft wird gesteuert, was beim Fehlschlagen der Auswertung
geschieht. Gültige Werte sind:
|
Eigenschaften für Transaktionen
Eigenschaft | O | K | Standardwert | Beschreibung |
---|---|---|---|---|
Transaktionsmodus | Nein | Nein | Nein | Der Transaktionsmodus auf diesem Empfangsknoten ist entscheidend dafür, ob
die übrigen Knoten in dem Fluss unter Verwendung eines Synchronisationspunktes ausgeführt werden. Folgende Optionen sind gültig:
|
Eigenschaften von Instanzen.
Eine umfassende Beschreibung dieser Eigenschaften finden Sie unter Konfigurierbare Nachrichtenflusseigenschaften.
Eigenschaft | O | K | Standardwert | Beschreibung | Eigenschaft des Befehls mqsiapplybaroverride |
---|---|---|---|---|---|
Pool zusätzlicher Instanzen | Nein | Ja | Pool verwenden, der dem Nachrichtenfluss zugeordnet ist | Der Pool, aus dem zusätzliche Instanzen beschafft werden.
|
componentLevel |
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. | additionalInstances |
Eigenschaft | O | K | Standardwert | Beschreibung |
---|---|---|---|---|
Ereignisse | Nein | Nein | Ohne | Auf dieser Registerkarte werden Ereignisse angezeigt, die Sie für den Knoten
definiert haben. Standardmäßig sind für keinen Knoten in einem Nachrichtenfluss
Überwachungsereignisse definiert. Über Hinzufügen,
Bearbeiten und Löschen können Sie
Überwachungsereignisse für den Knoten erstellen, ändern oder löschen (Details siehe
Überwachungsereignisquellen mithilfe von Überwachungseigenschaften konfigurieren). Sie können hier angezeigte Ereignisse aktivieren oder inaktivieren, indem Sie das Kontrollkästchen Aktiviert aktivieren oder inaktivieren. |