Um mehr über Trigger im Allgemeinen zu erfahren, siehe Abschnitt Informationen zu Triggern.
Das TCP/IP-Server-Triggerereignis tritt ein, wenn das überwachte Socket (IP-Adresse und Portnummer) Daten empfängt.
Typische Nutzung: Typische Nutzung: Ein vorhandenes Geschäftssystem führt eine Transaktion durch, wodurch wiederum Daten über ein bestimmtes Socket an den NiceLabel Automation Server gesendet werden. Der Dateninhalt kann strukturiert sein (CSV, XML und andere Formate) oder ein veraltetes Format aufweisen. In jedem Fall 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 wichtigsten Dateitrigger-Einstellungen vornehmen.
-
Name: Gibt den eindeutigen Namen des Triggers an. Die Namen helfen Ihnen dabei, zwischen verschiedenen Triggern zu unterscheiden, wenn Sie sie in Automation Builder konfigurieren und später in Automation Manager ausführen.
-
Beschreibung: Ermöglicht es Ihnen, die Rolle dieses Triggers zu beschreiben. Geben Sie für die Benutzer eine kurze Erklärung zur Funktionsweise des Triggers ein.
-
Anschluss: Gibt die Nummer der Schnittstelle an, wo eingehende Daten empfangen werden. Verwenden Sie die Portnummer, 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.
-
Maximale Anzahl gleichzeitig akzeptierter Verbindungen: Gibt die maximale Anzahl gleichzeitig akzeptierter Verbindungen an. Dies definiert die Anzahl von Clients, die gleichzeitig Daten an den Trigger senden können.
Die Optionen im Abschnitt Ausführungsereignis geben vor, wann der Trigger auslösen und Aktionen ausführen soll.
-
Bei Trennung des Clients: Gibt an, dass der Trigger auslöst, nachdem der Client Daten gesendet und die Verbindung geschlossen hat. Dies ist die Standardeinstellung.
Anmerkung
Falls Sie den Status des Druckauftrags als Feedback an die Drittanwendung zurücksenden wollen, sollten Sie diese Option nicht verwenden. Bleibt die Verbindung offen, können Sie mithilfe der Aktion Daten an TCP/IP-Port senden und dem Parameter Absender antworten ein Feedback senden.
-
Beim Empfang der Anzahl von Zeichen: Legt fest, dass der Trigger auslöst, wenn die erforderliche Anzahl von Zeichen empfangen wird. In diesem Fall kann die Drittanwendung eine Verbindung offen lassen und kontinuierlich Daten senden. Jedes Datenpaket muss dieselbe Größe haben.
-
Beim Empfang der Abfolge von Zeichen: Legt fest, dass der Trigger jedes Mal auslöst, wenn die erforderliche Anzahl von Zeichen empfangen wird. Diese Option wird verwendet, wenn Sie wissen, dass das Datenende immer durch eine identische Zeichenfolge gebildet wird. Anhand der Schaltfläche neben dem Feld „Bearbeiten“ können Sie (binäre) Sonderzeichen einfügen.
-
In Trigger-Daten einschließen: Die Abfolge von Zeichen, die das Trigger-Ereignis bestimmt, wird nicht aus den Daten entfernt, sondern ist in den Daten enthalten. Der Trigger bezieht den vollständigen empfangenen Datenstrom.
-
-
Wenn nach dem angegebenen Zeitintervall nichts empfangen wird: Gibt an, dass der Trigger auslöst, wenn ein bestimmtes Zeitintervall nach Empfang des letzten Zeichens verstreicht.
Ausführen
-
Verbindungen von den folgenden Hosts zulassen: Gibt die Liste von IP-Adressen oder Hostnamen der Computer an, die sich mit dem Trigger verbinden dürfen. Stellen Sie jeden Eintrag in eine neue Zeile.
-
Verbindungen von den folgenden Hosts nicht zulassen: Gibt die Liste von IP-Adressen oder Hostnamen der Computer an, die sich nicht mit dem Trigger verbinden dürfen. Stellen Sie jeden Eintrag in eine neue Zeile.
-
Begrüßungsnachricht: Gibt eine Textnachricht an, die jedes Mal an den Client zurückgegeben wird, wenn er sich mit dem TCP/IP-Trigger verbindet.
-
Antwortmeldung: Gibt die Textnachricht an, die jedes Mal an den Client zurückgegeben wird, wenn die Aktionen ausgeführt werden. Verwenden Sie diese Option, wenn der Client die Verbindung nicht nach Senden der Daten abbricht und die Antwort über das Ende der Aktionsausführung erwartet. Die Antwortnachricht ist fest codiert und daher immer identisch.
-
Meldungscodierung: Gibt das Datencodierungsmuster an, damit Sonderzeichen richtig verarbeitet werden können.NiceLabel Automation kann die Datencodierung anhand des BOM-Headers (Textdateien) oder des Codierungs-Attributs (XML-Dateien) automatisch erkennen.
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 22. 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.
Sicherheit
-
Trigger sperren und verschlüsseln: Aktiviert den Trigger-Schutz. Wenn Sie die Option aktivieren, wird der Trigger gesperrt und kann nicht mehr bearbeitet werden. Dadurch werden die Aktionen verschlüsselt. Nur Benutzer mit einem Passwort können den Trigger entsperren und bearbeiten.
Keepalive-Signale senden
Ihr Netzwerk-Routing-System kann Ihre Verbindung geräuschlos trennen, wenn einige Minuten lang kein TCP/IP-Verkehr stattfindet. Um zu vermeiden, dass die Verbindung unterbrochen wird, können Sie in regelmäßigen Abständen Keepalive-Signale in NiceLabel Automation.
Aktivieren Sie das Senden von Keepalive-Signalen in Ihrer Datei product.config:
-
Navigieren Sie zum Systemordner.
%PROGRAMDATA%\NiceLabel\NiceLabel 10
-
Erstellen Sie eine Sicherungskopie der Datei
product.config
. -
Öffnen Sie
product.config
in einem Text-Editor. Die Datei hat eine XML-Struktur. -
Fügen Sie die folgenden Zeilen hinzu:
<configuration> <IntegrationService> <KeepAliveTime>60000</KeepAliveTime> <KeepAliveInterval>10000</KeepAliveInterval> </IntegrationService> </configuration>
Anmerkung
KeepAliveTime
(in Millisekunden): Gibt an, wie lange die TCP-Socket-Verbindung inaktiv sein muss, bevor die Automatisierung ein Keepalive-Signal sendet und auf die Rücksendung der Bestätigungspakete wartet.KeepAliveInterval
(in Millisekunden): Gibt an, in welchen Abständen ein weiteres Keepalive-Paket gesendet werden soll, wenn der Host keine Bestätigungspakete zurücksendet.Wenn der TCP/IP-Trigger das KeepAlive-Paket empfängt und das Bestätigungspaket zurücksendet, beginnt die
KeepAliveTime
-Zeitschaltuhr erneut.Beide Werte (
KeepAliveTime
undKeepAliveInterval
) sind zwingend erforderlich, um das Senden von Keepalive-Signalen zu ermöglichen, und müssen Werte haben, die größer sind als 0. -
Speichern Sie die Datei
product.config
. -
Starten Sie Ihr Automation service neu.
Aktivierte Keepalive-Signale halten Ihre Verbindung jetzt aktiv.