SpreadsheetUrlDownload
HTTP-Requests
ausführen (Daten abrufen)
,
HTTP-Requests
ausführen (Daten senden)
Dieser Step kann mehrere HTTP Calls basierend auf einem SPREADSHEET ausführen. Sie können den Step benutzen, um verschiedene Arten von Webservices/APIs zu verbinden. Einfache Calls und Stapel-Verarbeitung mehrerer Zeilen wird unterstützt.
Dokumentation im Handbuch aufrufenÜber Synesty Studio für API Connector Tools
Mit Synesty als No Code Middleware verbinden Sie API Connector Tools mit anderen Schnittstellen, APIs und Systemen ohne Programmierung per Drag&Drop.
Automatisieren Sie Geschäftsprozesse und Integrationen wie EDI Datenimport / Export oder eine einmalige Daten-Migration.
Wir unterstützen Datenformate wie CSV, Excel (XLS/XLSX), XML oder JSON und ermöglichen auch HTTP-Konnektoren zu REST- oder GraphQL-APIs. Kunden nutzen es auch für Auswertungen, ETL-Aufgaben oder Feed-Optimierung.
Unser No Code Flow-Editor und unsere Low Code Scripting Tools ermöglichen kreative Anpassungen für jede Art von Integration.
Passende Vorlagen
Über Synesty Studio für API Connector Tools
Mit Synesty als No Code Middleware verbinden Sie API Connector Tools mit anderen Schnittstellen, APIs und Systemen ohne Programmierung per Drag&Drop.
Automatisieren Sie Geschäftsprozesse und Integrationen wie EDI Datenimport / Export oder eine einmalige Daten-Migration.
Wir unterstützen Datenformate wie CSV, Excel (XLS/XLSX), XML oder JSON und ermöglichen auch HTTP-Konnektoren zu REST- oder GraphQL-APIs. Kunden nutzen es auch für Auswertungen, ETL-Aufgaben oder Feed-Optimierung.
Unser No Code Flow-Editor und unsere Low Code Scripting Tools ermöglichen kreative Anpassungen für jede Art von Integration.
Passende Vorlagen
Inputs
Das sind die Optionen, mit denen man den Step konfigurieren kann.
| Name | Datentyp | Beschreibung | Pflichtfeld | Werte |
|---|---|---|---|---|
| account | ACCOUNT | Wählen sie einen HTTP account für eine Client Zertifikat-basierte Authentifizierung | Nein | |
| input | SPREADSHEET | SPREADSHEET das alle Daten zum ausführen der Anfrage enthält. | Ja | |
| host | STRING | Das ist die URL die abgerufen wird (e.g https://api.somewebservice.com/GetStock, https://www.mywebsite.com/products.csv). Ünterstützte Protokolle sind http://, https://. Das Protokoll ist Pflicht. | Ja | |
| method | STRING | Die HTTP Methode (GET, POST, PUT, HEAD, PATCH, DELETE). | Ja |
|
| requestBody | STRING | Optional: Den HTTP request body direkt senden. Besonders nützlich bei der Kommunikation mit XML oder JSON Webdiensten, bei denen die ganze XML Anfrage in das Text Feld geschrieben wird. Funktioniert nur mit der POST, PATCH, PUT HTTP Methode. Wenn batchSize=1 sind alle Felder der Zeile als Freemarker Variablen verfügbar (z.B. ${somecol1!}). Wenn batchSize>1 ist, sind alle Zeilen der einzelnen Stapel-Verarbeitung als Freemarker Variable mit der Bezeichnung ${rows} verfügbar. Bei bodyContentType=multipart/form-data (oder Dateiupoad mit fileToUpload) kann man auch Form-Parameter übermitteln z.B. ¶m1=value1¶m2=value2 (wenn die URL/host keine Parameter hat, dann ohne das erste &-Zeichen). Es ist auch für bessere Lesbarkeit möglich, pro Zeile einen Parameter zu verwenden. Wichtig ist, dass der Wert keine Zeilenumbrüche beinhaltet. Verwenden Sie ggf. die Funktion ${urlEncode("one & one is two")}, um Werte url-encodiert zu schicken. Für mehrzeilige Werte sollte die Freemarker <#compress> function probiert werden. | Nein | |
| limit | STRING | Begrenzt die Anzahl der Zeilen die vom Eingabe SPREADSHEET verwendet werden. Verwenden Sie kleine Werte zum Testen. | Nein | Standardwert: 5 |
| batchSize | STRING | Legen Sie eine batchSize > 1 fest um, einen Call pro N in batchSize festgelegten Zeilen zu machen. Dies ist oft hilfreich, wenn man auf APIs zugreifen möchte die nur das Senden von z.B. 25 Einträge pro Aufruf erlauben. Beispiel: Angenommen Sie haben 12 Zeilen in Ihrem Eingangs SPREADSHEET. Mit batchSize=1 werden 12 Requests ausgeführt (einer pro Zeile). Mit batchSize=5 werden 3 Requests (1. und 2. Request: 5 Zeilen, 3. Request: 2 Zeilen) ausgeführt. Wenn eine batchSize > 1 verwendet wird, kann auf alle Zeilen des Batchs im requestBody über die ${rows} Variable zugegriffen werden. Mit batchSize=1 kann auf alle Spaltenwerte jeder Zeile im requestBody zugegriffen werden. | Nein | Standardwert: 1 |
| bodyContentType | STRING | Optional: Der Content type des requestBody. | Nein |
|
| requestHeaders | STRING | Optional: Zusätzliche HTTP request headers, die der HTTP Anfrage als key=value (Schlüssel-Wert-Paar) hinzugefügt werden (ein Paar pro Zeile). | Nein | |
| username | STRING | Falls die URL mit HTTP BASIC AUTH geschützt ist. Das ist der Benutzername. | Nein | |
| password | STRING | Das HTTP BASIC AUTH Passwort. | Nein | |
| errorStatusCodes | STRING | kommagetrennte Liste von HTTP Status Codes bei denen der Flow anhält, z.B. 403,404,500. Leer lassen für alle Status Codes größer 300. | Nein | |
| filename | STRING | Kann verwendet werden um Dateinamen der Antwort-Dateien zusammenzusetzen. Immer eine Dateierweiterung für den Dateinamen angeben (z.B. meinedatei.txt). Wenn leer wird der Dateiname automatisch gesetzt. | Nein | |
| filesToUpload | FILELIST | Optional: Diese Datei direkt in den requestBody senden. Wichtig: Die Option 'bodyContentType' sollte dafür leer oder 'multipart/form-data;' sein. | Nein | |
| fileNameInList | STRING | Der Dateiname einer Datei in 'filesToUpload', die im Request gesendet werden soll. | Nein | |
| fileParameterName | STRING | Optional: Der Name des HTTP-Request-Parameters, unter dem die Datei hochgeladen wird. (Default, wenn leer: 'upfile') | Nein | |
| outputMode | STRING | Legen Sie das Ausgabe Verhalten fest. (Datei Liste - eine Datei pro Antwort. responseContent Spalte hinzufügen - Die Antwort wird ebenfalls im Ergenis Spreadsheet dargestellt. Bitte nur nutzen wenn Datei Liste nicht ausreicht. Fügt den Inhalt der Antwort mit Base64 kodierter Zeichenfolge zum Ausgabe Spreadsheet - Die Ausgabe der responseContent Spalte ist eine Base64 kodierte Zeichenfolge.) | Nein |
|
| encoding | STRING | Der Zeichensatz der Antwort (Default: UTF-8). Wird nur verwendet für den Ausgabe Modus 'responseContent Spalte hinzufügen' | Ja |
|
| outputSourceColumns | STRING | Legt die Spalten des Quell-Spreadsheets fest, die zum Ausgabe Spreadsheet hinzugefügt werden sollen. | Nein | |
| headerContentType | STRING | Der HTTP header ContentType | Nein |
|
| timeoutInSeconds | STRING | Optional: HTTP Verbingungs- und Lese-Timeout in Sekunden. Default: 60s. Wenn der Server für die Antwort länger als timeoutInSeconds braucht, schlägt der Step fehl und gibt ienen Fehler aus. | Nein | Standardwert: 60 |
| rateLimitPerSecond | STRING | Die Geschwindigkeitsbegrenzung erlaubt es die Anzahl der Aufrufe pro Sekunde, z.B. 2 Aufrufe/s (=120 Aufrufe/Minute) zu beschränken. Oder 0.5 Aufrufe/s bedeutet eine Verzögerung von 2 Sekunden nach jedem Aufruf. Default: keine Begrenzung. | Nein | |
| numErrorsToStopFlow | STRING | Optional: Legt die Anzahl der Fehler oder Timeouts fest, die passieren dürfen bevor ein Flow mit ERROR abbricht. Default: 3. Es wird empfohlen des Wert gering zu halten. Wenn Hosts zu langsam antworten, versuchen Sie die die batchSize zu verringern. | Nein | Standardwert: 3 |
| sslCertificates | STRING | Experten-Einstellungen für https-urls: Unter normalen Umständen resultieren URLs mit Selbst-Signierten SSL Zertifikaten in einem Fehler. Dieser kann übergangen werden wenn diese Einstellung auf 'Selbst-Signierten SSL Zertifikaten vertrauen' gesetzt wird. Diese Einstellung stellt aber ein Sicherheitsrisiko dar, da schadhafte Seiten dies missbrauchen könnten um sensitive Informationsn zu stehlen. Nur benutzen, wenn Sie wissen was Sie tun!!! | Nein |
|
Outputs
Das sind die Ergebnisse des Steps, die von nachfolgenden Steps, nach der Ausführung verwendet werden können.
| Name | Datentyp | Beschreibung |
|---|---|---|
| requests | SPREADSHEET | Ein SPREADSHEET, welche die URL, requestBody und HTTP-Status jeder Anfrage enthält. |
| output | FILELIST | Eine FILELIST, welche den Inhalt jeder Anfrage enthält. |
Hilfe oder Projektsupport gewünscht?
Wenn Sie Hilfe bei der Einrichtung dieses Steps benötigen oder ein Projekt umsetzen wollen, dann unterstützen Sie unsere verifizierten Partner. Partner findenSpreadsheetUrlDownload wird oft in Verbindung mit folgenden Steps verwendet:
| Name | Version | Beschreibung | Anwendungsfall |
|---|---|---|---|
|
Mapper
Mapper
|
- | Wandelt ein Spreadsheet in ein anderes um. | |
|
JSONReader
JSONReader
|
- | Liest die JSON-Datei in ein SPREADSHEET-Objekt. |
JSON Daten
|
|
Filter
Filter
|
- | Kann ein Spreadheet nach einem bestimmten Ausdruck in der Freemarker-Syntax filtern und gibt nur Zeilen zurück, die der Filterbedingung entsprechen. Es wird auch ein zweites SPREADSHEET ausgegeben, das das negative Ergebnis enthält (Zeilen, die nicht der Filterbedingung entsprechen). | |
|
DatastoreWriter
DatastoreWriter
|
- | Importiert Daten eines Spreadsheets in einen Datatstore. | |
|
DeepLTranslate
DeepLTranslate
|
- | Translates the text from the specified source language (source_lang) into the specified target language (target_lang) via DeepL. |
Nachrichten
senden
|
|
CSVWriter
(ext. Version: 2.0)
CSVWriter
(ext. Version: 2.0)
|
2.0 | Kann ein SPREADSHEET in eine CSV-Datei schreiben. |
CSV Daten
|
|
APICall
APICall
|
- | Stellt eine API/HTTP-Anfrage. Unterstützt das Parsen von XML/JSON-Antworten und sog. Weiterblättern (Pagination). |
HTTP-Requests
ausführen (Daten abrufen)
,
HTTP-Requests
ausführen (Daten senden)
|
|
SearchDatastore
SearchDatastore
|
- | Erlaubt die Suche in einem Datastore mit der Rückgabe von Daten als SPREADSHEET. |
Reports / Auswertungen
abrufen / auslesen
|
Weitere Steps in API Connector Tools
| Name | Version | Beschreibung | Anwendungsfall |
|---|---|---|---|
WebDAVDownload
WebDAVDownload
|
- | Dieser Step lädt Dateien vonn einem WebDAV-Server herunter. |
Dateien
empfangen oder herunterladen
|
|
XMLReader
XMLReader
|
- | Einlesen einer XML Datei in ein Spreadsheet. |
XML Daten
|
|
SpreadsheetUrlDownload
SpreadsheetUrlDownload
|
- | Dieser Step kann mehrere HTTP Calls basierend auf einem SPREADSHEET ausführen. Sie können den Step benutzen, um verschiedene Arten von Webservices/APIs zu verbinden. Einfache Calls und Stapel-Verarbeitung mehrerer Zeilen wird unterstützt. |
HTTP-Requests
ausführen (Daten abrufen)
,
HTTP-Requests
ausführen (Daten senden)
|
|
WebDAVDownload
WebDAVDownload
|
- | Dieser Step lädt Dateien vonn einem WebDAV-Server herunter. |
Dateien
empfangen oder herunterladen
|
|
ExtractArchive
ExtractArchive
|
- | Dekomprimiert ein ZIP-Archiv in eine Dateiliste |
Dateien
empfangen oder herunterladen
|
|
WebDAVUpload
WebDAVUpload
|
- | Dieser Step kann Dateien auf einen WebDAV-Server hochladen. |
Dateien
senden oder hochladen
|
|
WebDAVRename
WebDAVRename
|
- | Dieser Step bennent eine oder mehrere Dateien auf einem WebDAV-Server um, bzw. verschiebt sie in einen existierenden Unterordner. | |
|
APICall
APICall
|
- | Stellt eine API/HTTP-Anfrage. Unterstützt das Parsen von XML/JSON-Antworten und sog. Weiterblättern (Pagination). |
HTTP-Requests
ausführen (Daten abrufen)
,
HTTP-Requests
ausführen (Daten senden)
|
|
Archive
Archive
|
- | Komprimiert eine einzelne DATEI oder eine DATEILISTE zu einem ZIP-Archiv | |
|
WebDAVUpload
WebDAVUpload
|
- | Dieser Step kann Dateien auf einen WebDAV-Server hochladen. |
Dateien
senden oder hochladen
|
|
UrlDownload
UrlDownload
|
- | Dieser Step greift auf eine URL zu und läd den Inhalt herunter. Das Ergebnis ist ein Wer von Typ String. |
HTTP-Requests
ausführen (Daten abrufen)
,
HTTP-Requests
ausführen (Daten senden)
|
|
WebDAVRename
WebDAVRename
|
- | Dieser Step bennent eine oder mehrere Dateien auf einem WebDAV-Server um, bzw. verschiebt sie in einen existierenden Unterordner. | |
|
HTML2Spreadsheet
HTML2Spreadsheet
|
- | Extrahiert HTML-Elemente aus einer Datei oder einem Spreadsheet (mit HTML-Code in einer Spalte). |
Dateien
|
|
HTMLParser
HTMLParser
|
- | Kann HTML-String einlesen und bestimmte Elemente daraus extrahieren, indem CSS- oder jQuery - Ausdrücke verwendet werden. Anschließend kann damit eine neue String-Ausgabe aus diesen extrahierten Elementen zur weiteren Verarbeitung erstellt werden. |
Dateien
|
|
JSONReader
JSONReader
|
- | Liest die JSON-Datei in ein SPREADSHEET-Objekt. |
JSON Daten
|