FOR Schleife

Enterprise.png

Die Aktion führt alle untergeordneten (geschachtelten) Aktionen mehrmals aus. Alle geschachtelten Aktionen werden in einer Schleife so häufig ausgeführt, wie durch die Differenz zwischen dem Start- und Endwert vorgegeben.

UUID-7cda050d-5e85-d9bd-6bf4-1e1b227b0fa3.png

Anmerkung

Die Aktion „FOR Schleife“ leitet den Sitzungsdruckmodus ein – einen Druckoptimierungsmodus, der alle Etiketten anhand einer einzelnen Druckauftragsdatei in einer Schleife druckt. Weitere Informationen finden Sie im Abschnitt „Sitzungsdruck“ des NiceLabel Automation Benutzerhandbuchs.

Die Gruppe Schleifeneinstellungen enthält die folgenden Optionen:

  • Startwert: Referenz für den Startpunkt der Schleife. Wählen Sie Datenquelle, um den Startwert dynamisch anhand eines Variablenwerts zu definieren. Wählen Sie für den Start eine Variable mit einem numerischen Wert aus oder erstellen Sie eine solche Variable.

  • Endwert: Referenz für den Endpunkt. Wählen Sie Datenquelle, um den Startwert dynamisch anhand eines Variablenwerts zu definieren. Wählen Sie für den Start eine Variable mit einem numerischen Wert aus oder erstellen Sie eine solche Variable.

    Tipp

    Für Startwert und Endwert sind negative Werte erlaubt.

  • Loop-Wert in Variable speichern: speichert den Wert des aktuellen Schrittes der Schleife in einer vorhandenen oder neu erstellten Variablen. Der Schleifen-Schrittwert kann einen beliebigen Wert zwischen dem Start- und Endwert enthalten. Speichern Sie den Wert, um ihn in einer anderen Aktion zur Erkennung der aktuellen Iteration zu verwenden.

Datenfilter verwenden

Diese Aktion wendet die Filterregeln auf die Eingabedatenquelle an. Als Ergebnis der Aktion werden Felder aus Eingabedaten extrahiert und ihre Werte den verbundenen Variablen zugeordnet.

Die Aktion „Datenfilter verwenden“ führt also den ausgewählten Filter aus und weist die Werte den entsprechenden Variablen zu.

  • Elemente auf niedrigerer Ebene: Die Aktion kann Elemente auf niedrigerer Ebene erstellen, die durch „Für jede Zeile" oder „Für jeden Datenblock in ..." identifiziert werden. In diesem Fall extrahiert der Filter die Daten nicht auf Dokumentebene (mit fest codierter Feldpositionierung), sondern relativ aus den Unterbereichen, die sich wiederholende Abschnitte enthalten. Stellen Sie dabei sicher, dass Sie Ihre Aktionen unter solchen Elementen anordnen. Die Aktionen müssen unter solchen Elementen geschachtelt werden.

  • Variablen Feldern zuordnen: Die Zuordnung von Trigger-Variablen und Filterfeldern wird entweder manuell definiert oder erfolgt automatisiert, je nachdem, wie der Filter konfiguriert ist. Falls Sie manuell definierte Felder im Filter haben, müssen Sie die Felder auch manuell der entsprechenden Variablen zuordnen.

    Anmerkung

    Es empfiehlt sich, Felder mit Namen zu definieren, die mit den Namen der Etikettenvariablen identisch sind. In diesem Fall erfolgt nach Klicken auf die Schaltfläche Automatisch verbinden eine automatische Zuordnung identischer Namen.

  • Ausführung des Filters testen: Wenn die Zuordnung von Variablen zu Feldern abgeschlossen ist, können Sie die Ausführung des Filters testen. Das Ergebnis wird auf dem Bildschirm in einer Tabelle angezeigt. Die Anzahl von Zeilen in der Tabelle gibt die Häufigkeit der Ausführung von Aktionen auf der ausgewählten Ebene an. Die Spaltennamen entsprechen den Variablennamen. Die Zellen enthalten die Werte, die der jeweiligen Variablen durch den Filter zugewiesen wurden. Der Standardname der Vorschaudatei wird aus der Filterdefinition abgeleitet; Sie können den Filter auch auf jede andere Datei anwenden.

  • Datensätze für Berichte erfassen dient zur Erfassung Ihrer Daten, damit Sie Datenfilter zum Erstellen von Berichten verwenden können. Weitere Informationen finden Sie unter Berichte automatisieren.

    Pro_Enterprise.png
UUID-b7bbe427-83b0-a3d5-5620-bf5ad1e21251.png

Auf der Benutzeroberfläche Ihres Datenfilters navigieren.

  1. Filterauswahl

  2. Daten, die Ihr Filter zum Ausführen der Regeln verwendet.

  3. Erfassung von Berichtdatensätzen.

  4. Zuordnung Ihrer Felder (aus dem Filter) auf Variablen (aus dem Etikett/Trigger).

  5. Filterausführungs-Vorschau.

Weitere Informationen finden Sie in den Abschnitten „Informationen zu Filtern“ und „Beispiele“ im NiceLabel Automation Benutzerhandbuch.

Die Gruppe Filter ermöglicht es Ihnen, auszuwählen, welcher Filter verwendet werden soll.

  • Name: gibt den Namen des anzuwendenden Filters an. Er kann entweder fest codiert oder durch eine vorhandene oder neu erstellte Variable dynamisch definiert werden. Diese Liste enthält alle in der aktuellen Konfiguration definierten Filter. Sie können die unteren drei Elemente in der Liste verwenden, um einen neuen Filter zu erstellen.

Anmerkung

Bei Auswahl eines anderen Filters werden alle unter dieser Aktion geschachtelten Aktionen entfernt. Wenn Sie die aktuell definierten Aktionen beibehalten möchten, bewegen Sie sie aus der Aktion Datenfilter verwenden. Wenn Aktionen aus Versehen verloren gehen, können Sie Ihre Aktion Rückgängig machen und zur vorherigen Konfiguration zurückkehren.

Die Gruppe Datenquelle ermöglicht es Ihnen, die Inhalte festzulegen, die an den Drucker gesendet werden sollen.

  • Vom Trigger empfangene Daten verwenden: wählt die vom Trigger empfangenen Daten zur Verwendung in einem Filter aus. In diesem Fall nutzt die Aktion die ursprünglichen, vom Trigger empfangenen Daten und wendet die Filterregeln auf sie an.

    Beispiel 56. Beispiel

    Wenn Sie einen Datei-Trigger verwenden, stellen die Daten Inhalte der überwachten Datei dar. Wenn Sie einen Datenbank-Trigger verwenden, sind die Daten ein von der Datenbank ausgegebenes Daten-Set. Wenn Sie einen TCP/IP-Trigger verwenden, sind es Rohdaten, die über ein Socket empfangen wurden.


  • Dateiname: legt den Speicherort und den Dateinamen der Datei fest, welche die Daten enthält, auf die die Filterregeln angewandt werden. Der Inhalt der angegebenen Datei wird vom Filter verwendet. Die Option Datenquelle aktiviert den variablen Dateinamen. Sie müssen eine Variable auswählen oder erstellen, die den Pfad und/oder Dateinamen enthält.

  • Benutzerdefiniert: gibt den benutzerdefinierten Inhalt an, der vom Filter geparst werden soll. Sie können festen Inhalt, eine Mischung aus festem und variablem Inhalt oder ausschließlich variablen Inhalt verwenden. Um variablen Inhalt einzufügen, klicken Sie auf die Schaltfläche mit dem Pfeil rechts neben dem Datenbereich und fügen Sie eine Variable aus der Liste ein. Weitere Informationen finden Sie im Abschnitt „Zusammengesetzte Werte verwenden“ im NiceLabel Automation Benutzerhandbuch.

Das Feld Datenvorschau bietet eine Übersicht über den Prozess der Filterausführung, nachdem der Inhalt der für die Voransicht ausgewählten Datei ausgelesen und der ausgewählte Filter auf sie angewandt wurde.

Die Regeln im Filter extrahieren Felder. Die Tabelle zeigt das Ergebnis der Extraktion an. Jede Zeile in der Tabelle beinhaltet Daten für ein einzelnes Etikett. Jede Spalte steht für eine Variable.

Um ein Ergebnis sehen zu können, konfigurieren Sie die Zuordnung von Feldern zu passenden Variablen. Abhängig von der Filterdefinition kann die Zuordnung von Feldern und Variablen manuell oder automatisch erfolgen.

  • Name der Vorschaudatei: Gibt die Datei an, welche die Daten 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. Das Feld Datenvorschau wird mit dem neuen Ergebnis aktualisiert.

Für jeden Datensatz

Diese Aktion führt untergeordnete geschachtelte Aktionen mehrmals aus. Alle geschachtelten Aktionen werden als Schleife für jeden Datensatz in der Eingabemasken-Tabelle mit verbundener Datenbank ausgeführt.

Die Gruppe Einstellungen wählt die Datensätze aus.

  • Masken-Tabelle: Masken-Tabelle, die Datensätze enthält, für die eine Aktion wiederholt werden soll.

  • Alle Datensätze verwenden: wiederholt eine Aktion für alle Datensätze in einer definierten Tabelle.

  • Ausgewählte Datensätze verwenden: wiederholt eine Aktion nur für die ausgewählten Datensätze.

Wenn Sie die Aktion SQL-Anweisung ausführen mit aktivierter Option Für jeden Datensatz iterieren verwenden, NiceLabelwird automatisch die Aktion Für jeden Datensatz eingefügt. Es erscheint ein Hinweis auf die automatische Zuordnung Ihrer Variablen.

UUID-fd1e1d36-7791-3823-5d23-214a3939d49d.png
UUID-3c2cf06d-cd0e-86cb-9e53-23a731f14b58.png

Eingabeaufforderungsvariablen auf Ihrem Etikett verbinden sich automatisch mit Ihren Datenbankfeldern mit denselben Namen. Lesen Sie die Anweisungen zum Erstellen Ihrer Lösungen:

Wichtig

Wenn Sie Ihre Lösung mit einer Datenbankverbindung erstellen, verwenden Sie anstelle von Datenbankfeldern Eingabeaufforderungsvariablen auf Ihren Etiketten.

Verwenden Sie für Eingabeaufforderungsvariablen dieselben Namen wie für Datenbankfelder definiert, zum Beispiel:

Datenbankfeld: food_products_1c.ProdCode

Prompt-Variable auf Ihrem Etikett: ProdCode

NiceLabel ordnet dann automatisch entsprechende Variablen mit Datenbankfeldern zu.

Beispiel 58. Beispiel

Ihre Lösung ist mit Ihrer Datenbank verbunden. Ihre Konfiguration filtert angeforderte Datenbankdatensätze und Sie möchten gefilterte Datensätze auf Ihre Etiketten drucken.

Aktion verwenden Für jeden Rekord und verschachteln Sie Aktionen, um Ihre Etiketten zu drucken.

UUID-273b54f1-cecc-107f-6081-22d8b96ac772.png