Show/Hide Toolbars

Therefore Programming Interface 3.0

This interface is outdated. Use ITheRightsServer64.

 

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).

 

 

 

 

Ā© 2023 Therefore Corporation, all rights reserved.