Tag: TreeSelectionLive

The self-closing tag TreeSelectionLive sets the database tree selection mode. This is only applicable in single-server tools.

<TreeSelectionLive Value="True"/>
XML

Tag Attributes

AttributesAttribute ValueValue DescriptionComment
ValueTrue/False

N/A

Not Mandatory

Detailed Description

When Value is set to False, Tree selections will not be live and will suspend updates in the application (e.g. displaying entries in grid, etc.) until a subsequent <TreeSelectionLive Value="True"> action is encountered in the script.

In this case, the update happens only once, in its entirety, when the action is encountered.
This allows a selection of a large number of databases in a selection tree without any delays of having to wait for grid updates for each selection.

Example Script

<?xml version="1.0" encoding="UTF-8"?>
<ytriaAutomation Application="databaseEZ" ApplicationVersion="16.5">
	<TreeSelectionLive Value="False"/>
		<Load Server="Acme01/ACME">
			<Load Database="mail\jwill.nsf" Select="True"/>
			<Load Database="mail\jdoe.nsf" Select="True"/>
			<Load Database="archive\a_log.nsf" Select="True"/>
			<Load Database="log.nsf" Select="True"/>
			<Load Database="names.nsf" Select="True"/>
			<Load Database="mail.box" Select="True"/>
			<Load Database="admin4.nsf" Select="True"/>
			<Load Database="cldbdir.nsf" Select="True"/>
			<Load Database="ddm.nsf" Select="True"/>
			<Load Database="catalog.nsf" Select="True"/>
			<Load Database="schema.nsf" Select="True"/>
			<Load Database="certsrv" Select="True"/>
			<Load Database="reports" Select="True"/>
		</Load>
	<TreeSelectionLive Value="True"/>
</ytriaAutomation>
XML

In the script above, the loading of all the databases will be executed, but the grid UI will not be updated until the <TreeSelectionLive Value="True"/> line is encountered.