Therefore Programming Interface 3.0

The Thereforeâ„¢ Rights Server interface is an easy to implement COM Interface to override the default Thereforeâ„¢ Rights with custom rights. It is also possible to only override certain rights and use the Thereforeâ„¢ Default Settings for the remaining rights. Additionally you can extend the default Thereforeâ„¢ Rights with special rights on the document level (see functions AllowArchive, AllowRetrieve,...).

 

Common Strategies to Implement the Thereforeâ„¢ Rights Server

 

Not all Functions of the Thereforeâ„¢ Rights Server have to be implemented. If a function is not implemented, developers can always throw a not Implemented Exception and then Thereforeâ„¢ Default Procedures will be used and this Thereforeâ„¢ Rights Server Function will not be called in the future.

 

Strategy 1: Implement GetObjectRights

Thereforeâ„¢ Default Rights will be used for everything except for documents like categories and case definitions.

 

Strategy 2: Implement GetDocRights

GetDocRights will be called by the Thereforeâ„¢ Viewer every time a document is displayed. There is one restriction: Only for documents with permissions on document level the Rights Server is invoked. In the database table TheDocument the value of the column Security needs to be set to either 1 or 2. 1 stands for document permissions only and is used if the permission inheritance is broken directly on the document. 2 stands for a combination of permissions from document level and category. The standard approach is to add a database trigger to set this value for all desired documents (to the value 2). This allows to mark a document to be handled by the Rights Server without the need to specify any additional permissions for the document.

This function will be implemented and handles all the right for all documents. Please note that in this case implementation has be done carefully to prevent giving extensive right to the user (especially take care to handle the delete right correctly).