"Get File" node

You can use the Get File node to transfer the files from your server to the workflow using HTTP protocol.

• Maximum file size: 5 GB (5 000 000 000 bytes).

Node configuration

Set up a connection

In this part of the process, you must define how you will get access to your source. By selecting the authentication method and providing required information, you establish a connection.

1. Select HTTPS > Get File.

   

2. Select the authentication method:

   • No authentication - No authentication is required.

   • Login & Password - This method lets you use basic authentication to authenticate with the remote server.
     

     Click here to see the instructions

     1. Click Select connection.
     2. If the connection you want to use is in the list, select it and proceed to Filling out the configuration form.
        • If the connection list is empty or you don’t see a connection, you must:
          1. At the bottom of the dropdown list, click Add connection.
          2. In the Connection name field, enter the name of your connection (it’s visible only on the Select connection dropdown list).
          3. In the Login field, enter a login.
          4. In the Password field, enter the password.
          5. Click Create.
             The connection you created can be used later in other nodes and workflows.

   • Synerise API key - This method is particularly recommended for the users who use Synerise REST API. It lets you select a connection that includes an API key with the required permissions. This way, the requests to Synerise API are executed by this integration and a JWT is not required as it is generated while sending requests and attached to the request headers.

     Click here to see the instructions

     1. Click Select connection.
     2. If the connection you want to use is in the list, select it and proceed to Filling out the configuration form.
        • If the connection list is empty or you don’t see a connection, you must:
          1. At the bottom of the dropdown list, click Add connection.
          2. In the Connection name field, enter the name of your connection (it’s visible only on the Select connection dropdown list).
          3. From the API key dropdown, select the API key.
          4. Click Create.
             The connection you created can be used later in other nodes and workflows.

   • OAuth2 Client Credentials - This method lets you use your OAuth2 credentials to authorize.

     Click here to see the instructions

     1. Click Select connection.
     2. In the connection list:
        • If the connection you want to use is in the list, select it and proceed to Filling out the configuration form.
        • If the connection list is empty or you don’t see a connection, you must:
          1. At the bottom of the dropdown list, click Add connection.
          2. In the Connection name field, enter the name of your connection (it’s visible only on the Select connection dropdown list).
          3. In the Token endpoint URL field, enter the URL used to obtain an access token from the authorization server.
          4. In the Client ID field, enter a unique identifier assigned to your application by the service provider.
          5. In the Client secret field, enter a confidential key issued alongside the Client ID. It is used to securely authenticate your application.
          6. Optionally, in the Scope field, define the level of access your application is requesting. Scopes specify which actions or data your application can access (for example, read user data, send messages). Refer to the API documentation for the correct scope values.
          7. Click Create.
             The connection you created is saved and can be used later in other nodes and workflows.

Fill out the configuration form

1. From the Method dropdown list, select the method.

2. In the URL field, enter the endpoint.

3. From the File format dropdown list, select the format of the file:

   • XML Feed
   • JSON
   • JSON Lines
   • CSV - Provide the details on how to format the imported file:
   1. From the Delimiter dropdown, select the character that marks the end of a column.
   2. From the Quotation mark dropdown list, select the characters that contain the text or data type.
   3. From the Escape character dropdown lists, select the character changes the default interpretation of a character or a string followed by the character.

4. In the Headers fields, define request headers required by the HTTP API.

5. Confirm the settings by clicking Apply.

Examples of use

In this example, you can launch a workflow which retrieves a Synerise catalog by means of HTTPS protocol and send it further to a SFTP server. If needed, the workflow can perform a transformation of data retrieved from the catalog in order to meet data structure requirements in the SFTP server.

1. Add the Scheduled Run node.
2. In the configuration of the node, set it to immediately.
3. Add the Get File node by clicking THEN > HTTPS.
4. In the configuration of the node:
   1. Select the authentication method.
      • If no connections are available or you want to create a new one, see Add connection.
      • If you selected an existing connection, proceed to defining the integration settings.
   2. Leave the method at default (GET).
   3. In the URL, enter the address of the endpoint (you can get it here
   4. As a file format, from the dropdown list, select CSV file.
   5. Verify the following fields: Delimiter, Quotation mark, Escape character, Charset, Line ending.
   6. Configure settings for the Headers section.
   7. Confirm by clicking Apply.
5. Optionally, you can add the Data Transformation node to modify the data retrieved from the catalog to comply with the data structure standards in your SFTP.
6. Add the Send File node by clicking THEN > SFTP.
7. In the configuration of the node:
   1. Select the authentication method.
      • If no connections are available or you want to create a new one, see Add connection.
      • If you selected an existing connection, proceed to defining the integration settings.
   2. Enter the URL to the server.
   3. Enter the path to the directory.
   4. Enter the name of the file under which you want to send the data to the server.
   5. Select the format of the file.
   6. Confirm by clicking Apply.
8. Add the End node.