Um mehr über Filter im Allgemeinen zu erfahren, siehe Abschnitt Informationen zu Filtern.
Verwenden Sie diesen Filter, wenn Sie eine strukturierte Textdatei erhalten, in der die Felder anhand einer der folgenden Methoden identifiziert werden können:
-
Felder werden durch ein Zeichen getrennt: Übliche Trennzeichen sind Komma oder Semikolon. CSV (durch Kommas getrennte Werte) ist ein typisches Beispiel für eine getrennte Datei.
-
Felder enthalten eine feste Anzahl von Zeichen: Anders gesagt, Felder werden durch Spalten mit fester Breite definiert.
Beispiele für strukturierte Textdaten finden Sie in Abschnitt Textdatenbank.
Struktur definieren
Um die Struktur einer Textdatei zu definieren, haben Sie folgende Optionen:
-
Struktur anhand des Textdatei-Assistenten importieren: Klicken Sie in diesem Fall auf die Schaltfläche Datenstruktur importieren in der Menüleiste und folgen Sie den Anweisungen auf dem Bildschirm. Nach Beenden des Assistenten sind die Art der Textdatenbank sowie alle Felder definiert. Falls die erste Datenzeile die Feldnamen enthält, kann der Assistent sie importieren. Dies ist die empfohlene Methode, wenn der Trigger immer Daten empfängt, deren Struktur sich nicht ändert.
-
Manuelle Definition der Felder: In diesem Fall müssen Sie den Typ der Daten (getrennte Felder oder Felder mit fester Länge) und dann die Feldnamen manuell definieren. Weitere Informationen finden Sie im Abschnitt Felder Definieren .
-
Dynamisches Auslesen der Felder: In diesem Fall empfängt der Trigger möglicherweise Daten, die auf andere Art strukturiert sind. An Beispiel dafür sind neue Feldnamen – eine dynamische Struktur macht das Aktualisieren des Filters für jede Strukturelle Änderung überflüssig. Die Unterstützung für dynamische Struktur liest automatisch alle Datenfelder aus, unabhängig davon, ab ein neues Feld vorhanden ist oder einige der alten Felder fehlen. Danach ordnet sie sie automatisch den Variablen mit identischen Namen zu. Weitere Informationen finden Sie im Abschnitt Dynamische Struktur aktivieren.
Der „Datenvorschau“-Bereich vereinfacht die Konfiguration. Das Ergebnis einer definierten Filterregel wird bei jeder Konfigurationsänderung im Vorschaubereich hervorgehoben. Mithilfe der Datenvorschau können Sie prüfen, welche Daten mit jeder einzelnen Rolle extrahiert werden.
Bei strukturierten Textdateien ist die Definition von Feldern sehr unkompliziert. Es gibt zwei Optionen:
-
Felder werden durch Trennzeichen definiert: In diesem Fall haben Sie ein Trennzeichen wie Komma oder Semikolon zwischen den Feldern. Sie müssen lediglich die Feldnamen in der Reihenfolge definieren, in der sie in den vom Trigger empfangenen Daten auftreten.
-
Fester Spaltenbreite: In diesem Fall müssen Sie lediglich Folgendes definieren: die Feldnamen in der Reihenfolge, in der sie in den vom Trigger empfangenen Daten auftreten, sowie die Anzahl von Zeichen innerhalb eines Feldes. Damit geben Sie vor, wie viele Zeichen als Daten des jeweiligen Feldes ausgelesen werden.
Datenvorschau
Dieser Bereich zeigt eine Vorschau der Felddefinition an. Wenn das definierte Element ausgewählt wird, zeigt die Vorschau dessen Position in den Vorschaudaten an.
-
Name der Vorschaudatei: Gibt die Datei an, welche die Beispieldaten enthält, die durch den Filter geparst werden sollen. Die Vorschaudatei wird aus der Filterdefinition kopiert. Wenn Sie den Namen der Vorschaudatei ändern, wird der neue Name gespeichert.
-
Öffnen: Wählt eine andere Datei aus, auf die die Filterregeln angewandt werden sollen.
-
Aktualisieren: Wendet die Filterregeln erneut auf den Inhalt der Vorschaudatei an.Automation Aktualisiert den „Datenvorschau“-Bereich mit dem Ergebnis.
Formatierungsoptionen
Dieser Abschnitt definiert Funktionen zur Änderung von Zeichenfolgen, die auf ausgewählte Variablen oder Felder angewandt werden. Sie können eine oder mehrere Funktionen auswählen. Die Funktionen werden in der Reihenfolge ausgeführt, die in der Benutzeroberfläche ausgewählt ist – von oben nach unten.
-
Leerzeichen am Anfang löschen: Löscht alle Leerzeichen (ASCII-Dezimalwert 32) am Anfang einer Zeichenfolge.
-
Leerzeichen am Ende löschen: Löscht alle Leerzeichen (ASCII-Dezimalwert 32) am Ende einer Zeichenfolge.
-
Eröffnungs- und Abschlusszeichen löschen: Löscht die erste Instanz der ausgewählten Eröffnungs- und Abschlusszeichen, die in einer Zeichenfolge enthalten sind.
Beispiel 2. Beispiel
Wenn Sie „{“ als Eröffnungszeichen und „}“ als Abschlusszeichen verwenden, wird die Eingabe-Zeichenfolge
{{Auswahl}}
in{Auswahl}
konvertiert.
-
Suchen und ersetzen: Führt anhand der angegebenen Werte für Finde und Ersetzen durch eine Standardfunktion für Suchen und Ersetzen durch. Sie können auch reguläre Ausdrücke verwenden.
Anmerkung
Es werden verschiedene Implementierungen der regulären Ausdrücke verwendet. Nutzt die .NET Framework-Syntax für reguläre Ausdrücke. Weitere Informationen finden Sie im Knowledge Base-Artikel.
-
Nicht-druckbare Zeichen durch Leerzeichen ersetzen: Ersetzt alle Steuerzeichen in einer Zeichenfolge durch Leerzeichen (ASCII-Dezimalwert 32). Die nicht druckbaren Zeichen sind Zeichen mit ASCII-Dezimalwerten zwischen 0 und 31 sowie 127 und 159.
-
Nicht druckbare Zeichen löschen: Löscht alle Steuerzeichen in der Zeichenfolge. Die nicht druckbaren Zeichen sind Zeichen mit ASCII-Dezimalwerten zwischen 0 und 31 sowie 127 und 159.
-
Sonderzeichen dekodieren: Sonderzeichen (oder Steuercodes) sind Zeichen, die keine Entsprechung auf der Tastatur haben, z. B. Wagenrücklauf oder Zeilenvorschub. verwendet eine menschenlesbare Codierung für solche Zeichen, beispielsweise <CR> für Wagenrücklauf und <LF> für Zeilenvorschub. Weitere Informationen finden Sie im Abschnitt Eingabe von Sonderzeichen (Steuercodes).
Diese Option konvertiert Sonderzeichen aus der Syntax in tatsächliche Binärzeichen.
Beispiel 3. Beispiel
Wenn Sie die Datenfolge „<CR><LF>“ empfangen, fasst sie als reine Zeichenfolge aus 8 Zeichen auf. Um die empfangenen Daten als zwei Binärzeichen zu erkennen,
CR
(Wagenrücklauf – ASCII-Code 13) undLF
(Zeilenvorschub – ASCII-Code 10), müssen Sie diese Option aktivieren.
-
Suchen und Löschen von allem vor: Sucht die angegebene Zeichenfolge und löscht alle Zeichen ab Beginn der Daten bis zu der Zeichenfolge. Auch die gefundene Zeichenfolge kann gelöscht werden.
-
Suchen und Löschen von allem nach: Sucht die angegebene Zeichenfolge und löscht alle Zeichen ab der Zeichenfolge bis zum Ende der Daten. Auch die gefundene Zeichenfolge kann gelöscht werden.
-
Großschreibung ändern: Ändert alle Zeichen in Ihren Zeichenfolgen zu Groß- oder Kleinschreibung.
Der Filter für strukturierten Text kann Felder und ihre Werte in den empfangenen Daten automatisch erkennen. Daher ist eine manuelle Variable-zu-Feld-Zuordnung nicht notwendig.
Die Funktion Dynamische Struktur ist nützlich, wenn der Trigger Daten mit sich ändernder Struktur empfängt. In solchen Fällen bleibt die Haupt-Datenstruktur unverändert (z. B. Felder werden durch Kommas getrennt) oder dieselbe Struktur wird beibehalten, aber die Reihenfolge und/oder die Anzahl von Feldern ändert sich. Es könnten neue Felder hinzukommen oder alte Felder könnten nicht mehr verfügbar sein. Aufgrund der aktivierten Dynamischen Struktur erkennt der Filter die Struktur der empfangenen Datei automatisch. Gleichzeitig liest der Filter Feldnamen und Werte (Name-Wert
-Paare) aus den Daten. Dadurch müssen Felder nicht manuell Variablen zugeordnet werden.
Die Aktion Datenfilter verwenden bietet keine Zuordnungsmöglichkeiten, da sie die Zuordnung dynamisch vornimmt. Sie müssen nicht einmal die Etikettenvariablen in der Trigger-Konfiguration festlegen. Die Aktion ordnet Feldwerte den gleichnamigen Etikettenvariablen zu, ohne dass die Variablen aus dem Etikett importiert werden müssen. Diese Regel gilt jedoch nur für die Aktion Etikett drucken. Wenn Sie die Feldwerte in einer anderen Aktion verwenden möchten, müssen Sie Variablen im Trigger definieren, dabei aber die automatische Zuordnung von Variablen zu Feldern beibehalten.
Anmerkung
Wenn ein Feld in den Eingabedaten keine entsprechende Variable auf dem Etikett hat, tritt kein Fehler auf. Ignoriert die fehlenden Variablen, ohne eine Meldung auszugeben.
Dynamische Struktur konfigurieren
Um die dynamische Struktur zu konfigurieren, aktivieren Sie die Option Dynamische Struktur in den Eigenschaften des Filters für strukturierten Text.
-
Die erste Datenzeile muss Feldnamen enthalten.
-
Die Zeile, die Sie für Import bei folgender Zeile beginnen auswählen, muss die Feldnamen enthalten (für gewöhnlich die erste Zeile in den Daten).
-
Die Datenstruktur muss eine Trennung (durch Trennzeichen oder feste Spaltenbreite) aufweisen.
-
Falls nötig, können Sie die Daten formatieren.
Formatierungsoptionen
Dieser Abschnitt definiert Funktionen zur Änderung von Zeichenfolgen, die auf ausgewählte Variablen oder Felder angewandt werden. Sie können eine oder mehrere Funktionen auswählen. Die Funktionen werden in der Reihenfolge ausgeführt, die in der Benutzeroberfläche ausgewählt ist – von oben nach unten.
-
Leerzeichen am Anfang löschen: Löscht alle Leerzeichen (ASCII-Dezimalwert 32) am Anfang einer Zeichenfolge.
-
Leerzeichen am Ende löschen: Löscht alle Leerzeichen (ASCII-Dezimalwert 32) am Ende einer Zeichenfolge.
-
Eröffnungs- und Abschlusszeichen löschen: Löscht die erste Instanz der ausgewählten Eröffnungs- und Abschlusszeichen, die in einer Zeichenfolge enthalten sind.
Beispiel 4. Beispiel
Wenn Sie „{“ als Eröffnungszeichen und „}“ als Abschlusszeichen verwenden, wird die Eingabe-Zeichenfolge
{{Auswahl}}
in{Auswahl}
konvertiert.
-
Suchen und ersetzen: Führt anhand der angegebenen Werte für Finde und Ersetzen durch eine Standardfunktion für Suchen und Ersetzen durch. Sie können auch reguläre Ausdrücke verwenden.
Anmerkung
Es werden verschiedene Implementierungen der regulären Ausdrücke verwendet. Nutzt die .NET Framework-Syntax für reguläre Ausdrücke. Weitere Informationen finden Sie im Knowledge Base-Artikel.
-
Nicht-druckbare Zeichen durch Leerzeichen ersetzen: Ersetzt alle Steuerzeichen in einer Zeichenfolge durch Leerzeichen (ASCII-Dezimalwert 32). Die nicht druckbaren Zeichen sind Zeichen mit ASCII-Dezimalwerten zwischen 0 und 31 sowie 127 und 159.
-
Nicht druckbare Zeichen löschen: Löscht alle Steuerzeichen in der Zeichenfolge. Die nicht druckbaren Zeichen sind Zeichen mit ASCII-Dezimalwerten zwischen 0 und 31 sowie 127 und 159.
-
Sonderzeichen dekodieren: Sonderzeichen (oder Steuercodes) sind Zeichen, die keine Entsprechung auf der Tastatur haben, z. B. Wagenrücklauf oder Zeilenvorschub. verwendet eine menschenlesbare Codierung für solche Zeichen, beispielsweise <CR> für Wagenrücklauf und <LF> für Zeilenvorschub. Weitere Informationen finden Sie im Abschnitt Eingabe von Sonderzeichen (Steuercodes).
Diese Option konvertiert Sonderzeichen aus der Syntax in tatsächliche Binärzeichen.
Beispiel 5. Beispiel
Wenn Sie die Datenfolge „<CR><LF>“ empfangen, fasst sie als reine Zeichenfolge aus 8 Zeichen auf. Um die empfangenen Daten als zwei Binärzeichen zu erkennen,
CR
(Wagenrücklauf – ASCII-Code 13) undLF
(Zeilenvorschub – ASCII-Code 10), müssen Sie diese Option aktivieren.
-
Suchen und Löschen von allem vor: Sucht die angegebene Zeichenfolge und löscht alle Zeichen ab Beginn der Daten bis zu der Zeichenfolge. Auch die gefundene Zeichenfolge kann gelöscht werden.
-
Suchen und Löschen von allem nach: Sucht die angegebene Zeichenfolge und löscht alle Zeichen ab der Zeichenfolge bis zum Ende der Daten. Auch die gefundene Zeichenfolge kann gelöscht werden.
-
Großschreibung ändern: Ändert alle Zeichen in Ihren Zeichenfolgen zu Groß- oder Kleinschreibung.