SpreadsheetUrlDownload

execute and receive data by HTTP-Requests , execute and upload data by HTTP-Requests

This step can do multiple HTTP Calls based on a SPREADSHEET or SPREADSHEET list. Use it to connect to various kinds of webservices/APIs. Supports single calls and batch processing of multiple rows.

View manual

Why Synesty?

  • Central middleware for all integrations, connectors and automation of business processes
  • No coding required - just Drag&Drop and configuration
  • Professional support with quick responses
Sign up for FREE Demo

Related templates

Why Synesty?

  • Central middleware for all integrations, connectors and automation of business processes
  • No coding required - just Drag&Drop and configuration
  • Professional support with quick responses
Sign up for FREE Demo

Related templates

Inputs

Name Type Description Required Values
account ACCOUNT Select a HTTP account for client certificate based authentication No
input SPREADSHEET SPREADSHEET containing all the data to make the request. Yes
host STRING This is the URL which will be called (e.g http://api.somewebservice.com/GetStock, http://www.mywebsite.com/products.csv or ftp://username:password@ftp.myserver.com/folder/file.csv). Supported Protocols are http://, https://, ftp://. The protocol is mandatory. FTP is only supported for batchSize=1. Yes
method STRING The HTTP Method (GET, POST, PUT, HEAD, PATCH, DELETE). Yes
  • GET (Default)
  • POST
  • HEAD
  • PUT
  • PATCH
  • DELETE
requestBody STRING Optional: Directly sent the HTTP request body. This can be useful when talking to XML or JSON webservices where you can insert the full XML Request in this textfield. Only possible with POST, PUT, PATCH method. If batchSize = 1 then all fields of the row are available as Freemarker variables (e.g. ${somecol1!}). If batchSize > 1 then all rows of a single batch will be available as a Freemarker variable called ${rows}. When bodyContentType=multipart/form-data then you can send form parameters like &param1=value1&param2=value2 (if your URL/host does not have any parameters then your first parameter must not have the & character. It is also possible to add each parameter on a new line. Make sure each parameter/value is on a single line. If necessary use the function ${urlEncode("one & one is two")} to send values url-encoded. For multi-line values consider the Freemarker <#compress> function to remove linebreaks. No
limit STRING Limits the number of rows used from the input SPREADSHEET. Use low values for testing. No Default: 5
batchSize STRING Specify batchSize > 1 to make one call per N rows defined by batchSize. This is often useful to access APIs which allow you to send e.g. 25 items per call. Example: Assume you have 12 rows in your input Spreadsheet: If batchSize=1, then it will do 12 requests (one request per row). If batchSize=5 then it will do 3 requests (1st, 2nd request: 5 rows, 3rd request: 2 rows). If you use batchSize>1 then you can access all rows and their values of the batch in the requestBody. For batchSize=1 you access all columns of each row in the requestBody. No Default: 1
bodyContentType STRING Optional: The content type of the requestBody. No
  • application/octet-stream
  • application/xhtml+xml; charset=ISO-8859-1
  • application/json; charset=UTF-8
  • application/xml; charset=ISO-8859-1
  • text/html; charset=ISO-8859-1
  • text/plain; charset=ISO-8859-1
  • text/xml; charset=ISO-8859-1
  • application/x-www-form-urlencoded; charset=ISO-8859-1
  • multipart/form-data; charset=ISO-8859-1
  • text/csv; charset=UTF-8
requestHeaders STRING Optional: Additional HTTP request headers added to the HTTP-Request as key=value pairs (one pair per line). No
username STRING If the URL is protected with HTTP BASIC AUTH, this is the username. No
password STRING The HTTP BASIC AUTH password. No
errorStatusCodes STRING A comma separated list of http status codes for which flow stops execution, e.g. 403,404,500. Leave empty for all status codes greater than 300. No
filename STRING Can be used to construct the filenames of the response files. Always enter a filename and extension (e.g. myfile.txt). If empty a default filename will be constructed. No
filesToUpload FILELIST Optional: Directly sent this file in request body. Important: The option 'bodyContentType' should be empty or 'multipart/form-data;'. No
fileNameInList STRING The filename of a file in filesToUpload which should be send in the request. No
fileParameterName STRING Optional: The name of the HTTP-request-parameter under which the file is uploaded. (Default if empty: 'upfile') No
outputMode STRING Use this to specify the output behavior. (File List - one file per response. Add responseContent column - The response will also be part of the result spreadsheet. Only use this when needed if File Lis ist not enough. Add response content with Base64 encoded String to output spreadsheet - The output in the responseContent column will be a BASE64 encoded String.) No
  • File List (Default)
  • Add response content to output spreadsheet.
  • Add response content with Base64 encoded String to output spreadsheet.
encoding STRING The encoding of the response (Default: UTF-8). Only used for output mode 'Add responseContent column' Yes
  • UTF-8 (Default)
  • UTF-16
  • ISO-8859-1
  • ISO-8859-2
  • ISO-8859-4
  • ISO-8859-5
  • ISO-8859-15
  • cp1252 (Windows-1252, ANSI)
  • MacCentralEurope
  • US-ASCII
  • KOI8-R
outputSourceColumns STRING Specify the columns from the source SPREADSHEET which should be added to the output SPREADSHEET. No
headerContentType STRING The HTTP header content type No
  • application/octet-stream
  • application/xhtml+xml; charset=ISO-8859-1
  • application/json; charset=UTF-8
  • application/xml; charset=ISO-8859-1
  • text/html; charset=ISO-8859-1
  • text/plain; charset=ISO-8859-1
  • text/xml; charset=ISO-8859-1
  • application/x-www-form-urlencoded; charset=ISO-8859-1
  • text/csv; charset=UTF-8
timeoutInSeconds STRING Optional: HTTP Connection and read-(socket) timeout in seconds. Default: 60s. If the target host takes longer to respond than the timeoutInSeconds, then the step will fail with an error. No Default: 60
rateLimitPerSecond STRING Rate Limit allows you to limit the number of calls per second, e.g. 2 calls/s (=120 calls/minute). Or 0.5 calls/s means 2 seconds delay after each call. Default: Empty = No limit. No
numErrorsToStopFlow STRING Optional: Specifies the number of errors or timeouts which can happen before the flow will abort with an ERROR. Default: 3. It is recommended to leave this value small. If you experience slow responding hosts, try to decrease the batchSize first. No Default: 3
sslCertificates STRING Expert Setting for https-urls: Under normal circumstances, URLs which have only a self-signed SSL certificate will result in an error. You can prevent the error by setting this to 'Trust self-signed SSL Certificates'. But this can be a security risk, because malicious sites can abuse this to steal sensitive information. Only use this, if you know what you are doing!!! No
  • Do not trust self-signed SSL Certificates (default) (Default)
  • Trust self-signed SSL Certificates (Security Warning)

Outputs

Name Type Description
requests SPREADSHEET A SPREADSHEET containing the URL, requestBody and the HTTP-Status code of each request.
output FILELIST A FILELIST containing the content of each request.

Need help or project support?

If you need help during setup of this step or a project then reach out to our certified partners. Find Partners

More steps steps in Professional


Name Version Description Use-Case
WebDAVRename
WebDAVRename
- This step renames a single file or a list of files on a WebDAV-Server. You can also move the file(s) into a existing subfolder.
FTPRename
FTPRename
- This step renames a list of files on FTP. Currently there are two modes which are support: 1. Rename a single file to a new fileName or prefix the oldfilename Here you need to specify the input parameter remoteFilename and the parameter newRemoteFilenamePrefix or newRemoteFilename 2. Rename a list of files using a prefix which will be infront of the new Filename (e.g. [DONE_]OLDFILENAME.xml) Here you need to input a List which currently needs to be the result of another service which is executed before this step.
send or upload Files
FlowTrigger
FlowTrigger
- A step which can trigger another flow asynchronously. The run will count as a separate run. It can be used to execute a sub-process with a pause or delay.
WebDAVUpload
WebDAVUpload
- This step upload files to a WebDAV-Server.
send or upload Files
XMLReader
XMLReader
- Reads a XML file into a Spreadsheet object.
XML Data
SpreadsheetUrlDownload
SpreadsheetUrlDownload
- This step can download content from multiple URLs based on a SPREADSHEET or SPREADSHEET list. Use it to connect to various kinds of Webservice APIs.
execute and receive data by HTTP-Requests , execute and upload data by HTTP-Requests
JSONReader
JSONReader
- Reads a JSON file into a Spreadsheet object.
JSON data
UrlDownload
UrlDownload
- This step accesses an URL and downloads the content. The result is String value.
execute and receive data by HTTP-Requests , execute and upload data by HTTP-Requests
XMLSplitter
XMLSplitter
- Split a large XML File into multiple smaller XML files.
XML Data
KeyValueSpreadsheet
KeyValueSpreadsheet
- Converts a Spreadsheet into a special Spreadsheet which can be used as a key-value map.
FlowExecutingStep
FlowExecutingStep
- A step which can execute another Flow.
Archive
Archive
- Compresses a single FILE or a FILELIST into a ZIP-archive.
FTPSingleFileDownload
FTPSingleFileDownload
- This step downloads one single file from FTP. Currently you can specify a filenamePrefix and suffix to filter for the files you want to download. If there are multiple files which match the criteria only the first one is taken. The files will be ordered by descending modification date on FTP so the latest file would be taken out of a list.
receive or download Files
FTPDownload
FTPDownload
- This step downloads files from FTP. The result is a list of files. Currently you can specify a filenamePrefix and suffix to filter for the files you want to download.
receive or download Files
AddUpdateMappingset
AddUpdateMappingset
- Creates or updates a mappingset based on 2 columns of a Spreadsheet.
EmailSend
EmailSend
- This step sends a single email.
send Messages
ToList
ToList
- Creates a list of serveral inputs.
APICall
APICall
- Makes an API Request. Supports parsing of XML/JSON responses and pagingation.
execute and receive data by HTTP-Requests , execute and upload data by HTTP-Requests
FTPUpload
FTPUpload
- This step uploads a list of files to a FTP.
send or upload Files
XMLReaderVisual
XMLReaderVisual
- Reads XML file into a Spreadsheet object.
fetch XML Data
WebDAVDownload
WebDAVDownload
- This step downloads files from a WebDAV-Server. The result is a list of files.
receive or download Files
ExtractArchive
ExtractArchive
- Extracts (decompresses) an archive (ZIP,TAR,TARGZ,GZ,7z,LZMA)-archive into a FILELIST (Unzip)
receive or download Files
FTPRemove
FTPRemove
- Deletes a file or filelist from FTP or SFTP server. Hinweis: Die Benutzung des FTPRemove Steps erfolgt auf eigene Gefahr. Falsche Konfiguration kann zu Datenverlust führen. Wir übernehmen keine Haftung für Datenverlust der durch falsche Konfiguration entsteht. Wir empfehlen stattdessen den Step FTPRename zu nutzen, und die Dateien z.B. in einen "archive" Ordner zu verschieben und mit einem Datum zu versehen und diesen regelmäßig per Hand zu sichten und ggf. zu löschen. Das ist gängige Praxis und hat den Vorteil, dass sie eine Historie sowie Backup der verarbeiteten Daten haben.
JSONReaderVisual
JSONReaderVisual
- Reads JSON into a Spreadsheet object providing a simple graphical User-Interface.
fetch JSON data