18.4. Customizing the workflow

Note

For more details about jBPM please read the appropriate JBPM Reference Guide from the SOA Platform documentation suite; http://docs.redhat.com/docs/en-US/JBoss_Enterprise_SOA_Platform/
The process definitions are located in: portal-identity.sar/conf/processes. To create a custom workflow, you can extend the existing process description file: custom.xml.
Available variables in the business process:
  • name: portalURL type: java.lang.String description: represents the full url of the portal e.g. http://localhost:8080/portal
  • name: locale type: java.util.Locale description: the requested locale at registration
  • name: email type: java.lang.String description: the e-mail address of the user in case of registration. In case of changing the e-mail the new e-mail address.
  • name: user type: org.jboss.portal.core.identity.services.workflow.UserContainer description: Seralizable Object containing user information through the jBPM process
  • name: validationHash type: java.lang.String description: hash used for the validation part. Only available after executing SendValidationEmailAction

Note

Make sure that the filename and the process name match! e.g. conf/processes/custom.xml and process-definition name="custom".
When using a custom workflow it is possible to customize the status message after registering in the locale bundle: ( e.g. portal-identity.sar/conf/bundles/Identity.properties)

IDENTITY_VERIFICATION_STATUS_REGISTER_CUSTOM=Customized message here

18.4.1. Duration of process validity

By default requests (e.g. e-mail validation and registrations) expire after some time in the validation state. Therefore it is not required to add additional maintenance mechanism to invalidate a request. The default expiration time is 2 days, but is quite easy to change the timing by editing the duedate attribute in the process definition. changes in: portal-identity.sar/conf/processes/*.xml
<process-definition>
...
  <state name="validate_email">
      <timer name="time_to_expire" duedate="2 days" transition="timedOut" />
  </state>
...
</process-definition>
For more details about jBPM please read the appropriate JBPM Reference Guide from the SOA Platform documentation suite; http://docs.redhat.com/docs/en-US/JBoss_Enterprise_SOA_Platform/.