Feedback zum Status von Druckaufträgen

Die Anwendung, die Daten für den Etikettendruck in NiceLabel Automation bereitstellt, erwartet möglicherweise Informationen zu den Status des Druckauftrags. Dieses Feedback kann ein einfaches „Alles OK“ sein, nachdem der Druckauftrag erfolgreich erstellt wurde, oder im Fall von Problemen ausführliche Fehlerbeschreibungen beinhalten. Aus Performance-Gründen ist das Feedback standardmäßig in NiceLabel Automation deaktiviert. So wird ein hoher Druckdurchsatz gewährleistet, da der Trigger sich nicht um die Ausführung von Druckprozessen kümmert. Die Fehler werden in der Protokolldatenbank gespeichert, aber der Trigger ist davon unabhängig.

Sie können diese Methode auch nutzen, um Feedback zu anderen Daten zu senden, die der Trigger sammelt. Dabei kann es sich um den Status der Netzwerkdrucker, die Anzahl von Aufträgen im Drucker-Spooler, eine Liste von Etiketten in einem Ordner, die Liste von Variablen in der angegebenen Etikettendatei und vieles mehr handeln.

Anmerkung

Um Feedback-Unterstützung in der Druck-Engine zu aktivieren, aktivieren Sie den synchronen Druckmodus. Weitere Informationen finden Sie im Abschnitt Synchroner Druckmodus.

Aktivieren Sie Feedback zum Status von Druckaufträgen anhand einer der beiden verfügbaren Methoden.

Der Trigger stellt Feedback zum Status des Druckauftrags bereit (synchrones Feedback)

Einige Trigger haben eine integrierte Feedback-Funktion. Wenn der synchrone Druckmodus aktiviert ist, wird der Status des Druckauftrags automatisch an den Trigger ausgegeben. Der Client kann die Daten an den Trigger senden, die Verbindung aufrechterhalten und auf das Feedback warten. Um diese Feedback-Methode zu verwenden, wählen Sie einen Trigger-Typ aus, der die Bereitstellung von Feedback unterstützt.

Tritt bei einer der Aktionen ein Fehler auf, enthält die interne Variable ActionLastErrorDesc die entsprechende ausführliche Fehlermeldung. Sie können ihren Wert 1:1 senden oder ihn anpassen.

Weitere Informationen finden Sie in den Angaben zu den jeweiligen Trigger-Typen.

Webdienst-Trigger: Dieser Trigger-Typ verfügt über eine integrierte Unterstützung für Feedback. Das WSDL-(Web Service Description Language-)Dokument enthält Angaben zur Webdienst-Schnittstelle und zur Aktivierung von Feedback. Sie können die Standardantwort nutzen, die eine Fehlerbeschreibung ausgibt, falls die Druckaktion fehlschlägt. Alternativ können Sie die Nachricht auch anpassen und den Inhalt einer beliebigen Variablen senden. Die Variable selbst kann beliebige Daten enthalten, einschließlich einer Etikettenvorschau oder eines Etiketten-Druckauftrags (Binärdaten).
HTTP Server Trigger: Dieser Trigger-Typ verfügt über eine integrierte Unterstützung für Feedback. NiceLabel Automation nutzt die Standard-HTTP-Antwortcodes, um den Status des Druckauftrags anzuzeigen. Sie können die HTTP-Antwort auch anpassen und den Inhalt einer beliebigen Variablen senden. Die Variable selbst kann beliebige Daten enthalten, einschließlich einer Etikettenvorschau oder eines Etiketten-Druckauftrags (Binärdaten).
TCP/IP Server Trigger: Dieser Trigger unterstützt Feedback, aber nicht automatisch. Damit er Feedback ausgeben kann, konfigurieren Sie den datengebenden Client dafür, die Verbindung nicht zu trennen, nachdem die Daten gesendet wurden. Nach Abschluss des Druckprozesses ist für die nächste Aktion in der Liste (Daten an TCP/IP Port senden) möglicherweise die Einstellung Absender antworten sein aktiviert. Senden Sie Feedback über die bestehende, noch offene Verbindung.

Aktion stellt Feedback zum Status des Druckauftrags bereit (asynchrones Feedback)

Wenn Sie Trigger verwenden, die keine native Unterstützung für Feedback bieten, oder wenn Sie Feedback-Nachrichten während der Trigger-Verarbeitung senden möchten, definieren Sie eine Aktion, die Feedback an ein bestimmtes Ziel sendet. In diesem Fall kann die datengebende Anwendung die Verbindung trennen, nachdem die Trigger-Daten bereitgestellt wurden.

Beispiel 92. Beispiel

Sie haben den TCP/IP-Trigger verwendet, um die Daten zu erfassen. Der Client hat die Verbindung direkt nach Senden der Daten unterbrochen, weswegen keine Antwort über diese Verbindung mehr möglich ist. In solchen Fällen können Sie einen anderen Kanal verwenden, um Feedback zu senden. Sie können eine der Aktionen für ausgehende Verbindungen konfigurieren, z. B. SQL-Anweisung ausführen, Dokument/Programm öffnen, HTTP-Anfrage, Daten an TCP/IP-Port senden und andere. Solche Aktionen werden unter der Aktion Etikett drucken platziert.

Wenn Sie nur zu bestimmten Status Feedback senden möchten, etwa zu „Fehler aufgetreten“, können Sie eine der folgenden Methoden verwenden.

Bedingung für eine Aktion nutzen: Der Druckauftrags-Status wird in Form von zwei internen Variablen angegeben (ActionLastErrorID und ActionLastErrorDesc). Die erste enthält die Fehler-ID oder, falls keine Fehler aufgetreten sind, den Wert 0. Die zweite enthält eine ausführliche Fehlermeldung. Verwenden Sie Werte dieser Variablen in Bedingungen für Aktionen, die im Fall von Fehlern ausgeführt werden sollen. Beispielsweise würden Sie die Aktion HTTP-Anfrage nach dem Drucken verwenden. Die Aktion würde im Fall eines Fehlers Feedback senden. Um solches Feedback zu aktivieren, tun Sie Folgendes:
1. Öffnen Sie die Trigger-Eigenschaften.
2. Klicken Sie in der Multifunktionsleisten-Gruppe Variable auf die Schaltfläche Interne Variablen und aktivieren Sie die Variable ActionLastErrorID.
3. Öffnen Sie die Registerkarte „Aktionen“.
4. Fügen Sie die Aktion Daten an HTTP senden hinzu.
5. Erweitern Sie innerhalb der Eigenschaften der Aktion den Punkt Optionen für Ausführung und Fehlerhandhabung anzeigen.
6. Geben Sie Folgendes für Bedingung ein. Die Aktion mit dieser Bedingung wird nur ausgeführt, wenn ein Fehler auftritt und ActionLastErrorID die Fehler-ID enthält (ein beliebiger Wert größer 0). Standardmäßig werden die Bedingungen mithilfe der VBScript-Syntax angegeben.
  
  ActionLastErrorID > 0
7. Außerdem müssen Sie die Option Fehler ignorieren für jede Aktion öffnen, die erwartungsgemäß fehlschlagen wird. So weisen Sie an, die Ausführung der Aktionen nicht vollständig zu beenden, sondern mit der nächsten Aktion auf derselben hierarchischen Ebene fortzufahren.
  
  Anmerkung
  
  Weitere Informationen finden Sie in den Abschnitten Fehlerhandhabung.
Aktion „Testen“ verwenden: Die Aktion „Testen“ macht die Programmierung von Bedingungen überflüssig. Die Aktion bietet Ihnen zwei Platzhalter. Der Platzhalter Ausführen enthält Aktionen, die Sie ausführen möchten. Falls bei ihrer Ausführung ein Fehler passiert, werden sie abgebrochen; stattdessen werden die Aktionen ausgeführt, die im Platzhalter Bei Fehler angegeben sind. In diesem Platzhalter können Sie Aktionen für ausgehende Verbindungen verwenden, um ein Status-Feedback zum Druckauftrag bereitzustellen. Weitere Informationen finden Sie im Abschnitt Testen.