Daten aus Datei lesen

Die Aktion liest den Inhalt der angegebenen Datei und speichert ihn in einer Variablen. Der Inhalt aller Dateitypen, einschließlich Binärdaten, kann gelesen werden.

Normalerweise empfängt das Modul Automation Builder Daten für den Etikettendruck anhand eines Triggers. Zum Beispiel: Wenn ein Dateitrigger verwendet wird, wird der Inhalt der Triggerdatei automatisch gelesen und kann durch Filter geparst werden. Möglicherweise wollen Sie die Filter jedoch umgehen, um externe Daten zu erhalten. Nachdem Sie diese Aktion ausgeführt und die Daten in einer Variablen gespeichert haben, können Sie zur Nutzung der Daten jede verfügbare Aktion verwenden.

Diese Aktion ist nützlich:

  • Wenn Sie vom Trigger empfangene Daten mit Daten verbinden wollen, die in einer Datei gespeichert sind.

    • Warnung:

    Wenn Sie Daten aus Binärdateien laden (z. B. Bitmap-Bilder oder Druckdateien), müssen Sie sicherstellen, dass die Variable zum Speichern des ausgelesenen Inhalts als binäre Variable definiert ist.

  • Wenn Sie Daten zwischen Triggern austauschen möchten. Ein Trigger bereitet die Daten vor und speichert sie als Datei (anhand der Aktion Daten in Datei speichern.

Die Gruppe Datei definiert die Datei, aus der die Daten gelesen werden sollen.

  • Dateiname: Speicherort der Datei, die innerhalb dieser Aktion ausgelesen werden soll.

    Pfad und Dateiname können fest codiert werden, und jedes Mal wird dieselbe Datei verwendet. Wenn nur ein Dateiname ohne Pfad angegeben ist, wird der Ordner mit Loftware Automation Konfigurationsdatei (.MISX) verwendet. Sie können eine relative Referenz auf den Dateinamen verwenden, in der der Ordner mit .MISX-Datei als Hauptverzeichnis verwendet wird.

    Datenquelle: aktiviert den variablen Dateinamen. Wählen Sie eine Variable aus, die den Pfad und/oder Dateinamen enthält, oder kombinieren Sie mehrere Variablen, die den Dateinamen bilden. Weitere Informationen finden Sie im Abschnitt Zusammengesetzte Werte verwenden im Loftware Automation Benutzerhandbuch.

    Hinweis

    Verwenden Sie für Netzwerkressourcen die UNC-Syntax. Weitere Informationen finden Sie im Abschnitt Zugriff auf freigegebene Ressourcen im Netzwerk im Loftware Automation Benutzerhandbuch.

Die Inhalt-Gruppe legt die Details in Bezug auf den Dateiinhalt fest.

  • Variable: Variable, die den Dateiinhalt speichert. Es sollte mindestens eine Variable (vorhanden oder neu erstellt) definiert werden.

  • Codieren: Codierungstyp für die gesendeten Daten. Auto legt die Codierung automatisch fest. Wählen Sie, falls nötig, den bevorzugten Codierungstyp aus der Dropdown-Liste aus.

    Hinweis

    „Codieren“ kann nicht ausgewählt werden, wenn die Daten aus einer binären Variablen gelesen werden. In diesem Fall enthält die Variable die Daten, wie sie vorliegen.

Die Gruppe Bei Fehler wiederholen definiert, wie die Ausführung der Aktion fortfahren soll, falls der Zugriff auf die angegebene Datei fehlschlägt.

Tipp

Das Modul Automation Builder ist vielleicht nicht in der Lage, auf die Datei zuzugreifen, da sie durch eine andere Anwendung gesperrt wird. Wenn eine andere Anwendung Daten in die ausgewählte Datei schreibt oder die Datei im exklusiven Modus geöffnet hat, kann sie nicht gleichzeitig von einer anderen Anwendung geöffnet werden, nicht einmal zum Lesen. Andere mögliche Ursachen für erneute Versuche zum Ausführen der Aktion sind: Datei existiert (noch) nicht, Ordner existiert (noch) nicht oder der Dienstbenutzer hat keine Berechtigung zum Zugriff auf die Datei.

  • Wiederholungsversuche: definiert die Anzahl von wiederholten Versuchen, auf die Datei zuzugreifen. Ist der Wert auf 0 eingestellt, wird kein wiederholter Versuch unternommen.

  • Wiederholungsintervall: Zeitintervall zwischen einzelnen Wiederholungsversuchen in Millisekunden.

Aktionsausführung und Fehlerhandhabung

Jede Aktion kann als bedingungsabhängige Aktion festgelegt werden. Bedingungsabhängige Aktionen werden nur ausgeführt, wenn die festgelegten Bedingungen erfüllt sind. Um diese Bedingungen zu definieren, klicken Sie auf Optionen für Ausführung und Fehlerhandhabung anzeigen.

Die Ausführungsoptionen sind:

  • Aktiviert: gibt an, ob die Aktion aktiviert oder deaktiviert ist. Nur aktivierte Aktionen werden ausgeführt. Diese Funktion kann beim Testen einer Druckmaske verwendet werden.
  • Bedingung: definiert einen einzeiligen Programmierausdruck, welcher einen booleschen Wert bereitstellen muss (wahr oder falsch). Ist das Ergebnis des Ausdrucks wahr, wird die Aktion ausgeführt. Bedingungen sorgen dafür, dass Aktionen nicht jedes Mal ausgeführt werden müssen.

Die Fehlerhandhabung-Optionen sind:

  • Fehler ignorieren : gibt an, ob ein Fehler ignoriert werden soll. Wenn aktiviert, wird die Ausführung von Aktionen selbst dann fortgesetzt, wenn die aktuelle Aktion fehlschlägt.

    Hinweis

    Geschachtelte Aktionen, die von der aktuellen Aktion abhängig sind, werden im Fall eines Fehlers nicht ausgeführt. Die Aktionsausführung wird bei der nächsten Aktion fortgesetzt, die sich auf derselben Ebene wie die aktuelle Aktion befindet. Der Fehler wird protokolliert, führt aber nicht zu einer Unterbrechung der Ausführung von Aktionen.

    • Beispiel

    Am Ende des Druckvorgangs möchten Sie eventuell mittels der Aktion HTTP-Anfrage einen Statusbericht an eine externe Anwendung senden. Wenn die Druckaktion fehlschlägt, wird die Aktionsverarbeitung angehalten. Um die Berichterstellung trotz fehlgeschlagener Druckaktion auszuführen, muss für die Aktion Etikett drucken die Option Fehler ignorieren aktiviert sein.

  • Fehler in Variable speichern : ermöglicht Ihnen, eine Variable auszuwählen oder zu erstellen, in der der Fehler gespeichert werden soll. Dieselbe Fehlerbeschreibung wird zudem in den internen Variablen ActionLastErrorId und ActionLastErrorDesc gespeichert.