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
<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
<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.