Webdienst

Webdienst ist eine Methode der Kommunikation zwischen zwei elektronischen Geräten oder zwischen Softwareinstanzen. Webdienst ist als Standard für den Datenaustausch definiert. Er nutzt das XML-Format zum Markieren der Daten, das SOAP-Protokoll zum Übertragen der Daten und die WSDL-Sprache zur Beschreibung der verfügbaren Dienste.

Diese Aktion verbindet sich mit einem entfernten Webdienst und wendet die Methoden auf ihm an. Methoden können als Aktionen beschrieben werden, die auf dem Webdienst veröffentlicht sind. Diese Aktion sendet eingehende Werte an die ausgewählte Methode im entfernten Webdienst, ruft das Ergebnis ab und speichert es in ausgewählten Variablen.

Nachdem Sie die WSDL importiert und eine Referenz auf den Webdienst hinzugefügt haben, werden dessen Methoden im Kombinationsfeld Methode aufgelistet.

Sie möchten Produktetiketten drucken. Ihr Trigger würde nur einen Teil der erforderlichen Daten erhalten. Zum Beispiel: Der Trigger empfängt den Wert für die Variablen Product ID und Description, aber nicht für Price. Die Preisinformationen befinden sich in einer separaten Datenbank, auf die anhand eines Webdienst-Aufrufs zugegriffen werden kann. Webdienst definiert die Funktion anhand einer WSDL-Definition. Beispielsweise ist die Funktionseingabe Product ID und die Ausgabe ist Price. Die Webdienst-Aktion sendet Product ID an den Webdienst. Sie wird ausgeführt, führt eine interne Suche in ihrer Datenbank aus und stellt den entsprechenden Price als Ergebnis bereit. Die Aktion speichert das Ergebnis in einer Variablen, die auf dem Etikett verwendet werden 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 Webdienstdefinition enthält die folgenden Einstellungen:

• WSDL: Speicherort der WSDL-Definition.

  Die WSDL wird normalerweise vom Webdienst bereitgestellt. Normalerweise geben Sie den Link zur WSDL ein und klicken auf Importieren, um die Definition zu lesen. Falls Sie Probleme beim Abrufen der WSDL von der Online-Ressource haben, speichern Sie die WSDL als Datei und geben Sie den Pfad mit dem Dateinamen an, um die Methoden zu laden. Erkennt automatisch, ob der entfernte Webdienst Dokument- oder RPC-Syntax nutzt, und entsprechend kommuniziert.

• Adresse: Adresse, unter der der Webdienst veröffentlicht ist.

  Zu Beginn wird diese Information vom WSDL abgerufen, kann aber vor Ausführung der Aktion aktualisiert werden. Dies ist hilfreich für geteilte Entwicklungs-/Test-/Produktionsumgebungen, in denen dieselbe Liste von Aktionen, aber andere Namen von Servern, die Webdienste ausführen, verwendet werden.

  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.

• Methode: Methoden (Funktionen), die für den ausgewählten Webdienst verfügbar sind. Die Liste wird von der WSDL-Definition automatisch ausgefüllt.

• Parameter: Eingabe- und Ausgabevariablen der ausgewählten Methode (Funktion).

  Eingabeparameter erwarten eine Eingabe. Zu Test- und Fehlerbehebungszwecken können Sie einen festen Wert eingeben und eine Vorschau des Ergebnisses anzeigen. Normalerweise würden Sie jedoch eine Variable für eingehende Parameter auswählen. Der Wert dieser Variablen wird als Eingabeparameter verwendet. Der ausgehende Parameter stellt die Ergebnisse der Funktion bereit. Sie müssen die Variable auswählen, die das Ergebnis speichern soll.

• Zeitüberschreitung: Zeitüberschreitung, nach der die Verbindung mit einem Server hergestellt wird.

Authentifizierung aktiviert eine einfache Benutzerauthentifizierung. Die Option gibt Benutzerdaten an, die zur Herstellung eines ausgehenden Aufrufs eines entfernten Webdienstes benötigt werden.

• Grundlegende Authentifizierung aktivieren: ermöglicht die Angabe des Benutzernamens und Passworts, die manuell eingegeben oder durch Variablenwerte definiert werden können. Wählen Sie Datenquellen, um die Variablen auszuwählen oder zu erstellen.

• Passwort anzeigen: zeigt die verdeckten Zeichen im Benutzernamen und im Passwort an.

  Details zu Sicherheitsfragen finden Sie im Abschnitt „Zugriff auf Ihre Trigger sichern“ des Loftware Automation Benutzerhandbuchs.

Das Feld Datenvorschau ermöglicht es Ihnen, den Webdienst testweise auszuführen.

• Die Schaltfläche Ausführen führt einen Webdienst-Aufruf aus.

  Sendet Werte eingehender Parameter an den Webdienst und stellt das Ergebnis im ausgehenden Parameter bereit. Verwenden Sie diese Funktion, um die Ausführung eines Webdienstes zu testen. Sie können Werte für eingehende Parameter eingeben und das Ergebnis auf dem Bildschirm anzeigen. Wenn Sie mit der Ausführung zufrieden sind, können Sie den eingegebenen Festwert für den eingehenden Parameter durch eine Variable aus der Liste ersetzen.

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.