# 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. The number of the strings and the names used are dependent on the workflow to be started.

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

### 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">
>       <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>
>     </do-start-workflow>

## 1. Allowed Content

> arg-password
>   password argument
> arg-dn
>   DN argument
> arg-string
>   string argument

## 2. Attributes

> Attribute | Value(s) | Default Value
> --- | --- | ---
> disabled | true | false true if this element is disabled | false
> id | CDATA the LDAP format DN of a user authorized to start workflows on the User Application server supports variable expansion | #REQUIRED
> notrace | true | false true if this element should not be traced during execution of policy | false
> url | CDATA the URL of the User Application server where the worflow will run supports variable expansion | #REQUIRED
> workflow-id | CDATA the LDAP format DN of the workflow to start supports variable expansion | #REQUIRED

## 3. Content Rule

> ( arg-password , arg-dn , arg-string * )

## 4. Parent Elements

> actions
>   actions that are performed by a <rule>
> arg-actions
>   actions argument

Top Elements || All Elements || Tree