Other Downloads

Ytria software for Notes & Domino
Other downloads

scanEZ Extension database

Adds additional features to scanEZ including: open multiple documents from any HCL Notes view, plus open documents from a list of web URLs.

[scanEZ installation required]   Learn more

signEZ Server Batch Database

This optional Server Batch database contains extended functionality and allows you to include all databases on a server—including those in sub-directories.

[signEZ installation required]  Learn more

Ytria Designer Widget

This widget enables tight integration with Ytria tools and the Eclipse-based IBM Domino Designer. To install, simply click and drag the file Ytria_Designer_widget.xml to the right into the IBM Notes client My Widgets panel.
[IBM Domino Designer 8.5+ required]   Learn more

Ytria Launcher Widget

An Eclipse-based launcher for Ytria tools. To install, simply click and drag the file Ytria_Launcher_widget.xml to the right into the My Widgets panel in IBM Notes.
[IBM Domino Designer 8.5+ required]   Learn more

Download YtriaUpdate Utility

This is the application that checks for updates of your Ytria products and downloads them. This is the same application behind the ‘Check for Updates’ option included by default with your installation of EZ products. It is offered here as a separate download for those who need it.

Download

Size
34.6 MB
Version
v5.1.1.7 – 2020-10-30

HIDDEN !!! scanEZ Launcher

This extension simply provides a more convenient way to administer and develop HCL Domino web pages with scanEZ from your favourite browser.
[scanEZ installation required]   Learn more

 


Notes&Domino用のYtriaソフトウェア 日本語版。

HCL Notes & Domino 用に特化したツール
迅速なノーツ開発と効率的なドミノ運用管理に

日本語完全対応版としてご利用いただけます。
注意:試供版は英語のみのご提供になります。

EZ Suites

EZ Suite Complete 20

は HCL Notes/Domino 運用管理者および開発者のための Ytria ソフトウェア・ツールのすべてが同梱されており、一度に複数の製品のインストールを素早く完了できます。このスィートには scanEZ, aclEZ, agentEZ, databaseEZ, consoleEZ, replicationEZ, signEZ, viewEZ, actionBarEZ, designPropEZ そして formEZ を同梱。もちろん、インストールしたいツールだけ選択してインストールすることもできます。

ダウンロード

Version 
20.0.3 – Fix Release – 2020-10-20

EZ Suite Complete 16.5

は HCL Notes/Domino 運用管理者および開発者のための Ytria ソフトウェア・ツールのすべてが同梱されており、一度に複数の製品のインストールを素早く完了できます。このスィートには scanEZ, aclEZ, agentEZ, databaseEZ, consoleEZ, replicationEZ, signEZ, viewEZ, actionBarEZ, designPropEZ そして formEZ を同梱。もちろん、インストールしたいツールだけ選択してインストールすることもできます。

ダウンロード

Version 
16.5.5


EZ Suite v16.5

EZ Suite 16.5 sees the tools you love getting smarter!

Hot on the heels of the revolutionary EZ Suite 16 release, which saw the light of day earlier this year, comes an extensive update. Version 16.5 greatly increases the scope of what can be done through EZ Suite’s powerful automation capabilities and brings in many new performance enhancing functions and preferences.

Expand the scope of your EZ Suite tasks with these ready-to-use scripts.

As a quick preview of the newly expanded automation script capabilities, we have included some working scripts that you can put to use immediately. For your convenience, comments have been included as explanations of key functionalities. Feel free to change the values to meet your needs. Be sure to keep the Ytria Automation tag specifics in mind to ensure that your scripts function properly.

Script Level: Easy

Find and report all Mail Owner access levels and various connected properties and settings regarding their permissions across multiple databases on multiple servers.

This script can be used by itself in aclEZ to process a currently opened server, or with the new function found in replicationEZ that lets you launch a script on a selection of servers directly from within the interface. Learn more about this function here.
This script will parse the entire mail directory folder on a given server to find all mail owners set side by side with a selection of key properties and settings that govern access and permissions to their respective mail databases. A report will be generated and exported into an Excel file. Each access level will be reported on its own sheet within the file.

<ytriaAutomation Application="aclEZ" ApplicationVersion="16.5">
	<!--This will set the script's behavior when encountering an error. In this case, it will continue.-->
	<onerror continue="true" ></onerror>
	
	<!--First it is specified that the NAB presence is NOT to be checked and groups are NOT to be "expanded."-->
	<Option Type="PresenceInNAB" value="false"></Option>
	<Option Type="GroupExpander" value="ExpandNone"></Option>
	<TreeSelectionLive Value="True"></TreeSelectionLive>
	<!--All databases on the current server will be deselected in the tree.-->
	<unselect target="tree" server="true"></unselect>
	
	<!--Then the mail directory folder for the current server will be selected.-->
	<select target="tree" folder="mail"></select>
	
	<!--The next part of the script defines the actions to be taken within the Audit grid. The grid layout will be set as stated below. A Suspend Grid Redraw function is added so the processing will be held off until all columns are set.-->
	<SuspendRedraw value="true"></SuspendRedraw>
	
	<!--All columns are removed from the main grid in order to prepare for the columns that will be added.-->
	<RemoveAllcolumns></RemoveAllcolumns>
	
	<!--The grid columns are moved to the first position in reverse order. The name of the columns are indicated.-->
	<Add ColumnID="DB6" Position="1"></Add><!-- Catalog Categories -->
	<Add ColumnID="DB4" Position="1"></Add><!-- Database Type -->
	<Add ColumnID="A9" Position="1"></Add><!-- Replicate or Copy Documents -->
	<Add ColumnID="A8" Position="1"></Add><!-- Write Public Documents -->
	<Add ColumnID="A7" Position="1"></Add><!-- Read Public Documents -->
	<Add ColumnID="A6" Position="1"></Add><!-- Create LS/Java Agents -->
	<Add ColumnID="A5" Position="1"></Add><!-- Create Shared Folder/Views -->
	<Add ColumnID="A4" Position="1"></Add><!-- Create Private Folders/Views -->
	<Add ColumnID="A3" Position="1"></Add><!-- Create Private Agents -->
	<Add ColumnID="A2" Position="1"></Add><!-- Delete Documents -->
	<Add ColumnID="A1" Position="1"></Add><!-- Create Documents -->
	<Add ColumnID="ACL4" Position="1"></Add><!-- Type -->
	<Add ColumnID="ACL1" Position="1"></Add><!-- Name -->
	<Add ColumnID="DB3" Position="1"></Add><!-- Database File -->
	<Add ColumnID="DB2" Position="1"></Add><!-- Database Path -->
	<Add ColumnID="STATUS" Position="1"></Add><!-- Status -->
	<!--Any residual grouping and sorting is cleared.-->
	<Reset></Reset>
	
	<!--A new grouping configuration is set.-->
	<GroupBy ColumnID="ACL5"></GroupBy><!-- Access -->
	<GroupBy ColumnID="DB7"></GroupBy><!-- Server -->
	
	<!--And a new sorting configuration is set.-->
	<Sort columnID="DB2" Ascending="true"></Sort><!-- Database Path -->
	<Sort columnID="DB4" Ascending="true"></Sort><!-- Database Type -->
	<Sort columnID="DB3" Ascending="true"></Sort><!-- Database Filename -->
	
	<!--A filter is added to isolate only mail owners,and then the grid processing is reactivated by turning off the Suspend Grid Redraw state.-->
	<Filter columnID="ACL3" Empty="true"></Filter><!-- Mail Owner -->
	<SuspendRedraw value="false"></SuspendRedraw>
	
	<!--The following If condition will test if the main grid has any rows loaded. If there are any rows loaded (meaning that Mail Owners were found) the nested child actions will be carried out.-->
	<if target="Grid" test="VisibleRowsCount" Mode="GreaterThan" Value="0">
		
		<!--The following If condition declares that if this script is not being used in a loop, the Excel file will be opened as soon as it is generated. This can't be done if a loop is being run since the Excel file still may need to be worked on with the results of another server (depending on what you need to do). Keep in mind that we can't set an If condition with a SetParam value, hence the use of this variable. The variable is initialised first, and it will be changed if not in a loop.-->
		<SetVar vOpenExcelFile="False"></SetVar>
		<if target="var" test="{%ListSize%}" mode="Equals" Value="">
			<SetVar vOpenExcelFile="true"></SetVar>
		</if>
		
		<!--Finally, any findings regarding the databases and their respective mail owners, and the rights those mail owners hold, will be exported. Note that this report will be generated in the same location that this file is being run from.-->
		<Export>
			<SetParam field="FilePath" value="{%CurFilePath%}report_aclEZ.xlsx"></SetParam>
			<SetParam field="SelectedRowsOnly" value="false"></SetParam>
			<SetParam field="ExportType" value="Excel"></SetParam>
			<SetParam field="Mode" value="AppendRows"></SetParam>
			<SetParam field="ExcelSheetName" value="Email Owner Access"></SetParam>
			<SetParam field="OpenFileOnceGenerated" value="{%vOpenExcelFile%}"></SetParam>
		</Export>	
	</if>
</ytriaAutomation>


Script Level: Easy

Create a new item across all documents in a specific category—and across multiple databases.

This script can be used by itself in scanEZ to process a currently opened database, or with the new function found in databaseEZ that lets you launch a script on a selection of databases directly from within the interface. Learn more about this function here.
Small in size, yet very flexible in where you can take it, this script will simply select a category of documents and create a new item across all documents within that focused selection.

<ytriaAutomation Application="scanEZ" ApplicationVersion="16.5" Version="1.0">

<!--The following three lines let you specify the name and value of the item to be added, as well as the document category whose documents the item will be deployed to. Simply enter your desired values where indicated.-->
<SetVar ItemToAdd="Enter your value here"></SetVar>
<SetVar ItemValue="Enter your value here"></SetVar>
<SetVar DocumentCategory="Enter your value here"></SetVar>

<!--The following Expand/Focus sequence will allow the focus to be placed on the documents within the selection tree category specified.-->
<Expand target="tree" category="Documents" type="{%DocumentCategory%}"></Expand>
<focus target="tree" category="Documents" type="{%DocumentCategory%}"></focus>

<!--The CreateItem script block is where we define the item to be added. If the item already exists, it will not create a new one, instead it will skip the document and move on to the next. In this particular case, the item added will be a Text item that will use the name and value defined in the beginning of the script.-->
<CreateItem OnExisting="skip">
	<SetParam field="TypeList" value="Text"></SetParam>
	<SetParam field="FieldName" value="{%ItemToAdd%}"></SetParam>
	<SetParam field="FieldValue" value="{%ItemValue%}"></SetParam>
	<SetParam field="IsProtected" value="true"></SetParam>
</CreateItem>
</ytriaAutomation>


Script Level: Intermediate

Find all documents that match a given formula across a selection of databases, and export the findings into an Excel file.

This script can be used by itself in scanEZ to process a currently opened database, or with the new function found in databaseEZ that lets you launch an automation script on a selection of databases directly from within the interface. Learn more about this function here.
This intermediate script allows you to specify desired values in the beginning of the script using variables, minimizing any changes to the body of the script itself. This script will search a selection of databases for all the documents that match a defined formula. The name of the database that they are found in, as well as their UNIDs, will be exported into an Excel report.

<ytriaAutomation Application="scanEZ" ApplicationVersion="16.5">
	
	<!--This will set the scripts behavior when encountering an error. In this case, it will continue.-->
	<onerror continue="true" ></onerror>
	<!--Use the following variables to adapt the script to your own needs.-->
	<!--TO SET :: this is THE FORMULA used. Note that the formula follows the general XML rules of "escaping". -->
	<SetVar vSearchFormula="@Contains(Subject;"Help us protect your account")"></SetVar>
	
	<!--TO SET :: This is the item to use as a main "key" for the report.-->
	<SetVar vItemToUseAsKey="Subject"></SetVar>
	<!--This script block will perform the search for the documents.-->
	<SearchBy Type="Formula">
		<Setparam Field="SetFormula" Value="{%vSearchFormula%}"></Setparam>
		<Setparam Field="SearchDocuments" Value="true"></Setparam>
		<Setparam Field="SearchDesigns" Value="false"></Setparam>
		<Setparam Field="PutSearchInSelCreateName" Value="All Docs Found"></Setparam>
	</SearchBy>
	
	<!--The following Focus line will place the focus on the newly created My Selection folder named "All Docs Found".-->
	<Focus Target="Tree" Category="All Docs Found"></Focus>
	
	<!--The following If condition declares that If the My Selection exists (i.e. something has been found), the nested child actions will be carried out.-->
	<if Target="Tree" Test="FocusRoot" Mode="NotEquals" Value="True">
		
		<!--This will set the displayed document titles to the current database name, for reference in the resulting report.-->
		<ChangeDocumentTitle>
				<Setparam Field="TitleOptionType" Value="Formula"></Setparam>
				<Setparam Field="TitleOptionFormula" Value="@Implode(@DbName;"!!")"></Setparam>	
		</ChangeDocumentTitle>
		
		<!-- This will enact a Diff operation on the documents within the My Selection folder and select the main "key" item by the specified name.-->
		<Diff></Diff>
		<Select target="DiffGrid" Lines="ByValue">
			<SetParam ColumnID="AI2" Value="{%vItemToUseAsKey%}"></SetParam>
		</Select>
		
		<!-- This opens the Values grid.-->
		<Values>
			
			<!-- This will remove the Type column.-->
			<ShowTypeColumns value="false"></ShowTypeColumns>
			
			<!-- And this adds a custom column where the UNID will be displayed.-->
			<AddCustomColumn name="UNID">
				<SetParam field="TitleOptionType" Value="System"></SetParam>
				<SetParam field="TitleOptionSystem" Value="UNID"></SetParam>
			</AddCustomColumn>
			<Evaluate></Evaluate>
			
			<!--Finally, the results of the search will be exported into a report titled report_DeleteDoc.xlsx. If this script is to be executed as part of a Loop/List, the newly found information will be exported and appended to the same file.-->
			<Export>
				<SetParam field="FilePath" value="{%CurFilePath%}report_DeleteDoc.xlsx"></SetParam>
				<SetParam field="SelectedRowsOnly" value="false"></SetParam>
				<SetParam field="ExportType" value="Excel"></SetParam>
				<SetParam field="Mode" value="AppendRows"></SetParam>
				<SetParam field="ExcelSheetName" value="DOCS FOUND"></SetParam>
				<SetParam field="OpenFileOnceGenerated" value="False"></SetParam>
			</Export>
		</Values>		
	</if>
</ytriaAutomation>


Script Level: Advanced

Find and report all scheduled agents that have and have not run on a given server and create a concise report of agents in both conditions.

This script can be used by itself in agentEZ to process a currently opened server, or with the new function found in replicationEZ that lets you launch a script on a selection of servers directly from within the interface. Learn more about this function here.
This advanced script will load all enabled and scheduled agents on a currently loaded server and designate those that did not run. Additionally, it will create an Excel report of all agents, putting those that did run and those that did not on two separate pages. The report’s layout will be set up in a way so that it is easy to check the status.

<ytriaAutomation Application="agentEZ" ApplicationVersion="16.5">
	<!--This will set the script's behavior when encountering an error. In this case, it will continue.-->
	<onerror continue="true" ></onerror>
	
	<!--At this point, we don't want to automatically load the detailed agent information. This will set it as "false". -->
	<Option Type="AutoLoadDetailedAgentInfo" value="False"></Option>
	
	<!--This will allow the automatic Check Presence in NAB feature to be carried out on the agent signer for each agent loaded.-->
	<Option Type="PresenceInNAB" value="true"></Option>
	
	<!--This will set the option to use the Design Collection Note which is a much faster loading option.-->
	<UseDesignCollection value="true"></UseDesignCollection>
	
	<!--This defines our search as looking only for scheduled agents.-->
	<AgentTriggerType value="Scheduled" ></AgentTriggerType>
	<!--This will select all databases on the loaded server.-->
	<TreeSelectionLive Value="False"></TreeSelectionLive>
	<select target="tree" server="true"></select>
	<TreeSelectionLive Value="True"></TreeSelectionLive>
	<!--The next part of the script will handle the grid layout so the results are presented in a clear order. A Suspend Grid Redraw function is added so the processing will be held off until all columns are set.-->
	<SuspendRedraw value="true"></SuspendRedraw>
	
	<!--All columns are removed from the main grid in order to prepare for the columns that will be added.-->
	<RemoveAllcolumns></RemoveAllcolumns>
	
	<!--Second, the columns that we want are added back into the first position and in reverse order.-->
	<Add ColumnID="STATUS_LOAD" Position="1"></Add><!-- Is Agent Fully Loaded? -->
	<Add ColumnID="D33" Position="1"></Add><!-- Is background agent disabled on database -->
	<Add ColumnID="B6" Position="1"></Add><!-- Comment -->
	<Add ColumnID="D3" Position="1"></Add><!-- Database Type -->
	<Add ColumnID="R24" Position="1"></Add><!-- Run on week-ends -->
	<Add ColumnID="R23" Position="1"></Add><!-- Stop running agent on this date -->
	<Add ColumnID="R22" Position="1"></Add><!-- Start running agent on this date -->
	<Add ColumnID="R21" Position="1"></Add><!-- Running Interval -->
	<Add ColumnID="M13" Position="1"></Add><!-- Signer -->
	<Add ColumnID="B5" Position="1"></Add><!-- Last Alias -->
	<Add ColumnID="B4" Position="1"></Add><!-- Name -->
	<Add ColumnID="D2" Position="1"></Add><!-- Database Filename -->
	<Add ColumnID="D1" Position="1"></Add><!-- Database Path -->
	<Add ColumnID="L17" Position="1"></Add><!-- Last Run Duration -->
	<Add ColumnID="L15" Position="1"></Add><!-- Last Run Start Date -->
	<Add ColumnID="STATUS" Position="1"></Add><!-- Status -->
	
	<!--Then, all groupings are removed.-->
	<UngroupAll></UngroupAll>
	
	<!--And we will set a new grouping configuration.-->
	<GroupBy ColumnID="D46"></GroupBy><!-- Server -->
	<GroupBy ColumnID="R9"></GroupBy><!-- Run On -->
	<GroupBy ColumnID="R12"></GroupBy><!-- Agent Schedule -->
	
	<!--Also, a new sorting configuration is set.-->
	<Sort columnID="L17" Ascending="false"></Sort><!-- Last Run Duration -->
	<Sort columnID="D1" Ascending="true"></Sort><!-- Database Path -->
	<Sort columnID="D3" Ascending="true"></Sort><!-- Database Type -->
	<Sort columnID="D2" Ascending="true"></Sort><!-- Database Filename -->
	<!--All existing filters are cleared, and then the grid processing is reactivated by turning off the Suspend Grid Redraw state.-->
	<ClearFilters></ClearFilters>
	<SuspendRedraw value="false"></SuspendRedraw>
 
	<!--Note that the agent details don't need to be loaded in this situaiton, as this info is provided without a full information load.-->
	<Filter columnID="R8" Value="checked"></Filter><!-- Enable -->
	
	<!--The following If condition declares that if something is found (and thus making the grid count greater than 0), the nested child actions will be carried out.-->
	<if target="Grid" test="VisibleRowsCount" Mode="GreaterThan" Value="0">
		
		<!--All enabled agents will be selected (rows loaded in the grid).-->
		<Select lines="all"></Select>
		
		<!--Then, all the detailed agent information is loaded for all selected lines.-->
		<LoadMoreInfo></LoadMoreInfo>
		<!--A filter is added to find all agents that are enabled and did run correctly.-->
		<Filter columnID="L17" Empty="true"></Filter><!-- Last Run Duration not set... -->
		
		<!--These findings can now be exported. Note that this report will be generated in the same location that this file is being run from.-->
		<Export>
			<SetParam field="FilePath" value="report_agentEZ.xlsx"></SetParam>
			<SetParam field="SelectedRowsOnly" value="false"></SetParam>
			<SetParam field="ExportType" value="Excel"></SetParam>
			<SetParam field="Mode" value="AppendRows"></SetParam>
			<SetParam field="ExcelSheetName" value="Enabled Scheduled Agents - LAST RUN"></SetParam>
			<SetParam field="OpenFileOnceGenerated" value="False"></SetParam>
		</Export>
		
		<!--All filters will be cleared from the Last Run Duration column.-->
		<ClearFilters columnID="L17"></ClearFilters><!-- Last Run Duration... -->
		
		<!--A filter is then added to find all agents that are enabled, but did not run correctly. A small trick is used here: hiding anything that contains a ":" character (and thus indicating a duration).-->
		<Filter columnID="L17" Mode="NotContains" Text=":"></Filter><!-- Last Run Duration... -->
		
		<!--The following If condition declares that if this script is not being used in a loop, the Excel file will be opened as soon as it is generated. This can't be done if a loop is being run since the Excel file still may need to be worked on with the results of another server (depending on what you need to do). Keep in mind that we can't set an If condition with a SetParam value, hence the use of this variable. The variable is initialised first, and it will be changed if not in a loop.-->
		<SetVar vOpenExcelFile="False"></SetVar>
		<if target="var" test="{%ListSize%}" mode="Equals" Value="">
			<SetVar vOpenExcelFile="true"></SetVar>
		</if>
		
		<!--Finally, any findings regarding agents that did not run can be exported. Note that this report will be generated in the same location that this file is being run from.-->
		<Export>
			<SetParam field="FilePath" value="{%CurFilePath%}report_agentEZ.xlsx"></SetParam>
			<SetParam field="SelectedRowsOnly" value="false"></SetParam>
			<SetParam field="ExportType" value="Excel"></SetParam>
			<SetParam field="Mode" value="AppendRows"></SetParam>
			<SetParam field="ExcelSheetName" value="DID NOT RUN"></SetParam>
			<SetParam field="OpenFileOnceGenerated" value="{%vOpenExcelFile%}"></SetParam>
		</Export>
	</if>
	
</ytriaAutomation>


<p style="color: #d70f64; font-weight: bolder;">Script Level: Advanced</p>

Find multiple different types of profile documents and create reports of each different type found.

This script can be used by itself in scanEZ to process a currently opened database, or with the new function found in databaseEZ that lets you launch an automation script on a selection of databases directly from within the interface. Learn more about this function here.
This advanced script will iterate over a List containing different user-definable profile document names, and, for each given name, conduct a regex search to find the profile documents that contain a matching name. A multi-faceted report containing a full breakdown of all the items and their values within each document will be exported to an Excel file; each document name’s search results will be placed in its own page in the file.

<ytriaAutomation Application="scanEZ" ApplicationVersion="16.5">
	<!--This will set the script's behavior when encountering an error. In this case, it will continue.-->
	<onerror continue="true" ></onerror>
	<!--This will allow the script to run if called from databaseEZ by using the option 'Execute Automation File On...'-->
	<if target="var" test="{%ListSize%}" mode="NotEquals" Value="">
		<ExecuteListAction></ExecuteListAction>
	</if>
	<!--The script uses Loop and List actions. The Loop itself can be modified to fit your needs.-->
	<!--TO SET: these variables define the profile you are looking for. You may change the values to suit your needs and even add in more lines to the list keeping the format shown. Note: Personal profile documents are arranged in a level further down in scanEZ's selection tree and must be selected in a different way.-->
	<List name="allProfileName" Action="SetVar" vProfileName="CalendarProfile"></List>
	<List name="allProfileName" Action="SetVar" vProfileName="NotExistProfile"></List>
	<List name="allProfileName" Action="SetVar" vProfileName="ColorProfile"></List>
	<!--This line will expand the Profile Documents section of the selection tree.-->
	<Expand target="tree" Category="Profile Documents"></Expand>
	<!--Beginning here, the rest of the script is the Loop setup. All actions within this Loop section will be carried out in turn on all the lines in the List section (above) that use the specified name. The Loop is set to call on the List name allProfileName".-->
	<Loop list="allProfileName" OnError="Next">
		
		<!--This next action is mandatory in order for the action within the List lines referenced to be carried out. In the case of the lines in the List "allProfileName", the SetVar action is to be executed.-->
		<ExecuteListAction></ExecuteListAction>
		<!--Then, everything in the tree will be deselected.-->
		<UnSelect Target="tree" name="All"></UnSelect>
		
		<!--This will place the focus on the Profile Documents category so that the SelectByRegex action can be used on the first-level entries within.-->
		<Focus Target="Tree" Category="Profile Documents"></Focus>
		
		<!--The following line will enact a regex search on the first-level profile documents to find any profile documents that contain the name provided.-->
		<SelectByRegex Regex="{%vProfileName%}"></SelectByRegex>
		
		<!--As stated early on in this script, Personal Profile documents are arranged at a deeper level in the selection tree. If you want to be able to search through both of these levels at the same time to find both the first level profile documents and personal profile documents with this name use this line in place of the regex search above <Select Target="Tree" Category="Profile Documents" Type="{%vProfileName%}"></Select> -->
		
		<!--This will create a new My Selection folder containing the found documents. By doing this the displayed titles can be set to your desired form (titles cannot be set within the Profile Documents category).-->
		<MySelection>
			<Setparam Field="MySelectionName" Value="Selection of {%vProfileName%}"></Setparam>
			<Setparam Field="TitleOptionType" Value="Formula"></Setparam>
			<Setparam Field="TitleOptionFormula" Value="@Implode(@DbName;"!!")"></Setparam>	
		</MySelection>
		<!--Then the focus is placed on the newly created My Selection folder.-->
		<Focus Target="Tree" Category="Selection of {%vProfileName%}"></Focus>
		
		<!--The following If condition declares that if the My Selection does exist, (meaning that something has been found) the nested child actions will be enacted.-->
		<if Target="Tree" Test="FocusRoot" Mode="NotEquals" Value="True">
			
			<!--A Values function is carried out on the focused My Selection folder.-->
			<Values>
				
				<!--All items within the Values grid are selected.-->
				<SetParam Target="SelectDocumentItems" Field="All" value="true"></SetParam>
				
				<!--And finally all the findings are exported to an Excel file; the results for each profile name will be placed on its own sheet within the file. The file will be saved in the same location as the this Automation file.-->
				<Export>
				   <SetParam field="FilePath" value="{%CurFilePath%}report_FindProfile.xlsx"></SetParam>
				   <SetParam field="SelectedRowsOnly" value="false"></SetParam>
				   <SetParam field="ExportType" value="Excel"></SetParam>
				   <SetParam field="Mode" value="AppendRows"></SetParam>
				   <SetParam field="ExcelSheetName" value="{%vProfileName%}"></SetParam>
				   <SetParam field="OpenFileOnceGenerated" value="False"></SetParam>
				</Export>
			</Values>
			
		</if>
		
	</Loop>
</ytriaAutomation>


New in Automation

Automate more tasks thanks to a fully matured command language

First introduced in version 12, automation has always held a lot of promise for performing large, repetitive tasks. EZ Suite 16.5 sees the XML-based automation command language optimized and expanded beyond the original set of tags, and the capabilities that were available even as recently as version 16. The available catalog full of tags can be found in our Help section.

Record your actions to scripts with the powerful new Automation Recorder.

An all-new Automation Recorder takes performance optimization to another level by letting you record and “replay” actions you’ve performed in the EZ Suite tools. Simply hit Record at the beginning of your process, do your work, and the recorder will save the steps in an independent automation file that can be either recalled at a later time “as is,” or modified to fit your needs.

Launch scripts on a current selection through other EZ Suite tools.

Bridges between EZ Suite tools have become far more robust! Thanks to a new right-click menu option for multi-server and multi-database tools (not applicable to consoleEZ), you can now process a current selection of entries through other tools by employing a pre-saved automation script. Process a selection of servers with agentEZ or aclEZ, process a selection of databases with scanEZ—the possibilities are huge, and only a few clicks away!

Build your automation lists fast with the 'Create Automation List from Selection' feature.

Thanks to the new Create Automation List from Selection function, you can quickly “export” a selection of entries to a properly formatted List that can be used in an automation script Loop.

See the progress of your automation scripts in real time, and with a level of detail that you choose.

A new, dedicated console displays a full log of operations carried out through automation scripts—in real time—and with script-responsive verbosity levels.

The flexYgrid

Create better reports faster with the improved 'Append Rows' Export option.

Reporting is cleaner and easier to manage thanks to improvements in the “Append Rows” Export option that automatically reuses matching column headers. Combine reports worry-free. Regardless of how you have your grid columns placed, data exports now recognize columns and will append the like data to the proper place in your reports.

Keep your selection focus while performing Group/Sort operations.

Stay focused, on your current selections that is. Your selections now stay intact after Sort and Filter operations. And a new auto-scroll feature brings your focused entries back into view with only a key

Focus columns automatically thanks to Search function enhancements.

The flexYgrid Find First… regex search option will now focus the column in which the regex match is found—guesswork is eliminated.

Group/Ungroup easier thanks to quick toolbar buttons.

New one-click Group/Ungroup command buttons can now be found in the toolbar. Group by the currently focused column in the click of a button (or a CTRL+ I), or reset even the heaviest grouping arrangement (CTRL+SHIFT+G).

Choose from new options to Hide/Unhide columns.

Hiding columns just got easier, and safer! New right-click menu options and key commands let you hide currently selected columns (CTRL+F6) and unhide the last hidden column (CTRL+F6) for a virtual undo, or toggle between states.

Combine filters on individual columns for heightened precision.

Already a powerful function, the precision of column filters has been enhanced through the ability to enact multiple filters on the same column header. Zero in on specifics by adding in one filter after another.

See grid counts fast with the new grid status bar.

See totals for rows loaded, rows displayed, hidden rows, and selected rows at a glance thanks to a new count-status bar available in every flexYgrid panel.

Filter values more accurately through "Real value" Filter logic.

Sort operations are more precise, regardless of cell and group formatting, due to a process that uses the “real” values and not the text-formatted value displayed in the grid.

Display all filtered and manually-hidden rows at the click of a button.

Keep a firm grasp on the totality of your data throughout your operations. In just the click of a button, or with a CTRL + ALT + V, toggle the display of all rows filtered out of, or hidden in, a grid panel. These rows are color coded for easy identification.

Hold operation processing for quicker data manipulation.

Sometimes, the amount of data you’re working with is so large that processing between operations inevitably takes a bit of time. Group, Filter, Load etc. on grids with extremely large data volumes are still comparatively fast, but the minute waiting times between processes can add up. The Suspend Grid Redraw feature lets you hold the processing until you’ve set up all of your operations, and then take care of them all at once.

View everything in your group zone.

Perform as many groupings as you want, see them ALL thanks to a scrollable group zone.

Reset grid configurations in total security.

A lot of preparation and work can go into finding the data you need. When it’s time to revert back to your default settings, or even the original layout, you’ve got to be sure. By requiring a confirmation before the reset is carried out, any wrong clicks will be avoided.

View your data based on a specific time span back from the current date.

An all-new cut-off date column filter option lets you choose to see only entries that fall within a specified time span back from the current date.

New in scanEZ

Copy/Move documents with powerful new options to control how they are copied or moved in addition to the folder structure of their destination.

The Copy/Move Documents to Multiple Databases function is the closest thing Notes users can get to a drag-n-drop operation for Notes databases, and it has undergone both UX improvements and backend expansion. In addition to the ability to keep the original folder structure—or manually specify a new one—for the target documents, you can now choose from 4 different ways to carry out a Copy or Move operation: copy documents as new, replicate them, or replicate them with the option to force increment their sequence number depending on if the documents already exist in the target databases or not.

Export all files and attachments from a selection of documents in only a couple of clicks.

With scanEZ’s new Export All Attachments and Files… feature, attachment archival across scores of documents has literally become a 2-step process. Select the documents, and select where you want to save the attachments. That’s all there is to it!

Conduct in-depth audits between two non-replica databases with the new Database Comparator.

Have you ever wished that you could direct the Replication Auditor’s unique powers towards two databases that aren’t replicas? scanEZ now includes the new Database Comparator that lets you conduct Note Info audits between any two like databases that contain the same key UNIDs. Display only differences between them, or display the entire audit.

Get more out of the $Flags help section.

The valuable $Flags quick reference definition bank is now flexYgrid enabled.

Edit MIME/RFC822 compatible items.

scanEZ is now fully compliant with MIME/RFC 822 standards and thus has the ability to read out and edit related items.

Manage design source files in design elements like Xpages. (See also the new document attachment export feature.)

Reach beyond the backend of XPages with the ability to parse and export the contents of multiple components that just weren’t reliably accessible before—access compiled javascript, eclipse files, custom control components, and more.

New in databaseEZ

Create/delete Full Text indexes across multiple databases.

databaseEZ now supports creation/deletion of Full Text Indexes. (Note: Full Text Index creation only takes effect at the next Update.)

New in replicationEZ

Safeguard your grid entries for replicas loaded across servers while changing your selection.

An improved process for selecting/deselecting databases in the selection panel now offers the option to prevent unloading databases if you already have replicas from other servers loaded in the grid.

Get a clearer view of servers thanks to alphabetical selection tree ordering.

Finding your desired server within a full-capacity replicationEZ selection tree just got a whole lot easier. Your servers are now displayed in alphabetical order.

Drill down into conflicts directly from replicationEZ's Conflict Counter panel.

Finding your desired server within a full-capacity replicationEZ selection tree just got a whole lot easier. Your servers are now displayed in alphabetical order.

New in consoleEZ

View detailed error logs for multiple servers at once.

Expanded functionality in consoleEZ’s Dashboard panel now lets you see the error log details for multiple servers at once.

Pause "live" grids to activate all "static" grid capabilities.

Live grids like the grid in consoleEZ dashboard are powerful tools, but the live nature of the data stream presented barriers between these grids and the built-in flexYgrid tools like the Pivot Table builder and Data Comparator. This is no longer true: thanks to the Pause Data Stream option, you’ll be able to use all the tools and options available in static flexYgrid panels on live grids (while paused).

New in agentEZ

Automate more tasks thanks to a fully matured command language

See agent presence faster thanks to color coding enhancements in the database selection tree.

A new display development in agentEZ’s database selection tree now indicates different stages of agent presence at a glance. Databases displayed in gray text lack agents of any type and pink text indicates a lack of the specific type of agent indicated in the agent search filter.

EZ Suite:

Try it now!

See just how much faster and more fluid your HCL Notes and Domino administration and development can be.


Automation

What is the Ytria automation API?

Go even bigger with your EZ Suite tools—through large-scale repeatable processes.

EZ Suite tools can be automated? Yes!

First introduced in EZ Suite version 12, the Ytria automation API lets you perform large, repetitive tasks quickly and efficiently. EZ Suite 16.5 sees the focus of the command language and the scope of possibilities greatly expanded.

Here's how you can start putting automation to work for you.

Following through this page will help your understanding of what you can do with automation and how you can get started doing it. We’ll also introduce you to some key automation resources you’ll want to keep handy for the future.

First, let’s look at a quick-and-easy script.

Try out the script below in aclEZ with a server already loaded. You’ll get a concise readout of all ACL entries, and their corresponding access levels for all databases on a loaded server.

  • Simply copy/paste the script shown here into any text editor and save it as an XML file.
  • Open aclEZ and load a server into the selection tree. Then, select the option ‘Load Automation File…’ from the Server (or use CTRL+X).
  • Find the file you just saved and click ‘Open.’

That’s all there is to it! You’ll have a complete listing of all databases on the loaded server, as well as all applicable ACL entries grouped by access level and name.

<?xml version="1.0"?>
<ytriaAutomation Application="aclEZ" ApplicationVersion="16.5">

<RemoveAllColumns></RemoveAllColumns>
<Add ColumnID="DB1" Position="1"></Add>
<Add ColumnID="ACL5" Position="1"></Add>
<Add ColumnID="ACL1" Position="1"></Add>

<GroupBy ColumnID="DB1"></GroupBy>
<GroupBy ColumnID="ACL5"></GroupBy>
<GroupBy ColumnID="ACL1"></GroupBy>
<Collapse/>
</ytriaAutomation>

Want to learn more? Start here.

Our automation scripts are written in XML. If you are currently unfamiliar with XML, w3schools.com has some excellent tutorials to help kickstart your understanding.

To learn more about automation itself, visit our “XML Basics” page by clicking the link below. You’ll find simple examples of the types of components found in a good automation script—including their structure and purpose.

Tip: Once you start to get the general idea of what automation is all about, check out some commands that you’ll want to know. Some of the concepts involved require a bit of familiarization, but once you have the knowledge under your belt, large scale operations are a cinch to handle:

Basics

To learn more about automation itself, visit our "XML Basics" page by clicking the link below. You'll find simple examples of the types of components found in a good automation script—including their structure and purpose.

Learn more

Global Actions

This section contains high-level commands used universally across all tools. For example, loading a server or database.

Learn more

Basics

To learn more about automation itself, visit our "XML Basics" page by clicking the link below. You'll find simple examples of the types of components found in a good automation script—including their structure and purpose.

Learn more

Global Actions

This section contains high-level commands used universally across all tools. For example, loading a server or database.

Learn more

Check out the full scope of functionality.

Check out the ever-expanding catalog of functions that you can automate. Some of these command tags will sound familiar, some will seem brand new. A vast amount of possibilities exist. Each tag has it’s own page that contains an explanation of exactly what it will do, an example that puts it in context, and the technical information surrounding its use in a script.

Ytria Automation API Tag Catalog

Check out the ever-expanding catalog of functions that you can automate. Some of these command tags will sound familiar, some will seem brand new.

Drill down into the specifics.

Every product has its own exclusive functions. Click the links below for a direct access to the pages describing the specific action tags that are used to automate the individual products’ functionality.

scanEZ

API tags

aclEZ

API tags

agentEZ

API tags

consoleEZ

API tags

databaseEZ

API tags

replicationEZ

API tags

signEZ

API tags

viewEZ

API tags

designPropEZ

API tags

actionBarEZ

API tags

Let us work for you with these ready-made scripts.

Click below for some working scripts that you can put to work immediately. For your convenience, comments have been included as explanations of key functionalities. Feel free to change the values to meet your needs—when doing so, be sure to keep the Ytria Automation tag specifics in mind to ensure that your scripts function properly.

Search multiple servers for all invalid ACL entries.

This script will automatically search three servers for any and all invalid ACL entries—entries for names not found in the NAB—and then export the results to a per-server report, one Excel file each.

<?xml version="1.0"?>
<ytriaAutomation Application="aclEZ" ApplicationVersion="16.5">

<RemoveAllColumns></RemoveAllColumns>
<Add ColumnID="DB1" Position="1"></Add>
<Add ColumnID="ACL5" Position="1"></Add>
<Add ColumnID="ACL1" Position="1"></Add>

<GroupBy ColumnID="DB1"></GroupBy>
<GroupBy ColumnID="ACL5"></GroupBy>
<GroupBy ColumnID="ACL1"></GroupBy>
<Collapse/>
</ytriaAutomation>

Load a server and export all ACL information.

This script will load all databases on a server of your choice and then export all ACL attributes and roles to an HTML file.

<ytriaAutomation Application="aclEZ" ApplicationVersion="16.5">
<OnError continue="True"></OnError> 
<Echo Mode="False"></Echo>
<!--The variable in the next line will set the server to load. 
Simply change this variable value to accommodate your needs.--> 
<SetVar srv="Enter your server name here."></SetVar> 
<!-- Initialize --> 
<Load Server="{%srv%}" select="true"></Load>
<Export Type="FlagsAndRoles">
<SetParam target="ExportToFile" field="FilePath" value="aclEZ_export.html"></SetParam>
<SetParam target="ExportToFile" field="ExportType" value="HTML"></SetParam>
<SetParam target="ExportToFile" field="FileOutput" value="Unicode"></SetParam>
<SetParam target="ExportToFile" field="OpenFileOnceGenerated" value="true"></SetParam>
</Export>
</ytriaAutomation>

Find and report all Mail Owner access levels and various connected properties and settings regarding their permissions across multiple databases on multiple servers.

This script can be used by itself in aclEZ to process a currently opened server, or with the new function found in replicationEZ that lets you launch a script on a selection of servers directly from within the interface. Learn more about this function here.

This script will parse the entire mail directory folder on a given server to find all mail owners set side by side with a selection of key properties and settings that govern access and permissions to their respective mail databases. A report will be generated and exported into an Excel file. Each access level will be reported on its own sheet within the file.

<ytriaAutomation Application="aclEZ" ApplicationVersion="16.5">
<!--This will set the script's behavior when encountering an error. 
In this case, it will continue.-->
<onerror continue="true" ></onerror>

<!--First it is specified that the NAB presence is NOT to be checked and groups are NOT 
to be "expanded."-->
<Option Type="PresenceInNAB" value="false"></Option>
<Option Type="GroupExpander" value="ExpandNone"></Option>
<TreeSelectionLive Value="True"></TreeSelectionLive>
<!--All databases on the current server will be deselected in the tree.-->
<unselect target="tree" server="true"></unselect>

<!--Then the mail directory folder for the current server will be selected.-->
<select target="tree" folder="mail"></select>

<!--The next part of the script defines the actions to be taken within the Audit grid.
The grid layout will be set as stated below.
A Suspend Grid Redraw function is added so the processing will be held off until 
all columns are set.-->
<SuspendRedraw value="true"></SuspendRedraw>

<!--All columns are removed from the main grid in order to prepare for the columns 
that will be added.-->
<RemoveAllcolumns></RemoveAllcolumns>

<!--The grid columns are moved to the first position in reverse order.
The name of the columns are indicated.-->
<Add ColumnID="DB6" Position="1"></Add><!-- Catalog Categories -->
<Add ColumnID="DB4" Position="1"></Add><!-- Database Type -->
<Add ColumnID="A9" Position="1"></Add><!-- Replicate or Copy Documents -->
<Add ColumnID="A8" Position="1"></Add><!-- Write Public Documents -->
<Add ColumnID="A7" Position="1"></Add><!-- Read Public Documents -->
<Add ColumnID="A6" Position="1"></Add><!-- Create LS/Java Agents -->
<Add ColumnID="A5" Position="1"></Add><!-- Create Shared Folder/Views -->
<Add ColumnID="A4" Position="1"></Add><!-- Create Private Folders/Views -->
<Add ColumnID="A3" Position="1"></Add><!-- Create Private Agents -->
<Add ColumnID="A2" Position="1"></Add><!-- Delete Documents -->
<Add ColumnID="A1" Position="1"></Add><!-- Create Documents -->
<Add ColumnID="ACL4" Position="1"></Add><!-- Type -->
<Add ColumnID="ACL1" Position="1"></Add><!-- Name -->
<Add ColumnID="DB3" Position="1"></Add><!-- Database File -->
<Add ColumnID="DB2" Position="1"></Add><!-- Database Path -->
<Add ColumnID="STATUS" Position="1"></Add><!-- Status -->
<!--Any residual grouping and sorting is cleared.-->
<Reset></Reset>

<!--A new grouping configuration is set.-->
<GroupBy ColumnID="ACL5"></GroupBy><!-- Access -->
<GroupBy ColumnID="DB7"></GroupBy><!-- Server -->

<!--And a new sorting configuration is set.-->
<Sort columnID="DB2" Ascending="true"></Sort><!-- Database Path -->
<Sort columnID="DB4" Ascending="true"></Sort><!-- Database Type -->
<Sort columnID="DB3" Ascending="true"></Sort><!-- Database Filename -->

<!--A filter is added to isolate only mail owners,and then the grid processing is 
reactivated by turning off
the Suspend Grid Redraw state.-->
<Filter columnID="ACL3" Empty="true"></Filter><!-- Mail Owner -->
<SuspendRedraw value="false"></SuspendRedraw>

<!--The following If condition will test if the main grid has any rows loaded. 
If there are any rows loaded (meaning that Mail Owners were found) the nested 
child actions 
will be carried out.-->
<if target="Grid" test="VisibleRowsCount" Mode="GreaterThan" Value="0">

<!--The following If condition declares that if this script is not being used in a 
loop, the Excel file will be opened as soon as it is generated.
This can't be done if a loop is being run since the Excel file still may need 
to be worked on with the results of another server (depending on what you need
to do). Keep in mind that we can't set an If condition with a SetParam value, 
hence the use of this variable.
The variable is initialised first, and it will be changed if not in a loop.-->
<SetVar vOpenExcelFile="False"></SetVar>
<if target="var" test="{%ListSize%}" mode="Equals" Value="">
<SetVar vOpenExcelFile="true"></SetVar>
</if>

<!--Finally, any findings regarding the databases and their respective mail owners, 
and the rights those mail owners hold, will be exported. 
Note that this report will be generated in the same location that this file
is being run from.-->
<Export>
<SetParam field="FilePath" value="{%CurFilePath%}report_aclEZ.xlsx"></SetParam>
<SetParam field="SelectedRowsOnly" value="false"></SetParam>
<SetParam field="ExportType" value="Excel"></SetParam>
<SetParam field="Mode" value="AppendRows"></SetParam>
<SetParam field="ExcelSheetName" value="Email Owner Access"></SetParam>
<SetParam field="OpenFileOnceGenerated" value="{%vOpenExcelFile%}"></SetParam>
</Export> 
</if>
</ytriaAutomation>

Create a new item across all documents in a specific category—and across multiple databases.

This script can be used by itself in scanEZ to process a currently opened database, or with the new function found in databaseEZ that lets you launch a script on a selection of databases directly from within the interface. Learn more about this function here.

Small in size, yet very flexible in where you can take it, this script will simply select a category of documents and create a new item across all documents within that focused selection.

<?xml version="1.0" encoding="UTF-8"?>
<ytriaAutomation Application="scanEZ" ApplicationVersion="16.5" Version="1.0">

<!--The following three lines let you specify the name and value of the item to be added, 
as well as the document category whose documents the item will be deployed to. 
Simply enter your desired values where indicated.-->
<SetVar ItemToAdd="Enter your value here"></SetVar>
<SetVar ItemValue="Enter your value here"></SetVar>
<SetVar DocumentCategory="Enter your value here"></SetVar>

<!--The following Expand/Focus sequence will allow the focus to be placed on the documents 
within the selection tree category specified.-->
<Expand target="tree" category="Documents" type="{%DocumentCategory%}"></Expand>
<focus target="tree" category="Documents" type="{%DocumentCategory%}"></focus>

<!--The CreateItem script block is where we define the item to be added. If the item already 
exists, it will not create a new one, instead it will skip the document and move on to the 
next. In this particular case, the item added will be a Text item that will use the name 
and value defined in the beginning of the script.-->
<CreateItem OnExisting="skip">
<SetParam field="TypeList" value="Text"></SetParam>
<SetParam field="FieldName" value="{%ItemToAdd%}"></SetParam>
<SetParam field="FieldValue" value="{%ItemValue%}"></SetParam>
<SetParam field="IsProtected" value="true"></SetParam>
</CreateItem>
</ytriaAutomation>

Find all documents that match a given formula across a selection of databases, and export the findings into an Excel file.

This script can be used by itself in scanEZ to process a currently opened database, or with the new function found in databaseEZ that lets you launch an automation script on a selection of databases directly from within the interface. Learn more about this function here.

This intermediate script allows you to specify desired values in the beginning of the script using variables, minimizing any changes to the body of the script itself. This script will search a selection of databases for all the documents that match a defined formula. The name of the database that they are found in, as well as their UNIDs, will be exported into an Excel report.

<?xml version="1.0"?>
<ytriaAutomation Application="aclEZ" ApplicationVersion="16.5">

<RemoveAllColumns></RemoveAllColumns>
<Add ColumnID="DB1" Position="1"></Add>
<Add ColumnID="ACL5" Position="1"></Add>
<Add ColumnID="ACL1" Position="1"></Add>

<GroupBy ColumnID="DB1"></GroupBy>
<GroupBy ColumnID="ACL5"></GroupBy>
<GroupBy ColumnID="ACL1"></GroupBy>
<Collapse/>
</ytriaAutomation>

Find and report all scheduled agents that have and have not run on a given server and create a concise report of agents in both conditions.

This script can be used by itself in scanEZ to process a currently opened database, or with the new function found in databaseEZ that lets you launch an automation script on a selection of databases directly from within the interface. Learn more about this function here.

This intermediate script allows you to specify desired values in the beginning of the script using variables, minimizing any changes to the body of the script itself. This script will search a selection of databases for all the documents that match a defined formula. The name of the database that they are found in, as well as their UNIDs, will be exported into an Excel report.

<ytriaAutomation Application="agentEZ" ApplicationVersion="16.5">
<!--This will set the script's behavior when encountering an error. 
In this case, it will continue.-->
<onerror continue="true" ></onerror>

<!--At this point, we don't want to automatically load the detailed agent information. 
This will set it as "false". -->
<Option Type="AutoLoadDetailedAgentInfo" value="False"></Option>

<!--This will allow the automatic Check Presence in NAB feature to be carried out on 
the agent signer for each agent loaded.-->
<Option Type="PresenceInNAB" value="true"></Option>

<!--This will set the option to use the Design Collection Note which is a much 
faster loading option.-->
<UseDesignCollection value="true"></UseDesignCollection>

<!--This defines our search as looking only for scheduled agents.-->
<AgentTriggerType value="Scheduled" ></AgentTriggerType>
<!--This will select all databases on the loaded server.-->
<TreeSelectionLive Value="False"></TreeSelectionLive>
<select target="tree" server="true"></select>
<TreeSelectionLive Value="True"></TreeSelectionLive>
<!--The next part of the script will handle the grid layout so the results are presented 
in a clear order. A Suspend Grid Redraw function is added so the processing will 
be held off until all columns are set.-->
<SuspendRedraw value="true"></SuspendRedraw>

<!--All columns are removed from the main grid in order to prepare for the columns that 
will be added.-->
<RemoveAllcolumns></RemoveAllcolumns>

<!--Second, the columns that we want are added back into the first position 
and in reverse order.-->
<Add ColumnID="STATUS_LOAD" Position="1"></Add><!-- Is Agent Fully Loaded? -->
<Add ColumnID="D33" Position="1"></Add><!-- Is background agent disabled on database -->
<Add ColumnID="B6" Position="1"></Add><!-- Comment -->
<Add ColumnID="D3" Position="1"></Add><!-- Database Type -->
<Add ColumnID="R24" Position="1"></Add><!-- Run on week-ends -->
<Add ColumnID="R23" Position="1"></Add><!-- Stop running agent on this date -->
<Add ColumnID="R22" Position="1"></Add><!-- Start running agent on this date -->
<Add ColumnID="R21" Position="1"></Add><!-- Running Interval -->
<Add ColumnID="M13" Position="1"></Add><!-- Signer -->
<Add ColumnID="B5" Position="1"></Add><!-- Last Alias -->
<Add ColumnID="B4" Position="1"></Add><!-- Name -->
<Add ColumnID="D2" Position="1"></Add><!-- Database Filename -->
<Add ColumnID="D1" Position="1"></Add><!-- Database Path -->
<Add ColumnID="L17" Position="1"></Add><!-- Last Run Duration -->
<Add ColumnID="L15" Position="1"></Add><!-- Last Run Start Date -->
<Add ColumnID="STATUS" Position="1"></Add><!-- Status -->

<!--Then, all groupings are removed.-->
<UngroupAll></UngroupAll>

<!--And we will set a new grouping configuration.-->
<GroupBy ColumnID="D46"></GroupBy><!-- Server -->
<GroupBy ColumnID="R9"></GroupBy><!-- Run On -->
<GroupBy ColumnID="R12"></GroupBy><!-- Agent Schedule -->

<!--Also, a new sorting configuration is set.-->
<Sort columnID="L17" Ascending="false"></Sort><!-- Last Run Duration -->
<Sort columnID="D1" Ascending="true"></Sort><!-- Database Path -->
<Sort columnID="D3" Ascending="true"></Sort><!-- Database Type -->
<Sort columnID="D2" Ascending="true"></Sort><!-- Database Filename -->
<!--All existing filters are cleared, and then the grid processing is reactivated 
by turning off the Suspend Grid Redraw state.-->
<ClearFilters></ClearFilters>
<SuspendRedraw value="false"></SuspendRedraw>

<!--Note that the agent details don't need to be loaded in this situaiton, as this info is 
provided without a full information load.-->
<Filter columnID="R8" Value="checked"></Filter><!-- Enable -->

<!--The following If condition declares that if something is found (and thus making
the grid count greater than 0), the nested child actions will be carried out.-->
<if target="Grid" test="VisibleRowsCount" Mode="GreaterThan" Value="0">

<!--All enabled agents will be selected (rows loaded in the grid).-->
<Select lines="all"></Select>

<!--Then, all the detailed agent information is loaded for all selected lines.-->
<LoadMoreInfo></LoadMoreInfo>
<!--A filter is added to find all agents that are enabled and did run correctly.-->
<Filter columnID="L17" Empty="true"></Filter><!-- Last Run Duration not set... -->

<!--These findings can now be exported. Note that this report will be generated 
in the same location that this file is being run from.-->
<Export>
<SetParam field="FilePath" value="report_agentEZ.xlsx"></SetParam>
<SetParam field="SelectedRowsOnly" value="false"></SetParam>
<SetParam field="ExportType" value="Excel"></SetParam>
<SetParam field="Mode" value="AppendRows"></SetParam>
<SetParam field="ExcelSheetName" value="Enabled Scheduled Agents - LAST RUN"></SetParam>
<SetParam field="OpenFileOnceGenerated" value="False"></SetParam>
</Export>

<!--All filters will be cleared from the Last Run Duration column.-->
<ClearFilters columnID="L17"></ClearFilters><!-- Last Run Duration... -->

<!--A filter is then added to find all agents that are enabled, but did not run 
correctly. A small trick is used here: hiding anything that contains a 
":" character (and thus indicating a duration).-->
<Filter columnID="L17" Mode="NotContains" Text=":"></Filter><!-- Last Run Duration... -->

<!--The following If condition declares that if this script is not being used in a
loop, the Excel file will be opened as soon as it is generated. This can't be done 
if a loop is being run since the Excel file still may need to be worked on with the
results of another server (depending on what you need to do).
Keep in mind that we can't set an If condition with a SetParam value,
hence the use of this variable.
The variable is initialised first, and it will be changed if not in a loop.-->
<SetVar vOpenExcelFile="False"></SetVar>
<if target="var" test="{%ListSize%}" mode="Equals" Value="">
<SetVar vOpenExcelFile="true"></SetVar>
</if>

<!--Finally, any findings regarding agents that did not run can be exported. 
Note that this report will be generated in the same location that this file 
is being run from.-->
<Export>
<SetParam field="FilePath" value="{%CurFilePath%}report_agentEZ.xlsx"></SetParam>
<SetParam field="SelectedRowsOnly" value="false"></SetParam>
<SetParam field="ExportType" value="Excel"></SetParam>
<SetParam field="Mode" value="AppendRows"></SetParam>
<SetParam field="ExcelSheetName" value="DID NOT RUN"></SetParam>
<SetParam field="OpenFileOnceGenerated" value="{%vOpenExcelFile%}"></SetParam>
</Export>
</if>

</ytriaAutomation>

Find multiple different types of profile documents and create reports of each different type found.

This script can be used by itself in scanEZ to process a currently opened database, or with the new function found in databaseEZ that lets you launch an automation script on a selection of databases directly from within the interface. Learn more about this function here.

This advanced script will iterate over a List containing different user-definable profile document names, and, for each given name, conduct a regex search to find the profile documents that contain a matching name. A multi-faceted report containing a full breakdown of all the items and their values within each document will be exported to an Excel file; each document name's search results will be placed in its own page in the file.

<ytriaAutomation Application="agentEZ" ApplicationVersion="16.5">
<!--This will set the script's behavior when encountering an error. 
In this case, it will continue.-->
<onerror continue="true" ></onerror>

<!--At this point, we don't want to automatically load the detailed agent information. 
This will set it as "false". -->
<Option Type="AutoLoadDetailedAgentInfo" value="False"></Option>

<!--This will allow the automatic Check Presence in NAB feature to be carried out on 
the agent signer for each agent loaded.-->
<Option Type="PresenceInNAB" value="true"></Option>

<!--This will set the option to use the Design Collection Note which is a much 
faster loading option.-->
<UseDesignCollection value="true"></UseDesignCollection>

<!--This defines our search as looking only for scheduled agents.-->
<AgentTriggerType value="Scheduled" ></AgentTriggerType>
<!--This will select all databases on the loaded server.-->
<TreeSelectionLive Value="False"></TreeSelectionLive>
<select target="tree" server="true"></select>
<TreeSelectionLive Value="True"></TreeSelectionLive>
<!--The next part of the script will handle the grid layout so the results are presented 
in a clear order. A Suspend Grid Redraw function is added so the processing will 
be held off until all columns are set.-->
<SuspendRedraw value="true"></SuspendRedraw>

<!--All columns are removed from the main grid in order to prepare for the columns that 
will be added.-->
<RemoveAllcolumns></RemoveAllcolumns>

<!--Second, the columns that we want are added back into the first position 
and in reverse order.-->
<Add ColumnID="STATUS_LOAD" Position="1"></Add><!-- Is Agent Fully Loaded? -->
<Add ColumnID="D33" Position="1"></Add><!-- Is background agent disabled on database -->
<Add ColumnID="B6" Position="1"></Add><!-- Comment -->
<Add ColumnID="D3" Position="1"></Add><!-- Database Type -->
<Add ColumnID="R24" Position="1"></Add><!-- Run on week-ends -->
<Add ColumnID="R23" Position="1"></Add><!-- Stop running agent on this date -->
<Add ColumnID="R22" Position="1"></Add><!-- Start running agent on this date -->
<Add ColumnID="R21" Position="1"></Add><!-- Running Interval -->
<Add ColumnID="M13" Position="1"></Add><!-- Signer -->
<Add ColumnID="B5" Position="1"></Add><!-- Last Alias -->
<Add ColumnID="B4" Position="1"></Add><!-- Name -->
<Add ColumnID="D2" Position="1"></Add><!-- Database Filename -->
<Add ColumnID="D1" Position="1"></Add><!-- Database Path -->
<Add ColumnID="L17" Position="1"></Add><!-- Last Run Duration -->
<Add ColumnID="L15" Position="1"></Add><!-- Last Run Start Date -->
<Add ColumnID="STATUS" Position="1"></Add><!-- Status -->

<!--Then, all groupings are removed.-->
<UngroupAll></UngroupAll>

<!--And we will set a new grouping configuration.-->
<GroupBy ColumnID="D46"></GroupBy><!-- Server -->
<GroupBy ColumnID="R9"></GroupBy><!-- Run On -->
<GroupBy ColumnID="R12"></GroupBy><!-- Agent Schedule -->

<!--Also, a new sorting configuration is set.-->
<Sort columnID="L17" Ascending="false"></Sort><!-- Last Run Duration -->
<Sort columnID="D1" Ascending="true"></Sort><!-- Database Path -->
<Sort columnID="D3" Ascending="true"></Sort><!-- Database Type -->
<Sort columnID="D2" Ascending="true"></Sort><!-- Database Filename -->
<!--All existing filters are cleared, and then the grid processing is reactivated 
by turning off the Suspend Grid Redraw state.-->
<ClearFilters></ClearFilters>
<SuspendRedraw value="false"></SuspendRedraw>

<!--Note that the agent details don't need to be loaded in this situaiton, as this info is 
provided without a full information load.-->
<Filter columnID="R8" Value="checked"></Filter><!-- Enable -->

<!--The following If condition declares that if something is found (and thus making
the grid count greater than 0), the nested child actions will be carried out.-->
<if target="Grid" test="VisibleRowsCount" Mode="GreaterThan" Value="0">

<!--All enabled agents will be selected (rows loaded in the grid).-->
<Select lines="all"></Select>

<!--Then, all the detailed agent information is loaded for all selected lines.-->
<LoadMoreInfo></LoadMoreInfo>
<!--A filter is added to find all agents that are enabled and did run correctly.-->
<Filter columnID="L17" Empty="true"></Filter><!-- Last Run Duration not set... -->

<!--These findings can now be exported. Note that this report will be generated 
in the same location that this file is being run from.-->
<Export>
<SetParam field="FilePath" value="report_agentEZ.xlsx"></SetParam>
<SetParam field="SelectedRowsOnly" value="false"></SetParam>
<SetParam field="ExportType" value="Excel"></SetParam>
<SetParam field="Mode" value="AppendRows"></SetParam>
<SetParam field="ExcelSheetName" value="Enabled Scheduled Agents - LAST RUN"></SetParam>
<SetParam field="OpenFileOnceGenerated" value="False"></SetParam>
</Export>

<!--All filters will be cleared from the Last Run Duration column.-->
<ClearFilters columnID="L17"></ClearFilters><!-- Last Run Duration... -->

<!--A filter is then added to find all agents that are enabled, but did not run 
correctly. A small trick is used here: hiding anything that contains a 
":" character (and thus indicating a duration).-->
<Filter columnID="L17" Mode="NotContains" Text=":"></Filter><!-- Last Run Duration... -->

<!--The following If condition declares that if this script is not being used in a
loop, the Excel file will be opened as soon as it is generated. This can't be done 
if a loop is being run since the Excel file still may need to be worked on with the
results of another server (depending on what you need to do).
Keep in mind that we can't set an If condition with a SetParam value,
hence the use of this variable.
The variable is initialised first, and it will be changed if not in a loop.-->
<SetVar vOpenExcelFile="False"></SetVar>
<if target="var" test="{%ListSize%}" mode="Equals" Value="">
<SetVar vOpenExcelFile="true"></SetVar>
</if>

<!--Finally, any findings regarding agents that did not run can be exported. 
Note that this report will be generated in the same location that this file 
is being run from.-->
<Export>
<SetParam field="FilePath" value="{%CurFilePath%}report_agentEZ.xlsx"></SetParam>
<SetParam field="SelectedRowsOnly" value="false"></SetParam>
<SetParam field="ExportType" value="Excel"></SetParam>
<SetParam field="Mode" value="AppendRows"></SetParam>
<SetParam field="ExcelSheetName" value="DID NOT RUN"></SetParam>
<SetParam field="OpenFileOnceGenerated" value="{%vOpenExcelFile%}"></SetParam>
</Export>
</if>

</ytriaAutomation>

Record your actions to scripts with the powerful new Automation Recorder.

An all-new Automation Recorder takes performance optimization to another level by letting you record and "replay" actions you've performed in the EZ Suite tools. Simply hit Record at the beginning of your process, do your work, and the recorder will save the steps in an independent automation file that can be either recalled at a later time "as is," or modified to fit your needs.

Build your automation lists fast with the 'Create Automation List from Selection' feature.

Thanks to the new Create Automation List from Selection function, you can quickly "export" a selection of entries to a properly formatted List that can be used in an automation script Loop.


Ytria Localization

Ytria Localization

Thank you for your interest in this localization project

We’ve started development on a Web 2.0 interface (see the link at the bottom of this page) for anyone who wants to contribute translated terms. Here you will be able to add, edit, and update translated terms in any language.

Instructions

For Ytria product users

  • Click the Download link next to the desired localized language.
  • Save the .loc file in the same directory as your notes.exe file.

For translators who want to contribute to a localized language

  • Login with your Ytria account. Create an account if you do not have one yet.
  • Click the Edit link next to the language you want to begin translation on.
  • Under the Translation column, click the space next to the English Term and enter your translated term. Existing terms can also be updated.
  • Click the check box under the Done column to save your changes.

When you are ready to begin, click here to access the Localization database.


Ytria Designer Widget [DDE Integration]

Ytria Designer Widget

[DDE Integration]

A Plug-in for the Eclipse-based Domino Designer

The Ytria Designer widget allows for tight integration between the Eclipse-based IBM Domino Designer client and Ytria tools. *A restart of your Lotus Notes client is required after installing a widget

Step 1

In your Lotus Notes client (version 8.5 or higher) go to: File > Preferences > Widgets and make sure the ‘Show Widget Toolbar and the My Widgets Sidebar panel’ checkbox is selected.

Step 2

Click and drag the button below into the My Widgets panel. (Note: this installation method does not work with some versions of Internet Explorer, so as work-around you may right-click and save this Ytria_Designer_widget.xml file to your hard drive and drag and drop the local file).

Step 1

In the window that opens, choose the Install this plug-in option then click OK. Progress bars will appear to indicate the installation process.

Step 2

When installation is completed, click the Restart Now button.

Step 3

A Ytria Designer Widget icon should now appear in the My Widgets panel.

Step 4

The Ytria Designer Widget should now be ready to use in your Domino Designer.

How it works

Step 1

The Ytria Designer Widget allows you to right-click any design elements in the applications sidebar or navigator panel of the Domino Designer client and choose contextually relevant actions with Ytria software.

Step 2

The widget lets you open partial, and non-contiguous selections of design elements in Ytria tools–this can be an enormous time-saver as it circumvents the need to load the entire database in tools like signEZ, actionBarEZ, viewEZ and scanEZ.


Teamstudio CIAO!

Teamstudio CIAO!® Users

All Ytria software tools for Notes and Domino work seamlessly with Teamstudio CIAO!® . Our software looks to see if a design element is being “watched” by Teamstudio CIAO!® and if it is, we will automatically check out the design element for you. After you are done with it, we will also automatically check in the design element. Ytria signEZ users won’t have to worry either; design elements that are signed with a stored ID will be correctly signed even after the check in process.

How Ytria's interface for CIAO! works

Starting with the first instance where a Ytria tool needs to save something in a Notes database, we check for a CIAO! configuration. (This means that just opening a database with a Ytria tool will not trigger a check to see if the database needs to be verified by CIAO!).

When a note is saved in a CIAO!-enabed database, a dialog box will pop up (pictured below), asking you for the comment that will be used for the Check In. This dialog box includes a checkbox option to keep notes checked out. Ytria’s Interface for Teamstudio CIAO

When working on several designs at the same time (like in signEZ or actionBarEZ), the dialog box will appear only once, on the first document, and then the software will use the comment you entered for all the subsequent designs it will save.

You can disable Teamstudio CIAO!® CheckIn/CheckOut in Ytria products by adding the following line in your notes.ini file: YtriaCIAODisable=1

Special instructions with Teamstudio® Release 22a users

Those who are using Teamstudio CIAO!® and Ytria tools, may be experiencing some crash problems when attempting to run Ytria tools. Teamstudio® Release 23 should resolve these Teamstudio CIAO!® compatibility issues with Ytria tools.

In the meantime, to correct this problem, download and install the replacement ndbciao.dll file (below) provided to us from Teamstudio®. Since this is an “unofficial” build from Teamstudio® Release 22a, it would be a good idea to backup the original ndbciao.dll as a precautionary measure. Just in case you experience problems and need to revert to the original Gold release.

The latest release of Ytria tools now all manage this new “special” version of ndbciao.dll (Teamstudio® Release 22a “special”). However, Teamstudio® Release 22a and 22 are still unsupported.

Alternatively, if you are using Teamstudio CIAO!®, add this line in your notes.ini, to disable the use Teamstudio CIAO!® by our products: YtriaCIAODisable=1.

However, you will have to manually manage the check in and check out process yourself.

Reminder list:

  1. You must have Teamstudio® Release 22a installed (other versions will not work with the special .dll file)
  2. Install (replace) the ndbciao.dll file with the one provided on this web page
  3. Make sure you have the latest release of Ytria software installed on your machine


EZ Suite FAQs

EZ Suite FAQs

Here are some of the most popular questions about EZ Suite

Click here for FAQs related to EZ Suite 20 registration and licensing

General

Yes, we have one even better than Notespeek: scanEZ Lite is our free version, and allows you to see and search the entire contents of a database with a wide variety of features.

We realize that there are Notespeek users out there looking for a free tool that works with the latest versions of IBM Notes (formerly IBM Lotus Notes)—and we’re happy to provide that to the IBM Notes community free of charge.

On the flip side, it’s the Full Version of scanEZ that lets you directly edit data and use the more powerful features in the tool: Conflict Solver, (Post) Replication Auditor, comparing documents, mass editing etc. In fact, ALL our tools are available in Lite Versions too. Download and give them a try!

No, scanEZ follows the same security rules as allowed by IBM Notes.

However, as IBM Notes and Domino says, “you cannot have any true security for a local database”. IBM Notes and Domino means that if a database is physically copied onto your computer locally (i.e. through a copy and paste in Windows, not a Notes “replica” or “new copy”), then you will have “local copy”. Anyone with a “local copy” can see and will have access to all the documents inside of it. This means that you will be able to see everything, even without the proper access rights. Since the local database copy is not on a server, no protections will be applied and you can use scanEZ to look at any document.

License Key

The License Key is sent at the time of purchase (in an email titled: “Ytria.com Purchase.”). This is a “generic” key not linked to a specific computer. The License Key is entered into your Ytria software and is required to unlock all product features.

A License Key can be for: an evaluation, a rental or fully paid software.
A License Key is NOT required if you want to use the Lite (free) version of Ytria software.
License Keys are product and version sensitive.

Activation Code

For most users, right after you enter a License Key (or none at all for the Lite version) it will be validated by our server which then automatically sends your software the Activation Code—this all happens quickly in the background during the registration process. If your software can connect to our servers you will never even see the Activation Code.

But, in cases where there are internet connection issues you will have to receive your Activation Code by email (subject: “Ytria: Your Activation Code”)—and will have to enter it manually. Note: this Activation Code is only valid for the computer that requested it and will not work on a different computer.

Uninstall it from your previous machine. Follow the same steps as a new user for the new installation. Just remember to use the username and password you have already created.

Installation

Account Registration dialog box.

A temporary glitch is impeding account creation from the product. We are currently working on it for the next fix release.

Before Connection dialog box.

To circumvent this issue, please go back a step to the “Before Connection” dialog box and choose between suggested options 1 and 2

  • Connect with Browser
  • Register by email

Alternatively, you can also create an account by going directly to our login page.

After this, go to the Account Registration dialog box and choose the “I have a Ytria Account” option, and sign in with your new Ytria username and password.

Connect with Browser

In the “Connect with browser” window, click the “Open browser with URL” button to open your default browser or click on “Copy URL to Clipboard” button so you can manually paste the URL into a browser.

Fill in the registration page that loads. You will then get a confirmation message

The Activation Code will be sent to you by email. Click on “Activation Code” in the Product Activation dialog box, and paste it in the “Enter Activation Code” dialog box.

Register by email

Enter a valid email, and fill out the registration page that follows. An “Enter Activation Code” dialog box will pop up afterwards.

Your Activation Code should arrive in your mail box within 20 minutes. Enter it in the “Enter Activation Code” dialog box.

First of all, be sure that you copy and paste the license key sent to you by email (or from your Ytria Account) to avoid any typing errors. Note that license keys are version-sensitive (a scanEZ version 8.x license key, only works with scanEZ version 8.x).

Also, sometimes users get our product names confused—download the wrong product, enter the license key and then wonder why the license key doesn’t work. This mix-up occurs most frequently between scanEZ and signEZ.

Chances are you entered an Activation Code that was specifically made for a different computer—that old Activation Code will NOT work for another computer. Instead, you will need to use your License Key which is always sent to the buyer by email and is stored in the buyer’s Ytria Account (login required). See ‘Where are my License Keys?’ See below for more details.

License keys are ALWAYS sent to the buyer by email (it may be you, a manager, a purchaser or a reseller depending on your organization). You can try asking your “buyer” for the license keys. When informed, Ytria will allow end-users of our products to also find license keys in their own Ytria Account. You can try logging in to your Ytria Account to see if the license keys are there as well. Otherwise you may contact us, and we will do our best to track down the license keys, with your patience and help.

  • Download File: Save the YtriaEZSuite.zip file to your computer.
  • Decompress File: Unzip (or extract) the YtriaEZSuite.zip file, which contains a YtriaEZSuite.nsf file, to a folder of your choice. Strongly recommended: use your local Notes\data directory
  • Open database and install: In your Notes client open the YtriaEZSuite.nsf database, click the “Install” button and follow the instructions to complete your installation.

For first time users: After clicking “Install”, IBM Notes will show an “Execution Security Alert” dialog box. Choose “Start trusting the signer to execute this action”. You only need to do this once. This will only appear for first time users.

  • Activation: The “Ytria Key Management System” process starts after installation completes. Now you will need to activate your software (see the Activation FAQ for more details).

  1. In File->Preferences->Toolbar preferences, click on the Customize tab.
  2. Select the Ytria toolbar from the list (Select the Toolbar to Modify) at the top of the Customize tab. (If the Ytria toolbar does not exist, you will have to create it. Go to the Toolbars tab, click the New Toolbar button and enter the title: Ytria.)
  3. Click on the New button and select Button from the dropdown menu.
  4. Enter the product name in the Button caption text and the Popup help text fields. The next step will be to enter the formula.
  5. Copy the appropriate formula in the formula field:
    • scanEZ: @DbLookup( “Ytria” : “NoCache”; “scanez.exe” : @Text(@DocumentUniqueID))
    • aclEZ: @DbLookup( “Ytria” : “NoCache”; “aclez.exe” : “”)
    • agentEZ: @DbLookup( “Ytria” : “NoCache”; “agentez.exe” : “”)
    • databaseEZ: @DbLookup( “Ytria” : “NoCache”; “databaseez.exe” : “”)
    • consoleEZ: @DbLookup( “Ytria” : “NoCache”; “consoleez.exe” : “”)
    • replicationEZ: @DbLookup( “Ytria” : “NoCache”; “replicationez.exe” : “”)
    • signEZ: @DbLookup( “Ytria” : “NoCache”; “signez.exe” : “”)
    • viewEZ: @DbLookup( “Ytria” : “NoCache”; “viewez.exe” : “”)
    • actionBarEZ: @DbLookup( “Ytria” : “NoCache”; “actionbarez.exe” : “”)
    • designPropEZ: @DbLookup( “Ytria” : “NoCache”; “designpropez.exe” : “”)
    • formEZ: @DbLookup( “Ytria” : “NoCache”; “formez.exe” : “”)

    Additional

    • signEZ Hotspot: @DbLookup( “Ytria” : “NoCache”; “signez.exe” : @Text(“HOTSPOT_” + @Text(@NoteID)))
    • signEZ Direct: @DbLookup( “Ytria” : “NoCache”; “signez.exe” : @Text(“DIRECT_” + @Text(@NoteID)))
    • scanEZ multiSelection: tgt:=@Environment(“YtriaScanEZExtensionDB”); @If(tgt=””;@Return(@Prompt([Ok];”Error”;”scanEZ Extension Database cannot be found. Please re-install it.”));””); @If(@NoteID=”NT00000000″; @If(@ViewTitle!=””;@SetEnvironment(“YtriaScanEZLaunchParam”;@Implode(@DbName;”!!”)); @Do( @Command([OpenView]); @UpdateFormulaContext; curDB:=@Implode(@DbName;”!!”); @If(curDB!=”!!”;@Command([CloseWindow]);””); @SetEnvironment(“YtriaScanEZLaunchParam”;curDB) ) );@SetEnvironment(“YtriaScanEZLaunchParam”;@NoteID) ); @URLOpen(“notes://”+tgt+”/scanEZ?openform”)
  6. Click on the Change Icon button and select the appropriate image name. If the image does not exist, you will need to copy one of the images below, right-click on the image and select “Save image as”.
  7. Click “Ok” twice to close the two popups and then click on the “Save toolbar” to save your changes. You should now be able to access your software directly from Notes ND6.

This feature is only supported in:

  • Ytria software version 9.1.3 and up
  • Full version software (Lite users will not be able to use a localized version)

If the above criteria are met, then you can download the localized file for your Ytria software.

Click here for further instructions

The latest executable files are available for download here.

Below are all the files that you should delete, however, depending on the product installed it may not exist for you (which is normal).

Installation databases: [Productname].nsf, YtriaEZSuite.nsf

FOR R5.x users

  1. Delete the smarticon for [Productname]
  2. Delete the [Productname].exe, ndbYtria.dll, scanEZ.ini, scanEZMulti.dll in your notes.exe directory
  3. Delete the Ytria “something” .mac and .bmp files in your W32 directory (in the Notes\Data directory)
  4. Delete the Ytria “something” lines in your notes.ini file

FOR ND6.x+ users

  1. Remove the toolbar icon for [Productname], File>Preferences>Toolbar Preferences > Customize > and remove the icon.
  2. Delete the following files in your notes.exe directory:
    • ndbYtria.dll
    • YtriaUpdate.exe
    • YtriaRegister.dll
    • YtriaLang.loc (if localized version is installed)
    • [Productname].exe
    • scanEZMulti.dll (if scanEZ is installed)
    • YtriaRegex.sfd
    • YtriaFormula.sfd
    • scanEZ.ini (if installed)
    • scanEZ.sfd (if installed)
  3. Delete the Ytria and $Ytria “something” lines in your notes.ini file
  4. Delete the Notes\data\YTRIA_TECHNICAL_SUPPORT subdirectory, where dbghelp.dll, and crash logs are stored

This FAQ outlines the typical steps for first time users. By default, this “Ytria Key Management System” process automatically starts right after installation is completed. If you ever need to start this process manually go to the Ytria EZ Suite’s “About This Application” page, and click the “Manage Your Keys” button.

Ytria Key Management System for the EZ Suite

After the installation of the Ytria EZ Suite.

Key Management

I want to use the Lite Version (most users): If you want to use the Lite (free) version, just click the “Activate” button. [You can always enter a License Key or Activation Code later if you wish.]

I have a License Key: If you have a License Key, copy and paste it in the “Enter License Key” box and then click the “Add License Key” button. Once you are finished adding your License Keys (use a carriage return between license keys) click the “Activate” button.

I have an Activation Code (used only if the software cannot connect to our server): If you have an Activation Code, copy and paste it in the “Enter Activation Code” box and then click the “Add Activation Code” button. [Note: You will receive an Activation Code by email only if the software cannot communicate with our server, and after you register using our web form.]

Once completed you will see a “Success” message and can start using the tools. If you are a first time user, you will not use this option. Once you click the “Activate” button, the software will then ask you for permission to connect to our servers for registration purposes (see image below).

Begin Registration

Click “Next” to begin registration

Before Connection

Click “Next” to test your connection to our server and begin to register. If you see a Connection Error, use “Connect with browser” link to see other alternatives.

If testing your internet connection fails, you can try entering your proxy settings (if any) or use the “Connect with Browser” button to connect via a browser.

Alternative 1: Connect with Browser > Open browser with URL: In the “Connect with browser” window, you can click the “Open browser with URL” button to open your default browser, and fill in the registration page that loads.

Alternative 2: Connect with Browser > Copy URL to Clipboard: In the “Connect with browser” window, there is the “Copy URL to Clipboard” button so you can manually paste the URL into a browser.

Using the “Connect with Browser” alternative

Fill Registration Form

Fill in the registration information on the web page that opens; Remember that a valid email address is important! Click the “Register” button at the bottom of the page. An email containing an Activation Code will now be sent to you by email. Enter it in the Activation Code box (see Figure 1).

If you do not have any internet access at all (on say Computer A—the machine you want to install on), click the “Copy URL to Clipboard” button and enter the URL on a machine (Computer B) that does have internet access.

This means you will need to:

  1. Copy the URL (using the “Copy URL to Clipboard” from Computer A) to a USB key. Some users may have to manually copy this URL (yes, it’s fairly long) if a USB key is not available to them.
  2. Physically walk to an internet enabled computer (Computer B), and enter the URL into a browser.
  3. The URL opens a web form (See Figure 2-1 above) which should be filled out to complete registration. An “Activation Code” will be sent to your email address.
  4. Copy the “Activation Code” to your USB key, and physically walk back to Computer A and enter it into your Ytria software. Again, some users may need to copy it manually.
  5. Once the “Activation Code” is entered correctly, you are done! (See Figure 4 below)

Fill in the registration form

Create Account

What you do in the Account Registration dialog depends on whether or not you’ve previously registered any Ytria software.

If you’ve previously registered with Ytria: Just click the “I have a Ytria Account” radio button, enter your information and click “Next”. Wait for the software to test your internet connection, and your Activation Code should be sent to you automatically.

If you’re registering for the first time: Select the “Create a Ytria Account” radio button, fill in the form (legitimate email is important) and click “Next”. Wait for the software to test your internet connection, and your Activation Code should be sent to you automatically. If you’ve previously registered with Ytria Just click the “I have a Ytria Account” radio button, enter your information and click “Next”. Wait for the software to test your internet connection, and your Activation Code should be sent to you automatically. If you’re registering for the first time Select the “Create a Ytria Account” radio button, fill in the form (legitimate email is important) and click “Next”. Wait for the software to test your internet connection, and your Activation Code should be sent to you automatically.

Success!

Success, your Activation Codes (Lite and/or Full) have been applied. Start using the software!

Success

To fully complete registration, click the link in the “Ytria: Please Activate Your Account” email that is sent to you.

This FAQ outlines the typical steps for first time users. By default, this “Ytria Key Management System” process automatically starts right after installation is completed. If you ever need to start this process manually go to the Ytria EZ Suite’s “About This Application” page, and click the “Manage Your Keys” button.

Ytria Key Management System for the EZ Suite

After the installation of the Ytria EZ Suite.

I want to use the Lite Version (most users): If you want to use the Lite (free) version, just click the “Activate” button. [You can always enter a License Key or Activation Code later if you wish.]

I have a License Key: If you have a License Key, copy and paste it in the “Enter License Key” box and then click the “Add License Key” button. Once you are finished adding your License Keys (use a carriage return between license keys) click the “Activate” button.

I have an Activation Code (used only if the software cannot connect to our server): If you have an Activation Code, copy and paste it in the “Enter Activation Code” box and then click the “Add Activation Code” button. [Note: You will receive an Activation Code by email only if the software cannot communicate with our server, and after you register using our web form.]

Once completed you will see a “Success” message and can start using the tools. If you are a first time user, you will not use this option. Once you click the “Activate” button, the software will then ask you for permission to connect to our servers for registration purposes (see image below).

Begin Registration

Click “Next” to begin registration

Click “Next” to test your connection to our server and begin to register. If you see a Connection Error, use “Connect with browser” link to see other alternatives.

If testing your internet connection fails, you can try entering your proxy settings (if any) or use the “Connect with Browser” button to connect via a browser.

Alternative 1: Connect with Browser > Open browser with URL: In the “Connect with browser” window, you can click the “Open browser with URL” button to open your default browser, and fill in the registration page that loads.

Alternative 2: Connect with Browser > Copy URL to Clipboard: In the “Connect with browser” window, there is the “Copy URL to Clipboard” button so you can manually paste the URL into a browser.

Using the “Connect with Browser” alternative

Fill in the registration information on the web page that opens; Remember that a valid email address is important! Click the “Register” button at the bottom of the page. An email containing an Activation Code will now be sent to you by email. Enter it in the Activation Code box (see Figure 1).

If you do not have any internet access at all (on say Computer A—the machine you want to install on), click the “Copy URL to Clipboard” button and enter the URL on a machine (Computer B) that does have internet access.

This means you will need to:

  1. Copy the URL (using the “Copy URL to Clipboard” from Computer A) to a USB key. Some users may have to manually copy this URL (yes, it’s fairly long) if a USB key is not available to them.
  2. Physically walk to an internet enabled computer (Computer B), and enter the URL into a browser.
  3. The URL opens a web form (See Figure 2-1 above) which should be filled out to complete registration. An “Activation Code” will be sent to your email address.
  4. Copy the “Activation Code” to your USB key, and physically walk back to Computer A and enter it into your Ytria software. Again, some users may need to copy it manually.
  5. Once the “Activation Code” is entered correctly, you are done! (See Figure 4 below)

Fill in the registration form

What you do in the Account Registration dialog depends on whether or not you’ve previously registered any Ytria software.

If you’ve previously registered with Ytria: Just click the “I have a Ytria Account” radio button, enter your information and click “Next”. Wait for the software to test your internet connection, and your Activation Code should be sent to you automatically.

If you’re registering for the first time: Select the “Create a Ytria Account” radio button, fill in the form (legitimate email is important) and click “Next”. Wait for the software to test your internet connection, and your Activation Code should be sent to you automatically. If you’ve previously registered with Ytria Just click the “I have a Ytria Account” radio button, enter your information and click “Next”. Wait for the software to test your internet connection, and your Activation Code should be sent to you automatically. If you’re registering for the first time Select the “Create a Ytria Account” radio button, fill in the form (legitimate email is important) and click “Next”. Wait for the software to test your internet connection, and your Activation Code should be sent to you automatically.

Success!

Success, your Activation Codes (Lite and/or Full) have been applied. Start using the software!


To fully complete registration, click the link in the “Ytria: Please Activate Your Account” email that is sent to you.

If you are using Teamstudio CIAO!® and experiencing some difficulties, add this line in your notes.ini, to disable the use of Teamstudio CIAO!® by our products: YtriaCIAODisable=1. However, this means you will have to manually manage the check in and check out process yourself.

Note 1: Teamstudio® Edition 25 users may see this warning message: “Function not found in library. [nhkciao.dll CIAOIsEnabled]” and should use the notes.ini entry given above until further notice.

Note 2: Teamstudio® Edition 22 users should click here for details on how to correct this problem.

Only Lite users will see a pop-up appear on the launching of Ytria tools. Full users with properly entered license keys will not see such pop-up windows—the only exception we make are for software update notifications.

If you are a full user and believe that pop-up is appearing in error; it likely means that you are facing a cache issue. To clear your cache follow the steps below:

  1. Download and save the ClearCache.reg file to your computer
  2. Double-click the file you just downloaded. This will clear your Ytria cache files.

Troubleshooting

If your product is disappearing/crashing on startup (or when you try to connect with our server by using Help > Check for Updates) it’s very likely a proxy issue. Here’s how to correct this issue:

  1. Go to your Windows registry (Start > Run > regedit)
  2. Delete the following folder: HKEY_CURRENT_USER\Software\Ytria\Settings\HTTPProxy
  3. Clearing the proxy settings, should stop the product from crashing/disappearing

Sometimes, it may seem that your changes haven’t been made, when in fact they have (but you can’t see them reflected in Notes).

Why? This is due to the cache size used by Notes. Often, since the cache memory used is fairly large, Notes may simply “not know” that changes have been made, and displays the version that has not been changed yet. Closing and re-opening the database often helps “refresh” the application. Sometimes restarting Notes is needed.

If you get this error, this means that this Ytria .dll file is locked/in use. You need to close your Notes client (you can do this even while Ytria Update is running), and this will ensure that Ytria .dll files aren’t loaded by the Notes client. Once the files are “released,” you can continue with the Ytria update.

Sometimes, it may seem that your changes haven’t been made, when in fact they have (but you can’t see them reflected in Notes).

To take advantage of all the features on our web site, we recommend using one of the following web browsers:

  • Microsoft Internet Explorer 6.0 or higher
  • Mozilla Firefox 2.0 or higher

If you are using an older browser, you can still visit Ytria.com, but you will not be able to use the site to its full extent (Shop page will not work for instance).

Normally when running an update, you will see a list of Ytria software products and .dll files that you have installed on your computer (along with the file’s current version number). If you do not see this list, it is usually a Windows 7 or Windows Vista security issue.

  1. Add the following line to your Notes.ini file: YtriaUpdateFileName
  2. Give this entry a value that does not contain the word “update,” such as “YtriaCheckForNewVersions.exe”
  3. Find your YtriaUpdate.exe file and rename it to match the Notes.ini value you created for YtriaUpdateFileName
  4. Run the Ytria update again (Help > Check for updates…) and the list should now be available.

Explanation: Windows 7 and Windows Vista users may encounter problems using Ytria Update if their Notes directory is installed in their Program Files directory (we discourage using this directory for Notes installations). This issue causes the Ytria Update to fail to see which Ytria tools are installed. As a work-around, you may rename your YtriaUpdate.exe file. The YtriaUpdate.exe file should be in your Notes directory. If you do rename your YtriaUpdate.exe file you must create this Notes.ini entry and enter the new file name as the value, for example: YtriaCheckForNewerVersions.exe

This issue has been addressed, and will be fixed in our next update. Please note that clicking OK lets you continue without any problems.

Please note that the new “Check Presence in NAB” option is enabled by default. If you have a large NAB and a poor connection, the NAB Checker process may stall your system.

This feature is present in scanEZ, signEZ, databaseEZ, agentEZ and aclEZ, and can be enabled/disabled in the Options menu (in scanEZ, this can be done in the ACL interface’s “Expand…” drop down menu).

The last chosen state remains on subsequent starts of the tool until it is changed by the user.

In IBM Notes 9, the new option “Show toolbars only when editing” is enabled by default, thus hiding toolbars most of the time.

Disable this option in the Notes client to display the Ytria toolbar.

Only users who need to manually enter the Activation Code will receive this email.

After filling in the registration form on our Web site, our server will send an Activation Code to the email address specified by you. If after following the precautions below you still do not receive your “Ytria: Your Activation Code” email—let us know and we will send it to you manually (Note that we cannot create an Activation Code for you…You must fill in the form first…).

If you do not get your Activation Code (usually within 15 minutes), it is likely because:

  • Incorrect email address – the server will send the message to the wrong email address and you will never get it! Typing errors are extremely common! You can login to your account and change your email address in the Profile section.
  • Your mailbox is full – our message can’t be stored in your mailbox and you won’t get it!
  • Check your junk/spam mail – You or your internet provider use anti-spam programs which blocks the Activation Code email as spam. Please ensure that the following email address is allowed to be received by you: customer@ytria.com.


EZ Suite 16

The wait is over, the game has changed. EZ Suite 16 is here!

Ytria’s EZ Suite, already the most extensive toolkit for IBM Notes and Domino available, has gone through some radical developments since our last version. EZ Suite 16 is our dev team’s hard work materialized into a revamp of everything you’ve known about our tools and how we let you work with your data.

Record your actions to scripts with the powerful new Automation Recorder.

An all-new Automation Recorder takes performance optimization to another level by letting you record and “replay” actions you’ve performed in the EZ Suite tools. Simply hit Record at the beginning of your process, do your work, and the recorder will save the steps in an independent automation file that can be either recalled at a later time “as is,” or modified to fit your needs.

Launch scripts on a current selection through other EZ Suite tools.

Bridges between EZ Suite tools have become far more robust! Thanks to a new right-click menu option for multi-server and multi-database tools (not applicable to consoleEZ), you can now process a current selection of entries through other tools by employing a pre-saved automation script. Process a selection of servers with agentEZ or aclEZ, process a selection of databases with scanEZ—the possibilities are huge, and only a few clicks away!

Build your automation lists fast with the 'Create Automation List from Selection' feature.

Thanks to the new Create Automation List from Selection function, you can quickly “export” a selection of entries to a properly formatted List that can be used in an automation script Loop.

The flexYgrid

Faster, stronger, and better data parsing and handling capacity

One immediately noticeable improvement that affects every operation performed in any EZ Suite tool, is the heightened capacity and speed of the flexYgrid engine itself—10x faster in conservative estimates. Quicker loading, grid building, and data handling for an even larger amount of grid entries ensures an even more efficient administration and development boost across the board. No more restrictions or need to filter out what you show in the grid from a performance standpoint; the flexYgrid lets you handle it all.

Improved navigation precision and power

With even less limits on the amount of data that you can handle at once, precise ways to get to the data that you need are more important than ever. In this respect, the flexYgrid is filled with newly refined navigation options that let you take full advantage of the complete scope of your tools without missing a beat.

Superior Group and Sort functionality

Building upon the same intuitive Group and Sort operations that have always been present in the EZ Suite tools, new improvements offer a greater amount of flexibility than was previously possible. With sorting functions that operate independently between grouped columns and column entries, it is possible to perform separate sorting operations—with separate formats—on both your groups, and on the entries in the grouped columns. For example, group by a date and format the date to display the month, day and year, then sort your entries chronologically by time (or the reverse) within the individual dates.

Group functions are now expanded and include the ability to calculate and display Count, Sum, Average, Minimum, Maximum, and even Delta values in the Group grid entry. These totals are also independently sortable. Color formatting for groups has been expanded and now lets you set both the cell color and text color for greater visibility.

All-new possibilities for cutting through clutter include new filter options, intelligent filter menus, revamped value filter dialog, and more

Brand new filter options let you exclude empty cells, or a manual selection of entries, in only a couple of clicks.

Filtering functions have also improved across the entire EZ Suite. At first glance it may seem that some filters have been removed, but this is due to a more intelligent, context-based menu. Only the filtering options that apply to the column you are working with will be shown.

The “Values” filter has been completely rethought and now offers you search capabilities within its easy-to-use dialog.

Revert your tailored configurations to their origins at any time thanks to new multi-strength reset options that allow you to step back through your filtering/formatting operations towards your default settings, or even the original “factory” configuration.

Functional formatting enhancements: the multi-type column

An evolutive part of the new flexYgrid is the ability to parse and work with real item value types; whereas the “text-only” value translations in previous versions affected a bit of the functional integrity of the original Notes item values. This opens up a world of possibilities for custom data formatting options. For now, this is only used in certain parts of scanEZ, but this is only the beginning.

Expanded exporting

Exporting your data is now easier than ever thanks to one-click toolbar access, a more logical dialog layout, and improved interactivity with export preferences.

Add your own temporary data points to your grid

New annotation options give you a powerful method to create temporary comments or entries directly within the grid. You can work with these entries in the same way as you work with any other data point.

Save and recall everything that you configure

Set your configuration and save it to a preset file or set it as the default for any individual grid panel—you can create and save as many preset configuration files as you like.

Easy gateways to the most important features in the tools

Be it an all new feature, or a feature that was always there but slightly hidden, both a new toolbar, and the CTRL + Right Click shortcut, put access to all the important global functions of the flexYgrid only a couple of clicks away.

Central controls for every aspect of your grid

The new Grid Manager is a fully integrated, one-stop access point and control center for every property and formatting option in your grid. This is available in every grid panel, and gives you real-time control of what and how your grid displays your data.

Built-in pivot table builder

In V16, wherever you have a grid, you also have—right at your fingertips—powerful built-in functions for creating helpful pivot tables that consolidate your grid data into a presentation that highlights only your desired information.

Exclusive data comparator tool

Through a brand-new, patent pending tool, you can perform qualitative data checks without any need for external tools. These results will be embedded directly within the original data set and are themselves available to be used as data points for further analysis. Color coding, data family comparisons, and more in an exclusive tool not offered by any other solution on the market—period.

New in automation

If the flexYgrid can do it, it can be automated

Thanks to the new innovations that make up the flexYgrid engine and interface, everything that can be done in the flexYgrid can be automated. Grid configurations, pivot table building, replication check-ups, data comparisons, and more. If you can do it once in the flexYgrid, it can be programmed to be recalled on command. Batch operations have now become automation operations, and the products that have benefitted the most from this change are scanEZ and designPropEZ.

New in scanEZ

Multi-database document copying/moving

Restore operations are forever changed thanks to a new function in scanEZ that allows you to copy a selection of documents to one or more databases while maintaining the original file structure—if the destination database has a different structure, the database will first be “prepared” and will then receive the documents in their proper locations.

Previously inaccessible values and item properties as display titles

Identify your documents and designs quickly thanks to brand new abilities to scan and select previously inaccessible Document, Note, and Item properties as the document display title. These possibilities include values that aren’t even available in Notes such as the “Added in this file” date.

Direct encryption controls

Direct encrypt/decrypt functions now available. Encrypt or decrypt the database itself, locally—directly from the main database panel.

Complete parent/response hierarchies

Entire parent/response document hierarchies are now visible—a long sought after function has now been realized! Manage these links better thanks to a complete overview of these important relationships.

All-new possibilities for automation

The way EZ Suite can handle automation scripts has gone through a huge overhaul since the ability was first introduced in version 12. The flexYgrid has allowed automation to become a part of almost every nuance of the EZ Suite tools’ operation, but the tool that shows the largest leap forward in terms of these advancements is our flagship tool scanEZ.

What was once limited to a few features such as the Replication Auditor, Post-Replication Auditor, a few Search functions, and the Notes.ini editor, has now been expanded to include scanEZ’s entire range of functionality. You can now access the Diff and Values tools, perform complex Copy/Move operations, interact with My Selection folders, and more. All of these features can easily be repeated across multiple databases.

New in aclEZ

Extensive Effective Access calculation improvements

The Effective Access calculations have been deepened and improved across the board. Although the Expand Nested Group feature gave you a huge advantage in seeing any and all groups, their members, and their access levels, there was still a calculation needed on the part of the user to determine which access level would prevail. Now all of these calculations are automatic; the level of Effective Access is consolidated into an easy-to-read chart that encompasses the entire catalog of users and up to an entire server of databases.

Catalog Category property

For those of you that do use the catalog.nsf, a newly available property, aptly titled Catalog Category, will allow you to have the category tag available in your grid to sort, filter, and group by.

Group management expansion

Beyond the addition of flexYgrid functionality in all the grids within the NAB Group Navigator and the “Find users not in any Group” feature, key limitations have been unlocked that allow you to manage all aspects of ACL groups from directly within the tool.

Search and Replace functions are available within the right-click menu, and make it easy to choose a selection of group entries or members using a given string as selection criteria, and then replace that given string with a new one of your choice. This is extremely helpful if mass corrections are needed.

What’s more, the “Find users not in any Group” allows you the option to choose any number of members that are found to not be part of any groups, and add them to the group (or groups) of your choice in a couple of clicks.

What’s new in group management

'Convert to Team' button: connect Teams to existing Office 365 groups NEW

Why limit yourself to creating a team for one Office 365 group at a time in the Teams application? With sapio365, it's as simple as selecting your Office 365 groups and clicking the 'Convert to Team' button.

Added new columns: Drive information

Just like in the Users grid, we’ve added property columns displaying various drive information for groups. Sort and filter relevant columns to see which groups have reached their consumption quota, or categorize them by their quota state to get a general idea of storage consumption.

Added new column: ‘Add Guests’

You can now see if a group can accept guests. If the “Add Guests” property is displayed as “True” for a group, then that group accepts guests. This effective state value is calculated based on the values of the tenant-level setting and of the group’s group-level setting

EZ Suite:

Try it now!

See just how much faster and more fluid your HCL Notes and Domino administration and development can be.