“Forward” is used to redirect to a new page from the existing page. A hyperlink could also accomplish this, but often times if you want to direct to certain pages or with certain query strings based on actions performed, a button with a forward service might be better since it gives you access to a process canvas before forwarding.
The Forward service needs a page name to direct the user, but it can also take optional query strings and session variables. If query strings are sent, there is a flag that can be turned on/off called EncryptQueryString which encrypts the query strings sent.
Forward Use Examples
“Forward” service is used to redirect to a new page from the existing page. Forward can be useful in cases where we want to redirect users to certain pages based on the actions performed.
Basic Forward Use
In this webpage we have a button called “Next”. This button has a process which uses the “forward” service to forward to the next page.
Here’s a closer look at the “Forward” service inputs.
“Page” is the name of the page we would like to forward to. “QueryString” is any query strings we would like to pass to the page. Multiple query strings can be added by right clicking the QueryStrings node. We can also right click on “Sessions” to add one or more session variables to pass. “EncryptQueryString” input takes true or false and decides whether to encrypt the query strings or not.
Note: Query strings are passed in the URL and are visible to the user. Hence, encrypting the query strings is recommended.
Example:(Notice the highlighted text)
Encrypted Query String -
Unencrypted Query String -
In the output logs, we can see the name of the page we forwarded to along with any included Query Strings.
Using Forward Service to Redirect to the Appropriate Home Page After Login
When the user logs in, after the authentication process is completed, we get the correct home page for the user based on the user role, example: admin, internal user, etc. If a home page is found for the user role, we then use the forward service to forward the user to the homepage.
Here’s what the forward service in this process looks like:
Notice that we are using the homepage returned by the “GetHomePage” service. Also, the default value for “EncryptQueryString” is set to True.
Here are the logs for that service: