TCP/IP Client Trigger

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

Der TCP/IP Client Trigger wandelt Ihr Automation in einen Daten empfangenden Client um, der sich mit TCP/IP-Servern verbindet. Es gibt mehrere Geräte und Systeme, die die Rolle eines TCP/IP-Servers übernehmen: Sichtkontrollsysteme, Drucker, SPS, Scanner, Waagen usw. Automation kann sich mit ihnen verbinden und auf eingehende Daten warten. Nach Empfang einer bestimmten Anzahl von Zeichen, einer Zeichenfolge oder nach einer Zeitüberschreitung wird der TCP/IP-Client-Trigger ausgelöst und beginnt mit der Ausführung Ihrer Aktionen. Wenn die Verbindung fehlschlägt, ermöglicht Ihnen der Trigger, automatisch eine erneute Verbindung herzustellen.

Typische Nutzung: Sie drucken automatisch mehrere Arten von Verpackungsetiketten mithilfe eines Netzwerkdruckers. Es ist unerlässlich für Sie, zu wissen, wann Ihr Drucker den Druck einer Art von Etikett abgeschlossen hat, bevor Sie mit der zweiten Etikettenart fortfahren. Der TCP/IP Client Trigger ermöglicht Ihnen, permanente automatisierte Prüfungen der Druckerverfügbarkeit festzulegen. Beim Drucken der ersten Etikettenart prüft der TCP/IP Client Trigger den Druckstatus. Wenn der Drucker fertig ist, weist er Automation an, die zweite Etikettenart zum Drucken zu senden.

Allgemein

Zielserver: Geben Sie den Ort (IP-Adresse oder Hostname) des TCP/IP-Servers an, mit dem Sie eine Verbindung herstellen möchten.
Anschluss: Gibt die Portnummer des Hosts an, von dem Sie die eingehenden Daten empfangen werden. Stellen Sie sicher, dass auf der Server-Seite die entsprechenden Ports in der Firewall geöffnet sind.
Intervall für erneute Verbindung zum Server: Geben Sie die Zeit in Millisekunden an, nach der Automation versucht, eine erneute Verbindung zu Ihrem TCP/IP-Server herzustellen.
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 der Server 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

Initialisierungsnachricht: Textnachricht, die jedes Mal an den Server gesendet wird, wenn Automation die Verbindung herstellt.
Antwortmeldung: Gibt die Textnachricht an, die beim Auslösen des Triggers an den Server ausgegeben wird (bevor die Aktionen ausgeführt werden).
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 23. 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 Fehler bei der Ausführung nicht erkennen. Weitere Informationen finden Sie im Abschnitt Synchroner Druckmodus.

Anmerkung

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.

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 und KeepAliveInterval) 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.

TCP/IP Client Trigger

Produktebenen-info

Produktebenen-info

Anmerkung

Anmerkung

Anmerkung