Workflow configuration

Page save and Account creation Approval#

Page saves and account creation are two types of tasks that run under the workflow manager and, as such, can be configured to require the approval of some user/group to be effective.

The name of the workflow or decision is the part of the key after jspwiki.approver.. This is a logical name JSPWiki uses to determine which Principal to consult for approval.

The Principal is identified up by AuthorizationManager at runtime; it looks for a Principal match as follows: GroupPrincipals, Roles, WikiPrincipals/other principals. Thus, if a value of Admin is supplied JSPWiki will first check the GroupManager to see if group Admin exists; then the container roles, if any; then, user Principals. If the value is blank or the property is commented out, it means that the workflow does not require approval.

Example#

Add the next line to your jspwiki[-custom].properties file to require the Admin group (or Admin user, if a group is not found) to approve wiki pages after saving:
jspwiki.approver.workflow.saveWikiPage=Admin

Add the next line to your jspwiki[-custom].properties file to require the Admin group (or Admin user, if a group is not found) to approve new user profiles:

jspwiki.approver.workflow.createUserProfile=Admin

Once one, or both, properties are provided, workflow items will start to appear on the Workflow's inbox for both the requester and the user/group of Approvers.

The page save and the account creation code sits under the org.apache.wiki.tasks package, whereas the workflow management itself sits under org.apache.wiki.workflow package.


Category.Documentation