Attach to Variable Data

From the Object Properties window you can access the Attach to Variable Data dialog, which is used to connect an object property to a variable. Variables can be updated by “Control Objects” allowing you to control the values in other objects in your RTView display. See “Add/Edit Variables” for details on creating variables.

When an object property is attached to data, the Property Name and Value in the Object Properties window will be displayed in green. This indicates that editing this value from the Object Properties window is no longer possible. To remove the data attachment, and resume editing capabilities in the Object Properties window, right-click on the Property Name and select Detach from Data. You will recognize that an object property has been detached from the data source when the Property Name and Value are no longer green.

To bring up the Attach to Variable Data dialog, right-click on the Property Name from the Object Properties window and select Attach to Data>VARIABLE.

Variable Name	List of all available variables.
Column(s)	If the data type of the attached variable is tabular, you can select which column(s) to display.
Filter	Check box to indicate whether or not to filter the variable. Filters can only be used for tabular data.
Filter Column	Name of the column to use as a filter.
Filter Value	Value that the filter column must equal. Single or multiple values may be listed. Enter * to display all rows in the table. Enter "" to use as a literal comparative value. To list multiple values, separate with a semicolon. For example: value1;value2;value3. If your value contains a semicolon, enclose it in single quotes.

The Variable Name drop down menu lists all available local, global and include file variables. If you have not defined any variables this list will be empty. Select Tools>Variables to create a variable. See “Global Functions and Variables”, “Include Display Files”, and “Add/Edit Variables” for more information.

Validation Colors

Fields in the dialog change colors according to the information entered. These colors indicate whether or not information is valid.

The following describes the significance of the Attach to Variable Data validation colors:

White	Valid state	Entry is valid.
Red	Invalid state	Variable is invalid; or Variable is valid, but Column(s) or Filter Column selected are not.
Gray	Not Required	Field does not require a value. This applies to the Column(s), Filter Column or Filter Value field for variables that are not tabular.

The following describes the Attach to Variable Data dialog commands:

Command	Description
OK	Applies values and closes the dialog.
Apply	Applies values without closing the dialog.
Reset	Resets all fields to last values applied.
Clear	Clears all fields. Detaches object from the variable (once Apply or OK is selected).
Cancel	Closes the dialog with last values applied.