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)

• Dienstbeschreibung – Der Speicherort des WSDL-Schemas.
• 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. Die folgenden 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 – Das Kennwort für das Clientzertifikat. Dieses Feld unterstützt String -Variablen.
• SecureClientCertificatePassword – Das Kennwort für das Clientzertifikat in Form einer Secure String -Variablen.

Allgemein

• BeiFehlerFortfahren (ContinueOnError) - Gibt an, ob die Automatisierung auch bei Auftreten eines Fehlers weiterlaufen soll. Das Feld unterstützt nur Boolesche Werte (Wahr, Falsch). Der Standardwert ist Falsch. Dadurch wird die Ausführung des Projekts beim Auftreten eines Fehlers angehalten, wenn das Feld leer. Wenn der Wert auf Wahr gesetzt ist, wird das Projekt weiter ausgeführt, auch wenn Fehler auftreten.

  Hinweis: Wenn diese Aktivität in Try Catch enthalten ist und der Wert der Eigenschaft BeiFehlerFortsetzen auf „True“ gesetzt ist, wird kein Fehler beim Ausführen des Projekts aufgefangen.
• 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?wsdl fü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

• Header – Die von der SOAP-Anforderung empfangene Antwort.
• Ergebnis (Result) - Die Antwort des Webservers als 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.
• Passwort (Password) - Zeigt an, dass der Webservice eine einfache Authentifizierung verwendet und ermöglicht Ihnen die Eingabe Ihres Passworts. Die Eingabe eines Benutzernamens ist auch erforderlich. Diese Eigenschaft unterstützt Strings und String-Variablen.
• SecurePassword – Gibt an, dass der Webdienst die sichere Authentifizierung verwendet und Ihnen die Eingabe Ihres sicheren Zeichenfolgenkennworts ermöglicht. Die Eingabe eines Benutzernamens ist auch erforderlich. Diese Eigenschaft unterstützt Secure String-Variablen.

Windows-Authentifizierung (Windows Authentication)

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