Form Helper
Include forms to gather user input on Embed (white label integration portal) for use in Flows

The Form Helper can be used together with the Embed Feature to receive custom user input from your users which can then be used in the Embed Flow.
The Form Helper has only one field, which is used to create the form using the UI Form Schema that is also used to create the input forms for actions within Locoia.
There you can specify all attributes of the field seen by your users - such as if a field is required, what kind of field it is, etc. Learn how to get started with creating UI Form Schemas on this page:
Nested Fields and Expanding Lists are not supported by the Form Helper in order to maintain a straightforward Embed end user experience.
In order to reference to the user input within Embed flows regular Jinja referencing is used, starting with the Form Helper's reference and referencing to the individual fields by their reference.
Part of the Flow could for example read an export file from a FTP server, where the challenge is that all customers have a slightly different folder name. Thus the user need to specify their folder name in the embed setup.
The UI Form Schema in the form helper could in this case be:
{
"folder_name": {
"title": "Folder Name",
"type": "text",
"required": true,
"placeholder": "external-exports",
"info": "The folder name used for exporting data"
}
}
In order to reference to this field later in the Flow we have to take a look at the references that we assigned to the form helper itself, in this case
ftp_user_details
:
{{ ftp_user_details.folder_name }}/export.csv
During the Flow setup, your users will now see your form and can use it to fill in their individual details (or in this case have to, as you marked the field as required):

The Form Helper Step will always be shown as the last step in the Flow setup.
That's it! Now all the created Embed Flows include the user input of your respective end user.
Last modified 6mo ago