Show/Hide Toolbars

Therefore Programming Interface 3.0

Therefore API > What's New

What's new in Thereforeā„¢ 2020

Scroll

 

Modified feature: Role Based Permission Control

With Thereforeā„¢ 2020 all permission management is based on roles.

A role is a collection of permissions and can be assigned to a user or group on a Thereforeā„¢ object like categories, case definitions, workflow processes and folders but also on any other supported object like indexing profiles and many more.

TheRoleAssignments class is used to assign roles to users on a specific object (replaces the obsolete class TheSecurity) and is a collection of TheRoleAssignment objects.

Role assignments can have Conditions so that the role assignment only applies if the condition is met. Conditions can only be set for categories and case definitions.

 

TheRolePermission contains properties, each for a single permission (replaces the obsolete class ThePermissionConstants) while TheRoleAccessMask can contain a collection of permissions and is used for safely combining permission values and as parameter for several methods (replaces the obsolete class TheAccessMask).

Note that some permission values have changed. Do not mix permission values from new classes and methods with values from old classes and method.

 

Many methods and properties have been replaced to make use of the new classes exclusively. All old methods and classes are still usable for existing developments and are still compatible.

The ITheRightsServer interfaces will continue to work with old values. A replacement interface is planned for the next release.

 

New Classes

TheClientConnectionSettings

TheClientDiscoveryInfo

 

TheRole

TheRoleAccessMask

TheRoleAssignment

TheRoleAssignments

TheRolePermission

 

Obsolete Classes

TheAccessMask

ThePermission

ThePermissionConstants

ThePermissionList

TheSecurity

 

New Properties

TheCategoryField.SortDescending

 

TheFullTextQueryResultRow.IndexData

TheFullTextQueryResultRow.RoleAccessMask

TheQueryResultRow.RoleAccessMask

 

TheDependentFieldsQueryResult.AllRowsReturned

TheServer.CustomerId

TheTask.CaseNo

 

New Methods

TheDocument.GetThumbnail (new overload)

TheMultiQuery.ExecuteAsync (new overload)

TheQuery.ExecuteAsync (new overload)

 

TheServer.GetCategories (new overloads)

TheServer.GetClientDiscoveryInfo

TheServer.GetKeywords (new overload)

TheServer.GetObjects (new overloads)

TheServer.GetObjectRightsRole

TheServer.GetPublicSettingInt

TheServer.GetPublicSettingString

TheServer.HasPermission (new overloads)

TheServer.RenameObject

TheServer.ResetUserPwd

TheServer.SetUserPassword

TheServer.ShowCategorySelectionDialog (new overload)

 

Ā© 2023 Therefore Corporation, all rights reserved.