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.
This starts a new request and launches the first action.
Participant security is enforced.
The parameters the URL uses are as follows:
Parameter | Description |
| The site where WorkflowGen is installed |
| The task WorkflowGen will attempt to run, e.g. |
| The process name or ID that WorkflowGen will attempt to run, e.g. |
| Set to ✏️ Note: If the |
| The URL that the user will be returned to when submitting the completed form, e.g. ✏️ Note: As of version 7.15.5, this parameter ONLY supports absolute URLs (starting with |
| Name of the frame or iFrame to show the redirect page result as defined in the parameter By default, it uses the |
| The URL that the user will be returned to when selecting the ✏️ Note: As of version 7.15.5, this parameter ONLY supports absolute URLs (starting with |
| Name of the frame or iFrame to show the redirect page result as defined in the |
| The background color to use when displaying the forms border, e.g. |
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
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
The parameters the URL uses are as follows:
Parameter | Description |
| The site where WorkflowGen is installed |
| The task WorkflowGen will attempt to run, e.g. |
| The process name that WorkflowGen will attempt to run, e.g. |
| The process ID that WorkflowGen will attempt to run, e.g. ✏️ Note: If |
| Set to ✏️ Note: This parameter is only compatible with |
| The URL that the user will be returned to when submitting the completed form, e.g. ✏️ Note: As of version 7.15.5, this parameter ONLY supports absolute URLs (starting with |
| Name of the frame or iFrame to show the redirect page result as defined in the parameter By default, it uses the |
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
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.
The parameters the URL uses are as follows:
Parameter | Description |
| The site where WorkflowGen is installed |
| The task WorkflowGen will attempt to run, e.g.
|
| To be used with |
| Ensure no redirection after form submit, e.g. |
| The request ID that WorkflowGen will attempt to run, e.g. |
| The action ID that WorkflowGen will attempt to run, e.g. |
| The URL that the user will be returned to when submitting the completed form, e.g. ✏️ Notes:
|
| Name of the frame or iFrame to show the redirect page result as defined in the parameter By default, it uses the |
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
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
This displays the request follow-up form.
Participant security is enforced.
The parameters the URL uses are as follows:
Parameter | Description |
| The site where WorkflowGen is installed. |
| The task WorkflowGen will attempt to run, e.g. |
| The request ID that WorkflowGen will attempt to show, e.g. |
| The security mode for accessing the follow-up form. Set to |
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
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
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.
The parameters the URL uses are as follows:
Parameter | Description |
| The site where WorkflowGen is installed |
| The task WorkflowGen will attempt to run, e.g. |
| The request ID that WorkflowGen will attempt to show, e.g. |
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
The following examples show how to download file data from specific requests or actions using WorkflowGen URLs.
http://YOURSITE/wfgen/show.aspx?QUERY=DOWNLOAD&DATA_NAME=FORM_ARCHIVE&ID_PROCESS_INST=192
http://YOURSITE/wfgen/show.aspx?QUERY=DOWNLOAD&DATA_NAME=FORM_ARCHIVE&ID_PROCESS_INST=192&ID_ACTIVITY_INST=1
http://YOURSITE/wfgen/show.aspx?QUERY=DOWNLOAD&DATA_NAME=FORM_ARCHIVE&ID_PROCESS_INST=192&ID_ACTIVITY_INST=2
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.
Error | Description |
| The name or the identifier of the process ( |
| The database is not available. |
| Unable to retrieve the information about the user specified by the |
| The username passed through the |
| The specified process was not found or its status does not allow the system to instantiate it. |
| The specified action was not found of its status does not allow the system to instantiate it. |
| The process was not declared as a public sub-process. |
| The specified requester is not associated to the requester participant of the process. |
| The XML content is not a valid XML string. |
| The XML content does not represent a valid ADODB recordset object. |