"Send File" node

The integration between Synerise and Azure Blob Storage opens up possibilities of exporting data collected in Synerise. By means of the Send file node, you can push data from Synerise to add save it as a blob in your Azure storage. You can use this connection in various scenarios such as exporting transactions, event data, customer information (such as marketing agreements), results of metrics, aggregates, expressions, reports, and many more to Azure Blob Storage.

Prerequisites

You must have an account on Azure AD.

Node configuration

1. Click Azure Blob Storage > Send File.
2. Click Select connection.
3. From the dropdown list, select the connection.
   • If no connections are available or you want to create a new one, see Create a connection.
   • If you selected an existing connection, proceed to defining the integration settings.

Create a connection

To allow the data exchange, establish a connection between Synerise and Azure Blob Storage.

1. At the bottom of the Select connection dropdown list, click Add connection.
2. In the Blob SAS URL, enter the Blob shared access signature (SAS) URL that allows access to a storage account and/or containers and blobs. You can generate it in your Azure AD account.
3. Confirm by clicking Apply.

Define the integration settings

In this step, fill in the form that allows you to send data from Synerise to Azure Blob Storage.

1. In the Container field, enter the name of an existing container in your storage.
   If this field is already filled out, it means that the URL used in the connection settings contains the name of the container.
2. In the Blob name field, enter the name of the blob (file) you want to send to the storage.
   If this field is already filled out, it means that the URL used in the connection settings contains the name of the blob. In such case, the contents of the blob will be overwritten.
   You can use Jinjava in this field.
3. From the File format dropdown list, select the format in which the file will be saved in the storage. If you select the CSV [*.csv] option, follow the instructions below:
   1. From the Delimiter dropdown, select the character that separates fields in a row.
   2. From the Quotation mark dropdown list, select the characters that contain the text.
   3. From the Escape character dropdown list, select the character which changes the default interpretation of a character or a string followed by the character.
   4. From the Line ending dropdown list, select:
      • Line feed - This option shifts the cursor to the next line vertically.
      • Carriage return and line feed - This option points the cursor to the beginning of the line horizontally and shifts the cursor to the next line vertically.
   5. The No Byte Order Mark option is currently unused.
   6. To wrap the values with characters selected in the Quotation mark field when the delimiter occurs in the value, select the Quoting style only if required option. For example, for the following values:
      - one
      - two,three,four
      The output with the enabled Quoting style only if required option will be as follows:
      • “one”,
      • “two,three,four”
4. Confirm by clicking Apply.

Example of use

You can create a workflow that is triggered one time in order to export the customer database (email addresses and newsletter agreements) to the storage.

As a prerequisite for this example, create a segmentation of customers who have email addresses and enabled newsletter agreements. This segmentation will be used in the Get Profiles node that will be a part of the workflow.

In the configuration of the workflow:

1. Start the workflow with the Scheduled Run node. In the configuration of the node, set the Run trigger to one time. Select the Immediately tab.
2. To retrieve customers data to the workflow, as the next node, select Synerise > Get Profiles. In the configuration of the node:
   1. Select a segmentation from which you want to extract customers’ data.
   2. Select the customer attributes to be exported. In this example, it’s an email address and email marketing agreement.
3. To send the file with customers data, add Azure Blob Storage > Send File. Fill in the configuration form in the node.
4. Add the End node.
   Result: