Exporting Data to a Json File
The Export to Json task exports datasets or other Rulex structures to a series of JSON files.
The following additional tabs are provided:
Remote connections tab where you can configure the connection to the remote location where the file will be exported.
Documentation tab where you can document your task
Parametric options tab where you can configure process variables instead of fixed values. Parametric equivalents are expressed in italics in this page (PO).
Drag and drop the Export to Json task onto the stage.
Connect a task, which contains the data you want to export, to the new task.
Double click the Export to Json task.
Configure the task options as described in the table below in the Options and File Format tabs.
Save and compute the task.
Export to Json File options
Data to be exported
Select what type data you want to export from the list of options.
Possible options are:
Select how you want to save the file, either by storing it in a location you will then specify, by sending the file as an e-mail or both ways.
If you select to send the file by e-mail, you must then specify the e-mail address in the Recipients for export via email edit box.
Select whether the file will be saved locally (Local File System) or remotely (Http Remote API, SharePoint, HDFS, AWS S3, FTP, Azure Storage).
From version 4.7 of Rulex, API responses from HTTP calls can be redirected to external sources, such as SharePoint and S3. The response path corresponds to the filename, with the complete path for local file systems, and the remote directory for external sources.
Note: if you chose to save the file remotely you must also configure the Remote Connection parameters in the Remote Connections tab.
Enter or browse to the directory where the file will be saved.
If you are exporting to an Azure Storage repository you can either:
Enter a name for the file that will be exported.
Add current date and time as prefix
If selected, the date and timestamp will be added to the start of the file basename as a prefix.
Add current date and time as suffix
If selected, the date and timestamp will be added to the end of the file basename as a suffix.
Append data if already exists
If selected, data will be appended to the specified basename if the file already exists, otherwise the original data will be overwritten.
Recipients for export via email (use comma as separator)
Specify the email addresses where the exported file will be sent, separated by commas.
This option will only be valid if you have selected Send via email or Both in the Mode option.
File Format options
Select the format in which you want to export the file: flat, nested or according to the group column.
If you select the group option, you must have selected the Group Column option when importing the Json file, in order to create a column which identifies the group of each tag.
If you did not select this option in import, Rulex will not be able to identify which group each tag belongs to, and consequently a single group will be created in export.
Key for types
Specify the attribute which defines the data type.
Remove missing values
If selected, missing records are removed from the exported file.
Specific use case: exporting an HTTP response to SharePoint
When exporting an HTTP response to SharePoint, you do not need to only specify the HTTP Server connection parameters, but also the SharePoint connection parameters.
This means that, when following the procedure, you need to insert information on the connection for both the HTTP Server and SharePoint.
You will find all the operations to perform in the procedure below:
In the Export to Json File task, in the Options tab, select HTTP Remote API in the Export URI text box.
In the Remote Connections tab, configure the HTTP API as follows:
Choose the Authentication type and fill the connection information required.
In the Response URI drop down menu, select SharePoint.
In the Response file path, write the SharePoint path where you want the file to be saved.
In the Remote Connections tab, configure the SharePoint connection info required.
Save and compute the task.