HTTP-Anfrage (HTTP Request)

UiPath.Web.Activities.Http.NetHttpClient

Wichtig: Diese Aktivität ist in WebAPI-Paketversionen ab 2.0.0-preview und 2.3.0 verfügbar Ga. Verwenden Sie für die Legacy-Erfahrung die vorherige Aktivität HTTP Request (legacy), die in WebAPI-Versionen vor 2.0.0-preview enthalten ist.

Beschreibung

Verwenden Sie die Aktivität HTTP Request in der Vorschau von WebAPI 2.0.0, um das Stellen von Anfragen an Webserver oder APIs zu automatisieren und zu vereinfachen. Mit der Aktivität HTTP Request können Sie:

• Senden und empfangen Sie Daten sicher zwischen Systemen.
• Laden Sie Dateien und Daten mithilfe von Formularen hoch.
• Behandeln Sie Fehler ordnungsgemäß, indem Sie Anforderungen wiederholen, wenn etwas schief läuft.
• Stellen Sie eine sichere Verbindung mit SSL her, um Daten zu schützen.
• Verwalten Sie Cookies und Proxys automatisch, um Sitzungs- und Netzwerkbeschränkungen zu verarbeiten.

Projektkompatibilität

Windows | Plattformübergreifend

Windows, plattformübergreifende Konfiguration

Texteigenschaften der Aktivität
Anforderungsmethode *	Wählen Sie aus, wie Ihre HTTP-Anforderung mit dem Server interagieren soll: GET– Ruft Daten ab, ohne sie zu ändern. POST– Sendet Daten an den Server, normalerweise um eine Ressource zu erstellen oder zu aktualisieren. PUT– Aktualisiert eine vorhandene Ressource. DELETE– Entfernt eine angegebene Ressource vom Server. HEAD– Ähnlich wie GET, ruft aber nur Header ohne den Textinhalt ab. OPTIONS– Gibt Informationen zu den auf dem Server verfügbaren Kommunikationsoptionen an. PATCH– Aktualisiert teilweise eine vorhandene Ressource. TRACE– Wird zu Diagnosezwecken verwendet und sendet die empfangene Anforderung an den Client zurück.
Anforderungs-URL *	Geben Sie die Webadresse des Servers an, an den Sie Ihre Anforderung senden möchten. Beispiel: https://store.example.com/search.
Parameter	Fügen Sie serverspezifische Details zu Ihrer Anforderung als Schlüssel-Wert-Paare hinzu. Beispiel: query: "laptop", sortBy: "price".
Header	Fügen Sie serverspezifische Anweisungen oder Authentifizierungsdetails als Schlüssel-Wert-Paare hinzu. Beispiel: Authorization: "Bearer <your_access_token>", Accept: "application/json".
Texttyp der Anforderung *	Wählen Sie den Inhaltstyp aus, den Sie an den Server senden möchten: Keine– Sendet keine Daten, normalerweise für Abrufmethoden. Text– Sendet Daten als Nur-Text, normalerweise für POST- und PUT-Methoden. Nach der Auswahl werden die folgenden Felder angezeigt: Textinhaltstyp– Wählen Sie das Format des Texts aus, den Sie in Ihrer HTTP-Anforderung senden möchten, damit der Server weiß, wie er zu interpretieren ist: text/Plain– Regulärer Nur-Text. text/html– HTML-formatierter Text. text/css– CSS-formatierter Text. text/csv– Strukturierte Daten, die als CSV formatiert sind. text/xml– XML-formatierter Text, der von Menschen gelesen werden kann. Anwendung/xml– XML-formatierter Text, der für die Verarbeitung von Anwendungen vorgesehen ist. application/json– JSON-formatierter Text. Text– Schreiben Sie den Text oder die Daten, die Sie in Ihrer Anforderung senden möchten. Textcodierung– Wählen Sie das Codierungsformat für die Textnutzlast aus, z. B. Unicode, ASCII oder ISO. Dadurch wird sichergestellt, dass der empfangende Server Ihre Textnutzlast genau liest. Formular URL codiert– Sendet Daten, die als einfache Schlüssel-Wert-Paare formatiert sind. Nach der Auswahl wird das folgende Feld angezeigt: URL-codierte Formulardaten– Geben Sie die Schlüssel-Wert-Paare an. Beispiel: searchQuery: "Smartphone", brand: "XYZ", inStock: "true". Mehrteilige Formulardaten– Sendet Dateien oder komplexe Daten. Verwenden Sie diese Option, wenn Sie verschiedene Datentypen in Ihrer Anforderung kombinieren müssen. Nach der Auswahl werden die folgenden Felder angezeigt: Ressourcendateien– Geben Sie den Namen der Dateien an, die in Ihrem Projekt als IResource-Objekte gespeichert sind. Lokale Dateien– Geben Sie den Pfad zu einer Datei auf Ihrem Gerät an. Beispiel: "C:/Images/product-photo.jpg". Formulardatenteile– Geben Sie eine Sammlung von FormDataPartan Objekte: TextFormDataPart – Für Zeichenfolgen-Nutzdaten, z. B. JSON oder Nur-Text. BinaryFormDataPart – Für unformatierte Byte-Arrays. FileFormDataPart –Für Dateistreams basierend auf einem bestimmten Pfad. Zum Beispiel eine FormDataPart -Auflistung mit dem Ausdrucks-Editor: #VB New List(Of FormDataPart) From { New TextFormDataPart("{""jsonKey"":""jsonValue""}", "textPart", Encoding.UTF8, "application/json"), New BinaryFormDataPart(Encoding.UTF8.GetBytes("binaryContent"), "binaryPart", "application/octet-stream"), New FileFormDataPart("C:/Work/testfile.txt", "filePart", "text/plain") } Jeder FormDataPart -Typ verfügt über mehrere Konstruktoren, sodass Sie von häufig verwendeten Standardeinstellungen profitieren können. Die Aktivität weist automatisch den richtigen Content-Type- Header für jedes FileFormDataPart zu. Sie können diesen Header manuell überschreiben. Bei Dateilisten können Sie den automatisch zugewiesenen Header nicht überschreiben. Für Ressourcendateilisten verwendet die Aktivität den verfügbaren MIME-Typ. URL-codierte Formulardaten– Geben Sie einfache Schlüssel-Wert-Paare an. Binär– Sendet Rohdaten. Nach der Auswahl wird das folgende Feld angezeigt: Binäre Nutzlast– Geben Sie die Rohdatennutzlast an, z. B. Bilder, Videos, große Dateien oder Streaming-Daten. Zum Beispiel das Senden eines Bildes in binärer Form: File.ReadAllBytes("C:/Images/product-image.jpg") Stream– Sendet kontinuierliche Daten, z. B. das Hochladen einer großen Datei (Studio oder Video), wenn die Daten nicht vollständig auf einmal in den Speicher geladen werden können. Nach der Auswahl wird das folgende Feld angezeigt: Lokale Datei– Geben Sie den großen Dateipfad an, z. B.: File.OpenRead("C:/Videos/large-video.mp4") Die Aktivität weist automatisch den richtigen Inhaltstyp- Header für die hochgeladene Datei zu. Sie können diesen Header manuell überschreiben.

Eigenschaften-Panel
cURL-Import und Entwurfszeittests Dieser Abschnitt hilft Ihnen, die Aktivität über die cURL-Code-Snippets zu konfigurieren und Entwurfszeittests der Anforderung durchzuführen.	cURL Command Text– Mehrzeiliges Textfeld zur Entwurfszeit, in das ein vollständiger cURL-Befehl eingefügt werden kann. Unterstützt sowohl `cm- als auch bash-Stile. cURL-Importschaltfläche –Aktionsschaltfläche, die sofort die Analyse/den Import des aktuellen cURL-Befehlstexts in die Aktivität auslöst (Methode, URL, Header, Text, Authentifizierung, Dateien). Testanforderungsschaltfläche –Aktionsschaltfläche, die die konfigurierte Anforderung zur Entwurfszeit ausführt. Während der Ausführung wird auf Abbrechen umgeschaltet. Nach Abschluss oder Abbruch wird auf das Feld „Test“ und „Aktualisierter Bericht“ mit formatierter Antwort oder Fehler zurückgesetzt. Bericht–Mehrzeiliger Textbereich, der zur Anzeige des Ergebnisses des letzten cURL-Imports oder der Testausführung zur Entwurfszeit verwendet wird (Erfolgszusammenfassung, Zuordnungsdetails, Warnungen oder Fehler).
Clientoptionen Dieser Abschnitt hilft Ihnen, verbindungsbezogene Einstellungen zu definieren.	SSL-Überprüfung deaktivieren– Überspringt SSL-Sicherheitsüberprüfungen. Nützlich für Tests (True), nicht für die Produktion empfohlen (False, Standard). TLS-Protokoll– Wählt das TLS-Protokoll für sichere Verbindungen aus. Verfügbare Optionen sind Automatisch (Standard), TLS 1.2 und TLS 1.3. Cookies aktivieren– Aktiviert standardmäßig die automatische Cookie-Verarbeitung (True). Legen Sie False fest, um die automatische Cookie-Verarbeitung zu deaktivieren. Clientzertifikat– Gibt den Pfad zum Clientzertifikat für die Authentifizierung mit sicheren APIs an. Beispiel: "C:/certificates/client-cert.pfx". Sicheres Clientzertifikat-Kennwort– Speichert das sichere Kennwort für das bereitgestellte Clientzertifikat. Beispiel: "certPassword". Wechseln Sie zwischen einfachen und sicheren Kennwörtern, indem Sie das Plus-Symbol und die gewünschte Option auswählen: Nur Zeichenfolge verwenden und Sichere Zeichenfolge verwenden. Proxykonfiguration– Konfiguriert benutzerdefinierte Proxys, einschließlich Unterstützung für Authentifizierungs- und Umgehungslisten. Beispiel: "http://proxy.example.com:8080".
Authentication In diesem Abschnitt können Sie definieren, wie sich die Aktivität beim Server authentifiziert.	Authentifizierung– Wählen Sie die Authentifizierungsmethode aus. Verfügbare Optionen sind: Keine Authentifizierung– Der Server benötigt keine Benutzervalidierung, um Ihre Anforderung zu akzeptieren. Standardauthentifizierung– Bietet eine Benutzervalidierung für den empfangenden Server durch Benutzername und sicheres Kennwort. Wechseln Sie zwischen einfachen und sicheren Kennwörtern, indem Sie das Plus-Symbol und die gewünschte Option auswählen: Nur Zeichenfolge verwenden und Sichere Zeichenfolge verwenden. Bearer-Token– Bietet eine Benutzervalidierung für den empfangenden Server über ein eindeutiges Bearer-Token, das nach der Anmeldung generiert wird. Aushandelte Authentifizierung– Verwenden Sie das HTTP Negotiate-Schema für die Laufzeit, um Kerberos oder NTLM (und optional Digest) basierend auf Server-Herausforderungen auszuwählen. Wenn Authentifizierung auf Aushandelte Authentifizierung und Betriebssystemanmeldeinformationen verwenden = True festgelegt ist, wird der aktuelle Benutzerkontext des Betriebssystems verwendet (Windows-Anmeldetoken; unter Linux/ macOS ein vorhandenes Kerberos-Ticket, z. B. von kinit). Legen Sie Betriebssystemanmeldeinformationen verwenden = False fest, um das Feld Benutzerdefinierte Anmeldeinformationen zu aktivieren; Geben Sie NetworkCredential (Domäne/Benutzername/Passwort oder sicheres Passwort) an.
Anforderungsoptionen Dieser Abschnitt hilft Ihnen, das Verhalten der Anforderung zu definieren.	Zusätzliche Cookies– Geben Sie zusätzliche Cookies manuell als Schlüssel-Wert-Paare an. Anforderungs-Timeout– Geben Sie die maximale Wartezeit in Millisekunden an, bevor die Anforderung abgebrochen wird. Der Standardwert ist 10.000 Millisekunden (10 Sekunden). Bei Fehler fortfahren– Legen Sie fest, ob die Automatisierung auch dann fortgesetzt werden soll, wenn die Aktivität einen Fehler ausgibt (True, Standardoption). Um die Automatisierung zu beenden, wenn ein Fehler auftritt, verwenden Sie False. Weiterleitungen folgen– Legen Sie fest, ob Ihre Anforderung automatisch den vom Server bereitgestellten URL-Umleitungen folgen soll (True, Standardoption). Um Weiterleitungen zu ignorieren und die ursprüngliche Antwort zu verwenden, verwenden Sie False. Maximale Umleitungen– Geben Sie an, wie vielen automatischen Umleitungen Sie folgen sollen, bevor sie angehalten werden. Der Standardwert ist 3.
Wiederholungsrichtlinie Dieser Abschnitt hilft Ihnen, den Wiederholungsmechanismus im Falle eines Anforderungsfehlers zu definieren.	Richtlinientyp für Wiederholungen– Geben Sie die Methode für die Wiederholung von Anforderungen an. Verfügbare Optionen sind: Keine Wiederholung– Ihre Anforderung ruft den Server nur einmal auf. Wenn sie fehlschlägt, gibt es keine weiteren Versuche. Grundlegende Wiederholung– Wiederholt die Anforderung nach Fehlern mit einer festen Verzögerung. Anzahl der Wiederholungen– Geben Sie an, wie oft wiederholt werden soll. Der Standardwert ist 3. Verzögerung– Geben Sie die feste Zeit zwischen den Wiederholungen in Millisekunden an. Der Standardwert ist 500 Millisekunden (0,5 Sekunden). Use Retry-After-Header– Entscheiden Sie, ob die Anforderung den vom Server empfohlenen Retry-After -Header verwenden soll (True, Standardoption). Um den Headerwert Retry-After zu ignorieren, verwenden Sie False. Verzögerungslimit– Geben Sie die maximal zulässige Verzögerung zwischen „Wiederholen“ und „Nach “ in Millisekunden an. Der Standardwert ist 30.000 Millisekunden (30 Sekunden). Statuscodes für Wiederholungen– Geben Sie die Statuscodes an, die Wiederholungen auslösen sollen. Exponentieller Backoff– Wiederholungsversuche mit steigenden Verzögerungen zwischen den einzelnen Versuchen. Anzahl der Wiederholungen– Geben Sie an, wie oft wiederholt werden soll. Der Standardwert ist 3. Anfängliche Verzögerung– Geben Sie die Verzögerungszeit vor der ersten Wiederholung in Millisekunden an. Der Standardwert ist 500 Millisekunden (0,5 Sekunden). Multiplikator– Geben Sie die Zahl an, die verwendet wird, um die Verzögerung nach jeder fehlgeschlagenen Anforderung zu erhöhen. Der Standardwert ist 2, wodurch die Verzögerung jedes Mal verdoppelt wird. Jeweilsbei Verzögerungen entscheiden Sie, ob Sie einen zufälligen Versatz zwischen 0 und 100 Millisekunden hinzufügen möchten, um synchronisierte Wiederholungen zu vermeiden (Standard:True). Use Retry-After-Header– Entscheiden Sie, ob die Anforderung den vom Server empfohlenen Retry-After -Header verwenden soll (True, Standardoption). Um den Headerwert Retry-After zu ignorieren, verwenden Sie False. Verzögerungslimit– Geben Sie die maximal zulässige Verzögerung zwischen „Wiederholen“ und „Nach “ in Millisekunden an. Der Standardwert ist 30.000 Millisekunden (30 Sekunden). Statuscodes für Wiederholungen– Geben Sie die Statuscodes an, die Wiederholungen auslösen sollen.
Antwortoptionen In diesem Abschnitt können Sie anpassen, wie die Antwort vom Server zurückgegeben wird.	Antwort immer als Datei speichern– Erzwingen Sie das Schreiben des Antworttexts auf den Datenträger, auch wenn ein Dateiname des Anhangs nicht abgeleitet wird. Debugging-Informationen aktivieren– Aktivieren Sie die erweiterte Debug-Erfassung (unformatierte Anforderungs-/Antwortmetadaten, Snapshots der Header, Zeitvorgabe, Wiederholungsdetails) und die Ausgabe im Antwortobjekt oder während des Testens in der Entwurfsphase. Name der Ausgabedatei– Überschreiben Sie den vom Server bereitgestellten Dateinamen (z. B. von Content-Disposition). Zielordner der Ausgabedatei—Steuert den Zielordner für die gespeicherten Antwortdateien. Wenn die Datei bereits vorhanden ist – Definieren Sie eine Konfliktstrategie, wenn eine Datei mit dem aufgelösten Namen bereits im Zielordner vorhanden ist. Optionen: Automatische Umbenennung—Fügen Sie ein inkrementelles Suffix (_1, _2, …) hinzu, um einen eindeutigen Dateinamen zu erstellen. Replace—Vorhandene Datei überschreiben. Anhalten und verwerfen— Bricht den Speichervorgang (und den Workflow, wenn die Ausnahme nicht behandelt wird) ab und lässt die vorhandene Datei intakt.
Ausgabe Dieser Abschnitt hilft Ihnen, die vom Server zurückgegebene Antwort zu erfassen und zu speichern.	Antwortinhalt– Erfasst die Antwort vom Server und speichert sie für die zukünftige Verarbeitung in einer Variablen. Es beinhaltet: StatusCode– Statuscode der HTTP-Antwort. TextContent– Antwort als Nur-Text (falls verfügbar). BinaryContent– Rohe Antwortdaten für Nicht-Textinhalte. Datei– Antwort wird als Datei (ILocalResource) in Ihrem Download-Ordner gespeichert. Der Dateiname stammt aus Antwortheadern oder wird automatisch generiert, um Überschreiben von Dateien zu vermeiden. Header– Alle HTTP-Antwortheader. ContentHeaders– Header, die sich speziell auf den Antwortinhalt beziehen. Zum Beispiel Content-Type und Content-Length. RawRequestDebuggingInfo –Optionale Zeichenfolge, die erfasste Anforderungs-/Antwortdetails auf niedriger Ebene enthält (z. B konstruierte Anforderungszeile, Header, Wiederholungen, Timing) wird nur ausgefüllt, wenn Debugging aktiviert ist; Andernfalls leere Zeichenfolge.