Tag: TreeSelectionLive

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

<TreeSelectionLive Value="True"/>

Tag Attributes

AttributesAttribute ValueValue DescriptionComment


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"/>
	<TreeSelectionLive Value="True"/>

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.