Configure Asset Timer

Configuration of this Xinet Portal plug-in involves four steps:

•	Adding an image used in watermarking

•	Configuring a Exhibit-style site

•	Xinet database configuration

•	Editing your Xinet Portal templates

The procedure

The Xinet Portal distribution contains sites preconfigured to use Asset Timer, i.e., the Exhibit sites.

1.	Begin by adding a new site and configure it. (Refer to Xinet Portal Server Properties if you need help.)

2.	Assign a watermark image on the Xinet server’s Volumes/Users, System Volumes, Preview Settings page.

3.	Configure the Xinet database for Asset Timer:

a.	Using the nativeadmin GUI on the Xinet server, enable the database for all volumes available to the users that will be utilizing the Asset Timer.

b.	Go to the Data Fields tab and edit the data fields, usage_start_date, usage_end_date, and usage_locked, determining whether or not to write XMP data, the display format and optionally, assigning a local.js variable. If set, usage_locked overrides usage_end_date and/or usage_start_date.

c.	Also add these data fields to any users’ templates where you want to employ Asset Timer.

d.	Using the Database, PermSets tab, set up PermSets to be used by the Asset Timer administrator, and then by users.

For the Asset Timer administrator, the permission set must have the Data Field Settings for Visible, Searchable, Browse checked and a Field Type value of Edit for both of the new data fields added above, as shown below..

For each Asset Timer user, the permission set must have the Data Field Settings for Visible, Searchable, Browse checked and a Field Type value of Locked for both of the new data fields added above, as shown below:

4.	Assign these PermSets to users as appropriate.

Extending Asset Timer to parents and children [optional]

Some sites, for example, those where a photo montage might be assembled, with each element having different usage rights, may want to extend the Asset Timer locking mechanism (AT Locked) so that Asset Timer will also:

•	Lock any sub-folder within an expired folder (ATFolder Locked)

•	Lock any file in which an expired asset has been used (ATChild Locked)

These options work independently of one another,and by default, will be off.

About MultiLevelLinkedFiles

Keep in mind that the MultiLevelLinkedFiles setting in the Xinet database has an effect on how Asset Timer child locks will be applied: when multi-level links are disabled, only direct links to a child can lock a file using Asset Timer; when these multi-links are enabled (the default), multiple levels can be locked.

To check the MultiLevelLinkedFiles setting ( 1 = engaged; 2 = off) in the searchenginesettings table, use the following command:

mysql> SELECT * FROM SEARCHENGINESETTINGS WHERE SettingName = "MultiLevelLinkedFiles";

If you find that multi-level links are not engaged, and you would like to change the setting, use the following command:

mysql> REPLACE INTO SEARCHENGINESETTINGS (SettingName,SettingValue) VALUES ("MultiLevelLinkedFiles",1);

Some examples of extended Asset Timer locks

Given the following relationships (shown in Figure •):

•	/Vol1/FileA is contained in /Vol2/FileB

•	/Vol2/FileB is contained in /Vol3/FileC

•	/Vol2/FileC is contained in /Vol4/FileD

If folder /Vol4 and file /Vol2/FileC are AT Locked, and...

•	Both ATFolder Locks and ATChild Locks are on:

FileA is child-locked when multi-level links are on, FileB is child-locked, FileC is AT Locked and FileD is ATFolder Locked.

•	ATFolder Locks are on and ATChild Locks are off:

   FileB is AT Locked and FileC is ATFolder Locked.

•	ATFolder Locked is off and ATChild Locks are on:

FileA is ATChild Locked if multi-level links are on, FileB is ATChild Locked and FileC is AT Locked

•	ATFolder Locks are off and ATChild Locks are off:

Only FileC is AT Locked.

To enable additional Asset Timer locking:

1.	To turn on Asset Timer Folder Locks (ATFolder Locks), set FolderATLocksContent to 1 in the searchenginesettings table.

mysql> REPLACE INTO SEARCHENGINESETTINGS (SettingName,SettingValue) VALUES ("FolderATLocksContent",1);

Using the value, 0, will turn off ATFolder Locks. By default, this setting will be off. 

Once this option is enabled, a folder that has been locked by Asset Timer will also lock any files it contains, at any sub-folder level.

2.	To turn on Asset Timer Child Locks (ATChild Locks), set the ChildATLocksParent setting to 1 in the searchenginesettings table:

mysql> REPLACE INTO SEARCHENGINESETTINGS (SettingName,SettingValue) VALUES ("ChildATLocksParent",1);

Using the value, 0, will turn off ATChild Locks. By default, this setting will be off. 

Once this option is enabled, a file that has been either locked by Asset Timer or ATFolder Locked will also lock any files in which it is contained, at all parent levels.