Attribute Editor
Introduction
The Attribute Editor can manipulate the attribute structure of an Entryset. Specifically, it can add, delete, reorder, rename, combine or hide attributes sourced from two separate entrysets. Furthermore, it can manipulate the mapping of a "source" entryset attribute to a "resulting" entryset attribute using each "resulting" attribute's dynamically generated input connectors. These input connectors are created in the "Set Source Attribute For Output Attribute" input menu. They allow you to alter the attribute structure of an entryset from the Viewer. This can permit, for example, graphing different attributes of an entryset in a single XY Graph. The attribute editor can be used to switch the values displayed on the second, y-axis attribute.
The Attribute Editor keeps track of the mappings between source and target attributes once they have been defined and will do its best to maintain them. If the source entryset is removed from the input to the Attribute Editor, it will revert the source of the defined mappings to "None." If the connection is then reestablished, the Attribute Editor will reenable the mappings as they were originally defined.
Additionally, the mapping of the "source" entryset to the "resulting" attribute can be configured dynamically via an input "configuration" entryset. The Set Configuration Entryset input takes an entryset with two attributes, "Target" and "Source" and replaces the contents of the "Resulting Entryset" list in the Property Panel. There is no provision for manipulating the hidden status of the output entryset via the "configuration" entryset. When using the "configuration" entryset, all output attributes are visible. Using a "configuration" entryset makes it impossible to reference any "secondary input" entryset items. The "secondary" entryset inputs are disabled whenever a "configuration" entryset is connected to the Attribute Editor and are re-enabled once the "configuration" entryset input connection is dropped.
Property Panel:
Source Entryset Attributes
Select an attribute in this list and click the "Add To Resulting Attribute" button to add that attribute to the resulting entryset. You can add the entire entryset or specific attributes.
- Attribute
- The attribute in the source entryset.
- Hidden
- Whether the attribute is hidden or not.
Resulting Entryset
An ordered list of the attributes as they will appear in the entryset on the "Get Resulting Entryset" output connector. Select an attribute and click the "Up" or "Down" button to change its position in the ordering of attributes. Select an attribute in the list and press the "Delete" key to remove it from the resulting Entryset.
- Attribute
- An editable text field which determines the name of the attribute in the resulting entryset.
- Hidden
- This check box designates whether or not the attribute is visible in the resulting entryset or not.
- Source
- Select from the drop-down menu specify which Attribute in the source Entryset this Attribute will receive its data from. Select "None" to create a new, empty Attribute.
Input Menu:
Set Primary Entryset
Sets the primary source entryset that can be used to generate the resulting entryset.
Accepted Datatypes:
- Entryset
Set Configuration Entryset
Set's a "configuration" entryset which allows Source to Target attribute mapping to be configured dynamically. The entryset must have two attributes, "Target" and "Source". This entryset replaces the contents of the "Resulting Entryset" list in the Property Panel.
Accepted Datatypes:
- Entryset
Set Secondary Entryset
Sets another source entryset that can be used to generate the resulting entryset. This additional entryset input allows two entrysets to be combined into one.
Accepted Datatypes:
- Entryset
Output Attribute Settings → Set Source Attribute For [Attribute] (Dynamic Menu)
Sets which source attribute the [Attribute] in the resulting entryset obtains its data from.
Accepted Datatypes:
- Text
- The name of an attribute in the source entryset.
Output Menu:
Get Resulting Entryset
Gets the resulting entryset with the newly defined attribute structure.
Output Datatype:
- Entryset
Triggered By:
- Input Message:
- Output Attribute Settings → Set Source Attribute For [Attribute]
- Action:
- Fire-On-Connect