# How to launch a new request with context parameters from an external application via a URL

**URL:** <https://discuss.workflowgen.com/t/how-to-launch-a-new-request-with-context-parameters-from-an-external-application-via-a-url/326>\
**Category:** Web API\
**Created:** [October 8, 2015, 7:30am UTC](https://discuss.workflowgen.com/t/how-to-launch-a-new-request-with-context-parameters-from-an-external-application-via-a-url/326 "2015-10-08T07:30:34Z")\
**Posts on this page:** 11\
**Page:** 1

<div class="post-metadata">

**Author:** ![wfg-admin](https://yyz2.discourse-cdn.com/flex030/user_avatar/discuss.workflowgen.com/wfg-admin/32/714_2.png) [@wfg-admin](https://discuss.workflowgen.com/u/wfg-admin)\
**Post date:** [October 8, 2015, 7:30am UTC](https://discuss.workflowgen.com/t/how-to-launch-a-new-request-with-context-parameters-from-an-external-application-via-a-url/326/1 "2015-10-08T07:30:34Z")

</div>

This procedure lets you launch a new process from another application using SDK-style parameters.

### Notes

- The process to be launched must be a public access level sub-process.

- This solution is not available with WorkflowGen Standard and StandardOne licenses in version 5.

### URL

Use the URL `http://[myserver]/wfgen/show.aspx?QUERY=PROCESS_START_REMOTE`, replacing `[myserver]` with the name of your server.

### Required parameters

- **`PROCESS`**

- **`TEST `**

### Optional parameters

- **`CONTEXT`**

- **`REQUESTER_USERNAME`**

### Sample

Download [SDK\_CS\_RemoteLaunchURL\_v5.zip](https://app.box.com/s/eic3rt3ms3ztop9syx01dw62lu52k4cc) and follow the instructions in the included `setup.txt` for an example of usage.

---

<div class="post-metadata">

**Author:** ![schaubal](https://avatars.discourse-cdn.com/v4/letter/s/8baadc/32.png) [@schaubal](https://discuss.workflowgen.com/u/schaubal)\
**Post date:** [March 21, 2017, 6:05pm UTC](https://discuss.workflowgen.com/t/how-to-launch-a-new-request-with-context-parameters-from-an-external-application-via-a-url/326/2 "2017-03-21T18:05:31Z")

</div>

> [@wfg-admin](#):
>
> Web Services API: WorkfowContext specifications and usage](

the following link in this article is dead.[http://www.workflowgen.com/kb/web-services-api-workfowcontext-specifications-and-usage](http://www.workflowgen.com/kb/web-services-api-workfowcontext-specifications-and-usage). Can you point it to the new location?

---

<div class="post-metadata">

**Author:** ![pnicoll](https://yyz2.discourse-cdn.com/flex030/user_avatar/discuss.workflowgen.com/pnicoll/32/454_2.png) [@pnicoll](https://discuss.workflowgen.com/u/pnicoll)\
**Post date:** [March 21, 2017, 6:09pm UTC](https://discuss.workflowgen.com/t/how-to-launch-a-new-request-with-context-parameters-from-an-external-application-via-a-url/326/3 "2017-03-21T18:09:37Z")

</div>

Hi Supriya,

This and other integration-related FAQs have been compiled and updated in the new [WorkflowGen Integration Guide](https://advantys.gitbooks.io/workflowgen-integration-guide/content/). The material from the article you were looking for can be found in the [Web Services API](https://advantys.gitbooks.io/workflowgen-integration-guide/content/web-services-api.html) section.

However, the original FAQ is still available at [https://discuss.workflowgen.com/t/web-services-api-workflowcontext-specifications-and-usage/315](https://discuss.workflowgen.com/t/web-services-api-workflowcontext-specifications-and-usage/315).

---

<div class="post-metadata">

**Author:** ![kobecker](https://avatars.discourse-cdn.com/v4/letter/k/ee59a6/32.png) [@kobecker](https://discuss.workflowgen.com/u/kobecker)\
**Post date:** [July 26, 2017, 11:38am UTC](https://discuss.workflowgen.com/t/how-to-launch-a-new-request-with-context-parameters-from-an-external-application-via-a-url/326/4 "2017-07-26T11:38:00Z")

</div>

Hello,

can you please give another syntax example for  
http://[myserver]/wfgen/show.aspx?QUERY=PROCESS\_START\_REMOTE

I tried:  
[http://workflow/wfgen/show.aspx?QUERY=PROCESS\_START\_REMOTE&PROCESS="SDK\_CS\_REMOTE\_LAUNCH"&TEST="Y"](http://workflow/wfgen/show.aspx?QUERY=PROCESS_START_REMOTE&PROCESS=%22SDK_CS_REMOTE_LAUNCH%22&TEST=%22Y%22)  
(–\> using the example given)

I am getting the following error notification:  
“The process ‘“SDK\_CS\_REMOTE\_LAUNCH”’ cannot be found”.  
(–\> I tried with several other processes as well)

Am I missing something? Is the syntax incorrect?  
How can I call the right process?

Thank you,  
regards

---

<div class="post-metadata">

**Author:** ![eddy.daouk](https://yyz2.discourse-cdn.com/flex030/user_avatar/discuss.workflowgen.com/eddy.daouk/32/672_2.png) [@eddy.daouk](https://discuss.workflowgen.com/u/eddy.daouk)\
**Post date:** [July 26, 2017, 12:24pm UTC](https://discuss.workflowgen.com/t/how-to-launch-a-new-request-with-context-parameters-from-an-external-application-via-a-url/326/5 "2017-07-26T12:24:03Z")

</div>

Hi,

The parameters in your query shouldn’t have quotes.

Try:  
[http://workflow/wfgen/show.aspx?QUERY=PROCESS\_START\_REMOTE&PROCESS=SDK\_CS\_REMOTE\_LAUNCH&TEST=Y](http://workflow/wfgen/show.aspx?QUERY=PROCESS_START_REMOTE&PROCESS=SDK_CS_REMOTE_LAUNCH&TEST=Y)

Best Regards,  
Eddy.

---

<div class="post-metadata">

**Author:** ![kobecker](https://avatars.discourse-cdn.com/v4/letter/k/ee59a6/32.png) [@kobecker](https://discuss.workflowgen.com/u/kobecker)\
**Post date:** [July 28, 2017, 8:37am UTC](https://discuss.workflowgen.com/t/how-to-launch-a-new-request-with-context-parameters-from-an-external-application-via-a-url/326/6 "2017-07-28T08:37:09Z")

</div>

Hi Eddy,  
thank you, now it works 🙂  
But:  
I expected that the request sheet would open in the browser. Instead, I only see the requests’ ID ("ID=“1905”). In order to see the form sheet, I need to go via the portal again.

The goal for the remote launch was, that requesters can launch a request via URL and not need access the portal.  
Is that possible? Do I need to add additiotnal parameters to the URL?

Merci,  
regards  
Konstantin

---

<div class="post-metadata">

**Author:** ![eddy.daouk](https://yyz2.discourse-cdn.com/flex030/user_avatar/discuss.workflowgen.com/eddy.daouk/32/672_2.png) [@eddy.daouk](https://discuss.workflowgen.com/u/eddy.daouk)\
**Post date:** [July 28, 2017, 6:34pm UTC](https://discuss.workflowgen.com/t/how-to-launch-a-new-request-with-context-parameters-from-an-external-application-via-a-url/326/7 "2017-07-28T18:34:35Z")

</div>

Hi Konstantin,

If you want to launch a new request and see the webform in the portal then this would be the proper way to launch a new request:

[http://YOURSITE/wfgen/show.aspx?QUERY=START&P=SDK\_CS\_REMOTE\_LAUNCH](http://YOURSITE/wfgen/show.aspx?QUERY=START&P=SDK_CS_REMOTE_LAUNCH)

Kindly see the integration guide on how to use WorkflowGen URLs:  
[https://advantys.gitbooks.io/workflowgen-integration-guide/content/integration-using-workflowgen-urls.html](https://advantys.gitbooks.io/workflowgen-integration-guide/content/integration-using-workflowgen-urls.html)

Regards,  
Eddy.

---

<div class="post-metadata">

**Author:** ![kobecker](https://avatars.discourse-cdn.com/v4/letter/k/ee59a6/32.png) [@kobecker](https://discuss.workflowgen.com/u/kobecker)\
**Post date:** [July 31, 2017, 1:31pm UTC](https://discuss.workflowgen.com/t/how-to-launch-a-new-request-with-context-parameters-from-an-external-application-via-a-url/326/8 "2017-07-31T13:31:17Z")

</div>

Hello Eddy,  
perfect, now it works.  
Thank you for the great help again and the additional Link!  
Best regards Konstantin

---

<div class="post-metadata">

**Author:** ![Rogelio](https://avatars.discourse-cdn.com/v4/letter/r/13edae/32.png) [@Rogelio](https://discuss.workflowgen.com/u/Rogelio)\
**Post date:** [December 7, 2018, 4:25pm UTC](https://discuss.workflowgen.com/t/how-to-launch-a-new-request-with-context-parameters-from-an-external-application-via-a-url/326/9 "2018-12-07T16:25:41Z")

</div>

Hi Eddy,  
How can I launch a new request and see the webform AND also pass context parameters?  
Thanks,  
Rogelio

---

<div class="post-metadata">

**Author:** ![eddy.daouk](https://yyz2.discourse-cdn.com/flex030/user_avatar/discuss.workflowgen.com/eddy.daouk/32/672_2.png) [@eddy.daouk](https://discuss.workflowgen.com/u/eddy.daouk)\
**Post date:** [December 11, 2018, 8:29pm UTC](https://discuss.workflowgen.com/t/how-to-launch-a-new-request-with-context-parameters-from-an-external-application-via-a-url/326/11 "2018-12-11T20:29:20Z")

</div>

Hi Rogelio,

We don’t have a single URL that does all of that.

There are two workarounds:  
1- A possible workaround will be to make 2 calls. First one to PROCESS\_START\_REMOTE in order to create the request with a context (you can use WS API or GraphQL too) then start the first action via URL: [https://advantys.gitbooks.io/workflowgen-integration-guide/content/integration-using-workflowgen-urls.html#start-an-action-within-the-workflowgen-portal](https://advantys.gitbooks.io/workflowgen-integration-guide/content/integration-using-workflowgen-urls.html#start-an-action-within-the-workflowgen-portal)

2- Add additional custom parameters to the URL query.  
eg: [http://YOURSITE/wfgen/show.aspx?QUERY=START&P=SDK\_CS\_REMOTE\_LAUNCH&REQUEST\_SUBJECT=Hello](http://YOURSITE/wfgen/show.aspx?QUERY=START&P=SDK_CS_REMOTE_LAUNCH&REQUEST_SUBJECT=Hello)

Then add some custom Javascript / JQuery to retrieve the URL parameter and autofill the values. In this case, we have to retrieve the parent URL’s query parameters since the iframe’s URL does not contain the additional query parameters.

```auto
<script>
 function getQueryString() {
    var queryStringKeyValue = window.parent.location.search.replace('?', '').split('&');
    var qsJsonObject = {};
    if (queryStringKeyValue != '') {
        for (i = 0; i < queryStringKeyValue.length; i++) {
            qsJsonObject[queryStringKeyValue[i].split('=')[0]] = queryStringKeyValue[i].split('=')[1];
        }
    }
    return qsJsonObject;
}
            
$(document).ready(function(){
    $("#REQUEST_SUBJECT").val(getQueryString().REQUEST_SUBJECT);
});

</script>

```

Let me know if this helps.

Regards,  
Eddy.

---

<div class="post-metadata">

**Author:** ![Rogelio](https://avatars.discourse-cdn.com/v4/letter/r/13edae/32.png) [@Rogelio](https://discuss.workflowgen.com/u/Rogelio)\
**Post date:** [December 14, 2018, 7:31pm UTC](https://discuss.workflowgen.com/t/how-to-launch-a-new-request-with-context-parameters-from-an-external-application-via-a-url/326/12 "2018-12-14T19:31:41Z")

</div>

Hi Eddy,

Thank you very much for this response!

Worked it out with this.

Cheers!

Ro