HTTP-Aktionen
HTTP-Aktionen ermöglichen es Ihnen, mit APIs zu interagieren und Webanfragen zu senden, die verschiedene Vorgänge ausführen, z. B. das Hoch- und Herunterladen von Daten und Dateien.
Um eine API-Anforderung wie POST, GET, PUT oder DELETE zu senden, verwenden Sie die Aktion Webdienst aufrufen.
In den Eigenschaften der Aktion müssen Sie die URL des Dienstes und die entsprechende HTTP-Methode eingeben. Außerdem müssen Sie den Inhaltstyp für Anforderung und Antwort auswählen, z. B. XML und JSON.
Die Felder Benutzerdefinierte Kopfzeilen und Anforderungstext hängen von der API ab, und Sie müssen sie wie in der Dokumentation beschrieben konfigurieren.
Wenn der Webserver eine Authentifizierung erfordert, geben Sie Ihre Anmeldeinformationen in die entsprechenden Felder der Einstellungen der Aktion Erweitert ein.
Eine Variable namens WebServiceResponse speichert die Ergebnisse der Webdienstanforderung. Wenn es sich bei den Ergebnissen um Dateien handelt, können Sie diese lokal auf Ihrem Desktop speichern.
Um Text oder Dateien aus dem Web herunterzuladen, können Sie die Aktion Aus dem Web herunterladen auswählen. Für diese Aktion müssen Sie die URL der Webseite oder Datei eingeben und die entsprechende HTTP-Methode auswählen.
Wenn der Webserver eine Authentifizierung erfordert, geben Sie Ihre Anmeldeinformationen in die entsprechenden Felder der Einstellungen der Aktion Erweitert ein.
Eine Variable namens WebPageText speichert den heruntergeladenen Text. Wenn Sie mit dieser Aktion Dateien herunterladen, können Sie diese lokal auf Ihrem Desktop speichern.
Notiz
Abgesehen von den HTTP-Aktionen, ermöglicht Power Automate Benutzern die Interaktion mit der Webanwendung über die Browserautomatisierungsaktionen. Weitere Informationen zu Aktionen zur Browserautomatisierung finden Sie in Browserautomatisierung.
Aus dem Web herunterladen
Lädt Text oder eine Datei aus dem Web herunter und speichert ihn/sie.
Eingabeparameter
| Argument | Optional | Akzeptiert | Standardwert | Beschreibung des Dataflows |
|---|---|---|---|---|
| URL | Nein | Textwert | Die URL der Webseite oder Datei | |
| Methode | n/v | GET, POST | GET | Geben Sie an, wie die Informationen einer Website abgerufen werden sollen. GET sollte verwendet werden, wenn alle benötigten Informationen in der URL stehen, und POST, um weitere Informationen (Kennwörter usw.) einzugeben |
| Post parameters | Nein | Datentabelle | Die POST-Parameter in Form einer Datentabelle mit zwei Spalten | |
| Save response | n/v | Text in Variable holen (für Webseiten), auf Festplatte speichern (für Dateien) | Text in Variable abrufen (für Webseiten) | Gibt an, wie die zurückgegebenen Daten gespeichert werden |
| File name | n/v | Originalen Dateinamen beibehalten (nur Zielordner angeben), Vollständigen Pfad angeben (Zielordner + eigener Dateiname) | Ursprünglichen Dateinamen beibehalten (nur Zielordner angeben) | Gibt an, ob der ursprüngliche Dateiname der heruntergeladenen Datei beibehalten oder ein neuer Name angegeben werden soll |
| Destination folder | Nein | Ordner | Der Ordner, in dem die vom Webserver zurückgegebene Datei gespeichert wird | |
| Destination file path | Nein | Datei | Der vollständige Pfad (Ordner plus Dateiname), unter dem die vom Webserver zurückgegebene Datei gespeichert wird | |
| Connection timeout | Ja | Numerischer Wert | 30 | Die Zeit (in Sekunden), die der Agent wartet, bis eine Verbindung mit dem Server hergestellt wird, bevor er aufgibt |
| Follow redirection | n/v | Boolescher Wert | Ja | Gibt an, ob der Webserver Sie an eine andere Webseite oder Website weiterleiten darf |
| Clear cookies | n/v | Boolescher Wert | Nein | Gibt an, ob alle Cookies gelöscht werden sollen, die durch ähnliche Aktionen während dieser Automatisierung erstellt wurden |
| User agent | Ja | Textwert | Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.8.1.21) Gecko/20100312 Firefox/3.6 | Geben Sie an, als welche Browser-Identität Sie gesehen werden wollen. Einige Webserver lassen den Zugriff nur zu, wenn eine Browser-Identität gewählt wird |
| Codierung | n/v | Automatische Erkennung, IBM037: IBM EBCDIC (US-Kanada), IBM437: OEM Vereinigte Staaten, IBM500: IBM EBCDIC (International), ASMO-708: Arabisch (ASMO 708), DOS-720: Arabisch (DOS), ibm737: Griechisch (DOS), ibm775: Baltisch (DOS), ibm850: Westeuropäisch (DOS), ibm852: Mitteleuropäisch (DOS), IBM855: OEM Kyrillisch, ibm857: Türkisch (DOS), IBM00858: OEM Mehrsprachiges Latein I, IBM860: Portugiesisch (DOS), ibm861: Isländisch (DOS), DOS-862: Hebräisch (DOS), IBM863: Französisch-Kanadisch (DOS), IBM864: Arabisch (864), IBM865: Nordisch (DOS), cp866: Kyrillisch (DOS), ibm869: Griechisch, Modern (DOS), IBM870: IBM EBCDIC (Mehrsprachiges Latein-2), windows-874: Thai (Windows), cp875: IBM EBCDIC (Griechisch Modern), shift_jis: Japanisch (Shift-JIS), gb2312: Chinesisch Vereinfacht (GB2312), ks_c_5601-1987: Koreanisch, big5: Chinesisch Traditionell (Big5), IBM1026: IBM EBCDIC (Turkish Latin-5), IBM01047: IBM Latin-1, IBM01140: IBM EBCDIC (US-Kanada-Euro), IBM01141: IBM EBCDIC (Deutschland-Euro), IBM01142: IBM EBCDIC (Dänemark-Norwegen-Euro), IBM01143: IBM EBCDIC (Finnland-Schweden-Euro), IBM01144: IBM EBCDIC (Italien-Euro), IBM01145: IBM EBCDIC (Spanien-Euro), IBM01146: IBM EBCDIC (Vereinigtes Königreich-Euro), IBM01147: IBM EBCDIC (Frankreich-Euro), IBM01148: IBM EBCDIC (International-Euro), IBM01149: IBM EBCDIC (Isländisch-Euro), utf-16: Unicode, utf-16BE: Unicode (Big-Endian), windows-1250: Mitteleuropa (Windows), windows-1251: Kyrillisch (Windows), windows-1252: Westeuropa (Windows), windows-1253: Griechisch (Windows), windows-1254: Türkisch (Windows), windows-1255: Hebräisch (Windows), windows-1256: Arabisch (Windows), windows-1257: Baltisch (Windows), windows-1258: Vietnamesisch (Windows), Johab: Koreanisch (Johab), macintosh: Westeuropäisch (Mac), x-mac-japanese: Japanisch (Mac), x-mac-chinesetrad: Traditionelles Chinesisch (Mac), x-mac-koreanisch: Koreanisch (Mac), x-mac-arabic: Arabisch (Mac), x-mac-hebrew: Hebräisch (Mac), x-mac-greek: Griechisch (Mac), x-mac-cyrillic: Kyrillisch (Mac), x-mac-chinesesimp: Vereinfachtes Chinesisch (Mac), x-mac-romanisch: Rumänisch (Mac), x-mac-ukrainisch: Ukrainisch (Mac), x-mac-thai: Thai (Mac), x-mac-ce: Mitteleuropäisch (Mac), x-mac-icelandic: Isländisch (Mac), x-mac-turkish: Türkisch (Mac), x-mac-croatian: Kroatisch (Mac), utf-32: Unicode (UTF-32), utf-32BE: Unicode (UTF-32 Big-Endian), x-Chinese-CNS: Traditionelles Chinesisch (CNS), x-cp20001: TCA Taiwan, x-Chinese-Eten: Traditionelles Chinesisch (Eten), x-cp20003: IBM5550 Taiwan, x-cp20004: TeleText Taiwan, x-cp20005: Wang Taiwan, x-IA5: Westeuropäisch (IA5), x-IA5-Deutsch: Deutsch (IA5), x-IA5-Schwedisch: Schwedisch (IA5), x-IA5-Norwegisch: Norwegisch (IA5), us-ascii: US-ASCII, x-cp20261: T. 61, x-cp20269: ISO-6937, IBM273: IBM EBCDIC (Deutschland), IBM277: IBM EBCDIC (Dänemark-Norwegen), IBM278: IBM EBCDIC (Finnland-Schweden), IBM280: IBM EBCDIC (Italien), IBM284: IBM EBCDIC (Spanien), IBM285: IBM EBCDIC (Vereinigtes Königreich), IBM290: IBM EBCDIC (Japanisch Katakana), IBM297: IBM EBCDIC (Frankreich), IBM420: IBM EBCDIC (Arabisch), IBM423: IBM EBCDIC (Griechisch), IBM424: IBM EBCDIC (Hebräisch), x-EBCDIC-KoreanExtended: IBM EBCDIC (Koreanisch Erweitert), IBM-Thai: IBM EBCDIC (Thai), koi8-r: Kyrillisch (KOI8-R), IBM871: IBM EBCDIC (Isländisch), IBM880: IBM EBCDIC (Kyrillisch Russisch), IBM905: IBM EBCDIC (Türkisch), IBM00924: IBM Latin-1, EUC-JP: Japanisch (JIS 0208-1990 und 0212-1990), x-cp20936: Chinesisch Vereinfacht (GB2312-80), x-cp20949: Koreanisch Wansung, cp1025: IBM EBCDIC (Kyrillisch Serbisch-Bulgarisch), koi8-u: Kyrillisch (KOI8-U), iso-8859-1: Westeuropäisch (ISO), iso-8859-2: Mitteleuropäisch (ISO), iso-8859-3: Latein 3 (ISO), iso-8859-4: Baltisch (ISO), iso-8859-5: Kyrillisch (ISO), iso-8859-6: Arabisch (ISO), iso-8859-7: Griechisch (ISO), iso-8859-8: Hebräisch (ISO-Visual), iso-8859-9: Türkisch (ISO), iso-8859-13: Estnisch (ISO), iso-8859-15: Latein 9 (ISO), x-Europa: Europa, iso-8859-8-i: Hebräisch (ISO-Logisch), iso-2022-jp: Japanisch (JIS), csISO2022JP: Japanisch (JIS-Allow 1 byte Kana), iso-2022-jp: Japanisch (JIS-Allow 1 byte Kana - SO/SI), iso-2022-kr: Koreanisch (ISO), x-cp50227: Vereinfachtes Chinesisch (ISO-2022), euc-jp: Japanisch (EUC), EUC-CN: Vereinfachtes Chinesisch (EUC), euc-kr: Koreanisch (EUC), hz-gb-2312: Chinesisch Vereinfacht (HZ), GB18030: Chinesisch Vereinfacht (GB18030), x-iscii-de: ISCII Devanagari, x-iscii-be: ISCII Bengali, x-iscii-ta: ISCII Tamil, x-iscii-te: ISCII Telugu, x-iscii-as: ISCII Assamese, x-iscii-or: ISCII Odia, x-iscii-ka: ISCII Kannada, x-iscii-ma: ISCII Malayalam, x-iscii-gu: ISCII Gujarati, x-iscii-pa: ISCII Punjabi, utf-7: Unicode (UTF-7), utf-8: Unicode (UTF-8) | Automatische Erkennung | Die für die Webseite verwendete Kodierung. Wenn die Option Auto-detect gewählt ist, wird die zu verwendende Kodierung vom Webserver vorgegeben |
| Accept untrusted certificates | n/v | Boolescher Wert | Nein | Gibt an, ob nicht vertrauenswürdige Zertifikate akzeptiert werden |
| Anmeldeinformationen verwenden | n/v | Boolescher Wert | Nein | Geben Sie an, ob der Webserver eine Authentifizierung erfordert. Diese Eigenschaft bezieht sich auf die HTTP-Authentifizierung (d. h., wenn der Browser ein Popup-Fenster anzeigt, in dem nach Benutzernamen und Passwort gefragt wird) |
| Benutzername | Nein | Textwert | Der Benutzername für den Webserver | |
| Kennwort | Nein | Direkte verschlüsselte Eingabe oder Textwert | Das Kennwort für den Webserver |
Erzeugte Variablen
| Argument | Type | Beschreibung des Dataflows |
|---|---|---|
| DownloadedFile | Datei | Die heruntergeladene Datei |
| WebPageText | Textwert | Der Text der Webseite |
Ausnahmen
| Ausnahme | Beschreibung |
|---|---|
| Verzeichnis ist nicht vorhanden | Gibt an, dass ein erforderliches Verzeichnis nicht vorhanden ist |
| Fehler beim Herunterladen aus dem Web | Gibt ein Problem beim Herunterladen aus dem Web an |
Bekannte Probleme
- Die NTLM-Authentifizierung wird derzeit für Webanfragen in Power Automate für Desktop nicht unterstützt.
SOAP-Webdienst aufrufen
Ruft eine Methode von einem SOAP-Webdienst auf.
Eingabeparameter
| Argument | Optional | Akzeptiert | Standardwert | Beschreibung des Dataflows |
|---|---|---|---|---|
| Endpunkt | Keine | Textwert | Der Endpunkt des Webdiensts | |
| Benutzerdefinierte Header | Ja | Textwert | Die benutzerdefinierten Header, die in der Anforderung enthalten sein sollen, die an den Webdienst gesendet wird | |
| Anforderungstext | Keine | Textwert | Der Text der Anforderung, die an den Webdienst gesendet wird | |
| Verbindungstimeout | Keine | Numerischer Wert | 30 | Die Zeit (in Sekunden), die der Agent auf den Verbindungsaufbau mit dem Server warten sollte, bevor dieser fehlschlägt |
| Umleitung folgen | K. A. | Boolescher Wert | Ja | Gibt an, ob der Webserver Sie an einen anderen Webdienst weiterleiten darf |
| Clear cookies | K. A. | Boolescher Wert | Nein | Gibt an, ob alle Cookies gelöscht werden sollen, die zuvor durch ähnliche Aktionen während dieses Flows erstellt wurden |
| Fehlschlagen bei Fehlerstatus | K. A. | Boolescher Wert | Nein | Gibt an, ob die Antworten des aufgerufenen Webdiensts, die Fehler bezeichnen, wie normale Antworten verarbeitet werden (Unterdrücken aller Ausnahmen) oder in den verknüpften Ausnahmen resultieren |
| Benutzer-Agent | Keine | Textwert | Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.8.1.21) Gecko/20100312 Firefox/3.6 | Geben Sie an, als welche Browser-Identität Sie gesehen werden wollen. Einige Webserver lassen den Zugriff nur zu, wenn eine Browser-Identität gewählt wird |
| Benutzer-Agent | Ja | Textwert | Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.8.1.21) Gecko/20100312 Firefox/3.6 | Geben Sie an, als welche Browser-Identität Sie gesehen werden wollen. Einige Webserver lassen den Zugriff nur zu, wenn eine Browser-Identität gewählt wird |
| Codierung | n/v | Automatische Erkennung, IBM037: IBM EBCDIC (US-Kanada), IBM437: OEM Vereinigte Staaten, IBM500: IBM EBCDIC (International), ASMO-708: Arabisch (ASMO 708), DOS-720: Arabisch (DOS), ibm737: Griechisch (DOS), ibm775: Baltisch (DOS), ibm850: Westeuropäisch (DOS), ibm852: Mitteleuropäisch (DOS), IBM855: OEM Kyrillisch, ibm857: Türkisch (DOS), IBM00858: OEM Mehrsprachiges Latein I, IBM860: Portugiesisch (DOS), ibm861: Isländisch (DOS), DOS-862: Hebräisch (DOS), IBM863: Französisch-Kanadisch (DOS), IBM864: Arabisch (864), IBM865: Nordisch (DOS), cp866: Kyrillisch (DOS), ibm869: Griechisch, Modern (DOS), IBM870: IBM EBCDIC (Mehrsprachiges Latein-2), windows-874: Thai (Windows), cp875: IBM EBCDIC (Griechisch Modern), shift_jis: Japanisch (Shift-JIS), gb2312: Chinesisch Vereinfacht (GB2312), ks_c_5601-1987: Koreanisch, big5: Chinesisch Traditionell (Big5), IBM1026: IBM EBCDIC (Turkish Latin-5), IBM01047: IBM Latin-1, IBM01140: IBM EBCDIC (US-Kanada-Euro), IBM01141: IBM EBCDIC (Deutschland-Euro), IBM01142: IBM EBCDIC (Dänemark-Norwegen-Euro), IBM01143: IBM EBCDIC (Finnland-Schweden-Euro), IBM01144: IBM EBCDIC (Italien-Euro), IBM01145: IBM EBCDIC (Spanien-Euro), IBM01146: IBM EBCDIC (Vereinigtes Königreich-Euro), IBM01147: IBM EBCDIC (Frankreich-Euro), IBM01148: IBM EBCDIC (International-Euro), IBM01149: IBM EBCDIC (Isländisch-Euro), utf-16: Unicode, utf-16BE: Unicode (Big-Endian), windows-1250: Mitteleuropa (Windows), windows-1251: Kyrillisch (Windows), windows-1252: Westeuropa (Windows), windows-1253: Griechisch (Windows), windows-1254: Türkisch (Windows), windows-1255: Hebräisch (Windows), windows-1256: Arabisch (Windows), windows-1257: Baltisch (Windows), windows-1258: Vietnamesisch (Windows), Johab: Koreanisch (Johab), macintosh: Westeuropäisch (Mac), x-mac-japanese: Japanisch (Mac), x-mac-chinesetrad: Traditionelles Chinesisch (Mac), x-mac-koreanisch: Koreanisch (Mac), x-mac-arabic: Arabisch (Mac), x-mac-hebrew: Hebräisch (Mac), x-mac-greek: Griechisch (Mac), x-mac-cyrillic: Kyrillisch (Mac), x-mac-chinesesimp: Vereinfachtes Chinesisch (Mac), x-mac-romanisch: Rumänisch (Mac), x-mac-ukrainisch: Ukrainisch (Mac), x-mac-thai: Thai (Mac), x-mac-ce: Mitteleuropäisch (Mac), x-mac-icelandic: Isländisch (Mac), x-mac-turkish: Türkisch (Mac), x-mac-croatian: Kroatisch (Mac), utf-32: Unicode (UTF-32), utf-32BE: Unicode (UTF-32 Big-Endian), x-Chinese-CNS: Traditionelles Chinesisch (CNS), x-cp20001: TCA Taiwan, x-Chinese-Eten: Traditionelles Chinesisch (Eten), x-cp20003: IBM5550 Taiwan, x-cp20004: TeleText Taiwan, x-cp20005: Wang Taiwan, x-IA5: Westeuropäisch (IA5), x-IA5-Deutsch: Deutsch (IA5), x-IA5-Schwedisch: Schwedisch (IA5), x-IA5-Norwegisch: Norwegisch (IA5), us-ascii: US-ASCII, x-cp20261: T. 61, x-cp20269: ISO-6937, IBM273: IBM EBCDIC (Deutschland), IBM277: IBM EBCDIC (Dänemark-Norwegen), IBM278: IBM EBCDIC (Finnland-Schweden), IBM280: IBM EBCDIC (Italien), IBM284: IBM EBCDIC (Spanien), IBM285: IBM EBCDIC (Vereinigtes Königreich), IBM290: IBM EBCDIC (Japanisch Katakana), IBM297: IBM EBCDIC (Frankreich), IBM420: IBM EBCDIC (Arabisch), IBM423: IBM EBCDIC (Griechisch), IBM424: IBM EBCDIC (Hebräisch), x-EBCDIC-KoreanExtended: IBM EBCDIC (Koreanisch Erweitert), IBM-Thai: IBM EBCDIC (Thai), koi8-r: Kyrillisch (KOI8-R), IBM871: IBM EBCDIC (Isländisch), IBM880: IBM EBCDIC (Kyrillisch Russisch), IBM905: IBM EBCDIC (Türkisch), IBM00924: IBM Latin-1, EUC-JP: Japanisch (JIS 0208-1990 und 0212-1990), x-cp20936: Chinesisch Vereinfacht (GB2312-80), x-cp20949: Koreanisch Wansung, cp1025: IBM EBCDIC (Kyrillisch Serbisch-Bulgarisch), koi8-u: Kyrillisch (KOI8-U), iso-8859-1: Westeuropäisch (ISO), iso-8859-2: Mitteleuropäisch (ISO), iso-8859-3: Latein 3 (ISO), iso-8859-4: Baltisch (ISO), iso-8859-5: Kyrillisch (ISO), iso-8859-6: Arabisch (ISO), iso-8859-7: Griechisch (ISO), iso-8859-8: Hebräisch (ISO-Visual), iso-8859-9: Türkisch (ISO), iso-8859-13: Estnisch (ISO), iso-8859-15: Latein 9 (ISO), x-Europa: Europa, iso-8859-8-i: Hebräisch (ISO-Logisch), iso-2022-jp: Japanisch (JIS), csISO2022JP: Japanisch (JIS-Allow 1 byte Kana), iso-2022-jp: Japanisch (JIS-Allow 1 byte Kana - SO/SI), iso-2022-kr: Koreanisch (ISO), x-cp50227: Vereinfachtes Chinesisch (ISO-2022), euc-jp: Japanisch (EUC), EUC-CN: Vereinfachtes Chinesisch (EUC), euc-kr: Koreanisch (EUC), hz-gb-2312: Chinesisch Vereinfacht (HZ), GB18030: Chinesisch Vereinfacht (GB18030), x-iscii-de: ISCII Devanagari, x-iscii-be: ISCII Bengali, x-iscii-ta: ISCII Tamil, x-iscii-te: ISCII Telugu, x-iscii-as: ISCII Assamese, x-iscii-or: ISCII Odia, x-iscii-ka: ISCII Kannada, x-iscii-ma: ISCII Malayalam, x-iscii-gu: ISCII Gujarati, x-iscii-pa: ISCII Punjabi, utf-7: Unicode (UTF-7), utf-8: Unicode (UTF-8) | Automatische Erkennung | Die Kodierung, die für die Webdienst-Antwort verwendet wird. Wenn die Option auto-detect gewählt ist, wird die zu verwendende Kodierung vom Webdienst angegeben |
| Accept untrusted certificates | n/v | Boolescher Wert | Nein | Gibt an, ob nicht vertrauenswürdige Zertifikate akzeptiert werden |
| HTTP Authentication | n/v | Boolescher Wert | Nein | Gibt an, ob der Webserver eine HTTP-Authentifizierung erfordert. (das heißt, wenn der Browser ein Popupfenster mit der Frage nach Benutzername und Kennwort anzeigt) |
| Benutzername | Nein | Textwert | Der Benutzername für den Webserver | |
| Kennwort | Nein | Direkte verschlüsselte Eingabe oder Textwert | Das Kennwort für den Webserver |
Anforderungs-Erstellungsparameter abrufen
| Argument | Akzeptiert | Beschreibung |
|---|---|---|
| WSDL | Datei | Das WSDL-Dokument (Web Services Description Language), mit dem die Anforderung erstellt werden soll |
| Dienstleistung | Textwert | Der zu aufrufende Dienst |
| Port | Textwert | Der Port, über den der Dienst aufgerufen werden soll |
| SOAP-Version | Textwert | Die Version des SOAP-Dienstes |
| Vorgang | Textwert | Der Vorgang, der über den Dienst aufgerufen werden soll |
| Anforderungsumschlag | Textwert | Der Umschlag, der in der Anforderung an den Dienst gesendet werden soll |
Erzeugte Variablen
| Argument | Type | Beschreibung des Dataflows |
|---|---|---|
| SoapServiceResponseHeader | Liste von Textwerten | Die HTTP-Header der Antwort |
| SoapServiceResponse | Textwert | Der Antworttext des Webdiensts |
| StatusCode | Numerischer Wert | Der zurückgegebene Statuscode |
Ausnahmen
| Ausnahme | Beschreibung |
|---|---|
| Fehler beim Aufrufen des SOAP-Diensts | Gibt ein Problem beim Aufrufen des SOAP Service an |
| Ungültiger Header in benutzerdefinierten Headern | Gibt an, dass einige benutzerdefinierte Header ungültig waren |
Bekannte Probleme
- Die NTLM-Authentifizierung wird derzeit für Webanfragen in Power Automate für Desktop nicht unterstützt.
Webdienst aufrufen
Ruft einen Webdienst auf, indem Daten gesendet werden und die Antwort vom Webdienst abgerufen wird.
Eingabeparameter
| Argument | Optional | Akzeptiert | Standardwert | Beschreibung des Dataflows |
|---|---|---|---|---|
| URL | Nein | Textwert | Die URL des Webdiensts | |
| Methode | n/v | GET, POST, CONNECT, HEAD, PUT, DELETE, OPTIONS, TRACE, PATCH | GET | Die HTTP-Methode, die zum Aufrufen des Webdiensts verwendet werden soll |
| Accept | Ja | Textwert | application/xml | Der zulässige Inhaltstyp für die Antwort des Webdiensts |
| Content type | Ja | Textwert | application/xml | Der Inhaltstyp der Anforderung, die an den Webdienst gesendet wird |
| Custom headers | Ja | Textwert | Die benutzerdefinierten Header, die in der Anforderung enthalten sein sollen, die an den Webdienst gesendet wird | |
| Request body | Ja | Textwert | Der Text der Anforderung, die an den Webdienst gesendet wird | |
| Save response | n/v | Text in Variable holen (für Webseiten), auf Festplatte speichern (für Dateien) | Text in Variable abrufen (für Webseiten) | Gibt an, wie die zurückgegebenen Daten gespeichert werden |
| File name | n/v | Originalen Dateinamen beibehalten (nur Zielordner angeben), Vollständigen Pfad angeben (Zielordner + eigener Dateiname) | Ursprünglichen Dateinamen beibehalten (nur Zielordner angeben) | Gibt an, ob der ursprüngliche Dateiname der heruntergeladenen Datei beibehalten oder ein neuer Name angegeben werden soll |
| Destination folder | Nein | Ordner | Der Ordner, in dem die durch den Webdienst zurückgegebene Datei gespeichert wird | |
| Destination file path | Nein | Datei | Der vollständige Pfad (Ordner plus Dateiname), unter dem die vom Webdienst zurückgegebene Datei gespeichert wird | |
| Connection timeout | Ja | Numerischer Wert | 30 | Die Zeit (in Sekunden), die der Agent wartet, bis eine Verbindung mit dem Server hergestellt wird, bevor er aufgibt |
| Follow redirection | n/v | Boolescher Wert | Ja | Gibt an, ob der Webserver Sie an einen anderen Webdienst weiterleiten darf |
| Clear cookies | n/v | Boolescher Wert | Nein | Gibt an, ob alle Cookies gelöscht werden sollen, die durch ähnliche Aktionen während dieser Automatisierung vor dieser Aktion erstellt wurden |
| Fail on error status | n/v | Boolescher Wert | Nein | Gibt an, ob die Antworten des aufgerufenen Webdiensts, die Fehler bezeichnen, wie normale Antworten verarbeitet werden (Unterdrücken aller Ausnahmen) oder in den verknüpften Ausnahmen resultieren |
| Encode request body | n/v | Boolescher Wert | Ja | Gibt an, ob der Anforderungstext vor dem Aufrufen URL-codiert werden soll |
| User agent | Ja | Textwert | Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.8.1.21) Gecko/20100312 Firefox/3.6 | Geben Sie an, als welche Browser-Identität Sie gesehen werden wollen. Einige Webserver lassen den Zugriff nur zu, wenn eine Browser-Identität gewählt wird |
| Codierung | n/v | Automatische Erkennung, IBM037: IBM EBCDIC (US-Kanada), IBM437: OEM Vereinigte Staaten, IBM500: IBM EBCDIC (International), ASMO-708: Arabisch (ASMO 708), DOS-720: Arabisch (DOS), ibm737: Griechisch (DOS), ibm775: Baltisch (DOS), ibm850: Westeuropäisch (DOS), ibm852: Mitteleuropäisch (DOS), IBM855: OEM Kyrillisch, ibm857: Türkisch (DOS), IBM00858: OEM Mehrsprachiges Latein I, IBM860: Portugiesisch (DOS), ibm861: Isländisch (DOS), DOS-862: Hebräisch (DOS), IBM863: Französisch-Kanadisch (DOS), IBM864: Arabisch (864), IBM865: Nordisch (DOS), cp866: Kyrillisch (DOS), ibm869: Griechisch, Modern (DOS), IBM870: IBM EBCDIC (Mehrsprachiges Latein-2), windows-874: Thai (Windows), cp875: IBM EBCDIC (Griechisch Modern), shift_jis: Japanisch (Shift-JIS), gb2312: Chinesisch Vereinfacht (GB2312), ks_c_5601-1987: Koreanisch, big5: Chinesisch Traditionell (Big5), IBM1026: IBM EBCDIC (Turkish Latin-5), IBM01047: IBM Latin-1, IBM01140: IBM EBCDIC (US-Kanada-Euro), IBM01141: IBM EBCDIC (Deutschland-Euro), IBM01142: IBM EBCDIC (Dänemark-Norwegen-Euro), IBM01143: IBM EBCDIC (Finnland-Schweden-Euro), IBM01144: IBM EBCDIC (Italien-Euro), IBM01145: IBM EBCDIC (Spanien-Euro), IBM01146: IBM EBCDIC (Vereinigtes Königreich-Euro), IBM01147: IBM EBCDIC (Frankreich-Euro), IBM01148: IBM EBCDIC (International-Euro), IBM01149: IBM EBCDIC (Isländisch-Euro), utf-16: Unicode, utf-16BE: Unicode (Big-Endian), windows-1250: Mitteleuropa (Windows), windows-1251: Kyrillisch (Windows), windows-1252: Westeuropa (Windows), windows-1253: Griechisch (Windows), windows-1254: Türkisch (Windows), windows-1255: Hebräisch (Windows), windows-1256: Arabisch (Windows), windows-1257: Baltisch (Windows), windows-1258: Vietnamesisch (Windows), Johab: Koreanisch (Johab), macintosh: Westeuropäisch (Mac), x-mac-japanese: Japanisch (Mac), x-mac-chinesetrad: Traditionelles Chinesisch (Mac), x-mac-koreanisch: Koreanisch (Mac), x-mac-arabic: Arabisch (Mac), x-mac-hebrew: Hebräisch (Mac), x-mac-greek: Griechisch (Mac), x-mac-cyrillic: Kyrillisch (Mac), x-mac-chinesesimp: Vereinfachtes Chinesisch (Mac), x-mac-romanisch: Rumänisch (Mac), x-mac-ukrainisch: Ukrainisch (Mac), x-mac-thai: Thai (Mac), x-mac-ce: Mitteleuropäisch (Mac), x-mac-icelandic: Isländisch (Mac), x-mac-turkish: Türkisch (Mac), x-mac-croatian: Kroatisch (Mac), utf-32: Unicode (UTF-32), utf-32BE: Unicode (UTF-32 Big-Endian), x-Chinese-CNS: Traditionelles Chinesisch (CNS), x-cp20001: TCA Taiwan, x-Chinese-Eten: Traditionelles Chinesisch (Eten), x-cp20003: IBM5550 Taiwan, x-cp20004: TeleText Taiwan, x-cp20005: Wang Taiwan, x-IA5: Westeuropäisch (IA5), x-IA5-Deutsch: Deutsch (IA5), x-IA5-Schwedisch: Schwedisch (IA5), x-IA5-Norwegisch: Norwegisch (IA5), us-ascii: US-ASCII, x-cp20261: T. 61, x-cp20269: ISO-6937, IBM273: IBM EBCDIC (Deutschland), IBM277: IBM EBCDIC (Dänemark-Norwegen), IBM278: IBM EBCDIC (Finnland-Schweden), IBM280: IBM EBCDIC (Italien), IBM284: IBM EBCDIC (Spanien), IBM285: IBM EBCDIC (Vereinigtes Königreich), IBM290: IBM EBCDIC (Japanisch Katakana), IBM297: IBM EBCDIC (Frankreich), IBM420: IBM EBCDIC (Arabisch), IBM423: IBM EBCDIC (Griechisch), IBM424: IBM EBCDIC (Hebräisch), x-EBCDIC-KoreanExtended: IBM EBCDIC (Koreanisch Erweitert), IBM-Thai: IBM EBCDIC (Thai), koi8-r: Kyrillisch (KOI8-R), IBM871: IBM EBCDIC (Isländisch), IBM880: IBM EBCDIC (Kyrillisch Russisch), IBM905: IBM EBCDIC (Türkisch), IBM00924: IBM Latin-1, EUC-JP: Japanisch (JIS 0208-1990 und 0212-1990), x-cp20936: Chinesisch Vereinfacht (GB2312-80), x-cp20949: Koreanisch Wansung, cp1025: IBM EBCDIC (Kyrillisch Serbisch-Bulgarisch), koi8-u: Kyrillisch (KOI8-U), iso-8859-1: Westeuropäisch (ISO), iso-8859-2: Mitteleuropäisch (ISO), iso-8859-3: Latein 3 (ISO), iso-8859-4: Baltisch (ISO), iso-8859-5: Kyrillisch (ISO), iso-8859-6: Arabisch (ISO), iso-8859-7: Griechisch (ISO), iso-8859-8: Hebräisch (ISO-Visual), iso-8859-9: Türkisch (ISO), iso-8859-13: Estnisch (ISO), iso-8859-15: Latein 9 (ISO), x-Europa: Europa, iso-8859-8-i: Hebräisch (ISO-Logisch), iso-2022-jp: Japanisch (JIS), csISO2022JP: Japanisch (JIS-Allow 1 byte Kana), iso-2022-jp: Japanisch (JIS-Allow 1 byte Kana - SO/SI), iso-2022-kr: Koreanisch (ISO), x-cp50227: Vereinfachtes Chinesisch (ISO-2022), euc-jp: Japanisch (EUC), EUC-CN: Vereinfachtes Chinesisch (EUC), euc-kr: Koreanisch (EUC), hz-gb-2312: Chinesisch Vereinfacht (HZ), GB18030: Chinesisch Vereinfacht (GB18030), x-iscii-de: ISCII Devanagari, x-iscii-be: ISCII Bengali, x-iscii-ta: ISCII Tamil, x-iscii-te: ISCII Telugu, x-iscii-as: ISCII Assamese, x-iscii-or: ISCII Odia, x-iscii-ka: ISCII Kannada, x-iscii-ma: ISCII Malayalam, x-iscii-gu: ISCII Gujarati, x-iscii-pa: ISCII Punjabi, utf-7: Unicode (UTF-7), utf-8: Unicode (UTF-8) | Automatische Erkennung | Die Kodierung, die für die Webdienst-Antwort verwendet wird. Wenn die Option auto-detect gewählt ist, wird die zu verwendende Kodierung vom Webdienst angegeben |
| Accept untrusted certificates | n/v | Boolescher Wert | Nein | Gibt an, ob nicht vertrauenswürdige Zertifikate akzeptiert werden |
| HTTP Authentication | n/v | Boolescher Wert | Nein | Geben Sie an, ob der Webserver eine Authentifizierung erfordert. Diese Eigenschaft bezieht sich auf die HTTP-Authentifizierung (d. h., wenn der Browser ein Popup-Fenster anzeigt, in dem nach Benutzernamen und Passwort gefragt wird) |
| Benutzername | Nein | Textwert | Der Benutzername für den Webserver | |
| Kennwort | Nein | Direkte verschlüsselte Eingabe oder Textwert | Das Kennwort für den Webserver |
Erzeugte Variablen
| Argument | Type | Beschreibung des Dataflows |
|---|---|---|
| WebServiceResponseHeaders | Liste von Textwerten | Die HTTP-Header der Antwort |
| DownloadedFile | Datei | Die heruntergeladene Datei |
| WebServiceResponse | Textwert | Der Antworttext des Webdiensts |
| StatusCode | Numerischer Wert | Der zurückgegebene Statuscode |
Ausnahmen
| Ausnahme | Beschreibung |
|---|---|
| Fehler beim Aufrufen des Webdiensts | Gibt ein Problem beim Aufrufen des Webdiensts an |
| Verzeichnis ist nicht vorhanden | Gibt an, dass ein erforderliches Verzeichnis nicht vorhanden ist |
| Ungültiger Header in benutzerdefinierten Headern | Gibt an, dass einige benutzerdefinierte Header ungültig waren |
Bekannte Probleme
- Die NTLM-Authentifizierung wird derzeit für Webanfragen in Power Automate für Desktop nicht unterstützt.