Tag: RenameItems

The RenameItems action, along with the applicable SetParam child actions, lets you automate the Rename Items process launched by clicking on the 'Rename' button found in the Diff/Values panel in scanEZ.


<RenameItems>
	<SetParam field="Source" value="Form1;Form2;Form3"/>
	<SetParam field="Target" value="FormA;FormB;FormC"/>
	<SetParam field="NoTrim" value="True"/>
</RenameItems>
XML

SetParam Options

Field NameCompatible Field ValuesValue DescriptionComment
SourceUser definableSource item names. Separate multiple field names with a semicolon.Mandatory

The order of Source item names will be matched with Target item names.

TargetUser definableThe names for the target items. Separate multiple field names with a semicolon.Mandatory

The order of Target item names will be matched with Source item names.

NoTrimTrue/FalseThe state of the Advanced option checkboxNot Mandatory

Example Script

<?xml version="1.0" encoding="UTF-8"?>
<ytriaAutomation Application="scanEZ" ApplicationVersion="16.5" Version="1.0">
	<Load Server="ACME01/ACME">
		<Load Database="dbtest\maildbtest.nsf" Select="True"/>
	</Load>
	<focus target="tree" category="Documents" type="Reponse"/>
	<RenameItems>
		<SetParam field="Source" value="Form1;Form2;Form3"/>
		<SetParam field="Target" value="FormA;FormB;FormC"/>
		<SetParam field="NoTrim" value="True"/>
	</RenameItems>
</ytriaAutomation>
XML

In the script above, the database "dbtest\maildbtest.nsf" will be loaded and the selection tree focus placed on the "Response" document category in the selection tree. The RenameItems action will be launched, renaming the fields "Form1", "Form2", and "Form3" to "FormA", "FormB", and "Form3" respectively with the option to not automatically trim the entered field names enabled.