Plug-ins User Guide

Version 5.2 | Published March 20, 2024 ©

DataPool Hierarchy

DataNodes and DataFields

DataPool is a hierarchical data structure composed of DataFields and nodes. DataFields are the lowest level of the hierarchy. The DataFields don’t have children. Nodes are groups of DataFields. The DataPool hierarchy has a root node. Each of the DataFields in the hierarchy has a parent node, either the root node or any other sub-level node.

Example 1

The following example shows a hierarchy with a root, two nodes (NA and NB) and six DataFields. As can be seen each of the DataFields reside below a node. Setting the value of the DataField FA under the node NA follows the hierarchical structure to the required DataField:

NA/FA=<some information>;

In the case of field FC under NB:

NB/FC=<some other information>;

images/download/attachments/57231084/architecture_datanodes-1.png

To set the data of all DataFields under the node NB, the following commands are sent:

NB/FA=<info for A>;
NB/FB=<info for B>;
NB/FC=<info for C>;

Note that there is a certain amount of redundancy because NB appears three times. To avoid using the node name every time, the following alternative format is used:

NB={
FA=<info for A>;
FB=<info for B>;
FC=<info for C>;
};

The brackets determine the scope of the contained statements. In the above command the statement "FA=<info for A>;" is in the scope of object NB.

Example 2

Consider the following example:

images/download/attachments/57231084/architecture_datanodes-2.png
In this example NB has a child node called NC. To set data to the field FB under NC the following command is sent:

NB/NC/FB = <info for B>;

In order to populate all the fields in NC:

NB/NC= {
FA = <info for A>;
FB = <info for B>;
};

If we want to populate the whole hierarchy with data in one command:

NA = {
FA =<info for A>;
FB=<info for B>;
FC=<info for C>;
};
NB = {
FA =<info for A>;
FB=<info for B>;
NC = {
FA=<info for A>;
FB=<info for B>;
};
};