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 WebAPI 2.0.0-preview, um Anforderungen an Webserver oder APIs zu automatisieren und zu vereinfachen. Die Aktivität HTTP Request unterstützt Sie dabei:

• 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. LÖSCHEN - Entfernt eine angegebene Ressource vom Server. HEAD – Ähnlich wie GET , ruft aber nur Header ohne den Textkörper ab. OPTIONS – Enthält Informationen zu den auf dem Server verfügbaren Kommunikationsoptionen. PATCH – Aktualisiert teilweise eine vorhandene Ressource. TRUE – Wird für Diagnosezwecke verwendet, um die empfangene Anforderung an den Client zurückzusenden.
Anforderungs-URL *	Geben Sie die Webadresse des Servers an, an den Sie Ihre Anforderung senden möchten. Zum Beispiel: https://store.example.com/search .
Parameter	Fügen Sie serverspezifische Details zu Ihrer Anforderung als Schlüssel-Wert-Paare hinzu. Zum Beispiel: query: "laptop" , sortBy: "price" .
Header	Fügen Sie serverspezifische Anweisungen oder Authentifizierungsdetails als Schlüssel-Wert-Paare hinzu. Zum 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 zum Abrufen von Methoden. Text – Sendet Daten im reinen 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/real-text – 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 soll. application/xml – XML-formatierter Text, der für Anwendungen zur Verarbeitung vorgesehen ist. application/json – JSON-formatierter Text. Text – Geben Sie den tatsächlichen Text oder die Daten ein, 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. Zum 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. Zum Beispiel: "C:/Images/product-photo.jpg" . Formulardatenteile – Geben Sie eine Sammlung von FormDataPart -Objekten an: TextFormDataPart – Für Zeichenfolgennutzlast, z. B. JSON oder Nur-Text. Binärformdatenteil - Für unformatierte Byte-Arrays. FileFormDataTeil – Für Dateistreams basierend auf einem bestimmten Pfad. Zum Beispiel eine FormDataPart -Sammlung 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 Inhaltstypheader für jedes FileFormDataPart zu. Sie können diesen Header manuell überschreiben. Bei Dateilisten können Sie den automatisch zugewiesenen Header nicht überschreiben. Bei Ressourcendateilisten verwendet die Aktivität den verfügbaren MIME-Typ. URL-codierte Formulardaten – Geben Sie einfache Schlüssel-Wert-Paare an. Binärdaten - 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 Streamingdaten. Beispiel: File.ReadAllBytes("C:/Images/product-image.jpg") Stream - Sendet kontinuierliche Daten, wie z. B. das Hochladen einer großen Datei (audio oder Video), wenn die Daten nicht vollständig in den Speicher geladen werden können. Nach der Auswahl wird das folgende Feld angezeigt: Lokale Datei – Geben Sie den großen Dateipfad an. Die Aktivität weist automatisch den richtigen Inhaltstyp- Header für die hochgeladene Datei zu. Sie können diesen Header manuell überschreiben. Beispiel: File.OpenRead("C:/Videos/large-video.mp4")

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-Befehlstext – 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 (Erfolgszusammenfassung, Zuordnungsdetails, Warnungen oder Fehler) verwendet wird.
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 Verarbeitung von Cookies ( True ). Auf False festlegen, um die automatische Verarbeitung von Cookies zu deaktivieren. Clientzertifikat – Gibt den Pfad zum Clientzertifikat für die Authentifizierung bei sicheren APIs an. Zum Beispiel: "C:/certificates/client-cert.pfx" . Sicheres Clientzertifikat-Kennwort – Speichert das sichere Kennwort für das bereitgestellte Clientzertifikat. Zum Beispiel: "certPassword" . Wechseln Sie zwischen einfachen und sicheren Kennwörtern, indem Sie das Plus-Symbol und die gewünschte Option auswählen: Einfache Zeichenfolge verwenden und Sichere Zeichenfolge verwenden . Proxykonfiguration – Konfiguriert benutzerdefinierte Proxys, einschließlich Unterstützung für Authentifizierung und Umgehungslisten. Zum 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: Keine Authentifizierung – Der Server erfordert keine Benutzervalidierung, um Ihre Anforderung zu akzeptieren. Standardauthentifizierung – Bietet eine Benutzervalidierung für den empfangenden Server über einen Benutzernamen und ein sicheres Kennwort . Wechseln Sie zwischen einfachen und sicheren Kennwörtern, indem Sie das Plus-Symbol und die gewünschte Option auswählen: Einfache Zeichenfolge verwenden und Sichere Zeichenfolge verwenden . Bearer-Token - Ermöglicht dem empfangenden Server die Benutzervalidierung durch ein eindeutiges Bearer-Token, das nach der Anmeldung generiert wird. Ausgehandelte 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 manuell zusätzliche Cookies 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 fortsetzen – 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 . Umleitungen folgen – Entscheiden Sie, ob Ihre Anforderung automatisch den vom Server bereitgestellten URL-Umleitungen folgen soll ( True , Standardoption). Um Umleitungen zu ignorieren und die erste Antwort zu verwenden, verwenden Sie False . Maximale Umleitungen – Geben Sie an, wie viele automatische Umleitungen Sie anfordern sollen, bevor sie angehalten werden. Der Standardwert ist 3.
Wiederholungsrichtlinie Dieser Abschnitt hilft Ihnen, den Wiederholungsmechanismus im Falle eines Anforderungsfehlers zu definieren.	Typ der Wiederholungsrichtlinie – Geben Sie die Methode für die Wiederholung von Anforderungen an. Verfügbare Optionen: Keine Wiederholung – Ihre Anforderung ruft den Server nur einmal auf. Schlägt sie fehl, finden Sie keine weiteren Versuche. Standardwiederholung – 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). Retry-After-Header verwenden – Entscheiden Sie, ob die Anforderung den vom Server empfohlenen Retry-After- Header verwenden soll ( True , Standardoption). Um den Retry-After- Headerwert zu ignorieren, verwenden Sie False . Verzögerungslimit – Geben Sie die maximal zulässige Verzögerung zwischen Wiederholungen – 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 in Millisekunden vor der ersten Wiederholung an. Der Standardwert ist 500 Millisekunden (0,5 Sekunden). Multiplikator – Geben Sie die Zahl an, mit der die Verzögerung nach jeder fehlgeschlagenen Anforderung erhöht wird. Der Standardwert ist 2, wodurch sich die Verzögerung jedes Mal verdoppelt. Jitter verwenden – Entscheiden Sie bei Verzögerungen, ob Sie einen zufälligen Offset zwischen 0 und 100 Millisekunden hinzufügen möchten, um synchronisierte Wiederholungen zu vermeiden ( True , Standard). Retry-After-Header verwenden – Entscheiden Sie, ob die Anforderung den vom Server empfohlenen Retry-After- Header verwenden soll ( True , Standardoption). Um den Retry-After- Headerwert zu ignorieren, verwenden Sie False . Verzögerungslimit – Geben Sie die maximal zulässige Verzögerung zwischen Wiederholungen – 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, Header-Snapshot, Zeit, Wiederholungsdetails) und Ausgabe im Antwortobjekt oder während des Entwurfszeittests. Name der Ausgabedatei – Überschreiben Sie den vom Server bereitgestellten Dateinamen (z. B. von Content-Disposition). Zielordner der Ausgabedatei – Steuern Sie 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, …) an, um einen eindeutigen Dateinamen zu erstellen. Ersetzen – Überschreibt eine vorhandene Datei. 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 in einer Variablen zur weiteren Verarbeitung. Dazu gehören: StatusCode - HTTP-Antwortstatuscode. TextContent - Antwort als Nur-Text (falls verfügbar). BinärerInhalt – Rohantwortdaten für Nicht-Textinhalte. Datei – Antwort, die als Datei ( ILocalResource ) in Ihrem Download-Ordner gespeichert wurde. Der Dateiname stammt aus Antwortheadern oder wird automatisch generiert, um das Ü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 . RohRequestDebuggingInfo - Optionale Zeichenfolge, die erfasste Anfragen-/Antwortdetails auf niedriger Ebene enthält (z. B konstruierte Anforderungszeile, Header, Wiederholungen, Timing) wird nur ausgefüllt, wenn Debugging aktiviert ist; Andernfalls leere Zeichenfolge.