Trigger User Flows via External Navigation Links
Last updated
Last updated
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.
In this example parameters are passed to the User Flow. You can of course run a User Flow without starting parameters from IFS.
Locate the parameter you want to pass to Flow.
New to IFS debugging? Read this section: Aurena debugging
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.
Right mouse button (RMB) click the Flow and press Generate Web Link
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.
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:
Open the page designer.
Add a element to the command group of type ExternalNavigationLink.
Give the element (button) a label and paste the link you got from Flow link generation
Map the parameters that you configured in the Flow start step.
Confirm and close x2
Save and publish to context
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.
And voila! The user can now enjoy Flow.
