Select - Making Design Tree Selections

Tag: Select

The Select action, along with the applicable SetParam options, lets you automate the selection of design elements within selection trees found in viewEZ, signEZ, designPropEZ, actionBarEZ.

Detailed Description

To automate selections in any design tree, the values of for SetParam options NoteID, Name, and Alias can be specified in child actions.

SetParam Options

Field Name	Compatible Field Values	Value Description	Comment
NoteID	The NoteID in either decimal or hexadecimal format prefixed with an "h" or "H"	N/A	N/A
Name	User defined OR set value All	The text displayed in tree node Will select everything in the tree	Case insensitive "All" value depends on the current language of the product.
Alias	User defined	The Last Alias of the design	N/A

Example Scripts

XML

<Select>
	<SetParam NoteID="hC9A"/>
	<SetParam NoteID="h18FA"/>
</Select>

The Select action can be used for selecting entries within trees and grids; the selection mechanics, attributes and compatible values, and the attributes and SetParam options are different depending on what you need to select.

For selections in grids, server/database trees in mono-server and multi-server products, and scanEZ's selection tree, please look at these pages:

Selections in grid rows
Tree selections in multi-database and multi-server tools
Selections in scanEZ`s selection tree

XML

<YtriaAutomation>
	<Load Server="ACME01/ACME" Database="mail\daltmann.nsf"/>
	<Unselect>
		<SetParam Name="All"/>
	</Unselect>
	<Select>
		<SetParam NoteID="hCC6"/>
		<SetParam Name="($ApptUNID) [en]"/>
	</Select>
	<OpenColumns KeepAlive="True">
		<Add ColumnID="C1" Position="2"/>
		<Add ColumnID="C6" Position="3"/>
		<Add ColumnID="C7" Position="4"/>
	</OpenColumns>
</YtriaAutomation>

In the script above, the views within the mail database "daltmann.nsf" will be loaded into the selection tree of viewEZ. The Select action will select the views specified within its SetParam child actions: NoteID hCC6, and the view with the name ($ApptUNID)[en]. The 'Columns…' grid will be opened showing the column properties of these two selected views, and the grid columns with ColumnIDs of C1, C6, C7 will be added and placed in the grid position 2,3, and 4 respectively. The 'Columns…' grid dialog will stay open.