Difference between revisions of "Using a Databox - Read"

Revision as of 14:12, 31 January 2018

Home > Databoxes > Using a Databox - Read

Using a Databox - Read

Data held in a Databox can also be ‘read’. Reading from a Databox allows the data to be used elsewhere. For example, it may be data that is to be: •used in a message •used in a task •read so that the data can be manipulated and then written to another Databox

To read data from a Databox, open the Script in Edit mode and select the Databox - Read option from the Item Type drop down list in the Navigation Pane. The list of Databoxes that can be read from is displayed. Select the Databox and drag it onto the Script to the position required.

Example: We will use a Databox to read the Keyfax User Name from the Import XML and then write it into the Additional_Info node of the Export XML.

For this, we will use an Import XML Databox called ‘UserCode’.

In the Navigation Pane select the Databox ‘UserCode’ from the Databox- Read option in the Item Type drop down list, and drag it across to the required position in the Script grid.

This shows the ‘UserCode’ Databox being placed at the start of the Script.

Next, we need to specify where the data is to be placed once it has been read. In this example, we will write it to the Additional Info node of the Export XML. To do this, select the Databox - Write option from the Item Type drop down list in the Navigation Pane and drag the ‘Additional_Info’ Databox onto the Import.UserCode Databox. This will result in the Databox – Write action being placed against the read action.

This will now read the User code of the Keyfax User and then write it to the Additional Info node in the Export XML.

Running through the Scripts with a User Code of TOM will result in the Additional Information node being populated with ‘TOM’. As the ‘Additional Information’ section of the Keyfax Results screen reads from this node, it will be visible on the Results screen.