HTTP-Anfrage

Diese Aktion sendet anhand der ausgewählten HTTP-Methode Daten an den Ziel-Webserver. Die Schemata HTTP und HTTPS sind erlaubt.

HTTP fungiert als Anfrage-Antwort-Protokoll im Client-Server-Modell. In dieser Aktion fungiert als Client, der mit einem Remote-Server kommuniziert. Die Aktion übermittelt eine ausgewählte HTTP-Anfragenachricht an einen Server. Der Server gibt daraufhin eine Antwortnachricht aus, deren Textkörper Statusinformationen zur Ausführung der Anfrage sowie angeforderte Inhalte enthalten kann.

Die Über-Gruppe gibt die ausgewählte Aktion an.

• Name: ermöglicht es Ihnen, einen benutzerdefinierten Namen anzugeben. So können Sie Aktionen in der Liste der Aktionen in der Lösung leichter erkennen. Standardmäßig werden Aktionsnamen vom Typ der jeweiligen Aktion abgeleitet.
• Beschreibung: benutzerdefinierte Informationen über die Aktion. Geben Sie eine Beschreibung ein, um den Zweck und die Rolle einer Aktion in einer Lösung zu erklären.
• Aktionstyp: Nur-Lesen-Informationen über den ausgewählten Aktionstyp.

Die Gruppe Verbindungseinstellungen legt Verbindungsparameter fest.

• Ziel: Adresse, Port und Ziel (Pfad) auf dem Webserver.

  Hinweis

  Wenn ein Webserver am Standardport 80 ausgeführt wird, können Sie die Portnummer auslassen. Sie sollten die Verbindungsparameter fest codieren und einen festen Hostnamen oder eine feste IP-Adresse verwenden. Verwenden Sie einen Variablenwert, um diese Option dynamisch festzulegen. Weitere Informationen finden Sie im Abschnitt „Zusammengesetzte Werte verwenden“ im Loftware Automation Benutzerhandbuch.

  Beispiel

  Wenn die Variable hostname den Namen des Webservers und die Variable port die Portnummer bereitstellt, können Sie Folgendes für das Ziel eingeben: [hostname]:[port]

• Anfragemethode: verfügbare Anfragemethoden.

• Zeitüberschreitung: Zeitüberschreitungsdauer (in ms), innerhalb derer die Serververbindung hergestellt und eine Antwort empfangen werden sollte.

• Statusantwort in einer Variable speichern: Variable, die den vom Server empfangenen Statuscode speichert.

  Tipp

  Statuscodes im Bereich 2XX geben an, dass der Vorgang erfolgreich war. Die normale OK-Antwort ist Code 200. Die Codes im Bereich „5XX“ zeigen Serverfehler an.

• Datenantwort in einer Variable speichern: Variable, die die vom Server empfangenen Daten speichert.

Die Gruppe Authentifizierung ermöglicht es Ihnen, die Verbindung zum Webserver zu sichern.

• Grundlegende Authentifizierung aktivieren: ermöglicht es Ihnen, die erforderlichen Zugangsdaten zur Verbindung mit dem Webserver einzugeben. Benutzername und Passwort können entweder fest codiert sein oder anhand einer Variablen angegeben werden.

Die grundlegende HTTP-Authentifizierung (BA) nutzt statische Standard-HTTP-Header. Der BA-Mechanismus bietet keinen Datenschutz für die übermittelten Zugangsdaten. Sie werden bei der Übertragung lediglich mit Base64 codiert, aber nicht verschlüsselt. Die grundlegende Authentifizierung sollte bei Übertragungen per HTTPS genutzt werden.

• Passwort anzeigen: blendet das Passwort ein.

Die Gruppe Inhalt legt die an den Webserver zu sendenden Inhalte fest.

• Daten: Inhalt, der gesendet werden soll. Sie können festen Inhalt, eine Mischung aus festem und variablem Inhalt oder ausschließlich variablen Inhalt verwenden. Um variablen Inhalt einzugeben, klicken Sie auf die Schaltfläche mit dem Pfeil rechts neben dem Datenbereich und fügen Sie die Variable aus der Liste ein. Weitere Informationen finden Sie im Abschnitt „Werte in einem Objekt kombinieren“ des Loftware Benutzerhandbuchs.

• Codieren: Codierungstyp für die gesendeten Daten.

  Tipp

  Auto legt die Codierung automatisch fest. Wählen Sie, falls nötig, den bevorzugten Codierungstyp aus der Dropdown-Liste aus.

• Typ: Content-Type-Eigenschaft der HTTP-Nachricht. Wird keine Auswahl getroffen, wird der Standard application/x-www-form-urlencoded verwendet. Wenn der entsprechende Typ nicht aufgeführt ist, legen Sie einen benutzerdefinierten Typ fest oder stellen Sie eine Variable ein, die den Typ dynamisch definiert.

Zusätzliche HTTP-Header werden von bestimmten HTTP-Servern angefordert (insbesondere für REST-Dienste).

• Zusätzliche Header: fest codierte Header oder Header, die aus Variablenwerten bezogen werden. Um auf die Variablen zuzugreifen, klicken Sie auf die kleine Pfeil-Schaltfläche rechts neben dem Textbereich. Weitere Informationen finden Sie im Abschnitt Werte in einem Objekt kombinieren des Loftware Benutzerhandbuchs.

  Bestimmte HTTP-Server erfordern (insbesondere für REST-Dienste) die Aufnahme benutzerdefinierter HTTP-Header in die Nachricht. In diesem Abschnitt erfahren Sie, wie Sie die erforderlichen HTTP-Header angeben können.

  Die HTTP-Header müssen anhand der folgenden Syntax eingegeben werden:

  Header-Feldname: Header-Feldwert

  Um beispielsweise die Header-Feldnamen Accept, User-Agent und Content-Type zu nutzen, könnten Sie folgende Syntax verwenden:

  Accept: application/json; charset=utf-8
  User-Agent: Mozilla/5.0 (Windows NT 6.3; WOW64) AppleWebKit/537.36 (KHTML,
  like Gecko) Chrome/31.0.1650.63 Safari/537.36
  Content-Type: application/json; charset=UTF-8

  Sie können die Header-Feldnamen fest codieren oder ihre Werte aus Trigger-Variablen beziehen. Verwenden Sie so viele benutzerdefinierte Header-Felder wie nötig, aber achten Sie daran, dass jedes Header-Feld in einer neuen Zeile platziert wird.

  Hinweis

  Die eingegeben HTTP-Header heben die Header auf, die bereits anderswo in den Aktionseigenschaften definiert sind, z. B. Content-Type.

Aktionsausführung und Fehlerhandhabung

Jede Aktion kann als bedingungsabhängige Aktion festgelegt werden. Bedingungsabhängige Aktionen werden nur ausgeführt, wenn die festgelegten Bedingungen erfüllt sind. Um diese Bedingungen zu definieren, klicken Sie auf Optionen für Ausführung und Fehlerhandhabung anzeigen.

Die Ausführungsoptionen sind:

• Aktiviert: gibt an, ob die Aktion aktiviert oder deaktiviert ist. Nur aktivierte Aktionen werden ausgeführt. Diese Funktion kann beim Testen einer Druckmaske verwendet werden.
• Bedingung: definiert einen einzeiligen Programmierausdruck, welcher einen booleschen Wert bereitstellen muss (wahr oder falsch). Ist das Ergebnis des Ausdrucks wahr, wird die Aktion ausgeführt. Bedingungen sorgen dafür, dass Aktionen nicht jedes Mal ausgeführt werden müssen.

Die Fehlerhandhabung-Optionen sind:

• Fehler ignorieren : gibt an, ob ein Fehler ignoriert werden soll. Wenn aktiviert, wird die Ausführung von Aktionen selbst dann fortgesetzt, wenn die aktuelle Aktion fehlschlägt.

  Hinweis

  Geschachtelte Aktionen, die von der aktuellen Aktion abhängig sind, werden im Fall eines Fehlers nicht ausgeführt. Die Aktionsausführung wird bei der nächsten Aktion fortgesetzt, die sich auf derselben Ebene wie die aktuelle Aktion befindet. Der Fehler wird protokolliert, führt aber nicht zu einer Unterbrechung der Ausführung von Aktionen.

Beispiel

Am Ende des Druckvorgangs möchten Sie eventuell mittels der Aktion HTTP-Anfrage einen Statusbericht an eine externe Anwendung senden. Wenn die Druckaktion fehlschlägt, wird die Aktionsverarbeitung angehalten. Um die Berichterstellung trotz fehlgeschlagener Druckaktion auszuführen, muss für die Aktion Etikett drucken die Option Fehler ignorieren aktiviert sein.

• Fehler in Variable speichern : ermöglicht Ihnen, eine Variable auszuwählen oder zu erstellen, in der der Fehler gespeichert werden soll. Dieselbe Fehlerbeschreibung wird zudem in den internen Variablen ActionLastErrorId und ActionLastErrorDesc gespeichert.