EZ Suite FAQs

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.

All EZ Suite tools are NOT affected by the Log4j vulnerability in any way. EZ Suite products are developed in C++ and do not use any Java library.

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

Ytria automation API lets you perform large, repetitive tasks quickly and efficiently. Ytria’s tools sees the focus of the command language and the scope of possibilities greatly expanded.

To know more how you can start putting automation to work for you, click here.

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.

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.

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.

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

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.