Dateinamensmuster

Zur Identifizierung der Datei, die vom FileInput-Knoten gelesen werden soll, können Sie ein Dateinamensmuster mit Platzhalterzeichen angeben. Auch zur Benennung der Datei, die vom FileOutput-Knoten erstellt werden soll, können Sie ein Dateinamensmuster angeben, allerdings nur mit einem Platzhalterzeichen für ein einzelnes Zeichen.

Dateinamensmuster mit dem FileInput-Knoten verwenden

Der FileInput-Knoten liest Dateien aus einem angegebenen Verzeichnis ein und leitet auf Basis des Inhalts dieser Dateien Nachrichten weiter. Es werden nur Dateien mit Namen gelesen, die dem in der Eigenschaft Dateiname oder Muster des FileInput-Knotens angegebenen Muster (Eingabemuster) entsprechen. Hierbei kann es sich entweder um einen Dateinamen oder um eine mit einem Dateinamen übereinstimmende Zeichenfolge (ein Muster) handeln. Ein Muster ist eine Zeichenfolge mit mindestens einem der folgenden Platzhalterzeichen:
Platzhalterzeichen Beispiel 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.
Das Standardmuster ist ein Stern (*), der für alle Dateinamen steht.

Dateinamen mit den folgenden Zeichen können nicht angegeben werden: Stern ('*'), Fragezeichen ('?') und Dateinamenstrennzeichen ('/' und '\').

Eventuell möchten Sie Dateien verarbeiten, die alle die gleiche Erweiterung aufweisen, zum Beispiel die Erweiterung xml. In diesem Fall geben Sie in der Eigenschaft Dateiname oder Muster des FileInput-Knotens den Wert *.xml ein. Der Knoten verarbeitet dann alle Dateien im angegebenen Verzeichnis mit dieser Erweiterung.

Wenn Sie den Nachrichtenfluss auf einem Windows-Server implementieren, wird beim Abgleich der Dateinamen mit dem Muster die Groß-/Kleinschreibung ignoriert. Bei einem Linux-, UNIX- oder z/OS-Server wird die Groß-/Kleinschreibung beim Abgleich hingegen beachtet.

Musterabgleich

Der FileInput-Knoten setzt im Element 'LocalEnvironment.Wildcard.WildcardMatch' die Zeichenfolge ein, die im Dateinamen die Stelle der Platzhalter einnimmt. Nachfolgend finden Sie einige Beispiele für den Musterabgleich mit dem Wert dieses Elements, wobei der Wert in der Eigenschaft Dateiname oder Muster auf Datei????.von*.xml gesetzt wurde:
  • Wenn der FileInput-Knoten eine Datei mit dem Dateinamen Datei1234.vonHQ.xml findet, wird eine Übereinstimmung erkannt. Der Wert im LocalEnvironment.Wildcard.WildcardMatch-Element wird in diesem Fall auf 1234.vonHQ gesetzt, und die Datei wird vom Knoten verarbeitet.
  • Wenn der Dateiname Datei123.vonHQ.xml lautet, wird keine Übereinstimmung erkannt, da sich zwischen dem Datei-Element des Dateinamens und dem .von-Element zu wenige Zeichen befinden. Die Datei wird in diesem Fall vom FileInput-Knoten ignoriert.
  • Wenn der Dateiname Datei2345.von.xml lautet, wird eine Übereinstimmung erkannt. Der Wert im LocalEnvironment.Wildcard.WildcardMatch-Element wird in diesem Fall auf 2345.von gesetzt, und die Datei wird vom Knoten verarbeitet. In diesem Beispiel entspricht der * in der Zeichenfolge der Eigenschaft Dateiname oder Muster einer Zeichenfolge mit null Zeichen. Wenn die Zeichenfolge zwischen dem von-Element und dem .xml-Element des Dateinamens auf jeden Fall mindestens ein Zeichen lang sein soll, müssen Sie in der Eigenschaft Dateiname oder Muster den Wert Datei????.von?*.xml eingeben.

Dateinamensmuster mit dem FileOutput-Knoten verwenden

Der FileOutput-Knoten schreibt Nachrichten in Dateien, die er im Dateisystem des Brokers erstellt oder ersetzt. Es werden nur Dateien mit Namen geschrieben, die dem in der Eigenschaft Dateiname oder Muster des FileInput-Knotens angegebenen Muster entsprechen. Hierbei kann es sich entweder um einen Dateinamen oder um eine mit einem Dateinamen übereinstimmende Zeichenfolge (ein Muster) handeln. Diese Eigenschaft lässt nur Muster mit einem Platzhalterzeichen für ein einzelnes Zeichen, dem Stern ('*'), zu. Der zu verwendende Dateiname wird wie folgt bestimmt:
  • Wenn die Eigenschaft Dateiname oder Muster kein Platzhalterzeichen enthält, dann entspricht der Name der erstellten Datei dem Wert dieser Eigenschaft. Der Dateiname muss auf dem Dateisystem gültig sein, auf dem sich der Broker befindet, für den der Nachrichtenfluss implementiert wird.
  • Wenn die Eigenschaft Dateiname oder Muster ein einzelnes Platzhalterzeichen enthält, dann wird dieses Platzhalterzeichen durch den Wert des Elements 'LocalEnvironment.Wildcard.WildcardMatch' der aktuellen Nachricht ersetzt. Daraus ergibt sich der Name der zu erstellenden Datei. Der Dateiname muss auf dem Dateisystem gültig sein, auf dem sich der Broker befindet, für den der Nachrichtenfluss implementiert wird. Wird der Wert 'WildcardMatch' nicht gefunden, so wird das Platzhalterzeichen durch die leere Zeichenfolge ersetzt.
Dateinamen mit den folgenden Zeichen können nicht angegeben werden: Stern ('*'), Fragezeichen ('?') und Dateinamenstrennzeichen ('/' und '\'). Der Name der Datei kann durch Werte in der aktuellen Nachricht überschrieben werden.

Falls für die Eigenschaft Dateiname oder Muster kein Wert angegeben ist, muss der Name durch die aktuelle Nachricht überschrieben werden. Die Platzhalterersetzung findet nur statt, wenn diese Eigenschaft nicht auf diese Weise überschrieben wird.

Dateinamen werden an das Dateisystem übergeben, auf das der Broker Zugriff hat. Die Konventionen dieser Dateisysteme müssen berücksichtigt werden. So muss beispielsweise bei Dateinamen in Windows-Systemen Groß-/Kleinschreibung nicht beachtet werden, wogegen in UNIX-Systemen Dateinamen, die in der Groß- und Kleinschreibung voneinander abweichen, als verschiedene Dateinamen angesehen werden.

Anmerkungen zur Übertragung mittels FTP

Sie können den FileInput-Knoten zur Übertragung von Dateien von einem fernen FTP-Server und zur anschließenden Verarbeitung der Dateien verwenden. Es werden nur Dateien mit Namen gelesen, die dem im Knoten angegebenen Dateinamensmuster entsprechen. Wenn Ihr Broker auf einer Plattform ausgeführt wird, die die Groß-/Kleinschreibung berücksichtigt, beispielsweise unter UNIX, geben Sie vermutlich ein Muster mit einer Mischung aus groß und klein geschriebenen Zeichen ein. Verwenden Sie dieses Muster nun zur Verarbeitung von Dateien, die sich in einem Verzeichnis auf einem fernen FTP-Server befinden, und dieser Server wird auf einer Plattform ausgeführt, die die Groß-/Kleinschreibung ignoriert, beispielsweise unter Windows, dann kann der Dateinamensabgleich und somit auch die Verarbeitung der Dateien fehlschlagen, weil die Dateinamen auf dem fernen Server einheitlich groß oder klein geschrieben sind. Befindet sich hingegen Ihr Broker auf einer Plattform, die die Groß-/Kleinschreibung ignoriert, und der ferne FTP-Server, auf dem sich die Dateien befinden, wird auf einer Plattform ausgeführt, die die Groß-/Kleinschreibung beachtet, dann stimmt das von Ihnen angegebene Muster eventuell mit mehreren Dateien auf dem fernen FTP-Server überein. In diesem Fall werden alle der übereinstimmenden Dateien nacheinander verarbeitet.

Sie können den FileOutput-Knoten zum Schreiben von Dateien auf einen fernen FTP-Server verwenden. Es werden nur Dateien mit Namen übertragen, die dem im Knoten angegebenen Dateinamensmuster entsprechen. Wenn Ihr Broker auf einer Plattform ausgeführt wird, die die Groß-/Kleinschreibung berücksichtigt, beispielsweise unter UNIX, geben Sie vermutlich ein Muster mit einer Mischung aus groß und klein geschriebenen Zeichen ein. Verwenden Sie dieses Muster nun zur Übertragung von Dateien in ein Verzeichnis auf einem fernen FTP-Server, und dieser Server wird auf einer Plattform ausgeführt, die die Groß-/Kleinschreibung ignoriert, beispielsweise unter Windows, dann entspricht die Schreibweise des auf dem Server erstellten Dateinamens nicht Ihrem Muster, sondern der Name wird vollständig groß geschrieben.

Wenn der Name einer Datei auf einem FTP-Server ein oder mehrere Zeichen enthält, die auf der Plattform des Brokers, in dem Sie das Dateinamensmuster angegeben haben, ungültig sind, dann wird die Datei auf dem FTP-Server nicht zur Verarbeitung durch den FileInput-Knoten übertragen.

Zugehörige Konzepte
Verarbeitung von Dateien durch den Broker
Zugehörige Tasks
Mit Dateien arbeiten
Datei lesen
Datei schreiben
Zugehörige Verweise
FileInput-Knoten
FileOutput-Knoten
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
ac55200_