A guide to enabling the Forms behaviour in your application.
This article will step you through the process of adding the Forms behaviour to your application.
Since the Forms behaviour will need to both add data to your application, and have a front facing UI, it will need to be included in both the Entity and User Interface diagrams. Additionally, you will also need to make sure that the administrators have the access to manage the forms.
Create an entity which is going to hold your form(s).
You do not need to make an entity for every form you want, just the different types. For example, you may make a Sign-up Form entity which holds forms for different sports, but then have a second entity called Newsletters to hold your newsletter subscription forms. If you have a very simple app, it may be easiest to create an entity called ‘Forms’ which holds all of them for you.
With this entity selected, click on the “Behaviour” button in the Add items panel appearing above the entity, and select “Forms”.
You will now see the Forms behaviour associcated with your entity.
User Interface Diagram
- Create a page which is going to hold your form.
Add the “Form Tile” to your page.
With the tile selected, update the tile properties by giving your tile a name, and selecting your entity with the Forms behaviour.
Configure your users to have the appropriate permissions for your form entity. See an example below.
A user with access to the Admin is required to have CRUD access to your Forms entity to be able to build and configure your form(s). This is the Admin user below.
It is important to note that you don’t need to give users create permission in order for them to be able to fill out the form on the frontend. As long as they have access to the page where the form is displayed, any user is able to create a submission.
Last updated: 19 September 2020