SOAP-Anfrage (SOAP Request)

UiPath.Web.Activities.Design.SoapClientWithBodyFactory

Beschreibung

Ermöglicht das Ausführen von HTTP-Anfragen an eine angegebene Web-API unter Verwendung von SOAP. Wenn Sie diese Aktivität zuerst in das Panel Designer (Designer) ziehen, wird das Fenster SOAP-Anfrageassistent (SOAP Request Wizard) angezeigt, in dem Sie Anfragen einfacher erstellen und Server-Antworten in der Vorschau anzeigen können. Wenn Sie den Assistenten schließen, kann er nicht wieder geöffnet werden.

Alle in diesem Fenster vorhandenen Felder sind auch im Panel „Eigenschaften“ verfügbar. Daher können Sie Ihre Einstellungen auch nach dem Schließen des Assistenten bearbeiten.

Projektkompatibilität

Windows – Legacy

Hinweis:

SOAP-Anforderungen werden nur von Windows-Legacy-Projekten unterstützt. Wenn Sie SOAP-Anforderungen in Windows- oder plattformübergreifenden Projekten ausführen müssen, versuchen Sie es stattdessen mit diesen Lösungen:

• Verwenden Sie Windows Legacy für Ihren gesamten Prozess.
• Verwenden Sie einen Windows-Legacy-Prozess nur für den SOAP-Anforderungsteil und rufen Sie ihn von einem Windows-Prozess über Eingabe-/Ausgabeargumente auf
• Verwenden Sie die Aktivität „Invoke Code“.
• Verwenden Sie codierte Workflows (verfügbar ab Studio 2023.10).
• Verwenden Sie die Aktivität „HTTP Request“, um eine eigene Anforderung zu erstellen, die der SOAP-Definition entspricht. Stellen Sie sicher, dass Sie die richtigen Header verwenden und die richtige XML in Ihren Anforderungstext aufnehmen.

Der SOAP-Anfrageassistent (SOAP Request Wizard)

• Service Description - The WSDL schema location.
• Drei-Punkte-Menü – Ermöglicht die Suche nach einer .wsdl-Datei auf Ihrer Festplatte. .
• Get – Ruft Informationen aus der bereitgestellten .wsdl-Datei ab und zeigt die verfügbaren Parameter in der Tabelle an.
• Vertrag (Contract) - Der Name des Vertrags, der die verwendete Methode des SOAP-Services beschreibt.
• Methode – Eine Liste aller unterstützten Methoden. Bei Änderung der Methode ändern sich auch die in der Tabelle angezeigten Parameter.

Parametertabelle (Parameters Table)

• Name (Name) - Der Name aller unterstützten Parameter.
• Typ (Type) - Der Typ jedes unterstützten Parameters. In einigen Fällen zeigt das Herüberfahren über den Typ (Type) weitere Informationen an, beispielsweise, ob der Parameter optional ist.
• Wert (Value) - Ermöglicht das Hinzufügen eines Wertes für jeden Parameter, damit Sie Ihre gewünschte Anfrage ausführen können.
• Authentifizierung – Eine Drop-Down-Liste, die Ihnen die Auswahl des Authentifizierungstyps des Webservices ermöglicht. Folgende Optionen sind verfügbar:
  • Keine (None) - Die Standardoption. Zeigt an, dass der Webservice keine Autorisierung verwendet.
  • Einfach (Simple) - Zeigt an, dass der Service einfache Authentifizierung verwendet. Bei Auswahl dieser Methode werden die Felder Benutzername (Username) und Passwort (Password) angezeigt, in denen Sie Ihre Anmeldedaten eingeben können.
  • Windows (Windows) - Zeigt an, dass der Service die Windows-Authentifizierung verwendet.
  • Client-Zertifikat (Client Certificate) - Zeigt an, dass der Service Client-Zertifikate zur Autorisierung verwendet. Bei Auswahl wird das Feld Client-Zertifikat (Client Certificate) angezeigt, mit dem Sie Ihr lokales Laufwerk nach Ihrem Zertifikat durchsuchen können.
• Aufrufen (Invoke) - Ermöglicht das Ausführen einer Anfrage mit den angegebenen Optionen.
• Antwort (Response) - Zeigt eine Antwortvorschau des Webservers an.

Eigenschaften

Client-Zertifikatsauthentifizierung (Client Certificate Authentication)

• Client-Zertifikat (Client Certificate) - Zeigt an, dass der Service Client-Zertifikate zur Autorisierung verwendet und lässt Sie Ihr lokales Laufwerk nach Ihrem Zertifikat durchsuchen.
• ClientCertificatePassword - The password for the client certificate. This field supports String variables.
• SecureClientCertificatePassword - The password for the client certificate, in the form of a Secure String variable.

Allgemein

• BeiFehlerFortsetzen – Gibt an, ob die Automatisierung auch dann fortgesetzt werden soll, wenn die Aktivität einen Fehler ausgibt. Dieses Feld unterstützt nur boolesche Werte (True, False). Der Standardwert ist False. Wenn das Feld leer ist und ein Fehler ausgegeben wird, wird die Ausführung des Projekts angehalten. Wenn der Wert auf True gesetzt ist, wird die Ausführung des Projekts ungeachtet eines Fehlers fortgesetzt.
  Hinweis:

  Wenn die Aktivität in Abfangen versuchen (Try Catch) enthalten ist und der Wert der Eigenschaft BeiFehlerFortfahren (ContinueOnError) auf Wahr (True) gesetzt ist, wird kein Fehler bei der Ausführung des Projekts abgefangen.

• AnzeigeName (DisplayName) - Der Anzeigename der Aktivität.

Eingabe

• Vertragsname (Contract Name) - Der Name des Vertrags, der die verwendete Methode des SOAP-Services beschreibt. Das Feld unterstützt nur Zeichenfolgen und Zeichenfolgenvariablen.
• EndPunkt (EndPoint) - Der Speicherort des WSDL-Schemas. Standardmäßig wird die URL http://www.webservicex.com/globalweather.asmx?wsdlfür Testzwecke bereitgestellt. Diese Eigenschaft unterstützt Zeichenfolgen und Zeichenfolgenvariablen und entspricht dem Feld Servicebeschreibung (Service Description) im Fenster SOAP-Anfrageassistent (SOAP Request Wizard).
• Methode (Method) - Der aufgerufene Methodenname des Kunden.
• Parameter – Die Parameter für die angegebene Methode. Klicken Sie auf die Schaltfläche Ellipsenschaltfläche, um das Fenster Parameter anzuzeigen. In diesem Fenster können Sie die gewünschten Parameter hinzufügen.

Sonstiges

• Privat (Private) - Bei Auswahl werden die Werte von Variablen und Argumenten nicht mehr auf der Stufe Verbose protokolliert.

Ausgabe

• Headers - The response received from the SOAP request.
• Result - The web server's response, as a String variable.

Einfache Authentifizierung (Simple Authentification)

• Benutzername (Username) - Zeigt an, dass der Webservice eine einfache Authentifizierung verwendet und ermöglicht Ihnen die Eingabe Ihres Benutzernamens. Die Eingabe eines Passworts ist auch erforderlich. Diese Eigenschaft unterstützt Zeichenfolgen und Zeichenfolgenvariablen.
• Password - Indicates that the web service uses simple authentication and enables you to input your password. Adding a username is also required. This property supports Strings and String variables.
• SecurePassword - Indicates that the web service uses secure authentication and enables you to input your secure string password. Adding a username is also required. This property supports Secure String variables.

Windows-Authentifizierung (Windows Authentication)

• WindowsAnmeldedatenVerwenden (UseWindowsCredentials) - Bei Auswahl zeigt dieses Auswahlfeld an, dass für den angegebenen Webservice die Windows-Anmeldedaten verwendet werden sollten.