do-start-workflow

The <do-start-workflow> action starts the workflow specified by workflow-id for the recipient specified by <arg-dn> on the User Application server specified by url using credentials specified by id and <arg-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 may be specified by named <arg-string>'s. Multiple values can be specified delimited by a semi-colon(;). In case, a 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. There are some names that have special meaning and are available regardless of the workflow being started.

Name	Description
: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. Default: Operation event correlation id is used if no value is specified.

There will be one of these two local variables available to the enclosing policy depending on the success or failure of this request.

• success.do-start-workflow : This local variable will be available only if the workflow is started successfully. And it contains the Instance id of the provisioning request.
  
• error.do-start-workflow : This local variable will be available only if any type of error occurs while starting the workflow. And it contains the error string.

Example

<do-start-workflow id="cn=WorkflowAdmin,o=People" url="http://localhost:8080/IDMProv" workflow-id="CN=ApproveCellPhone,CN=RequestDefs,CN=AppConfig,CN=UserApplication,CN=DriverSet,O=novell" time-out="30000">
  <arg-password>
    <token-named-password name="workflow-admin"/>
  </arg-password>
  <arg-dn>
    <token-parse-dn dest-dn-format="ldap" src-dn-format="qualified-slash">
      <token-xpath expression="@qualified-src-dn"/>
    </token-parse-dn>
  </arg-dn>
  <arg-string name="provider">
    <token-text>ACMEWireless</token-text>
  </arg-string>
  <arg-string name="reason">
    <token-text>new hire</token-text>
  </arg-string>
  <arg-string name="email">
    <token-text>jmiller@acme.com; jack.miller@gmail.com; jackm@outlook.com</token-text>
  </arg-string>
  <arg-string name="text">
    <token-text>one, two, and three\; a, b, and c\; first, second, and third</token-text>
  </arg-string>
</do-start-workflow>