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.

Discovery of role extensions

Role extensions are discovered in the following order:

1. Workflow scripts may be defined in folders named "Role exts" anywhere in the system.
2. If the current user does not have read access to the role extension itself, then the extension is ignored.
3. If the documentation has LimitToPath, then that is examined to filter out if not applicable to current role.