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.

atd_dialog_localvar.gif

 

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.