Um mehr über Filter im Allgemeinen zu erfahren, siehe Abschnitt Informationen zu Filtern.
Verwenden Sie diesen Filter, wenn ein Trigger unstrukturierte Daten empfängt, z. B. Dokumente und Berichte aus einem alten System, abgefangene Kommunikation zwischen Geräten und erfasste Druckströme. Der Filter ermöglicht es Ihnen, einzelne Felder, Felder in sich wiederholenden Unterbereichen und sogar Name-Wert
-Paare zu extrahieren.
Beispiele für strukturierte Textdaten finden Sie in den Abschnitten Altdaten, Zusammengesetzte CSV-Dateien und Binärdateien.
Struktur definieren
Folgende Elemente können Sie zur Konfiguration des Filters verwenden:
-
Feld: Gibt die Position von Felddaten zwischen der Start- und Endposition von Feldern an. Es gibt verschiedene Möglichkeiten zur Angabe der Feldposition, die von einer festen Codierung der Position bis hin zur Aktivierung relativer Positionierungen reichen. In der Aktion Datenfilter verwenden müssen Sie die definierten Felder den jeweiligen Variablen zuordnen. Weitere Informationen finden Sie im Abschnitt Felder Definieren .
-
Unterbereich: Gibt die Position sich wiederholender Daten an. Jeder Unterbereich definiert mindestens einen Datenblock, der wiederum Daten für Etiketten enthält. Es können Unterbereiche in Unterbereichen definiert werden, was die Vorgabe komplexer Strukturen ermöglicht. Sie können Felder innerhalb jedes Datenblocks definieren. In der Aktion müssen Sie die definierten Felder den jeweiligen Variablen zuordnen. Für jeden Unterbereich definiert Automation eine neue Platzhalterebene innerhalb der Aktion „Datenfilter verwenden“, sodass Sie Feldern dieser Ebene Variablen zuordnen können. Weitere Informationen finden Sie im Abschnitt Unterbereiche definieren.
-
Zuweisungsbereich: Gibt die Position sich wiederholender Daten an, welche die
Name-Wert
-Paare enthalten. Automation liest Feldnamen und ihre Werte gleichzeitig aus. Automation Auch die Zuordnung zu Variablen erfolgt in automatisch. Verwenden Sie diese Funktion, um den Filter für die sich ändernden Eingangsdaten einzurichten; so können Sie Wartungsaufwand vermeiden. Sie können den Zuweisungsbereich auf der Stammebene des Dokuments oder innerhalb des Unterbereichs festlegen. Weitere Informationen finden Sie im Abschnitt Zuweisungsbereiche definieren.
Der „Datenvorschau“-Bereich vereinfacht die Konfiguration. Das Ergebnis einer definierten Filterregeln wird bei jeder Konfigurationsänderung im Vorschaubereich hervorgehoben. So können Sie sehen, welche Daten durch die einzelnen Regeln extrahiert würden.
Die Felder können auf Stammebene als Dokumentfelder definiert werden. Die Felder können innerhalb eines Datenblocks definiert werden. Die Name-Wert
-Paare können innerhalb des Zuweisungsbereichs definiert werden.
Allgemein
In diesem Abschnitt werden allgemeine Eigenschaften des Filters für unstrukturierte Daten definiert.
-
Name: Gibt den Filternamen an. Verwenden Sie einen anschaulichen Namen, der die Rolle des Filters in einer Konfiguration beschreibt. Sie können ihn jederzeit ändern.
-
Beschreibung: Ermöglicht es Ihnen, die Rolle dieses Filter zu beschreiben. Sie können hier eine kurze Erklärung zur Funktionsweise des Filters eingeben.
-
Codierung: Gibt die Datencodierung an, mit der dieser Filter arbeitet.
-
Leere Zeilen in Datenblöcken ignorieren: Legt fest, dass kein Fehler gemeldet wird, wenn der Filter leere Feldwerte aus den Datenblöcken extrahiert.
Nachdem Sie ein Feld definiert haben, müssen Sie seinen Namen sowie Regeln für die Extraktion von Feldwerten aus den Daten angeben. Bei Ausführung des Filters werden die Extraktionsregeln auf die Eingangsdaten angewendet und ordnen das Ergebnis dem Feld zu.
Feldeigenschaften
-
Name: Gibt den eindeutigen Namen des Feldes an.
-
Feld enthält binäre Daten: Gibt an, dass das Feld binäre Daten enthält. Aktivieren Sie diese Option nur, wenn Sie wirklich davon ausgehen, binäre Daten zu erhalten.
Feldanfang
-
Position im Dokument: Fest codierte Position in den Daten, die den Anfangs-/Endpunkt bestimmt. Der Koordinatenursprung ist in der oberen linken Ecke. Das Zeichen an der definierten Position wird in die extrahierten Daten eingeschlossen.
-
Ende des Dokuments: Der Start-/Endpunkt befindet sich am Ende des Dokuments. Sie können auch einen Versatz ab Ende des Dokuments um eine bestimmte Anzahl von Zeilen und/oder Zeichen definieren.
-
Zeichenfolge ab dem Beginn des Dokuments finden: Die Position der gesuchten Zeichenfolge bestimmt den Anfangs-/Endpunkt. Nachdem Automation die gewünschte Zeichenfolge gefunden hat, bestimmt das erste auf sie folgende Zeichen den Start-/Endpunkt. Die gesuchte Zeichenfolge wird nicht in die extrahierten Daten eingeschlossen. Die Standardsuche berücksichtigt Groß-/Kleinschreibung.
-
Suche bei absoluter Position beginnen: Sie können eine Feinanpassung der Suche vornehmen, indem Sie die Startposition vom Datenbeginn (Position 1,1) aus versetzen. Verwenden Sie diese Funktion, um die Suche nicht am Datenbeginn zu starten.
-
Vorkommen: Gibt an, welche Instanz der gesuchten Zeichenfolge verwendet werden soll. Verwenden Sie diese Option, wenn Sie die Start-/Endposition nicht nach der ersten gefundenen Instanz der Zeichenfolge festlegen möchten.
-
Versatz ab Zeichenfolge: Gibt den positiven oder negativen Versatz nach der gesuchten Zeichenfolge an.
Beispiel 6. Beispiel
Sie legen der Versatz so fest, dass die gesuchte Zeichenfolge in den extrahierten Daten enthalten ist.
-
Feldende
-
Position im Dokument: Fest codierte Position in den Daten, die den Anfangs-/Endpunkt bestimmt. Der Koordinatenursprung ist in der oberen linken Ecke. Das Zeichen an der definierten Position wird in die extrahierten Daten eingeschlossen.
-
Ende des Dokuments: Der Start-/Endpunkt befindet sich am Ende des Dokuments. Sie können auch einen Versatz ab Ende des Dokuments um eine bestimmte Anzahl von Zeilen und/oder Zeichen definieren.
-
Zeichenfolge ab dem Beginn des Dokuments finden: Die Position der gesuchten Zeichenfolge bestimmt den Anfangs-/Endpunkt. Nachdem Automation die gewünschte Zeichenfolge gefunden hat, bestimmt das erste auf sie folgende Zeichen den Start-/Endpunkt. Die gesuchte Zeichenfolge wird nicht in die extrahierten Daten eingeschlossen. Die Standardsuche berücksichtigt Groß-/Kleinschreibung.
-
Suche bei absoluter Position beginnen: Sie können eine Feinanpassung der Suche vornehmen, indem Sie die Startposition vom Datenbeginn (Position 1,1) aus versetzen. Verwenden Sie diese Funktion, um die Suche nicht am Datenbeginn zu starten.
-
Vorkommen: Gibt an, welche Instanz der gesuchten Zeichenfolge verwendet werden soll. Verwenden Sie diese Option, wenn Sie die Start-/Endposition nicht nach der ersten gefundenen Instanz der Zeichenfolge festlegen möchten.
-
Versatz ab Zeichenfolge: Gibt den positiven oder negativen Versatz nach der gesuchten Zeichenfolge an.
Beispiel 7. Beispiel
Sie legen der Versatz so fest, dass die gesuchte Zeichenfolge in den extrahierten Daten enthalten ist.
-
-
Zeichenfolge nach Feldbeginn finden: Der Anfangs-/Endpunkt wird durch die Position der gesuchten Zeichenfolge gemäß der Option Zeichenfolge ab dem Beginn des Dokuments finden festgelegt, aber die Suche beginnt nach der Anfangsposition des Felds/Bereichs, nicht am Anfang der Daten.
-
Länge: Gibt die Länge der Daten in Zeilen und/oder Zeichen an. Die angegebene Anzahl von Zeilen und/oder Zeichen wird ab der Startposition extrahiert.
-
Ende der Zeile: Legt fest, dass die Daten ab der Startposition bis zum Ende derselben Zeile extrahiert werden sollen. Sie können einen negativen Versatz ab dem Zeilenende angeben.
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 8. 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 9. 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.
Ein Unterbereich ist ein Datenabschnitt, der mehrere Datenblöcke enthält, die von derselben Extraktionsregel erkannt werden. Jeder Datenblock stellt Daten für ein einzelnes Etikett bereit.
Alle Datenblöcke müssen mithilfe derselben Konfigurationsregel erkannt werden. Jeder Datenblock kann einen weiteren Unterbereich enthalten. Sie können eine unbegrenzte Anzahl von Unterbereichen in übergeordneten Unterbereichen definieren.
Beinhaltet der Filter die Definition eines Unterbereichs, zeigt die Aktion Datenfilter verwenden Unterbereiche mit eingebetteten Platzhaltern an. Alle Aktionen, die unter einem solchen Platzhalter eingebunden sind, werden nur für Datenblöcke auf dieser Ebene ausgeführt. Sie können verschiedene Etiketten mit Daten aus verschiedenen Unterbereichen drucken.
Konfiguration von Unterbereichen
Unterbereiche werden mit ähnlichen Regeln konfiguriert wie einzelne Felder. Jeder Unterbereich wird über die folgenden Parameter definiert.
-
Name Unterbereich: Gibt den Namen des Unterbereichs an.
-
Datenblöcke: Gibt an, wie Datenblöcke innerhalb des Unterbereichs erkannt werden. Jeder Unterbereich enthält mindestens einen Datenblock. Jeder Datenblock stellt Daten für ein einzelnes Etikett bereit.
-
Jeder Block enthält eine feste Anzahl von Zeilen: Gibt an, dass jeder Datenblock im Unterbereich exakt die eingegebene Anzahl von Zeilen enthält. Verwenden Sie diese Option, wenn Sie wissen, dass jeder Datenblock genau dieselbe Anzahl von Zeilen enthält.
-
Blöcke beginnen mit einer Zeichenfolge: Gibt an, dass Datenblöcke mit der eingegebenen Zeichenfolge beginnen. Alle Inhalte zwischen den beiden angegebenen Zeichenfolgen gehören zu einem separaten Datenblock. Der Inhalt zwischen der letzten Zeichenfolge und dem Ende der Daten stellt den letzten Datenblock dar.
-
Blöcke enden mit einer Zeichenfolge: Gibt an, dass Datenblöcke mit der eingegebenen Zeichenfolge enden. Alle Inhalte zwischen den beiden angegebenen Zeichenfolgen gehören zu einem separaten Datenblock. Der Inhalt zwischen dem Beginn der Daten und der ersten Zeichenfolge stellt den ersten Datenblock dar.
-
Blöcke werden durch eine Zeichenfolge getrennt: Gibt an, dass Datenblöcke durch die ausgewählte Zeichenfolge getrennt werden. Alle Inhalte zwischen den beiden ausgewählten Zeichenfolgen gehören zu einem separaten Datenblock.
-
-
Anfang des ersten Datenblocks: Gibt die Anfangsposition des ersten Datenblocks an. Gleichzeitig definiert die Option die Anfangsposition des Unterbereichs. Für gewöhnlich ist die Anfangsposition auch der Anfang der empfangenen Daten. Die Konfigurationsparameter sind mit denen für die Definition von Feldern identisch. Weitere Informationen finden Sie im Abschnitt Felder Definieren.
-
Ende des letzten Datenblocks: Gibt die Endposition des letzten Datenblocks an. Gleichzeitig definiert die Option die Endposition des Unterbereichs. Für gewöhnlich ist die Endposition das Ende der empfangenen Daten. Die Konfigurationsparameter sind mit denen für die Definition von Feldern identisch. Weitere Informationen finden Sie im Abschnitt Felder Definieren.
Konfiguration von Feldern innerhalb von Unterbereichen
Felder innerhalb des Unterbereichs werden anhand derselben Parameter konfiguriert wie auf Stammebene definierte Felder. Weitere Informationen finden Sie im Abschnitt Felder Definieren.
Anmerkung
Die Feld-Zeilennummern verweisen auf die Position innerhalb des Datenblocks, nicht auf die Position innerhalb der Eingangsdaten.
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.
Der Filter für unstrukturierte Daten erkennt Felder und ihre Werte in den empfangenen Daten automatisch. Dadurch ist eine manuelle Variable-zu-Feld-Zuordnung überflüssig.
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.
Zuweisungsbereiche konfigurieren
Zuweisungsbereiche werden anhand derselben Methode konfiguriert wie Unterbereiche. Weitere Informationen finden Sie im Abschnitt Unterbereiche definieren. Der Zuweisungsbereich kann auf Stammdatenebene definiert werden, sodass er nur einmal vorhanden ist. Alternativ kann er auch innerhalb eines Unterbereichs konfiguriert werden, woraufhin er für jeden Datenblock im Unterbereich ausgeführt wird.
Felder im Zuweisungsbereich konfigurieren
Wenn Sie einen Zuweisungsbereich erstellen, definiert der Filter automatisch zwei Platzhalter. Diese zwei Platzhalter definieren das Name:Wert
-Paar.
-
Variablenname: Gibt das Feld an, dessen Inhalt als Variablenname verwendet wird (
Name
-Komponente in einem Paar). Konfigurieren Sie das Feld mithilfe derselben Methode, die Sie auch für Dokumentenfelder verwenden. Weitere Informationen finden Sie im Abschnitt Felder Definieren. -
Variablenwert: Gibt das Feld an, dessen Inhalt als Variablenwert verwendet wird (
Wert
-Komponente in einem Paar). Konfigurieren Sie das Feld mithilfe derselben Methode, die Sie auch für Dokumentenfelder verwenden. Weitere Informationen finden Sie im Abschnitt Felder Definieren.
Beispiel
Der Bereich zwischen ^XA und ^XZ ist der Zuweisungsbereich. Jede Zeile in einem Zuweisungsbereich stellt ein Name:Wert
-Paar bereit. Name ist als der Wert zwischen dem 6. Zeichen und dem Gleichheitszeichen in jeder Zeile definiert. Wert ist als der Wert zwischen dem Gleichheitszeichen und dem Zeilenende (mit negativem Versatz um drei Zeichen) definiert.
^XA ^FD01DonationHR=G095605 3412625^FS ^FD02DonationBC=DG0956053412625^FS ^FD03HospitalNoHR=HN060241^FS ^FD04HospitalNoBC=060241^FS ^FD05Surname=Hawley^FS ^FD07Forename=Annie^FS ^FD09Product=Blood^FS ^FD10PatientBlGp=O Rh +ve^FS ^FD11DoB=27 June 1947^FS ^FD12DateReqd=25 Dec 2012^FS ^XZ