Tag: Select
The Select
action, along with the applicable SetParam options, lets you automate the selection of servers and/or databases within the selection trees found in aclEZ, databaseEZ, agentEZ, and replicationEZ.
<select target="tree" Database="MyPath\orphan.nsf"/>
Note | 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, design trees in mono-database products, and scanEZ's selection tree, please look at these pages:
Tag Attributes
Attributes | Attribute Value | Value Description | Comment |
Target | Tree | | Mandatory – see detailed description |
Server | User definable server name | | Mandatory* when using replicationEZ |
Database | User definable database file name | | |
Replica ID | User definable Replica ID | String representation of the database Replica ID | |
Folder | User definable folder name | User defined folder name (with path for subfolders) | |
Detailed Description
In any application where there is a Databases panel/server tree, the
Select
action, a
Target
attribute value of
"Tree"
, and the applicable attribute/value combination for the desired selection will emulate the selection of server/database tree nodes in the UI and will trigger all relevant actions.
When selecting databases using attributes
ReplicaID or
Database all nodes containing databases with matching Replica IDs including all duplicate databases will also be affected.
Example Script
<YtriaAutomation Version="1.0" Application="replicationEZ" ApplicationVersion="16.5.0" Console="True">
<Load Server="ACME01/ACME"/>
<Load Server="ACME02/ACME"/>
<Unselect Target="Tree" Server="All"/>
<select target="tree" Server="ACME01/ACME" Database="log.ntf"/>
<select target="tree" Server="ACME02/ACME" ReplicaID="852561D4:006BAEBA"/>
</YtriaAutomation>
In the script above, servers "ACME01/ACME" and "ACME01/ACME" will be loaded into replicationEZ's selection tree, and all possible residual selections will deselected. The Select
action will be used two separate times: The first line will select the database "log.ntf" on ACME01/ACME and its replica on ACME02/ACME if this exists. The second line will select the database matching the Replica ID of "852561D4:006BAEBA" on ACME02/ACME and its replica on ACME02/ACME if this exists. The databases and their replicas that have been selected will be loaded into the main grid.