Skip to main content

xSuite Interface Windows Prism 5.x – Online-Hilfe

Syntax von Namensfiltern

Wenn als Konfigurationswert ein Namensfilter anzugeben ist, bezieht sich dieser Filter oftmals auf den Namen einer zu verarbeitenden Datei. Die gleiche Syntax wird aber auch in anderen Zusammenhängen genutzt, z. B. zur Filterung von Feldinhalten. Solche Eigenschaften sind durch den Namen oder Namensbestandteil FileFilter oder Filter gekennzeichnet.

Ein Filterausdruck kann sich aus mehreren Einzelwerten zusammensetzen, um verschiedene alternative Namensmuster zu definieren. Als Trennzeichen zwischen den Mustern wird ein senkrechter Strich (Pipe-Zeichen) (|) verwendet.

"FileFilter": "*.jpg|*.jpeg"

In diesem Beispiel wird nach Dateianlagen gefiltert, die die Endung .jpg oder .jpeg haben.

Folgende Wildcard-Zeichen sind zulässig:

  • Stern (*): beliebig viele oder kein Zeichen

  • Fragezeichen (?): ein einzelnes Zeichen

  • Raute (#): ein numerisches Zeichen

Anstatt eines Wildcard-Ausdrucks kann ein regulärer Ausdruck verwendet werden. Die Kennzeichnung als regulärer Ausdruck erfolgt durch die Einbettung des Ausdrucks in /-Zeichen:

"FileFilter": "/^.*(jpg|jpeg)$/"

Für reguläre Ausdrücke ist eine Auflistung alternativer Werte möglich, die durch Trennzeichen separiert sind. Diese Auflistung ist auch in Kombination mit Wildcard-Ausdrücken möglich. Zur Definition von Negativfiltern kann der Filterausdruck in ein NOT(…) eingeschlossen werden:

"FileFilter": "*|NOT(*.tif)|NOT(*.tiff)"

In diesem Beispiel umfasst der Filter grundsätzlich alle Dateinamen (*), schließt aber Dateinamen mit der Endung .tif oder .tiff explizit aus.

Bei Positiv-Filtern erfolgt die Auswertung der alternativen Muster oder-verknüpft. Bei Negativ-Filtern wird das Ergebnis des gesamten Filterausdrucks hingegen als falsch gewertet, wenn einer der enthaltenen Negativ-Filter zutrifft. Innerhalb eines Negativ-Filters ist eine Oder-Verknüpfung zulässig. Der obige Ausdruck kann somit auch wie folgt formuliert werden:

"FileFilter": "*|NOT(*.tif|*.tiff)"

Hinweis

Alle Filter, sowohl als Wildcard-Ausdruck als auch als regulärer Ausdruck, unterscheiden nicht zwischen Groß-/Kleinschreibung. Bei der Konfiguration müssen somit keine alternativen Muster in Groß- und Kleinschreibung für den gleichen Ausdruck angegeben werden.