WebSphere Message Broker Version 8.0.0.5 Betriebssysteme: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Sehen Sie sich die Informationen zur aktuellen Produktversion im IBM Integration Bus Version 9.0 an.

Dateinamensmuster

Zur Identifizierung der Datei, die vom FileInput-, CDInput- und FTEInput-Knoten gelesen werden soll, können Sie ein Dateinamensmuster mit Platzhalterzeichen angeben. Auch zur Benennung der Datei, die durch die FileOutput- und FTEOutput-Knoten erstellt wird, können Sie ein Dateinamensmuster mit einem einzelnen Platzhalterzeichen angeben.

Dateinamensmuster mit den Knoten FileInput, CDInput und FTEInput verwenden

Die Empfangsknoten lesen Dateien aus einem angegebenen Verzeichnis und geben Nachrichten abhängig vom Inhalt dieser Dateien weiter. Es werden nur Dateien mit Namen gelesen, die dem in der Eigenschaft Dateiname oder Muster des FileInput-Knotens bzw. File name filter (Dateinamensfilter) des FTEInput-Knotens angegebenen Muster (Eingabemuster) entsprechen.

Wenn Sie Dateinamensmuster verwenden, um Dateien aus dem FileInput-Knoten auszuschließen, werden Dateien mit Namen, die mit dem Ausschlussmuster übereinstimmen, das in der Eigenschaft Dateiausschlussmuster des FileInput-Knotens angegeben ist, nicht gelesen oder verarbeitet.

Bei der Übereinstimmung kann es sich um einen Dateinamen oder eine Zeichenfolge (ein Muster) handeln. Ein Muster ist eine Zeichenfolge mit mindestens einem der folgenden Platzhalterzeichen:
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, gefolgt von sechs Zeichen und der Erweiterung .csv.
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 '\').

Beispiel:
  • Wenn Sie möchten, dass der FileInput-Knoten alle Dateien mit einer bestimmten Erweiterung (z. B. xml) verarbeitet, setzen Sie die Eigenschaft Dateiname oder Muster auf *.xml und der Knoten wird alle Dateien im Verzeichnis (und in Unterverzeichnissen, falls ausgewählt) mit dieser Erweiterung verarbeiten.
  • Wenn der FileInput-Knoten alle Dateien mit einer bestimmten Erweiterung, z. B. .csv, von der Verarbeitung ausschließen soll, setzen Sie seine Eigenschaft Dateiausschlussmuster auf *.csv und der Knoten wird keine Dateien mit dieser Erweiterung im Verzeichnis (und Unterverzeichnissen, falls ausgewählt) verarbeiten.

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

Die Knoten FileInput, CDInput, und FTEInput setzen das Element LocalEnvironment.Wildcard.WildcardMatch auf die Zeichenfolge, die im Dateinamen die Platzhalterzeichen ersetzen. Das Element LocalEnvironment.Wildcard.WildcardMatch bleibt von Dateiausschlussmustern unberührt. Nachfolgend finden Sie einige Beispiele für den Musterabgleich mit dem Wert dieses Elements, wobei der Wert in der Eigenschaft Dateiname oder Muster des FileInput-Knotens 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 muss, geben Sie in der Eigenschaft Dateiname oder Muster den Wert Datei????.von?*.xml ein.

Dateinamensmuster mit den Knoten FileOutput, CDOutput und FTEOutput verwenden

Der Knoten schreibt Nachrichten in Dateien, die er im Dateisystem des Brokers erstellt oder ersetzt. 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 für den Dateinamen kein Platzhalterzeichen enthält, wird der Wert dieser Eigenschaft als Name der erstellten Datei verwendet. Dieser Wert muss ein gültiger Dateiname auf dem Dateisystem sein, auf dem sich der Broker befindet, für den der Nachrichtenfluss implementiert wird.
  • Enthält die Eigenschaft des Dateinamens ein einziges Platzhalterzeichen, wird dieses Platzhalterzeichen durch den Wert des Elements 'LocalEnvironment.Wildcard.WildcardMatch' in der aktuellen Nachricht ersetzt und der daraus resultierende Wert ergibt den Namen der erstellten Datei. Dieser Wert muss ein gültiger Dateiname auf dem Dateisystem 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 des FileOutput-Knotens 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, während in UNIX-Systemen Dateinamen, die in der Groß- und Kleinschreibung voneinander abweichen, als verschiedene Dateinamen angesehen werden.

Beispiel: Wenn die Eigenschaft Dateiname oder Muster des FileInput-Knotens den Wert *.out hat und die eingehende Datei myfile heißt, lautet der Name der ausgehenden Datei myfile.out.

Hinweise zu FTP und SFTP

Sie können den FileInput-Knoten zur Übertragung von Dateien von einem fernen FTP oder SFTP-Server und zur anschließenden Verarbeitung der Dateien verwenden. Es werden nur Dateien mit Namen gelesen, die dem im Knoten angegebenen Dateinamensmuster entsprechen. Sie können mithilfe eines Dateiausschlussmuster auch verhindern, das Dateien auf einem fernen FTP- oder SFTP-Server gelesen werden. Wenn Ihr Broker unter einem Betriebssystem ausgeführt wird, das die Groß-/Kleinschreibung berücksichtigt (z. B. UNIX), geben Sie vermutlich ein Muster mit einer Mischung aus Groß- und Kleinbuchstaben ein. Wenn Sie dieses Muster nun zur Verarbeitung von Dateien verwenden, die sich in einem Verzeichnis auf einem fernen FTP oder SFTP-Server befinden, und dieser Server unter einem Betriebssystem ausgeführt wird, das die Groß-/Kleinschreibung ignoriert (z. B. Windows), dann kann der Dateinamensabgleich fehlschlagen, was zur Folge hat, dass keine Dateien verarbeitet werden. Dieser Fehler tritt auf, weil die Dateinamen auf dem fernen Servern keine Groß-/Kleinschreibung aufweisen. Befindet sich hingegen Ihr Broker unter einem Betriebssystem, das die Groß-/Kleinschreibung ignoriert, und der ferne FTP-Server, auf dem sich die Dateien befinden, wird unter einem Betriebssystem ausgeführt, das die Groß-/Kleinschreibung beachtet, dann stimmt das von Ihnen angegebene Muster eventuell mit mehreren Dateien auf dem fernen FTP oder SFTP-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 oder SFTP-Server verwenden. Es werden nur Dateien mit Namen gelesen, die dem im Knoten angegebenen Muster entsprechen. Wenn Ihr Broker unter einem Betriebssystem ausgeführt wird, das die Groß-/Kleinschreibung berücksichtigt (z. B. UNIX), geben Sie vermutlich ein Muster mit einer Mischung aus Groß- und Kleinbuchstaben ein. Wenn Sie diese Muster dann jedoch verwenden, um Dateien in ein Verzeichnis auf einem fernen FTP- oder SFTP-Server zu schreiben, der unter einem Betriebssystem aktiv ist, das die Groß-/Kleinschreibung nicht beachtet (z. B. Windows), dann wird der Dateiname nicht so, wie in Ihrem Muster angegeben, sondern in Großbuchstaben geschrieben.

Wenn der Name einer Datei auf einem FTP-Server ein oder mehrere Zeichen enthält, die im Betriebssystem 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.

Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Letzte Aktualisierung:
        
        Letzte Aktualisierung: 2015-02-28 16:20:18


KonzeptthemaKonzeptthema | Version 8.0.0.5 | ac55200_