Trigger User Flows via External Navigation Links

Introduction

This section provides instructions on triggering a User Flow through a button command of type "External Navigation Link." In the given example, Open ID is set up in the Flow Server to utilize Azure AD as the Identity Provider (IDP). Additionally, IFS is configured to use Azure AD as its IDP. With this configuration, Flow can utilize the Auth token cached in the browser, facilitating a (almost) seamless transition to the User Flow.

If the customer is not utilizing Azure AD and Single Sign-On (SSO), it is still possible to initiate a User Flow following the instructions outlined in this guide. The key distinction is that in this scenario, users will be required to log in using their Flow credentials through Basic Authentication against the Flow Server.

How to trigger a User Flow via External Navigation Link

In this example parameters are passed to the User Flow. You can of course run a User Flow without starting parameters from IFS.

Configuring the User Flow and generate Web Link

1. Locate the parameter you want to pass to Flow.

New to IFS debugging? Read this section: Aurena debugging

1. Go to Flow studio and create your User Flow with the corresponding start variables. The naming in the start step can be different from the IFS parameters.

1. Right mouse button (RMB) click the Flow and press Generate Web Link

1. Add the NG client URL (https://web.novacuraflow.com/) in the "Web Client Url" field.

The "Execute Only" option locks the user to the execution view and prohibits the user from quitting the workflow or returning to a menu after execution.

1. Click the Copy (NG) link to copy the URL to the clipboard. Now it's time to configure the command in IFS.

If you want to learn more about Generating Links visit the Flow help docs:

Generate link | Flow Helphelp.novacuraflow.com

Configure the command in IFS

1. Open the page designer.

1. Add a element to the command group of type ExternalNavigationLink.

   

   Adding element

   

   Choose type

2. Give the element (button) a label and paste the link you got from Flow link generation

1. Map the parameters that you configured in the Flow start step.

Open key value mapping

Map the parameters

1. Confirm and close x2

1. Save and publish to context

Save

Publish

1. Click the button you just create to run the User Flow. When clicking the button element a new tab will open a navigate to the configured URL.

If this is the first time the user runs the Flow within the current IFS session, they will be prompted with the Flow login page. If Open ID is configured just click "OPENID". In the latter case the User Flow will start immediately, no auth against Microsoft is needed.

Login

And voila! The user can now enjoy Flow.