> For the complete documentation index, see [llms.txt](https://docs.advantys.com/workflowgen-administration-module-reference-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.advantys.com/workflowgen-administration-module-reference-guide/workflow-applications/startprocess-workflow-application.md).

# STARTPROCESS

## Overview

The **STARTPROCESS** workflow application lets you launch a new request with the corresponding parameters. It provides a simple solution for inter-process communications.

There are three ways to use STARTPROCESS to launch a new request:

* Process ID
* Process name with process version
* Process name with test

## Parameters

### Process

<table data-header-hidden><thead><tr><th valign="top">Parameter</th><th valign="top">Type</th><th valign="top">Direction</th><th valign="top">Description</th></tr></thead><tbody><tr><td valign="top"><strong>Parameter</strong></td><td valign="top"><strong>Type</strong></td><td valign="top"><strong>Direction</strong></td><td valign="top"><strong>Description</strong></td></tr><tr><td valign="top"><code>PROCESS_ID</code></td><td valign="top">Numeric</td><td valign="top">IN</td><td valign="top">Process ID of the request to launch (to be used independently, without the other parameters)</td></tr><tr><td valign="top"><code>PROCESS_NAME</code></td><td valign="top">Text</td><td valign="top">IN</td><td valign="top">Process name of the request to launch</td></tr><tr><td valign="top"><code>PROCESS_VERSION</code></td><td valign="top">Numeric</td><td valign="top">IN</td><td valign="top">Version of the process to launch</td></tr><tr><td valign="top"><code>TEST</code></td><td valign="top">Text</td><td valign="top">IN</td><td valign="top"><p>Test mode</p><ul><li><code>Y</code>: Launch a test version</li><li><code>N</code>: Launch the active version</li></ul></td></tr></tbody></table>

### Optional parameters

<table data-header-hidden><thead><tr><th valign="top">Parameter</th><th valign="top">Type</th><th valign="top">Direction</th><th valign="top">Description</th></tr></thead><tbody><tr><td valign="top"><strong>Parameter</strong></td><td valign="top"><strong>Type</strong></td><td valign="top"><strong>Direction</strong></td><td valign="top"><strong>Description</strong></td></tr><tr><td valign="top"><code>REQUEST_ID</code></td><td valign="top">Numeric</td><td valign="top">OUT</td><td valign="top">Returns the ID of the new request</td></tr><tr><td valign="top"><code>IMPERSONATE_USERNAME</code></td><td valign="top">Text</td><td valign="top">IN</td><td valign="top">Username of the impersonating user</td></tr></tbody></table>

You can define other parameters as needed in the workflow process to launch; for example `COMPANY` (text type IN parameter), e.g. `ACME_COMPANY`.

## Examples

### Process ID

<table data-header-hidden><thead><tr><th valign="top">Parameter</th><th valign="top">Type</th><th valign="top">Direction</th><th valign="top">Description</th></tr></thead><tbody><tr><td valign="top"><strong>Parameter</strong></td><td valign="top"><strong>Type</strong></td><td valign="top"><strong>Direction</strong></td><td valign="top"><strong>Description</strong></td></tr><tr><td valign="top"><code>PROCESS_ID</code></td><td valign="top">Numeric</td><td valign="top">IN</td><td valign="top">Send value of <code>MY_PROCESS_ID</code> (a numeric process data containing the ID of the process to start, e.g. <code>1320</code>)</td></tr></tbody></table>

### Process name with process version

<table data-header-hidden><thead><tr><th valign="top">Parameter</th><th valign="top">Type</th><th valign="top">Direction</th><th valign="top">Description</th></tr></thead><tbody><tr><td valign="top"><strong>Parameter</strong></td><td valign="top"><strong>Type</strong></td><td valign="top"><strong>Direction</strong></td><td valign="top"><strong>Description</strong></td></tr><tr><td valign="top"><code>PROCESS_NAME</code></td><td valign="top">Text</td><td valign="top">IN</td><td valign="top">Send value of <code>MY_PROCESS_NAME</code> (a text process data containing the name of the process to start, e.g. <code>LEAVE_APPLICATION</code>) </td></tr><tr><td valign="top"><code>PROCESS_VERSION</code></td><td valign="top">Numeric</td><td valign="top">IN</td><td valign="top">Send value of <code>MY_PROCESS_VERSION</code> (a numeric process data containing the version number of the process to start, e.g. <code>2</code>)</td></tr></tbody></table>

### Process name with test

<table data-header-hidden><thead><tr><th valign="top">Parameter</th><th valign="top">Type</th><th valign="top">Direction</th><th valign="top">Description</th></tr></thead><tbody><tr><td valign="top"><strong>Parameter</strong></td><td valign="top"><strong>Type</strong></td><td valign="top"><strong>Direction</strong></td><td valign="top"><strong>Description</strong></td></tr><tr><td valign="top"><code>PROCESS_NAME</code></td><td valign="top">Text</td><td valign="top">IN</td><td valign="top">Send value of <code>MY_PROCESS_NAME</code> (a text process data containing the name of the process to start, e.g. <code>LEAVE_APPLICATION</code>) </td></tr><tr><td valign="top"><code>TEST</code></td><td valign="top">Text</td><td valign="top">IN</td><td valign="top">Send value of <code>MY_TEST</code> (e.g. <code>Y</code>)</td></tr></tbody></table>