Integration Using WorkflowGen URLs

Overview

Integrations with external systems using WorkflowGen are possible through the use of WorkflowGen applications, RSS feeds, and the WorkflowGen Web Service API. As well, integrations with WorkflowGen can be performed through the use of URLs to perform the following types of functions:

  • Launching requests and actions from any external site, with or without WorkflowGen frames and menus.

  • Launching an action in a non-WorkflowGen window and redirecting to another (non-WorkflowGen) website.

  • Viewing a follow-up form disconnected from the WorkflowGen User Portal.

  • Viewing a graphical follow-up disconnected from the WorkflowGen User Portal.

Use cases could include permitting the seamless integration of WorkflowGen into an external portal, such as Microsoft SharePoint, SAP Portal, DotNetNuke, or other web-based portals. Filling out and submitting web forms as well as following up activities could then be performed without the use of the default WorkflowGen web portal if desired.

To enforce the appropriate security in WorkflowGen, these URL launches require users to authenticate themselves, and therefore work best with Integrated Authentication.

Launch a new request and start the first action

  • This starts a new request and launches the first action.

  • Participant security is enforced.

Parameters

The parameters the URL uses are as follows:

From within the WorkflowGen portal

  • WorkflowGen menus and banners are visible.

To launch a process directly from a link or URL, use the example below:

http://YOURSITE/wfgen/show.aspx?QUERY=START&P=CLUB_CS_LEAVE

From within another website

  • WorkflowGen menus and banners are hidden.

  • A Back link is displayed in the top left corner.

  • Redirection will be performed upon form submit.

To launch a process directly from a link or URL and redirect back to a website other than WorkflowGen, use the example below:

http://YOURSITE/wfgen/show.aspx?QUERY=START&P=CLUB_CS_LEAVE&BACKURL_SUBMIT=http://www.advantys.com&BACKURL_CANCEL=http://www.workflowgen.com&FORM_BGCOLOR=white

Launch a new request and start the first action without the WorkflowGen portal

Parameters

The parameters the URL uses are as follows:

To launch a process directly from a link or URL without the WorkflowGen portal, use the example below:

http://YOURSITE/wfgen/show.aspx?QUERY=PROCESS_START&PROCESS=CLUB_CS_LEAVE&BACKURL_SUBMIT=http://www.advantys.com

Start an existing action

  • This launches any workflow action that has been created. It can be the first, second, or later action of a workflow.

  • Participant security is enforced.

Parameters

The parameters the URL uses are as follows:

Without the WorkflowGen portal

  • WorkflowGen menus and banners are hidden.

To launch an action (second) directly from a link or URL, use the example below:

http://YOURSITE/wfgen/show.aspx?QUERY=APPLICATION_START&ID_PROCESS_INST=192&ID_ACTIVITY_INST=2&BACKURL_SUBMIT=http://www.advantys.com

Within the WorkflowGen portal

  • WorkflowGen menus and banners are visible.

To launch an action (second) directly from a link or URL with visible menus, use the example below:

http://YOURSITE/wfgen/show.aspx?QUERY=CONTEXT&REQUEST_QUERY=APPLICATION_START&NO_REDIR=Y&ID_PROCESS_INST=192&ID_ACTIVITY_INST=2

Display a request follow-up form

  • This displays the request follow-up form.

  • Participant security is enforced.

Parameters

The parameters the URL uses are as follows:

Without the WorkflowGen portal

  • WorkflowGen menus and banners are hidden.

To display a request follow-up form directly from a link or URL, use the example below:

http://YOURSITE/wfgen/show.aspx?QUERY=PROCESS_INSTANCE_FORM&ID_PROCESS_INST=192

Within the WorkflowGen portal

  • WorkflowGen menus and banners are visible.

To display a request follow-up form directly from a link or URL with visible menus, use the example below:

http://YOURSITE/wfgen/show.aspx?QUERY=CONTEXT&REQUEST_QUERY=PROCESS_INSTANCE_FORM&ID_PROCESS_INST=192

Display a graphical follow-up form without the WorkflowGen portal

  • This displays the graphical follow-up form disconnected from the WorkflowGen User Portal.

  • Participant security is enforced.

  • WorkflowGen menus and banner are hidden.

  • Drill-down to activities is disabled.

Parameters

The parameters the URL uses are as follows:

To display the disconnected graphical follow-up form, use the example below:

http://YOURSITE/wfgen/show.aspx?QUERY=WFCANVAS_PROCESS_INSTANCE&ID_PROCESS_INST=192

Download file data of a specific request or action using a WorkflowGen URL

The following examples show how to download file data from specific requests or actions using WorkflowGen URLs.

📌 Download the latest form archive of request #192

http://YOURSITE/wfgen/show.aspx?QUERY=DOWNLOAD&DATA_NAME=FORM_ARCHIVE&ID_PROCESS_INST=192

📌 Download the form archive of the first action of request #192

http://YOURSITE/wfgen/show.aspx?QUERY=DOWNLOAD&DATA_NAME=FORM_ARCHIVE&ID_PROCESS_INST=192&ID_ACTIVITY_INST=1

📌 Download the form archive of the second action of request #192

http://YOURSITE/wfgen/show.aspx?QUERY=DOWNLOAD&DATA_NAME=FORM_ARCHIVE&ID_PROCESS_INST=192&ID_ACTIVITY_INST=2

Display the User Portal inside another website

By using an iFrame you can embed the WorkflowGen User Portal inside another website. In this case, you have to define the URL of the "host" application in the Configuration Panel.

Settings

Possible errors

Last updated