Authentication (and workflow) variables
Compose Enterprise is going through a design update. The illustrations on this page might be of the old design, but the information is up to date. Thank you for your patience during this update!
When you connect a form to a workflow, you may pre-populate your form questions in multiple ways, see the Form and workflow population overview. One source of values you may pre-populate into your forms are workflow variables. These are accessible across the entire workflow, much like input variables you create in the Variables section in the Workflow Builder. If you also have authentication on either a start point or a pause point in your workflow, you’ll also access a set of authentication variables.
Pre-populate questions with workflow variables
Start off by either opening an existing workflow or by creating a workflow with a start point (or pause point) and a form activity. Select the Start point. We want to access all available authentication variables, so choose Azure AD, BankID/ID-porten and Vipps in the Authenticate With section. ID-porten provides every variable as BankID except one, so you’ll access all variables by selecting just BankID and Vipps.
Select the Form activity and enter the Question Answers menu by clicking the Pre populate questions button.
Since you haven’t populated any questions yet, the list is empty. Select the questions you want to populate by clicking the Select question from model button.
A view of the form data model drops down. Select a question, click OK, and repeat this step for every question you want to populate.
The list is now filled with the questions you chose from the data model. Select one of the questions to reveal the Question Details panel on the right. As a default, you may give the question a static value, but to attribute a variable, click the Value From Workflow radio button, and click Browse.
If your workflow is as simple as the example in this guide, you will only see a Workflow Variables and a Start folder of variables. These folders contain all the variables accessible for population. The workflow variables list contain all default variables (and the input variables you create in the Variables section). The start point list contains the authentication variables.
Workflow variables
Authentication variables
Most of the default workflow variables are not customizable, except from all variables listed from entryPointName to tertiaryRecipient. These are customizable in the start point. The reason they are not displayed in the Start folder is because you can have multiple start points in a workflow. They are therefore workflow variables and their values vary based on the entrypoint of the workflow. See the how-to-guide on multiple start points to learn more.
All authentication methods pull out the authentication “Type” value. BankID&ID-porten both pulls out SSN and userID, and BankID also pulls out a name value. Vipps, with the consent of the respondent user, can pull out full name, first name, last name, email, phone number, address and birth date. Select the variable you want to use to pre-populate, and click OK.
Repeat this step for all questions you want to pre-populate and click OK to save the settings. Note: The respondent user only logs in with one authentication, so you won’t get population from both BankID/ID-porten and Vipps simultaneously.
MS Entra ID-authentication makes Azure User ID (Azure ObjektID), Full name, First Name, Last Name and Email available. The Azure User ID can be used to get more information from the user profile in Azure with the Microsoft Graph APIs: Get user - Microsoft Graph v1.0.
Once you’ve published the workflow with the population settings, you should get automatically populated services after the respondent user has logged in.
