Recalling data gathered from the form itself is a great way to personalize your forms. Thanks to this feature, you can recall existing information coming from the form input or from previous actions.
Recalling input data from your form
One of the most common uses of recalling data is to personalize your form. You can recall the submitters' name, for instance, in order to address them by their name. All you have to do is include a field to gather that information.
As you can see in the example below, we used this feature to recall the user's name and show the user's email. This way, we can personalize the form, and make sure the user know which email address is entered.
Recalling info in forms: Step by step
In this example, we will use an Email verification form. This form is fully generated with one of Arengu's templates. This template includes the generation of a one-time password, that is automatically generated and sent to the user via email. Once you click on your template, all you have to do is complete it with your own API keys and personalize it to your taste.
In this example, we'll use the user's first name, so we'll include a name field. To do so, just drag the Text field and drop it in your form, wherever you like. Afterwards, you can rename it and change its ID, if you'd like to.
As you can see in the image above, each field has a settings menu. In the ID field, you can name each field whatever you want. In this case, the field's ID is name. We will use this ID name to recall this information later on. In this case, we will use it to personalize the second step, where the user is asked to enter a one-time code. To recall information, click on the text you'd like to edit, and reference the value of the field by entering the field ID, as you can see in the example below — {{name}} and {{email}}. Keep in mind you can use this feature in other texts on your form, such as labels, hint texts, etc.
Keep in mind you can also recall information in other parts of your form. In this example, we will include the name of the submitter in a success message.
To do so, go to the Success message, right at the end of the flow linked to this form. Go to Forms > Flows to find all the flows linked to your form template. When you click on the flow, you will see the image above. Click on Submit the form, the final action of this flow. Under Success message, we'll write a personalized message, including the name of the submitter. In this case, the formula {{input.body.name}} will display whatever the submitter typed in the field name.
To recall information coming from the form fields, you need to follow this structure:{{input.body.field_id}}
Recalling data from previous actions
Another interesting way to recall data is using information coming from previous actions of your flow. In Arengu, it is also possible to reuse information coming from previous flow's actions, by making reference to them. Check out Arengu's documentation to know exactly how to reference them and keep your actions connected.
🌰 In a nutshell
In order to recall any info in your Arengu form, simply add a field to get that info and take in mind its ID. To use it later on, reference it with the formula {{input.body.field_id}} if it comes from the form, or {{action_id.output_variable}}, if it belongs to an action.
