Webdienstanfrage senden

Webdienstanforderung

• URL: Geben Sie die URL des Webservers ein, an den Sie die Anforderung senden möchten. Alternativ können Sie eine Variable hinzufügen, um die URL anzugeben.

• Verfahren: Wählen Sie für die Webanforderung die Methode aus, die Sie verwenden möchten. Mögliche Optionen sind POST, GET, PUT, DELETE oder HEAD.

• Inhalte-Typ: Wählt den Inhaltstyp aus, der für die Webanforderung verwendet werden soll. Verfügbar, wenn Sie die Methode POST oder PUT auswählen.

• HTTP-Header: Geben Sie die Header-Eigenschaften und -Werte ein, die mit der Webanforderung gesendet werden sollen. Sie können aus einem Verzeichnis mit Header-Eigenschaften und -Werte auswählen oder eine Variable hinzufügen, um die Header-Eigenschaft oder den Wert anzugeben. Sie können dem von Ihnen eingegebenen Wert auch ein Sonderzeichen hinzufügen.

Quelle

• Inhaltsdaten: Gibt die Inhaltsdaten an, die Sie mit den Methoden POST oder PUT einer Webanforderung senden möchten. Verfügbar, wenn Sie POST oder PUT für die Eigenschaft Verfahren auswählen.

• Abfragezeichenkette: Gibt die Abfragezeichenkette an, die mit den Methoden GET, DELETE oder HEAD einer Webanforderung gesendet werden sollen. Verfügbar, wenn Sie GET, DELETE oder HEAD für die Eigenschaft Verfahren auswählen.

  • Eingebettete Vorlage:

    • Wert: Geben Sie die Vorlage, die die Aktion verwenden soll, in das Eingabefeld ein. Alternativ können Sie eine Variable hinzufügen, um die Vorlage anzugeben, oder ein Sonderzeichen zum eingegebenen Wert hinzufügen.

    • Importieren: Ruft das Dialogfeld Datei öffnen auf, in dem Sie eine Datei suchen und auswählen können, die das Skript enthält, das Sie der Variable zuweisen möchten. Der Inhalt der Datei wird in das Eingabefeld Wert importiert.

    • Exportieren: Öffnet das Dialogfeld Datei speichern, in dem Sie den Inhalt des Eingabefelds Wert als externe Datei speichern können. Sie können den Wert als neue Datei speichern oder den Inhalt einer vorhandenen Datei ersetzen.

    • Eingebetteten Wert bearbeiten : Öffnet das Dialogfeld Wert für, in dem Sie den Wert der eingebetteten Quelle bearbeiten können.

  • Variable:

    • Variable: Geben Sie die Variable ein, die Sie für die Quelle verwenden möchten. Alternativ können Sie auch auf eine kürzlich verwendete Variable oder auf Weitere Variablen klicken, um das Dialogfeld Variable einfügen zu öffnen.

  • Externe Datei:

    • Speicherort: Gibt das Dateisystem oder den Speicherort an, in dem der Quellordner vorliegt. Die Dateisysteme oder Speicherorte können einen temporären Speicherordner, lokale Dateisysteme oder Netzwerkfreigaben, Librarian oder einen unterstützten Cloud-Speicherort umfassen. Weitere Informationen über unterstützte Cloud-Speicherorte finden sie auf der Administration Console Seite „Cloud-Speicher“.

    • Dateiname: Legt den Dateipfad fest. Sie können den Speicherort des Ordners eingeben oder auf Durchsuchen klicken, um zur gewünschten Datei zu navigieren und diese auszuwählen. (Wenn Speicherort auf Temporärer Speicher eingestellt ist, ist die Option Durchsuchen nicht verfügbar). Alternativ können Sie eine Variable hinzufügen, um die Datei anzugeben, oder ein Sonderzeichen zum eingegebenen Wert hinzufügen.

    • Letzte veröffentlichte Version: Gibt an, dass die Aktion die zuletzt veröffentlichte Version der angegebenen Librarian-Datei verwendet. Diese Option wird nur wirksam, wenn die Librarian-Datei einem Workflow zugewiesen ist. Verfügbar, wenn Speicherort auf Librarian gesetzt ist.

    • Dateicodierung: Legt das Codierungsschema fest, das von der Quelldatei verwendet wird.

  • HTTP-Anforderungsvariable:

    • Variablenname: Gibt den Variablennamen der Anforderungsvariablen an, die als Quelle gesendet werden soll.

    • Wert: Gibt den Wert der Anforderungsvariablen an.

Authentifizierung

• Verfahren: Legt die Authentifizierungsmethode fest, die die Aktion verwendet, um eine Verbindung zum Client aufzubauen.

  • Anonym: Gibt an, dass die Benutzer auf den Client zugreifen können, ohne einen Benutzernamen und ein Kennwort anzugeben.

  • Aktuelle Windows-Anmeldeinformationen verwenden: Gibt an, dass das aktuelle Windows-Benutzerkonto genutzt wird, um eine Verbindung zum Client herzustellen.

  • Vorgegebene Anmeldeinformationen verwenden: Gibt an, dass der Benutzername, die Domäne und das Kennwort, die Sie angeben, für die Verbindungsaufnahme mit dem Client verwendet werden.

Antwort

• Codes für Erfolgsstatus: Gibt die Statuscodes an, die Sie für erfolgreich halten.

• Antwort in Variable speichern: Legt die Variable fest, in die der die Webdienstantwort gespeichert werden soll. Geben Sie die gewünschte Variable in das Eingabefeld ein. Alternativ können Sie eine Variable hinzufügen.

Erweiterte Optionen

• Quelleninhalt in SOAP Body-Tag einfügen: Gibt an, dass der Quelleninhalt vor dem Senden in ein SOAP Body-Tag eingefügt wird. Verfügbar, wenn Sie POST oder PUT für die Eigenschaft Verfahren auswählen.

• Zeitüberschreitung beim Senden: Die Wartezeit für eine Antwort vom Client in Sekunden, bevor die Aktion fehlschlägt.

• Zählung erneut versuchen: Gibt die Häufigkeit an, mit der die Anforderung erneut gesendet wird, wenn die Aktion fehlschlägt.

Aktion

• Name: Gibt den Namen der Aktion an. Sie können den Standardnamen ersetzen, indem Sie einen neuen Namen in das Feld eintragen.

• Beschreibung: Gibt eine Beschreibung für die Aktion an.

• Aktion ausführen: Legt fest, wie oft Sie die Aktion ausführen möchten.

  • Immer: Gibt an, dass die Aktion jedes Mal ausgeführt wird, wenn das Ereignis eintritt.

  • Nie: Gibt an, dass die Aktion nicht ausgeführt wird, wenn das Ereignis eintritt.

  • Bedingt, auf Variable basierend: Legt fest, dass die Aktion nur dann ausführt wird, wenn eine ausgewählte Variable eine bestimmte Bedingung erfüllt. Nutzen Sie diese Option in Situationen, in denen nur eine Bedingung vorhanden ist, die bestimmt, ob die Aktion durchgeführt wird. Nachdem Sie diese Option ausgewählt haben, können Sie die bedingte Anweisung im Eingabefeld erstellen.

    Steuerelemente im Eingabefeld

    • Variable: Gibt die Variable an, die für die bedingte Anweisung verwendet werden soll. Geben Sie die Variable in das Eingabefeld ein. Klicken Sie , um eine Liste der zuletzt verwendeten Variablen anzuzeigen, oder klicken Sie auf Weitere Variablen, um das Dialogfeld Variable einfügen zu öffnen.

    • [Relationale Operatoren]: Gibt den relationalen Operator zur Verwendung für die bedingte Anweisung an. Klicken Sie auf den bestehenden Operator, um eine Liste zusätzlicher Operatoren zu öffnen, und wählen Sie den gewünschten aus. Weitere Informationen finden Sie unter Relationale Operatoren. Welche Operatoren in der Liste verfügbar sind, hängt davon ab, ob Sie für die Option Typ den Eintrag Text oder Dezimal auswählen.

    • Wert: Gibt den oder die Werte zur Verwendung für die bedingte Anweisung an. Um einen Wert hinzuzufügen, klicken Sie auf und auf <Wert eingeben>. Geben Sie den gewünschten Wert ein und drücken Sie dann Enter. Um einen Wert zu löschen, klicken Sie mit der sekundären Maustaste darauf und klicken Sie dann auf Löschen. Bei manchen Operatoren wie Is blank (ist leer) und Is not blank (ist nicht leer) muss kein Wert angegeben werden. In diesen Fällen ist das Feld Wert nicht verfügbar.

    • Typ: Legt fest, ob die bedingte Anweisung einen Text oder einen Dezimalwert auswertet.

  • Bedingt, auf Ausdruck basierend: Gibt die Bedingungen an, unter denen die Aktion ausgeführt wird. Nutzen Sie diese Option in Situationen, wo mehrere bedingte Anweisungen benötigt werden. Wenn Sie diese Option wählen, können Sie den bedingten Ausdruck im Eingabefeld erstellen, indem Sie die gewünschten bedingten Anweisungen eingeben. Ein bedingter Ausdruck wird auf der Registerkarte Strukturansicht erstellt und bearbeitet. Klicken Sie auf die Registerkarte Textansicht, um eine schreibgeschützte Textansicht des bedingten Ausdrucks aufzurufen.

    Steuerelemente im Eingabefeld (Registerkarte „Strukturansicht“)

    • [Bedingter Verbinder]: Gibt den bedingten Verbinder für die bedingten Anweisungen innerhalb der Gruppe an. Der bedingte Verbinder Und ist voreingestellt.

      Klicken Sie auf den bestehenden bedingten Verbinder, um ein Menü aufzurufen, in dem Sie Ihren bedingten Ausdruck mit einem der folgenden Verfahren konfigurieren können:

      • Und, Oder, NichtUnd, NichtOder: Klicken Sie auf den bedingten Verbinder in der Liste, den Sie für die bedingten Anweisungen verwenden möchten. Weitere Informationen über die unterstützten bedingten Verbinder finden Sie unter Bedingte Verbinder.

      • Bedingung hinzufügen: Klicken Sie hierauf, um eine weitere bedingte Anweisung zur aktuellen Gruppe hinzuzufügen.

      • Gruppe hinzufügen: Klicken Sie hierauf, um eine Untergruppe mit bedingten Anweisungen zur aktuellen Gruppe hinzuzufügen.

      • Gruppe entfernen: Klicken Sie hier, um die Untergruppe zu löschen. Verfügbar, wenn Sie das Menü aus einer Untergruppe heraus öffnen.

      • Alles entfernen: Klicken Sie hierauf, um alle bedingten Anweisungen (einschließlich der Untergruppen) zu löschen. Verfügbar, wenn Sie das Menü von der obersten Gruppe aus öffnen.

    • : Fügt zu der Gruppe, die dem jeweiligen Verbinder zugeordnet ist, eine bedingte Anweisung hinzu. Dieses Symbol wird rechts von den einzelnen bedingten Verbindern in Ihrem Ausdruck angezeigt.

    • :  Löscht die bedingte Anweisung. Dieses Symbol wird rechts von einer bestehenden bedingten Anweisung angezeigt, wenn Sie auf die Anweisung zeigen.

    • Variable: Gibt die Variable an, die für die bedingte Anweisung verwendet werden soll. Geben Sie die Variable in das Eingabefeld ein. Klicken Sie , um eine Liste der zuletzt verwendeten Variablen anzuzeigen, oder klicken Sie auf Weitere Variablen, um das Dialogfeld Variable einfügen zu öffnen.

    • [Relationale Operatoren]: Gibt den relationalen Operator zur Verwendung für die bedingte Anweisung an. Klicken Sie auf den bestehenden Operator, um eine Liste zusätzlicher Operatoren zu öffnen, und wählen Sie den gewünschten aus. Weitere Informationen finden Sie unter Relationale Operatoren. Welche Operatoren in der Liste verfügbar sind, hängt davon ab, ob Sie für die Option Typ den Eintrag Text oder Dezimal auswählen.

    • Wert: Gibt den oder die Werte zur Verwendung für die bedingte Anweisung an. Um einen Wert hinzuzufügen, klicken Sie auf und auf <Wert eingeben>. Geben Sie den gewünschten Wert ein und drücken Sie dann Enter. Um einen Wert zu löschen, klicken Sie mit der sekundären Maustaste darauf und klicken Sie dann auf Löschen. Bei manchen Operatoren wie Is blank (ist leer) und Is not blank (ist nicht leer) muss kein Wert angegeben werden. In diesen Fällen ist das Feld Wert nicht verfügbar.

    • Typ: Legt fest, ob die bedingte Anweisung einen Text oder einen Dezimalwert auswertet.

Fehlerverarbeitung und Diagnose

• Fehler ignorieren und mit der Ausführung von Aktionen fortfahren: Gibt an, dass bei einem Fehlschlagen der Aktion die übrigen Aktionen weiter ausgeführt werden. Wenn diese Option nicht ausgewählt wurde und die Aktion fehlschlägt, hängt das resultierende Verhalten von den folgenden Faktoren ab:

  Die Aktion ist Bestandteil einer Aktion vom Typ „Gruppieren“

  • Wenn Sie Der Reihe nach für die Eigenschaft Aktionen ausführen auf der Registerkarte Ausführung der Aktion Gruppieren angegeben haben, werden keine weiteren Aktionen im Rahmen der Aktion „Gruppieren“ ausgeführt. Außerhalb dieser Aktion „Gruppieren“ sind keine Aktionen betroffen.

  • Wenn Sie Parallel für die Eigenschaft Aktionen ausführen auf der Registerkarte Ausführung der Aktion Gruppieren angegeben haben, werden die Fehler ignoriert und weitere Aktionen werden im Rahmen der Aktion „Gruppieren“ ausgeführt. Außerhalb dieser Aktion „Gruppieren“ sind keine Aktionen betroffen.

  Die Aktion ist nicht Bestandteil einer Aktion vom Typ „Gruppieren“

  • Wenn Sie Der Reihe nach für die Eigenschaft Aktionen ausführen auf der Registerkarte Ausführung des Ereignisses angegeben haben, werden keine weiteren Aktionen im Rahmen dieses Ereignisses ausgeführt.

  • Wenn Sie Parallel für die Eigenschaft Aktionen ausführen auf der Registerkarte Ausführen des Ereignisses angegeben haben, werden die Fehler ignoriert und weitere Aktionen werden im Rahmen des Ereignisses ausgeführt.

• Bei Fehlschlag erneut versuchen: Gibt an, dass BarTender versucht, die Aktion erneut auszuführen, wenn diese fehlschlägt.

  • Maximale erneute Versuche: Legt die maximale Anzahl der Versuche durch BarTender fest, die Aktion erneut auszuführen. Verfügbar, wenn die Option Bei Fehlschlag erneut versuchen ausgewählt wurde.

  • Intervall für erneute Versuche: Legt die Zeit fest, wie lange BarTender warten wird, nachdem die Aktion fehlgeschlagen ist, bevor es versuchen wird, die Aktion erneut auszuführen. Verfügbar, wenn die Option Bei Fehlschlag erneut versuchen ausgewählt wurde.