Ytria logo DOCUMENTATION
⚠ This page requires javascript enabled in browser
Automation / All products Automation / Tree Actions

 

Tag: Unselect

The UnSelect action, along with the applicable SetParam options, lets you automate the deselecting of servers and/or databases within the selection trees found in aclEZ, databaseEZ, agentEZ, and replicationEZ.

<Unselect target="tree" Database="MyPath\orphan.nsf"/>


NoteThe Unselect action can be used for deselecting 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

AttributesAttribute ValueValue DescriptionComment
TargetTreeMandatory – see detailed description
ServerUser definable server nameMandatory* when using replicationEZ
DatabaseUser definable database file name
Replica IDUser definable Replica IDString representation of the database Replica ID
FolderUser definable folder nameUser defined folder name (with path for subfolders)

Detailed Description


In any application where there is a Databases panel/server tree, the Unselect action, a Target attribute value of "Tree", and the applicable attribute/value combination to target the desired selection will emulate deselecting server/database tree nodes in the UI and will trigger all relevant actions.

When deselecting databases using attributes ReplicaID or Database, all nodes containing databases with matching Replica IDs, including all duplicate databases, with.

Example Script

<YtriaAutomation Version="1.0" Application="replicationEZ" ApplicationVersion="16.5.0" Console="True">
<Load Server="ACME01/ACME"/>
<Load Server="ACME02/ACME"/>
<select target="tree" Server="ACME01/ACME" Database="log.ntf"/>
<select target="tree" Server="ACME02/ACME" Database="archlg50.ntf"/>
<Select Lines="All"/>
<Export>
<SetParam field="FilePath" value="D:LogAudit.html"/>
<SetParam field="ExportType" value="HTML"/>
<SetParam field="SelectedRowsOnly" value="true"/>
</Export>
<Unselect Target="Grid" Lines="All"/>
</YtriaAutomation>

In the script above, servers ACME01/ACME and ACME02/ACME will be loaded into replicationEZ's selection tree. The Select action will be used three separate times: The first line will select the database "log.ntf" on ACME01/ACME and its replica on ACME02/ACME (if this exists), and the second line will select the database "archlg50.ntf"on server ACME02/ACME and its replica on ACME01/ACME (if it exists). All databases and replicas that have been selected will be loaded into the main grid. All lines within the main grid will be selected and a report exported from the grid data. The Unselect action will then unselect all lines within the main grid.