Building stream-to-tree production objects

The stream-to-tree production object comprises existing stream field objects and tree output node component objects defined to include all information required to generate schema. Nodes describe the structured output required for stream-to-tree and tree-to-tree production objects. Each node component object is a hierarchical list of child objects of the same type. You can also attach a list of attributes represented by the attribute object.

Defining tree output nodes

Click New below the Tree Output Nodes pane.

When the Node Component Information window opens, complete the fields and options as follows:

Name – enter the name of the current node component.
Node – enter the physical NDO data node name.

Node Type – select one of the options to create a branch node. This disables the data source selections unless you are creating a repeating node:

Option	Description
Branch	Create a branch node. When you select branch node, you can make the branch invisible or alternative. The initial node cannot be invisible. Invisible – checks if the NDO node is invisible. Describes a logical node used to group a set of nodes. Alternatives – checks if the NDO node is alternative. Set this property to describe mutually exclusive child nodes beneath a parent.
Clone	Copy the input node to the output tree, inheriting all attributes and child nodes.
Leaf	Create a leaf node. When you select a leaf node, select a datatype from the drop-down list that displays.

Option

Description

Branch

Create a branch node. When you select branch node, you can make the branch invisible or alternative. The initial node cannot be invisible.

Invisible – checks if the NDO node is invisible. Describes a logical node used to group a set of nodes.
Alternatives – checks if the NDO node is alternative. Set this property to describe mutually exclusive child nodes beneath a parent.

Clone

Copy the input node to the output tree, inheriting all attributes and child nodes.

Leaf

Create a leaf node. When you select a leaf node, select a datatype from the drop-down list that displays.

Data Source (only for leaf nodes) – select the source of node data for leaf nodes:

Option	Description
Field	Assign an input field’s data to the output node. When you select Field, select Data or Attribute, then from the attributes list, select the associated attributes. To create node attributes, assign the following properties to the attribute object—name, data source (stream or tree field object, literal, or datalink), qualification list, and filter list.
Datalink	The output node data comes from a selected variable.
Literal	The output node data is a literal value that you enter in the field that displays by this option.
None	No data. Run the output node with no data or with a filter.

Repeats – select this option to indicate that the node is repeating. If you select repeating, also indicate the maximum number of instances. Add an optional break qualification to stop iteration when a certain condition is met. Select Use Field Object info and select a field object name in the Field drop-down list only if repeating data is retrieved from the input transaction. You can also select other data sources for a repeating node.

When the Alternatives property is set, its associated child nodes may not be repeating. A qualification attached to this child node becomes the rule for whether the child node is selected to produce the output data. If a qualification on the child is not set, production fails. Repeating nodes can be built from groups or repeating tree field object. The number of instances is determined using the maximum number of instances property, number of instances of the source field or node, and optionally break qualifications.
Filters (only for leaf and branch nodes) – select or create filters that apply to leaf and branch nodes.