Informationen zu Filtern

NiceLabel Automation nutzt Filter, um die Struktur der Daten zu definieren, die von Triggern empfangen werden. Immer wenn ein Trigger Daten empfängt, werden sie von einem oder mehreren Filtern geparst. Dabei werden relevante Werte für Ihre Konfiguration extrahiert. Jeder Filter enthält Regeln zur Erkennung von Feldern in den empfangenen Daten.

Anmerkung

Als Ergebnis stellt der Filter eine Liste von Feldern und deren Werten bereit (Name:Wert-Paare).

Datenstruktur

Die Filterkomplexität hängt von der Datenstruktur ab. Bei Dateien mit strukturierten Daten, wie z. B. CSV- oder XML-Dateien, ist die Datenextraktion einfach. In solchen Fällen werden die Feldnamen bereits durch die Daten definiert. Die Extraktion von Name:Wert-Paaren geht schnell. Im Fall von unstrukturierten Daten braucht man mehr Zeit für die Definition der Extraktionsregeln. Sie könnten auf solche Daten stoßen, wenn Sie Dokumente und Berichte aus Altsystemen, abgefangene Kommunikation zwischen Geräten oder erfasste Druckströme exportieren.

Der Filter definiert eine Liste von Feldern, die aus den eingehenden Daten extrahiert werden, sobald Sie den Filter ausführen.

NiceLabel Automation unterstützt verschiedene Typen von Eingabedaten, die allesamt von einem der unterstützten Filtertypen geparst werden können. Wählen Sie den richtigen Filter für den jeweiligen Eingabedatentyp aus. Beispielsweise würden Sie für eingehende CSV-Daten den Filter für strukturierten Text, für eingehende JSON-Daten den JSON-Filter und für XML-Daten den XML-Filter verwenden. Für alle Arten von unstrukturierten Daten würden Sie den Filter für unstrukturierte Daten verwenden. Weitere Informationen finden Sie im Abschnitt Informationen zu Datenstrukturen.

Daten extrahieren

Ein Filter ist ein Satz von Regeln und führt die Extraktion nicht selbst aus. Um den Filter auszuführen, verwenden Sie die Aktion Datenfilter verwenden. Diese Aktion wendet Filterregeln auf die jeweiligen Daten an und extrahiert die Werte.

Jeder Trigger-Typ kann beliebig viele „Datenfilter verwenden“-Aktionen ausführen. Wenn Sie zusammengesetzte Daten erhalten, die nicht von einem einzigen Filter geparst werden können, können Sie mehrere Filter definieren und ihre Regeln anhand einer Abfolge von „Datenfilter verwenden“-Aktionen ausführen. Danach können Sie die extrahierten Werte aus allen Aktionen auf demselben Etikett verwenden.

Felder Variablen zuordnen

Um die extrahierten Werte zu nutzen, müssen Sie sie in Variablen speichern. Die Aktion „Datenfilter verwenden“ tut beides – sie extrahiert Werte und speichert sie in Variablen. Um diesen Prozess zu konfigurieren, ordnen Sie jede Variable dem entsprechenden Feld zu. Der Wert des Feldes wird dann in der zugeordneten Variablen gespeichert.

Tipp

Es empfiehlt sich, Felder und Variablen mit identischen Namen zu definieren. In diesem Fall verbindet die automatische Zuordnung Variablen mit den gleichnamigen Feldern, wodurch die manuelle Zuordnung überflüssig wird.

Automatische Zuordnung ist für alle unterstützten Filtertypen verfügbar. Wenn die automatische Zuordnung aktiviert ist, extrahiert die „Datenfilter verwenden“-Aktion Werte und ordnet sie automatisch den Variablen zu, deren Namen mit denen der jeweiligen Felder identisch sind. Weitere Informationen finden Sie in den Abschnitten Dynamische Struktur aktivieren für den Filter für strukturierten Text, Zuweisungsbereiche definieren für den Filter für unstrukturierte Daten und „Zuweisungsbereiche definieren“ für XML- oder JSON-Filter.

Aktionen mit extrahierten Daten ausführen

Für gewöhnlich möchten Sie bestimmte Aktionen anhand der extrahierten Daten ausführen, z. B. Etikett öffnen, Etikett drucken oder eine der Aktionen für ausgehende Verbindungen. Es ist sehr wichtig, solche Aktionen unter der Datenfilter verwenden-Aktion einzubinden. So stellen Sie sicher, dass die eingebundenen Aktionen für jede Datenextraktion ausgeführt werden.

Beispiel 1. Beispiel

Wenn Sie eine CSV-Datei mit fünf Zeilen haben, werden auch die eingebundenen Aktionen fünfmal ausgeführt, einmal für jede Datenextraktion. Sind die Aktionen nicht eingebunden, werden sie nur einmal ausgeführt und enthalten nur Daten aus der letzten Datenextraktion. Beim obigen Beispiel würde die 5. CSV-Zeile gedruckt, die ersten vier Zeilen nicht. Falls Sie Unterbereiche nutzen, müssen Sie sicherstellen, dass Sie Ihre Aktion unter dem richtigen Platzhalter einbinden.