Start Workflow

Starts the workflow specified by workflow-id for the recipient DN on the User Application server specified by a URL and by 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. Multiple values can be specified delimited by a semi-colon(;). If the semi-colon is part of the value, then it should be escaped by using a backslash(\). The number of the strings and the names used are dependent on the workflow to be started. If a policy containing this action encounters an error, Designer generates the error as the local variable error.do-start-workflow. For more information about local error variables, see Local Variable Selector.

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. By default, Operation event correlation is used. If no value is specified for the identifier, default value is used.

    NOTE:CorrelationID is not available in the Policy Builder user interface of this version.

If any 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 Selector.

User Application URL

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

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 Selector.

Timeout Value

Specify the number of milliseconds you want Identity Manager to try to establish a connection to the User Application server before timing out. The default value is 0.

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.

Strings

Specify the arguments for the workflow.You can enter the strings manually, or select the Edit the strings icon Edit the Strings icon to open the Named String Builder and specify the strings. For more information about the Named String Builder, see Named String Builder.

The arguments are defined on the workflow. Depending on how the workflow is defined, some of the arguments might be required for the workflow to start.

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