In select BlueConic connections, you can use the JavaScript data processor to apply custom-written JavaScript code functionality to a data source.
Adding this data processor to your tenant
To use this processor, you first need to add it to your tenant by navigating to BlueConic settings > Plugins, clicking the Add plugin button at the top right, and registering the following external URL:
For more detailed instructions, review the article Overview: What are BlueConic plugins?. And if you need further assistance, reach out to BlueConic Support.
Adding this data processor to a connection
The JavaScript data processor is available in all BlueConic connections that use data processors. Review the complete list of BlueConic data processors.
Each of these connections has a specific step on its import and/or export goal page to add data processors (e.g., "Correct your files before the import," "Modify your data before the export"). In that step, use the search box to add "JavaScript"; once added, it appears in a numbered list of data processors activated for that connection.
For more information, review the full article Using data processors with BlueConic connections.
Configuring this data processor
The JavaScript data processor requires some configuration to ensure that BlueConic imports or exports the data as specified. To make these configurations, click the cogwheel icon next to "JavaScript" in the numbered list of data processors. This opens a window with the following settings:
Description: Enter a custom description for your JavaScript code functionality.
Code editor: Input your JavaScript code that will be applied to your data source. The object “data” should be used for your functions. The functions “getValue(dataObject, dotExpression)” and “getValues(dataObject, dotExpression)” can be used to retrieve data.
Test JavaScript: Press this button to test your JavaScript code for errors.
Additional target fields: Optionally specify any additional data fields created within the JavaScript code to be used in the mapping step. For example, if you add ”extra_prop” as a new property to the data source, you have to specify “extra_prop” as an additional target field that will then be available in the mapping step. You can add an additional target field by manual input or automatic detection from the code.
Click OK to save your settings and apply the data processor to your connection.
Deep Dive into the JavaScript Data Processor
For a technical deep dive into how the JavaScript data processor works, see the JavaScript Data Processor Deep Dive page.