Role extensions
Role extensions are extensions points for a role.
Parameters
The parameter given is either an instance of the RoleExtensionParameter class or zero parameters.
If called with zero parameters, the script should return documentation for itself.
If the script is called with other parameters, then the script is not called via the Role framework, which can be useful if scripts can be utilized for other functions.
Documentation
When the role extension is called with zero parameters, it should return some documentation for itself.
The documentation consists of a RoleExtensionDocumentation class instance.
Depending of the role extension works on users or roles, the actual value returned may be a RoleExtensionUserDocumentation, or a RoleExtensionRoleDocumentation. It is also possible to return a RoleExtensionEventDocumentation for those extensions that are event on changes to membership of a role, these are called automatically so documentation makes little sense.
Helper functions/classes
Discovery of role extensions
Role extensions are discovered in the following order:
- Workflow scripts may be defined in folders named "Role exts" anywhere in the system.
- If the current user does not have read access to the role extension itself, then the extension is ignored.
- If the documentation has LimitToPath, then that is examined to filter out if not applicable to current role.
