1. NiceLabel Help Center
  2. Automation
  3. Informationen zu Triggern

Cloud-Trigger

Produktebenen-info

Erfordert ein NiceLabel Cloud-Abonnement.

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

Hier erfahren Sie mehr über NiceLabel Label Cloud.

Cloud-Trigger ermöglicht Ihnen die Integration von NiceLabel Cloud oder von Ihrem vor Ort gehosteten Control Center mit vorhandenen Geschäftssystemen, die in privaten Clouds oder in speziellen Rechenzentren ausgeführt werden. Wenn ein vorhandenes Geschäftssystem (wie SAP S/4HANA oder Oracle NetSuite) eine Ausgabe erzeugt, ermöglicht Ihnen eine in der Cloud gehostete API, HTTP-Anforderungen an den Cloud-Trigger zu senden.

Der Cloud-Trigger ermöglicht Ihnen das lokale Drucken von Etiketten, deren Inhalte aus den Cloud-basierten Informationssystemen stammen. Da der im lokalen Automation ausgeführte Cloud-Trigger Standardmethoden für den Zugriff auf Cloud-basierte Dienste verwendet, können Sie lokales Drucken auf sichere und zeitsparende Weise bereitstellen.

Der Cloud-Trigger bietet eine sichere und transparente Möglichkeit zur Integration Ihres lokalen Etikettendrucks anhand von Anwendungen, die über das offene Internet kommunizieren.

Im Gegensatz zum HTTP Server Trigger müssen Sie für den Cloud-Trigger keine eingehenden Ports in Ihrer Firewall öffnen. Der Cloud-Trigger nutzt eine dedizierte NiceLabel API, die in der Cloud ausgeführt wird. Deswegen erfordert der Trigger nur eine Öffnung des ausgehenden Ports 443 oder der Ports 9350-9354. In den meisten Fällen sind diese Ports bereits geöffnet.

Beim Implementieren des Cloud-Triggers haben Sie zwei Optionen:

In Bezug auf den Funktionsumfang sind beide Optionen gleichwertig. Wählen Sie Ihre bevorzugte Option auf Basis Ihrer verfügbaren Infrastruktur.

Cloud-Trigger mit NiceLabel Cloud implementieren

Implementierungsphasen für NiceLabel Cloud

Um den lokalen Etikettendruck anhand des NiceLabel Cloud implementierten Cloud-Triggers zu ermöglichen, müssen Sie eine Zusammenarbeit zwischen Benutzern mit drei Rollen herstellen: ein Benutzer, der den Cloud-Trigger auf dem lokalen Automation Server konfiguriert (Entwickler), ein Benutzer, der den Cloud-Trigger in NiceLabel Cloud einrichtet und ein Benutzer, der das Abonnement im Entwicklerportal vornimmt.

UUID-4a7834ab-e9e3-d7ac-d0fd-c550f1520e0e.png

  1. Der Entwickler übernimmt die Konfiguration und Bereitstellung der Cloud-Trigger-Konfiguration auf dem lokalen Automation Server anhand von Automation Builder und Automation Manager.

    Anmerkung

    NiceLabel Automation muss in der NiceLabel Cloud angemeldet sein.

  2. Der NiceLabel Cloud Administrator gewährt dem externen Integrator Zugriff auf den Cloud-Trigger in Control Center. Nach Fertigstellung sendet der NiceLabel Cloud Administrator dem externen Integrator den entsprechenden Integratorschlüssel.

  3. Der externe Integrator führt im Entwicklerportal das Geschäftssystem des Kunden und die NiceLabel Cloud zusammen.

    Anmerkung

    Im Entwicklerportal wird die dafür erstellte API namens Cloud Trigger gehostet. Diese API fungiert als Schnittstelle zwischen den Ereignissen, die im Geschäftssystem des Kunden stattfinden, und der lokale ausgeführten Automation Konfiguration.

    Anmerkung

    Der Begriff „extern“ bedeutet, dass die Rolle dieses Benutzers darin besteht, das Abonnement im Entwicklerportal vorzunehmen. Das erstellte Abonnement authentifiziert den Integrator. Externe Integratoren müssen nicht zwangsläufig Personen außerhalb des Unternehmens sein. Die Aufgaben können auch von internen Integratoren übernommen werden, die dem Entwicklungsteam des Unternehmens angehören.

    Der externe Integratoren führt folgende Aktionen im Entwicklerportal aus:

    1. Anmeldung im Entwicklerportal. Vor der ersten Anmeldung muss der Integrator außerdem den Registrierungsvorgang durchlaufen.

    2. Erstellen eines Abonnements für die Cloud Trigger API.

    3. Verknüpfung des Abonnements mit dem Integratorschlüssel. So erhält das Abonnement Zugriff auf die Cloud-Trigger des Kunden.

      Weitere Details finden Sie im Abschnitt NiceLabel Cloud API im Entwicklerportal einrichten.

Cloud-Trigger in Automation Builder konfigurieren

Dieser Abschnitt beschreibt, wie Sie den Cloud-Trigger in Automation konfigurieren, das auf Ihrem lokalen Server ausgeführt wird.

  1. Öffnen Sie Ihren Automation Builder. Stellen Sie sicher, dass der Automation Builder bei der NiceLabel Cloud angemeldet ist. Gehen Sie auf Datei > Über > NiceLabel Cloud, um sich zu vergewissern, dass Sie angemeldet sind.

  2. Die Registerkarte Konfigurationselemente wird geöffnet. Klicken Sie auf Cloud-Trigger, um eine neue Konfiguration für den Cloud-Trigger zu erstellen.

  3. Stellen Sie Namen und Beschreibung ein, um Ihren Cloud-Trigger unter anderen Triggern leicht finden zu können.

  4. Nehmen Sie die Kommunikation-Einstellungen für den Trigger vor:

    • Legen Sie die Eindeutige Kennung fest. Nachdem Sie den Trigger bereitgestellt haben, ist diese eindeutige Kennung erforderlich, um den Trigger aufzurufen.

      Wenn Sie die Cloud-Trigger-Konfiguration auf mehreren Computern durchführen, müssen Sie sicherstellen, dass jeder Computer automatisch seine eigene eindeutige Kennung verwendet. Um unerwünschte Duplikate zu vermeiden, fügen Sie interne Variablen als Teil der Eindeutigen Kennung ein. Sie können zu diesem Zweck zwei interne Variablen verwenden:

      • ComputerName: Der Name des Computers, auf dem die Konfiguration ausgeführt wird.

      • SystemUserName: Der Windows-Benutzername des aktuell angemeldeten Benutzers.

      Um interne Variablen in die Eindeutige Kennung einzufügen, klicken Sie auf „Datenquelle einfügen“ und wählen Sie Ihre internen Variablen aus.

      UUID-7905238a-2b2d-69c4-9856-247bdcb0320c.png

    • Warten, bis Trigger-Ausführung abgeschlossen ist: Das HTTP-Protokoll wartet darauf, dass der Empfänger (in diesem Fall NiceLabel Automation) eine numerische Antwort an den Absender übermittelt, die den Status der empfangenen Nachricht anzeigt. Standardmäßig antwortet NiceLabel Automation mit dem Code 200. Dies zeigt an, dass Automation die Daten erfolgreich empfangen hat, gibt aber keine Informationen über den Erfolg von Trigger-Aktionen.

      Diese Option legt fest, dass ein Trigger nicht sofort nach Empfang der Daten eine Antwort sendet, sondern wartet, bis alle Aktionen ausgeführt wurden. Danach sendet er den Antwort-Code, um das erfolgreiche Ausführen von Aktionen zu bestätigen. Wenn diese Option aktiviert ist, können Sie eine benutzerdefinierte Antwort und die entsprechenden Daten zurücksenden (z. B. ist die Antwort auf eine HTTP-Abfrage die Etikettenvorschau im PDF-Format).

      Beim Cloud-Trigger sind die relevanten, in Automation integrierten Standard-HTTP-Antwortcodes:

      HTTP-Antwortcode

      Beschreibung

      200

      Alle Aktionen erfolgreich ausgeführt.

      500

      Beim Ausführen der Aktion sind Fehler aufgetreten.

      Anmerkung

      Um Feedback zum Druckprozess an Automation zu senden, aktivieren Sie den synchronen Druckmodus. Weitere Informationen finden Sie im Abschnitt Synchroner Druckmodus.

    • Antworttyp: Gibt den Typ Ihrer Antwortnachricht an. Häufig verwendete Internet-Medientypen (auch MIME-Typen oder Content-Typen genannt) stehen in der Dropdown-Liste zur Verfügung. Falls Ihr Medientyp nicht in der Liste enthalten ist, geben Sie ihn selbst ein. Automation sendet die ausgehenden Antwortdaten im Format des festgelegten Medientyps als Feedback. Variable aktiviert variable Medientypen. Wählen Sie bei aktivierter Option eine Variable aus (oder erstellen Sie eine Variable), die den Medientyp enthält.

      Anmerkung

      Wenn Sie keinen MIME-Typ angeben, verwendet NiceLabel Automation application/octet-stream als Standard.

    • Antwortdaten: Definiert den Inhalt Ihrer Antwortnachricht. Beispiele für Inhalte, die Sie in Form von HTTP-Antworten senden können: Benutzerdefinierte Fehlermeldungen, Etikettenvorschau, erzeugte PDF-Dateien, Druckstrom-(Spool-)Dateien, XML-Dateien mit Daten aus der Druck-Engine und der Etikettenvorschau (als Base64-Zeichenfolge codiert) usw.

      Wenn Ihre Ausgabe aus binären Inhalten besteht (z. B. Etikettenvorschau oder Druckstrom), müssen Sie einen unterstützten Medientyp auswählen, z. B. image/jpeg oder application/octet-stream.

    • Zusätzliche Header: Ermöglicht es Ihnen, benutzerdefinierte MIME-Header für die HTTP-Antwortnachricht zu definieren.

      Die Syntax für Antwortheader und Beispiele stehen im Abschnitt Aktion „HTTP-Anfrage“ zur Verfügung.

      Tipp

      Sie können bei Antwortdaten und zusätzlichen Headern festen Inhalt, eine Mischung aus festem und variablem Inhalt oder ausschließlich variablen Inhalt verwenden. Um variablen Inhalt einzufügen, klicken Sie auf die Schaltfläche mit dem Pfeil rechts neben dem Datenbereich und fügen Sie Ihre Variable aus der Liste ein. Sie können auch eine neue Variable erstellen, die die Daten enthält, sie Sie verwenden möchten. Weitere Informationen finden Sie im Abschnitt Zusammengesetzte Werte verwenden im Benutzerhandbuch.

  5. Stellen Sie den Trigger in Automation Manager bereit und starten Sie ihn. Der Cloud-Trigger überwacht jetzt eingehende Anfragen.

Anmerkung

Wenn Ihre Konfiguration höhere Verfügbarkeit und Skalierbarkeit erfordert, können Sie mehrere identische Cloud-Trigger bereitstellen. Installieren Sie zu diesem Zweck mehrere Instanzen von Automation und stellen Sie die Cloud-Trigger auf ihnen bereit. Wenn die bereitgestellten Cloud-Trigger dieselbe Eindeutige Kennung haben, verteilt der integrierte Lastausgleich in NiceLabel Cloud die Traffic-Last gleichmäßig auf sie.

Cloud-Trigger-Zugriff für den externen Integrator einrichten

Anmerkung

Um den Zugriff des Integrators auf den Cloud-Trigger einzurichten, müssen Sie die Berechtigung zur Verwaltung der Cloud-Integration im Cloud-basiertenControl Center haben. Im Benutzerhandbuch für Control Center finden Sie weitere Informationen zur Verwaltung von Benutzerrechten.

  1. Gehen Sie zu Ihrem Cloud-basierten Control Center. Öffnen Sie den Webbrowser und geben Sie https://<yourlabelcloudname>./dashboard ein:

    https://<yourlabelcloudname>.onnicelabel.com/dashboard.

  2. Gehen Sie auf Anwendungen > Cloud-Integrationen.

  3. Klicken Sie auf +Hinzufügen. Die Seite Cloud-Trigger-Integratoren wird geöffnet.

  4. Geben Sie den Namen des Integrators ein, den Sie hinzufügen.

    UUID-48984233-2f5c-3b15-04d2-a284439f7360.png

  5. Kopieren Sie den Schlüssel.

  6. Klicken Sie auf Speichern.

  7. Verweisen Sie den externen Integrator auf das Entwicklerportal. Senden Sie die folgenden Informationen an den externen Integrator:

    • Link zur NiceLabel Cloud API: https://developerportal.onnicelabel.com/

    • Den Integrator-Schlüssel (siehe Schritt 5).

    • Die eindeutige Kennung des Triggers. Sie finden diese Eindeutige Kennung in den Automation-Konfigurationseinstellungen für Cloud-Trigger (siehe Schritt 4 im AbschnittCloud-Trigger in Automation Builder konfigurieren .

    Anmerkung

    Externe Integratoren benötigen den Schlüssel, um sich zum Aufrufen des Cloud-Triggers des Kunden zu authentifizieren.

Anmerkung

Weitere Informationen finden Sie im Abschnitt „Cloud-Trigger“ Ihres Control Center Benutzerhandbuchs.

Ein Abonnement im Entwicklerportal erstellen

Nach Erhalt der erforderlichen Informationen vom NiceLabel Cloud-Administrator muss sich der externe Integrator zuerst im Entwicklerportal registrieren und Abonnements (für jeden Kunden) zum Aufrufen der Trigger erstellen. Diese Triggeraufrufe stammen aus den Cloud-basierten Informationssystemen der Kunden.

Anmerkung

Wenn Sie die E-Mail des Entwicklerportals nicht in Ihrem Posteingang finden, sehen Sie im Spam-Ordner nach.

Anmerkung

Kunden sind Unternehmen, die Cloud-Trigger-Konfigurationen ausführen, welche die Daten von externen Informationssystemen erhalten.

Anmerkung

Jeder Integrator kann mit einem Abonnement mehrere Cloud-Trigger aufrufen.

  1. Öffnen Sie Ihren Browser und gehen Sie auf https://developerportal.onnicelabel.com/

  2. Folgen Sie den Anweisungen auf dem Bildschirm, um die Registrierung durchzuführen. Nach Klicken auf Sign up erhalten Sie eine Bestätigungs-E-Mail. Klicken Sie auf den Bestätigungslink, um Ihren Account im Entwicklerportal zu aktivieren.

  3. Öffnen Sie die Registerkarte Produkte und klicken Sie auf Label Cloud. Danach werden Sie auf eine Seite mit Ihren APIs und vorhandenen Abonnements geleitet.

  4. Klicken Sie auf Add subscription. Die Seite Subscribe to product wird geöffnet.

    Anmerkung

    Sie können mehrere Abonnements erstellen. Ein einzelnes Abonnement kann jedoch nur für einen einzelnen Kunden verwendet werden. Daher empfiehlt NiceLabel Ihnen, den Namen den Kunden in den Subscription name (Abonnementnamen) einzubeziehen, z. B. Cloud Trigger Example Customer.

  5. Geben Sie den Subscription name ein.

  6. Klicken Sie auf Confirm. Das neu erstellte Abonnement steht unter Products > Label Cloud verfügbar.

  7. Klicken Sie auf der Seite Label Cloud auf Developer Sign Up API v1.

  8. Klicken Sie auf Try it. Die API-Seite wird geöffnet.

    UUID-233e0250-4199-27da-0968-e7275329f997.png

  9. Fügen Sie den Integrator Key aus dem Cloud-basierten Control Center des Kunden ein.

  10. Klicken Sie auf Send.

    • Die Antwort lautet: Abonnement <Ihr Abonnementschlüssel> erfolgreich mit Integratorschlüssel <Wert des Integratorschlüssels> verbunden.

    Anmerkung

    Sie haben den Integratorschlüssel vom NiceLabel Cloud Administrator erhalten. Der Schlüssel sieht folgendermaßen aus: 979d7be5df2b473193ac5519f94cd901

    Beispiel 26. Beispiel

    Wenn Sie den Integrationsschlüssel als Abfrageparameter weitergeben, sieht die URL folgendermaßen aus:https://labelcloudapi.onnicelabel.com/SignUpApi/DeveloperSignup?integratorKey=979d7be5df2b473193ac5519f94cd901.


    Wenn Sie den Aufruf anhand der URL (wie im Beispiel gezeigt) vornahmen, gleicht die DeveloperSignup-Operation das Abonnement mit dem zugeordneten Kunden ab. Auf diese Weise authentifiziert sich der Integrator beim Aufrufen des Cloud-Triggers, der in der Automation des Kunden ausgeführt wird.

    Die verbundenen Abonnements werden außerdem im Cloud-basierten Control Center angezeigt. Prüfen Sie unter Anwendungen > Cloud-Integrationen, ob der externe Integrator sein Abonnement verbunden hat. Die Cloud-Integration sollte den Status Entwickler [Name, E-Mail-Adresse] abonniert haben.

Aufrufen Ihres Cloud-Triggers (NiceLabel Cloud Implementierung)

Mit diesem Schritt stellen Sie sicher, dass die Ausgaben der externen Geschäftssysteme lokal gehostete Cloud-Trigger erfolgreich ausführen. Dies ist der Zweck der CloudTriggerOperation. Geben Sie in der URL für den Aufruf den Namen des Triggers an, den Sie aufrufen.

Um einen Trigger mit der eindeutigen Kennung MyCloudTrigger aufzurufen, verwenden Sie die folgende URL:

https://labelcloudapi.onnicelabel.com/TriggerApi/CloudTrigger/MyCloudTrigger

Rufen Sie die URL für jedes Ereignis (Ausgabe) im externen Geschäftssystem wie im Beispiel gezeigt auf. Jeder Aufruf führt den Cloud-Trigger aus, der auf dem lokalen Automation Server gehostet wird.

Alle API-Aufrufe müssen die beiden folgenden Header enthalten:

  • Api-Version ist die Version der API, die Sie verwenden. Aktuell ist v1 die einzig verfügbare API-Version.

  • Ocp-Apim-Subscription-Key ist der Schlüssel, der Ihr Abonnement identifiziert.

CloudTrigger-Aufrufe testen

Um sich mit der Funktion von CloudTrigger-Aufrufen vertraut zu machen, können Sie solche Aufrufe im Entwicklerportal testen.

Bevor Sie diesen Aufruf testen, müssen Sie eine funktionierende Automation Konfiguration einrichten.

  1. Öffnen Sie das Entwicklerportal, öffnen Sie die Products-Registerkarte und klicken Sie auf Label Cloud.

  2. Wählen Sie Cloud Trigger API v1.

  3. Erstellen Sie ein Beispiel für GET- oder POST-Methoden. Klicken Sie auf den entsprechenden Link.

    • Klicken Sie nach Auswahl der Methode auf Try it. Eine neue Seite wird geöffnet. Die triggerID wird bereits unter den Query parameters aufgeführt.

    • Geben Sie im Value-Feld per Kopieren und Einfügen die triggerID ein, die Sie vom Entwickler der Automation-Konfiguration erhalten haben. Dies ist die Eindeutige Kennung des Triggers. Die Eindeutige Kennung steht unter Automation Builder > Triggereinstellungen > Allgemein zur Verfügung.

      UUID-b2a4eb67-50bc-91d5-4b8c-709a50ee1587.png

  4. Wählen Sie unter Authorization den Abonnementschlüssel aus. Da Sie bereits mindestens ein Abonnement definiert haben, enthält die Dropdown-Liste bereits den Schlüssel für das definierte Abonnement. Wählen Sie diesen (primären oder sekundären) Schlüssel aus.

  5. Klicken Sie auf Send.

    • Der Antwortstatus (Response status) lautet „200 OK“.

Schnelle Überprüfung Ihres Cloud-Triggers

Wenn Sie Ihre NiceLabel Cloud-API im Entwicklerportal eingerichtet haben, können Sie eine einfache Konfiguration in Automation Builder vornehmen, um zu testen, ob der Cloud-Trigger funktioniert. Ist dies der Fall, erhalten Sie die Meldung „Trigger works ok.“ auf der Seite „Cloud Trigger API“, nachdem Sie auf Try it geklickt haben.

  1. Öffnen Sie den Automation Builder erstellen Sie eine neue Konfiguration. Stellen Sie sicher, dass Ihr Automation Manager mit der NiceLabel Cloud verbunden ist.

  2. Fügen Sie einen neuen Cloud-Trigger hinzu.

  3. Legen Sie den Namen und die Beschreibung sowie die Eindeutige Kennung fest. In diesem Fall verwenden wir TestCloudTrigger als eindeutige Kennung.

  4. Aktivieren Sie Warten, bis Trigger-Ausführung abgeschlossen ist. So können Sie Trigger-Antworten zurückverfolgen.

    • Wählen Sie text/plain als Antworttyp.

    • Definieren Sie die Antwortdaten. Dies sind die Daten, die Sie empfangen werden, wenn der Trigger funktioniert. Wir verwenden für dieses Beispiel die folgende Zeichenfolge: „Trigger works ok."

    • Definieren Sie die Zusätzlichen Header. Verwenden Sie das Heading:Value-Format.

  5. Implementieren Sie die Konfiguration.

  6. Öffnen Sie Ihr Entwicklerportal und gehen Sie zu Ihrer Seite Cloud Trigger API v1.

  7. Klicken Sie auf Try it.

  8. Fügen Sie TestCloudTrigger in das triggerID-Feld ein. Klicken Sie auf Send.

    • Die Antwortinhalte enthalten die Bestätigung: „Trigger works ok."

      UUID-7a2db5bb-633b-5b19-e8f2-16e863b1d8b3.png

Cloud-Trigger mit Ihrem vor Ort gehosteten Control Center implementieren

Cloud-Trigger in Automation Builder konfigurieren

Dieser Abschnitt beschreibt, wie Sie den Cloud-Trigger in Automation konfigurieren, das auf Ihrem lokalen Server ausgeführt wird.

Öffnen Sie Ihren Automation Builder. Stellen Sie sicher, dass der Automation Builder mit Ihrem Control Center verbunden ist. Wählen Sie zu diesem Zweck Datei > Optionen > Control Center und prüfen Sie, ob die URL-Adresse Ihres Control Center angegeben ist.

Anmerkung

Eine Verbindung zwischen Automation Builder und Control Center bedeutet außerdem, dass beide Anwendungen denselben Lizenzschlüssel nutzen.

Die Registerkarte Konfigurationselemente wird geöffnet. Klicken Sie auf Cloud-Trigger, um eine neue Konfiguration für den Cloud-Trigger zu erstellen.

Allgemein Tab

  1. Stellen Sie Namen und Beschreibung ein, um Ihren Cloud-Trigger unter anderen Triggern leicht finden zu können.

  2. Nehmen Sie die Kommunikation-Einstellungen für den Trigger vor:

    • Legen Sie die Eindeutige Kennung fest. Nachdem Sie den Trigger bereitgestellt haben, registriert diese eindeutige Kennung den Trigger in Ihrem Control Center. Verwenden Sie nur alphanumerische Zeichen. Sonderzeichen sind nicht erlaubt.

      Wenn Sie die Cloud-Trigger-Konfiguration auf mehreren Computern durchführen, müssen Sie sicherstellen, dass jeder Computer automatisch seine eigene eindeutige Kennung verwendet. Um unerwünschte Duplikate zu vermeiden, fügen Sie interne Variablen als Teil der Eindeutigen Kennung ein. Sie können zu diesem Zweck zwei interne Variablen verwenden:

      • ComputerName: Der Name des Computers, auf dem die Konfiguration ausgeführt wird.

      • SystemUserName: Der Windows-Benutzername des aktuell angemeldeten Benutzers.

      Um interne Variablen in die Eindeutige Kennung einzufügen, klicken Sie auf „Datenquelle einfügen“ und wählen Sie Ihre internen Variablen aus.

      UUID-7905238a-2b2d-69c4-9856-247bdcb0320c.png

    • Warten, bis Trigger-Ausführung abgeschlossen ist: Das HTTP-Protokoll wartet darauf, dass der Empfänger (in diesem Fall NiceLabel Automation) eine numerische Antwort an den Absender übermittelt, die den Status der empfangenen Nachricht anzeigt. Standardmäßig antwortet NiceLabel Automation mit dem Code 200. Dies zeigt an, dass Automation die Daten erfolgreich empfangen hat, gibt aber keine Informationen über den Erfolg von Trigger-Aktionen.

      Diese Option legt fest, dass ein Trigger nicht sofort nach Empfang der Daten eine Antwort sendet, sondern wartet, bis alle Aktionen ausgeführt wurden. Danach sendet er den Antwort-Code, um das erfolgreiche Ausführen von Aktionen zu bestätigen. Wenn diese Option aktiviert ist, können Sie eine benutzerdefinierte Antwort und die entsprechenden Daten zurücksenden (z. B. ist die Antwort auf eine HTTP-Abfrage die Etikettenvorschau im PDF-Format).

      Beim Cloud-Trigger sind die relevanten, in Automation integrierten Standard-HTTP-Antwortcodes:

      HTTP-Antwortcode

      Beschreibung

      200

      Alle Aktionen erfolgreich ausgeführt.

      400

      Keine Konfiguration verfügbar.

      500

      Beim Ausführen der Aktion sind Fehler aufgetreten.

      Anmerkung

      Um Feedback zum Druckprozess an Automation zu senden, aktivieren Sie den synchronen Druckmodus. Weitere Informationen finden Sie im Abschnitt Synchroner Druckmodus.

    • Antworttyp: Gibt den Typ Ihrer Antwortnachricht an. Häufig verwendete Internet-Medientypen (auch MIME-Typen oder Content-Typen genannt) stehen in der Dropdown-Liste zur Verfügung. Falls Ihr Medientyp nicht in der Liste enthalten ist, geben Sie ihn selbst ein. Automation sendet die ausgehenden Antwortdaten im Format des festgelegten Medientyps als Feedback. Variable aktiviert variable Medientypen. Wählen Sie bei aktivierter Option eine Variable aus (oder erstellen Sie eine Variable), die den Medientyp enthält.

      Anmerkung

      Wenn Sie keinen MIME-Typ angeben, verwendet NiceLabel Automation application/octet-stream als Standard.

    • Antwortdaten: Definiert den Inhalt Ihrer Antwortnachricht. Beispiele für Inhalte, die Sie in Form von HTTP-Antworten senden können: Benutzerdefinierte Fehlermeldungen, Etikettenvorschau, erzeugte PDF-Dateien, Druckstrom-(Spool-)Dateien, XML-Dateien mit Daten aus der Druck-Engine und der Etikettenvorschau (als Base64-Zeichenfolge codiert) usw.

      Wenn Ihre Ausgabe aus binären Inhalten besteht (z. B. Etikettenvorschau oder Druckstrom), müssen Sie einen unterstützten Medientyp auswählen, z. B. image/jpeg oder application/octet-stream.

    • Zusätzliche Header: Ermöglicht es Ihnen, benutzerdefinierte MIME-Header für die HTTP-Antwortnachricht zu definieren.

      Die Syntax für Antwortheader und Beispiele stehen im Abschnitt Aktion „HTTP-Anfrage“ zur Verfügung.

      Tipp

      Sie können bei Antwortdaten und zusätzlichen Headern festen Inhalt, eine Mischung aus festem und variablem Inhalt oder ausschließlich variablen Inhalt verwenden. Um variablen Inhalt einzufügen, klicken Sie auf die Schaltfläche mit dem Pfeil rechts neben dem Datenbereich und fügen Sie Ihre Variable aus der Liste ein. Sie können auch eine neue Variable erstellen, die die Daten enthält, sie Sie verwenden möchten. Weitere Informationen finden Sie im Abschnitt Zusammengesetzte Werte verwenden im Benutzerhandbuch.

Andere Tab

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 27. 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.

Sicherheit Tab

  • 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.

Auslöser starten

Stellen Sie den Trigger in Automation Manager bereit und starten Sie ihn. Der Cloud-Trigger prüft jetzt auf eingehende Anfragen.

Anmerkung

Wenn Ihre Konfiguration höhere Verfügbarkeit und Skalierbarkeit erfordert, können Sie mehrere identische Cloud-Trigger bereitstellen. Installieren Sie zu diesem Zweck mehrere Instanzen von Automation und stellen Sie die Cloud-Trigger auf ihnen bereit. Wenn die bereitgestellten Cloud-Trigger dieselbe Eindeutige Kennung haben, verteilt der integrierte Lastausgleich in NiceLabel Cloud die Traffic-Last gleichmäßig auf sie.

Cloud-Trigger aufrufen (Vor-Ort-Implementierung)

Mit diesem Schritt stellen Sie sicher, dass die Ausgaben der externen Geschäftssysteme lokal gehostete Cloud-Trigger erfolgreich ausführen. Dies ist der Zweck der CloudTriggerOperation. Geben Sie in der URL für den Aufruf den Namen des Triggers an, den Sie aufrufen.

Um den Trigger mit Ihrer eindeutigen Kennung MyCloudTrigger aufzurufen, verwenden Sie die folgende URL:

https://<YourServerName>/epm/api/trigger/<MyCloudTriggerID>

Anmerkung

Die URL kann mit http oder https beginnen – je nachdem, wie Sie Ihr Control Center bei der Installation eingerichtet haben. Weitere Informationen finden Sie im Abschnitt „Website und Speicher einrichten“ des Control Center Installationshandbuchs.

Rufen Sie die URL für jedes Ereignis (Ausgabe) im externen Geschäftssystem wie im Beispiel gezeigt auf. Jeder Aufruf führt den Cloud-Trigger aus, der auf dem lokalen Automation Server gehostet wird.

Alle Aufrufe müssen einen Header namens Integrator-Key enthalten.

Beispiel 28. Beispiel

Integrator-Key: 9d59d7d444da412b8acfb488a01bb632