Appendix B: Extras

dfc.Properties

The editor offers fast access to the configuration files of Documentum. It is available from the Edit menu and opens the first file found following the environment path. Also, the reference file dfcfull.properties will be open, if found, in which case all available commands are loaded from this file and will be available as value assistance that will appear either if dfc. is entered or by pressing Ctrl +Space.

How and when changes to the dfc.properties file will take effect depends on the dfc behavior. It may vary between different dfc versions.

The ACL Viewer

The ACL viewer displays ACLs for viewing and/or editing and is called either from the View (à View ACL) menu or from the context menu of the DQL result list.

It is activated only if an active session is available and either the selected objects in the DQL result list are ACLs or an ACL is assigned to them (like dm_document or dm_folder) and the attribute r_object_id is available in the list.

The ACL list contains all ACLs from the selected objects of the DQL result list. To view or edit properties, you can select an ACL from the list.

ACLs will only be added to the list once. Therefore, the number of selected objects can differ from the of the number of the ACLs in the list.

The Usage area informs about the usage of the ACL in the current repository.

Change permissions You can modify one or more selected permissions by clicking the Edit button. If more than one permission is selected, only the changes will be applied, unchanged fields will be ignored. For example, all groups can be assigned an extended permission without changing the basic permissions or the values of the other extended permissions.

Add permissions The Add button opens a dialog to add one or more new permissions. If an existing permission has been selected before, the settings of this permission will be copied to the dialog as default.

To search for a group or user, you can enter an expression (begins with) in the Search field. The Filter limits the displayed users and/or groups:

Parameter	Selection
All:	All users and groups
User:	Users only
Group:	Groups only

Additionally available for Template ACLs:

Parameter	Selection
Users and groups	Users and groups
Qualified aliases	Qualified aliases only
Unqualified aliases	Unqualified aliases only

You can select multiple members from the list and add them at once with identical permissions. You can repeat this procedure until either the list of the users is empty or the dialog is closed.

Delete permissions You can delete the selected permissions by clicking the Delete button.

Save changes You can save your changes in two different ways:

• Save to ACL: Saves the changes to the ACL object. All objects that have been assigned this ACL are affected.

• Save to Object: Saves the changes to the object only, that is, a new ACL is created and assigned to the objects selected in the DQL result list. This function is only available if the object from the DQL result list is not an ACL itself. If more than one object with the same ACL is selected in the DQL Result List, a new ACL is created for each of them.

View group members If permissions are assigned to group names, the contained users and their resulting permissions can be displayed with the function Show users from the context menu.

You can select one or more groups.

In that list all users are displayed, together with their group names, the highest resulting basic permission as well as the aggregated extended permissions.

Copy permissions You can copy the selected permissions among different ACLs using the functions Copy, Cut and Paste from the context menu. The behavior is the same as using the common clipboard functions.

If a permission is inserted into an ACL which grants permissions to already existing users or groups, several options are available:

Option	What It Does
Replace	The old permission is deleted and replaced by the new one.
Merge	Permissions are merged, meaning the higher basic permission is assigned and the extended permissions are aggregated.
Skip	This permission will not be pasted.

Content Restore

The Content Restore template allows the restoring of deleted non content-less objects (usually dm_document and its descendants).

The plugin adds two functions to the context menu of the DQL result list. They are available, if the list contains dmr_content objects.

Example query: Select * from dmr_content where parent_count=0;

Content File: View This function opens the content of the dmr_content object for viewing. It is allowed for all objects in the list, regardless if they are deleted (parent_count=0) or are still linked to a dm_sysobject.

Content File: Restore A dialog opens to allow some settings for the restore. The name is prefilled with the original filename taken from the attribute setfile. ACL and folder link is not mandatory.

Click Restore content to create a new object of the selected type and to place it in the selected folder. Attributes cannot be restored for technical reasons.

If more than one object is selected to be restored, the dialog is loaded with the data for the next object.