Webdienst-Trigger

Um mehr über Trigger im Allgemeinen zu erfahren, siehe Abschnitt Informationen zu Triggern.

Das Webdienst-Triggerereignis tritt ein, wenn ein überwachtes Socket (IP-Adresse und Portnummer) Daten empfängt. Die Daten müssen der SOAP-Notation entsprechen – sie codiert XML-Daten als HTTP-Nachricht. Die Webdienst-Schnittstelle wird im WSDL-Dokument beschrieben. Ein solches Dokument steht für jeden definierten Webdienst-Trigger zur Verfügung.

Der Webdienst-Trigger stellt ein Feedback zum Druckauftrag bereit, aber Sie müssen dazu den synchronen Verarbeitungsmodus aktivieren. Weitere Informationen finden Sie im Abschnitt Feedback zum Status von Druckaufträgen im Benutzerhandbuch.

Normalerweise verwenden Programmierer den Webdienst, um den Etikettendruck in ihre eigenen Anwendungen zu integrieren. Ein vorhandenes Geschäftssystem führt eine Transaktion durch, wodurch Daten über ein bestimmtes Socket an den NiceLabel Automation Server gesendet werden. Die gesendeten Daten sind als SOAP-Nachricht formatiert. Die Daten können in einem strukturierten Format wie CSV und XML oder aber in einem der Legacy-Formate bereitgestellt werden. In beiden Fällen liest NiceLabel Automation die Daten aus, parst Werte anhand von Filtern und druckt diese Werte auf Etiketten. Weitere Informationen zum Parsen und Extrahieren von Daten finden Sie im Abschnitt Informationen zu Filtern.

Allgemein

In diesem Bereich können Sie die allgemeinen Datei-Trigger-Einstellungen vornehmen.

Kommunikation

Anmerkung

Dieser Trigger unterstützt Internet Protocol Version 6 (IPv6).

In diesem Bereich können Sie die obligatorische Portnummer sowie verschiedene Feedback-Einstellungen konfigurieren.

Anschluss: Gibt die Nummer der Schnittstelle an, die eingehende Daten empfängt. Verwenden Sie eine Schnittstelle, die noch nicht von einer anderen Anwendung genutzt wird. Falls die ausgewählte Schnittstelle in Verwendung ist, können Sie den Trigger nicht in Automation Manager starten. Weitere Informationen zu Sicherheitsüberlegungen finden Sie in Abschnitt Zugriff auf Ihre Trigger sichern.

Anmerkung

Wenn auf Ihrem Server Multi-Homing aktiviert ist (mehrere IP-Adressen auf einer oder mehreren Netzwerkkarten), antwortet NiceLabel Automation an der festgelegten Schnittstelle für alle IP-Adressen.

Sichere Verbindung (HTTPS): Aktiviert die sichere Transportschicht für Ihre HTTP-Nachrichten und verhindert Abhörangriffe. Weitere Informationen zur Einrichtung finden Sie im Abschnitt Sicheres Übertragungsprotokoll (HTTPS) nutzen.
Maximale Anzahl gleichzeitiger Aufrufe: Gibt die maximale Anzahl gleichzeitig akzeptierter Verbindungen an. Dies definiert die Anzahl von Clients, die gleichzeitig Daten an den Trigger senden können.
Antwortdaten: Definiert die benutzerdefinierte Antwort, die zusammen mit den Methoden ExecuteTriggerWithResponse und ExecuteTriggerAndSetVariablesWithResponse verwendet werden kann. Die Antwortdaten enthalten den Inhalt, der im Textbereich angezeigt wird. Sie können feste Werte, variable Werte und Sonderzeichen verbinden. Um Variablen und Sonderzeichen einzufügen (oder zu erstellen), klicken Sie auf die Pfeil-Schaltfläche rechts neben dem Textbereich. Die Antwort kann Binärdaten enthalten, z. B. Etikettenvorschaubilder und Druckdateien (*.PRN).

Status-Feedback

Standardmäßig stellt der Trigger Feedback zum Status des erstellten Druckauftrags bereit. Der Trigger akzeptiert und nutzt die bereitgestellten Daten zum Ausführen definierter Aktionen. Sie können die Ausführung von Aktionen überwachen – der Trigger meldet einen Erfolgsstatus für jedes Ereignis, das während der Ausführung eintritt. Um Statusberichte während des Druckvorgangs zu ermöglichen, aktivieren Sie Synchroner Druckmodus.

Der Webdienst-Trigger stellt die folgenden Methoden (Funktionen) zur Verfügung:

ExecuteTrigger: Diese Methode nimmt Daten zur Verarbeitung entgegen und gibt optionales Statusfeedback aus. Einer der Eingabeparameter aktiviert bzw. deaktiviert Feedback. Wenn Sie Statusberichte aktivieren, enthält das Feedback die Fehler-ID und eine ausführliche Beschreibung des Fehlers. Ist die Fehler-ID gleich 0, gab es kein Problem beim Erstellen der Druckdatei. Ist die Fehler-ID größer als 0, ist beim Druckprozess ein Fehler aufgetreten. Die Webdienst-Antwort in dieser Methode ist nicht konfigurierbar – die Antwort enthält immer die Fehler-ID und die Fehlerbeschreibung.

ExecuteTriggerWithResponse: Diese Methode nimmt Daten zur Verarbeitung entgegen und gibt benutzerdefiniertes Statusfeedback aus. Die Webdienst-Antwort ist konfigurierbar. Sie können mit allen Arten von Daten antworten, die nach einer beliebigen verfügbaren Struktur organisiert sind. Sie können binäre Daten in der Antwort verwenden.
ExecuteTriggerAndSetVariables: Ähnlich wie die obige Methode ExecuteTrigger, bietet dieser Webdienst einen zusätzlichen eingehenden Parameter, welcher die formatierte Liste mit Name-Wert-Paaren entgegennimmt. Der Trigger parst die Liste automatisch, extrahiert Werte und speichert die Werte in den gleichnamigen Variablen, sodass Sie keinen eigenen Filter für die Datenextraktion definieren müssen.
ExecuteTriggerAndSetVariablesWithResponse: Ähnlich wie die obige Methode ExecuteTriggerWithResponse, bietet dieser Webdienst einen zusätzlichen eingehenden Parameter, welcher die formatierte Liste mit Name-Wert-Paaren entgegennehmen. Der Trigger parst die Liste automatisch, extrahiert Werte und speichert die Werte in der gleichnamigen Variablen, sodass Sie keinen eigenen Filter für die Datenextraktion definieren müssen.

Weitere Informationen über die Struktur von Nachrichten, die Sie anhand einer der oben aufgeführten Methoden senden können, finden Sie im Abschnitt WSDL unten.

WSDL

Die Web Services Description Language (WSDL) gibt den Stil von SOAP-Nachrichten vor. Dies kann entweder ein Remoteprozeduraufruf-Stil (RPC) oder ein Dokument-Stil sein. Wählen Sie den Stil, den Ihre datengebende Anwendung unterstützt.

Das WSDL-Dokument legt die Eingangs- und Ausgangsparameter des Webdienstes fest.

Nachdem der Webdienst-Trigger an Port 12345 definiert wurde, implementieren Sie ihn in Automation Manager und starten Sie ihn. WSDL wird verfügbar unter:

http://localhost:12345

WSDL bietet verschiedene Methoden an, die allesamt Daten für den Trigger bereitstellen. Wählen Sie die Methode, die für Ihre Anforderungen am besten geeignet ist.

Methoden mit WithResponse im Namen ermöglichen es Ihnen, angepasste Antworten zu senden, etwa benutzerdefinierte Fehlermeldungen, eine Etikettenvorschau, PDF-Dateien, Druckdateien (*.PRN) und ähnliches. Methoden ohne WithResponse im Namen geben ebenfalls Feedback aus, aber Sie können die Antwort nicht anpassen. Das Feedback enthält standardmäßige Fehlermeldungen.
Methoden mit SetVariables im Namen ermöglichen Ihnen, eine Liste mit Variablen in zwei vordefinierten Formaten bereitzustellen.Automation Extrahiert automatisch Werte und ordnet sie den passenden Variablen zu. Dies spart Ihnen Zeit, weil Sie keinen Filter für die Extraktion und Zuordnung definieren müssen. Für die Methoden ohne SetVariables im Namen müssen Sie die Filter selbst definieren.

Die Oberfläche des Webdienstes definiert die folgenden Methoden:

ExecuteTrigger-Methode

Der Hauptteil der Definition lautet:

<wsdl:message name="WebSrviTrg_ExecuteTrigger_InputMessage">
    <wsdl:part name="text" type="xsd:string"/>
    <wsdl:part name="wait" type="xsd:boolean"/>
</wsdl:message>
<wsdl:message name="WebSrviTrg_ExecuteTrigger_OutputMessage"
    <wsdl:part name="ExecuteTriggerResult" type="xsd:int"/
    <wsdl:part name="errorText" type="xsd:string"/>
</wsdl:message>

Die Definition beinhaltet zwei Eingabevariablen (Sie geben ihre Werte an):

text: Filter in der Konfiguration parst diese Eingabezeichenfolge. Normalerweise ist die Eingabezeichenfolge als CSV- oder XML-Datei strukturiert, wodurch sie sich einfach parsen lässt. Sie können auch ein anderes Textdateiformat verwenden.
wait: Dies ist ein boolesches Feld, das zwei Dinge festlegt:
- Ob Sie auf die Statusantwort des Druckauftrags warten möchten oder nicht.
- Ob der Webdienst ein Feedback ausgeben soll oder nicht.
Wählen Sie für Wahr den Wert 1. Wählen Sie für Falsch den Wert 0. Abhängig vom ausgewählten Methodentyp gibt es entweder eine vordefinierte Antwort, oder Sie können eine benutzerdefinierte Antwort senden.

Dies sind optionalen Ausgabevariablen (Sie erhalten ihre Werte, wenn Sie sie anfordern, indem Sie wait auf 1 setzen:

ExecuteTriggerResult: Die als Ganzzahl ausgegebene Antwort enthält den Wert 0, falls kein(e) Datenverarbeitungsfehler gemeldet wird/werden. Sie enthält eine Ganzzahl größer 0, wenn Fehler aufgetreten sind. Die Anwendung, welche den Webdienst-Aufruf an NiceLabel Automation ausführt, kann die Antwort als Fehlerindikator verwenden.
errorText: Dieser Zeichenfolgenwert enthält eine Druckauftrags-Statusantwort, wenn ein Fehler während der Trigger-Verarbeitung auftritt.

Anmerkung

Wenn während der Trigger-Verarbeitung ein Fehler auftritt, wird dieses Element in die XML-Antwortnachricht eingeschlossen und sein Wert enthält die Fehlerbeschreibung. Ist jedoch kein Fehler aufgetreten, wird das Element nicht in die XML-Antwort eingeschlossen.

ExecuteTriggerWithResponse-Methode

Sie würden diese Methode verwenden, wenn ein Trigger die benutzerdefinierte Antwort nach erfolgter Ausführung senden soll.

Einige Beispiele für Inhalte, die Sie in Form von benutzerdefinierten Antworten senden können: Benutzerdefinierte Fehlermeldungen, eine Etikettenvorschau, erzeugte PDF-Dateien, Druckstrom-Dateien (Spool-Dateien), XML-Dateien mit Daten aus der Druck-Engine und der Etikettenvorschau (als Base64-Zeichenfolge codiert) usw. Die Möglichkeiten sind praktisch unbegrenzt.

Der Hauptteil der Definition lautet:

<wsdl:message name="WebSrviTrg_ExecuteTriggerWithResponse_InputMessage">
    <wsdl:part name="text" type="xsd:string"/>
    <wsdl:part name="wait" type="xsd:boolean"/>
</wsdl:message>
<wsdl:message name="WebSrviTrg_ExecuteTriggerWithResponse_OutputMessage">
    <wsdl:part name="ExecuteTriggerWithResponseResult" type="xsd:int"/>
    <wsdl:part name="responseData" type="xsd:base64Binary"/>
    <wsdl:part name="errorText" type="xsd:string"/>
</wsdl:message>

Im obigen Beispiel gibt es zwei Eingabevariablen (Sie geben ihre Werte an):

text: Filter in der Konfiguration parst diese Eingabezeichenfolge. Normalerweise ist die Eingabezeichenfolge als CSV- oder XML-Datei strukturiert, wodurch sie sich einfach parsen lässt. Sie können auch ein anderes Textdateiformat verwenden.
wait: Dies ist ein boolesches Feld, das zwei Dinge festlegt:
- Ob Sie auf die Statusantwort des Druckauftrags warten möchten oder nicht.
- Ob der Webdienst ein Feedback ausgeben soll oder nicht.
Wählen Sie für Wahr den Wert 1. Wählen Sie für Falsch den Wert 0. Abhängig vom ausgewählten Methodentyp gibt es entweder eine vordefinierte Antwort, oder Sie können eine benutzerdefinierte Antwort senden.

Außerdem sind im Beispiel die folgenden optionalen Ausgabevariablen enthalten.

Anmerkung

Sie erhalten Werte von optionalen Ausgabevariablen, wenn Sie sie durch Einstellen des wait-Feldwerts auf 1 anfordern.

ExecuteTriggerWithResponseResult: Die Ganzzahl-Antwort enthält den Wert 0, wenn bei der Datenverarbeitung keine Fehler aufgetreten sind. Sie enthält eine Ganzzahl größer 0, wenn Fehler aufgetreten sind. Die Anwendung, die den Webdienst-Aufruf an NiceLabel Automation ausführt, kann diese Antwort als Fehlerindikator verwenden.
responseData: Benutzerdefinierte Antwort, die Sie bei der Konfiguration des Webdienst-Triggers festlegen können. Die Antwort erfolgt in Form von base64-codierten Daten.
errorText: Wenn ein Fehler bei der Trigger-Verarbeitung auftritt, enthält diese Zeichenfolge den Antwort-Wert für den Druckauftrags-Status.

Anmerkung

Fall bei der Trigger-Verarbeitung ein Fehler gemeldet wird, beinhaltet die XML-Antwortnachricht das errorText-Element. Der Wert dieses Elements enthält die Fehlerbeschreibung. Ist jedoch kein Fehler aufgetreten, wird das Element nicht in die XML-Antwort eingeschlossen.

ExecuteTriggerAndSetVariables-Methode

Der Hauptteil der Definition lautet:

<wsdl:message name="WebSrviTrg_ExecuteTriggerAndSetVariables_InputMessage">
    <wsdl:part name="text" type="xsd:string"/>
    <wsdl:part name="variableData" type="xsd:string"/>
    <wsdl:part name="wait" type="xsd:boolean"/>
</wsdl:message>
    <wsdl:message name="WebSrviTrg_ExecuteTriggerAndSetVariables_OutputMessage">
    <wsdl:part name="ExecuteTriggerAndSetVariablesResult" type="xsd:int"/>
    <wsdl:part name="errorText" type="xsd:string"/>
</wsdl:message>

Im obigen Beispiel gibt es drei Eingabevariablen (Sie geben ihre Werte an):

text: Filter in der Konfiguration parst diese Eingabezeichenfolge. Normalerweise ist die Eingabezeichenfolge als CSV- oder XML-Datei strukturiert, wodurch sie sich einfach parsen lässt. Sie können auch ein anderes Textdateiformat verwenden.
wait: Dies ist ein boolesches Feld, das zwei Dinge festlegt:
- Ob Sie auf die Statusantwort des Druckauftrags warten möchten oder nicht.
- Ob der Webdienst ein Feedback ausgeben soll oder nicht.
Wählen Sie für Wahr den Wert 1. Wählen Sie für Falsch den Wert 0. Abhängig vom ausgewählten Methodentyp gibt es entweder eine vordefinierte Antwort, oder Sie können eine benutzerdefinierte Antwort senden.

variableData: Dies ist die Zeichenfolge, welche die Name:Wert-Paare enthält. Der Trigger liest alle Paare aus und ordnet die verfügbaren Werte den gleichnamigen Trigger-Variablen zu. Ist die Variable im Trigger nicht vorhanden, verwirft der Trigger das jeweilige Name:Wert-Paar. Wenn Sie die Liste von Variablen und ihren Werten mithilfe dieser Methode angeben, müssen Sie keine Datenextraktion in den Filtern definieren. Der Trigger übernimmt das gesamte Parsing für Sie.

Es gibt zwei verfügbare Strukturen für den variableData-Inhalt.
XML-Struktur
Der Trigger stellt Variablen innerhalb des <Variables />-Stammelements der XML-Datei bereit. Der Variablenname enthält den Attributnamen und der Variablenwert enthält den Elementwert.

<?xml version="1.0" encoding="utf-8"?> <Variables> <variable name="Variable1">Value 1</variable> <variable name="Variable2">Value 2</variable> <variable name="Variable3">Value 3</variable> </Variables>

Anmerkung

Betten Sie Ihre XML-Daten innerhalb des CDATA-Abschnitts ein. CDATA, also Zeichendaten, ist ein Abschnitt des Elementinhalts, der dem Parser mitteilt, dass er als normale Zeichendaten interpretiert werden soll, nicht als Markup. Daher behandelt der Trigger den gesamten Inhalt als Zeichendaten. <element>ABC</element> wird z. B. als <element>ABC</element> interpretiert. Jeder CDATA-Abschnitt beginnt mit der Folge <![CDATA[ und endet mit der Folge ]]>. Fügen Sie Ihre XML-Daten einfach zwischen diesen Folgen ein.
Name-Wert-Paare
Der Trigger stellt Variablen in Form eines Textdatenstroms bereit. Jedes Name:Wert-Paar steht in einer eigenen Zeile. Der Variablenname steht auf der linken Seite des Gleichheitszeichens (=), der Variablenwert auf der rechten Seite.

Variable1="Value 1" Variable2="Value 2" Variable3="Value 3"

Dies sind die optionalen Ausgabevariablen:

Anmerkung

Sie erhalten Werte für optionale Variablen, wenn Sie sie durch Einstellen von wait auf 1 anfordern:

ExecuteTriggerAndSetVariablesResult: Die Ganzzahl-Antwort enthält den Wert 0, wenn bei der Datenverarbeitung keine Fehler aufgetreten sind. Sie enthält eine Ganzzahl größer 0, wenn bei der Datenverarbeitung Fehler gemeldet werden. Die Anwendung, die den Webdienst-Aufruf an NiceLabel Automation ausführt, kann die Antwort als Fehlerindikator verwenden.
errorText: Dieser Zeichenfolgenwert enthält eine Druckauftrags-Statusantwort, wenn ein Fehler während der Trigger-Verarbeitung auftritt.

Anmerkung

Im Fall eines Trigger-Verarbeitungsfehlers ist dieses Element in der XML-Antwortnachricht enthalten. Sein Wert beinhaltet die Fehlerbeschreibung. Ist jedoch kein Fehler aufgetreten, wird das Element nicht in die XML-Antwort eingeschlossen.

ExecuteTriggerAndSetVariablesWithResponse-Methode

Sie würden diese Methode verwenden, wenn der Trigger nach erfolgter Ausführung eine benutzerdefinierte Antwort senden soll.

Der Hauptteil der Definition lautet:

<wsdl:message name="WebSrviTrg_ExecuteTriggerAndSetVariablesWithResponse_
InputMessage">
    <wsdl:part name="text" type="xsd:string"/>
    <wsdl:part name="variableData" type="xsd:string"/>
    <wsdl:part name="wait" type="xsd:boolean"/>
</wsdl:message>
<wsdl:message name="WebSrviTrg_ExecuteTriggerAndSetVariablesWithResponse_
OutputMessage">
    <wsdl:part name="ExecuteTriggerAndSetVariablesWithResponseResult"
type="xsd:int"/>
    <wsdl:part name="responseData" type="xsd:base64Binary"/>
    <wsdl:part name="errorText" type="xsd:string"/>
</wsdl:message>

Es gibt drei Eingabevariablen (Sie geben ihre Werte an):

text: Filter in der Konfiguration parst diese Eingabezeichenfolge. Normalerweise ist die Eingabezeichenfolge als CSV- oder XML-Datei strukturiert, wodurch sie sich einfach parsen lässt. Sie können auch ein anderes Textdateiformat verwenden.
wait: Dies ist ein boolesches Feld, das zwei Dinge festlegt:
- Ob Sie auf die Statusantwort des Druckauftrags warten möchten oder nicht.
- Ob der Webdienst ein Feedback ausgeben soll oder nicht.
Wählen Sie für Wahr den Wert 1. Wählen Sie für Falsch den Wert 0. Abhängig vom ausgewählten Methodentyp gibt es entweder eine vordefinierte Antwort, oder Sie können eine benutzerdefinierte Antwort senden.

variableData: Dies ist die Zeichenfolge, welche die Name:Wert-Paare enthält. Der Trigger liest alle Paare aus und ordnet die verfügbaren Werte den gleichnamigen Trigger-Variablen zu. Ist die Variable im Trigger nicht vorhanden, verwirft der Trigger das jeweilige Name:Wert-Paar. Wenn Sie die Liste von Variablen und ihren Werten mithilfe dieser Methode angeben, müssen Sie keine Datenextraktion in den Filtern definieren. Der Trigger übernimmt das gesamte Parsing für Sie.

Es gibt zwei verfügbare Strukturen für den variableData-Inhalt.
XML-Struktur
Der Trigger stellt Variablen innerhalb des <Variables />-Stammelements der XML-Datei bereit. Der Variablenname enthält den Attributnamen und der Variablenwert enthält den Elementwert.

<?xml version="1.0" encoding="utf-8"?> <Variables> <variable name="Variable1">Value 1</variable> <variable name="Variable2">Value 2</variable> <variable name="Variable3">Value 3</variable> </Variables>

Anmerkung

Betten Sie Ihre XML-Daten innerhalb des CDATA-Abschnitts ein. CDATA, also Zeichendaten, ist ein Abschnitt des Elementinhalts, der dem Parser mitteilt, dass er als normale Zeichendaten interpretiert werden soll, nicht als Markup. Daher behandelt der Trigger den gesamten Inhalt als Zeichendaten. <element>ABC</element> wird z. B. als <element>ABC</element> interpretiert. Jeder CDATA-Abschnitt beginnt mit der Folge <![CDATA[ und endet mit der Folge ]]>. Fügen Sie Ihre XML-Daten einfach zwischen diesen Folgen ein.
Name-Wert-Paare
Der Trigger stellt Variablen in Form eines Textdatenstroms bereit. Jedes Name:Wert-Paar steht in einer eigenen Zeile. Der Variablenname steht auf der linken Seite des Gleichheitszeichens (=), der Variablenwert auf der rechten Seite.

Variable1="Value 1" Variable2="Value 2" Variable3="Value 3"

Dies sind die optionalen Ausgabevariablen:

Anmerkung

Sie erhalten ihre Werte, wenn Sie sie durch Einstellen von wait auf 1 anfordern:

ExecuteTriggerAndSetVariablesWithResponseResult: Die Ganzzahl-Antwort enthält den Wert 0, wenn bei der Datenverarbeitung keine Fehler aufgetreten sind. Sie enthält eine Ganzzahl größer 0, wenn bin der Antwort Fehler gemeldet werden. Die Anwendung, welche den Webdienst-Aufruf an NiceLabel Automation ausführt, kann die Antwort als Fehlerindikator verwenden.
responseData: Benutzerdefinierte Antwort, die Sie bei der Konfiguration des Webdienst-Triggers festlegen können. Die Antwort erfolgt in Form von base64-codierten Daten.
errorText: Dieser Zeichenfolgenwert enthält eine Druckauftrags-Statusantwort, wenn ein Fehler während der Trigger-Verarbeitung auftritt.

Anmerkung

Im Fall eines Trigger-Verarbeitungsfehlers ist dieses Element in der XML-Antwortnachricht enthalten. Sein Wert beinhaltet die Fehlerbeschreibung. Ist jedoch kein Fehler aufgetreten, wird das Element nicht in die XML-Antwort eingeschlossen.

Sonstiges

Die Optionen im Bereich Feedback von der Print Engine legen die Kommunikationsparameter fest, durch die Sie Feedback von der Druck-Engine erhalten können.

Überwachtes Drucken: Aktiviert den synchronen Druckmodus. Verwenden Sie ihn, wenn Sie den Status des Druckauftrags an die Drittanwendung zurücksenden wollen. Weitere Informationen finden Sie im Abschnitt Synchroner Druckmodus.

Die Optionen im Abschnitt Datenverarbeitung geben an, ob Sie die Daten kürzen möchten, damit sie in eine Variable passen, oder ob die fehlenden Etikettenvariablen ignoriert werden sollen. Standardmäßig meldet Fehler und unterbricht den Druckprozess, wenn Sie versuchen, zu lange Werte in Etikettenvariablen zu speichern oder Werte für nicht vorhandene Etikettenvariablen anzugeben.

Übermäßig lange Variableninhalte ignorieren: kürzt Datenwerte, die die Länge der Variable gemäß Definition im Etiketten-Designer überschreiten, um sie auf passende Länge zu bringen. Diese Option wird wirksam, wenn Sie Variablenwerte in Filtern oder aus Befehlsdateien festlegen und wenn Sie Werte von Triggervariablen den gleichnamigen Etikettenvariablen zuordnen.

Beispiel 25. Beispiel

Die Etikettenvariable akzeptiert maximal 5 Zeichen. Wenn diese Option aktiviert ist, wird jeder Wert über 5 Zeichen auf die ersten 5 Zeichen gekürzt. Wenn der Wert 1234567 lautet, ignoriert die 6. Und 7. Stelle.
Fehlende Etikettenvariablen ignorieren: Beim Drucken mit Befehlsdateien (z. B. JOB-Dateien), werden alle Variablen ignoriert, die:
- in der Befehlsdatei angegeben sind (anhand des SET Befehls)
- nicht auf dem Etikett definiert sind
Etwas Ähnliches geschieht, wenn Sie einen Zuweisungsbereich in einem Filter definieren, um alle Name-Wert-Paare zu extrahieren, Ihr Etikett jedoch weniger Variablen enthält.

Wenn Sie Werte von nicht vorhandenen Etikettenvariablen einstellen, gibt einen Fehler aus. Wenn diese Option aktiviert ist, wird der Druck fortgesetzt.

Die Optionen im Abschnitt Scripting geben die Scripting-Möglichkeiten an.

Scripting-Sprache: Wählt die Scripting-Sprache für den Trigger aus. Alle Script ausführen-Aktionen, die Sie innerhalb eines einzelnen Triggers nutzen, verwenden die ausgewählte Scripting-Sprache.

Die Optionen im Abschnitt Empfangene Daten speichern legen die Befehle fest, die für vom Trigger empfangene Daten zur Verfügung stehen.

Vom Trigger empfangene Daten speichern in Datei: Aktivieren Sie diese Option, um vom Trigger empfangene Daten zu speichern. Die Option Variable aktiviert einen variablen Dateinamen. Wählen Sie eine Variable aus, die den Pfad und den Dateinamen enthält.
Bei Fehler vom Trigger empfangene Daten speichern in Datei: Aktivieren sie diese Option, um die vom Trigger empfangenen Daten nur dann zu speichern, wenn ein Fehler bei der Ausführung der Aktion auftritt. Sie könnten diese Option beispielsweise aktivieren, um die Daten zu behalten, die das Problem hervorgerufen haben, um die Lösungsfindung zu erleichtern.

Anmerkung

Stellen Sie sicher, dass Sie die Unterstützung für Überwachtes Drucken aktivieren. Ist sie nicht aktiviert, kann Automation Fehler bei der Ausführung nicht erkennen. Weitere Informationen finden Sie im Abschnitt Synchroner Druckmodus.

Anmerkung

Automation speichert die empfangenen Daten in einer temporären Datei. Diese temporäre Datei wird sofort nach Abschluss der Trigger-Ausführung gelöscht. Die interne Variable DataFileName verweist auf diesen Dateinamen. Weitere Informationen finden Sie in den Abschnitten Interne Variablen.