Start Workflow

Starts the workflow specified by workflow-id for the recipient DN on the User Application server specified by a URL and using credentials specified by the ID and password. The recipient must be an LDAP format DN of an object in the directory served by the User Application server. The additional arguments to the workflow can be specified by named strings. The number of the strings and the names used are dependent on the workflow to be started.

Remark

There are some names that have special meaning and are available regardless of the workflow being started.

  • :InitiatorOverrideDN: The LDAP format DN of the initiator of the workflow, if other than the User used to authenticate.

  • :CorrelationID: An identifier used to correlate related workflows.

If any type of error occurs while starting the workflow, the error string is available to the enclosing policy in the local variable named error.do-start-workflow. Otherwise that local variable is unavailable.

Fields

Provisioning Request DN

Specify the DN of the workflow to start in LDAP format. Supports variable expansion. For more information, see Variable Expansion.

User Application URL

Specify the URL of the User Application server where the workflow will run. Supports variable expansion. For more information, see Variable Expansion.

Authorized User DN

Specify the DN of a user authorized to start workflows on the User Application server in LDAP format. Supports variable expansion. For more information, see Variable Expansion.

Authorized User Password

Specify the password of the authorized user to start workflows on the User Application server. Store the password as a Named Password on the driver object. This allows the password to be encrypted when it is stored.

Recipient DN

Specify the DN of the recipient of the workflow in LDAP format.

Additional Arguments

Specify the arguments for the workflow. The arguments are defined on the workflow. Some of the arguments might be required for the workflow to start. It depends upon how the workflow is defined.

Example

The following example starts a workflow process each time there in an add operation. The workflow is a request for a cell phone. To view the policy in XML, see start_workflow.xml.

Policy starts a workflow process to request a cell phone for each add operation
Start workflow