Open My Betty Blocks and see your dashboard with suggested application templates in the ‘Start building’ section. Choose ‘View all templates’, then find the Dynamic Questionnaire template and click ‘Use template’.

Note: If you want to see the template’s live preview, click on its thumbnail, and in an open window find the ‘Live preview’ button.

The next steps will include coming up with a name for your application and setting a value for the application ID configuration. Find out why you need this setting and how to configure it properly in the Introduction to application templates article.

You can’t just create a new account (webuser) in the built-in login flow of the runtime application. Instead, your first webuser has to be created in the Back Office. In order to do that, navigate to Back Office > Settings > Webusers and click on ‘New’.

Make sure you fill in all of the required fields (Full name can be left empty. It will be automatically combined from the first and last name). Leave the ‘Active’ checkbox checked, otherwise you won’t be able to log in. A password has to be set only once, so make sure you do not make a typo. In this application, only one role is present by default. That role has the name ‘webuser’. Start typing the name in the role field and it will autocomplete your input. Select the value that it provides you with. Don’t forget to save your form at the end.

Once created, you can log into the application's live view with the credentials provided when creating the webuser.

You can add as many webusers as you like. Adding them is the same process as adding your first webuser. You could see the webusers as accounts who can log into the runtime application.

After logging in, you will see your home page:

Since the application is brand new, no questionnaires have been created yet. So we will make our first one right now.

To create your first questionnaire, click on the ‘Create questionnaire’ button. You will be greeted with the input fields of your first questionnaire. Some fields are pre-filled to help with orientation.

The questionnaire comes with one section out of the box. You can enter a name and description for a section. Sections contain one or multiple questions. When answering a questionnaire, all questions in the same section will be shown.

You can create a new section by clicking on the ‘Add section’ button. This will add a section below the current one sorted by an index.

Sections can be moved or deleted. Moving can be done when there is more than one section. Now each one has this set of buttons to do those actions.

With the arrows, you can move the section up or down the order. Clicking the delete button will show a dialogue asking if you are sure to delete the section. After deleting a section all questions that belong to it will be deleted too.

Each section comes with a single question by default. You can add more questions to a section by clicking the ‘Add question’ in the corresponding section.

A question has multiple values that can be set. These values are:

Questions can be moved or deleted. Moving can be done when there is more than one question. A question has this set of buttons to do those actions:

With the arrows, you can move the question up or down the order. Clicking the delete button will show a dialogue asking if you are sure to delete the question. When deleting a question, all answer options that belong to it will be deleted too.

The multiple choice question types have answer options. When selecting one of the multiple choice types, the first answer option will be made for you. An answer option looks like this:

The first input field is the name/value of the answer option. This could be something like a ‘Yes’ or ‘No’. Clicking the trash can icon will show a dialogue asking if you are sure to delete the answer option.

The part below ‘Show questions’ contains the interactions that can be set for an answer option. More on this in the next heading.

A question can have up to 20 answer options by default. If you want to set more than twenty answer options, you need to go to the page builder and open the ‘Admin - Questionnaire Edit’ page.

Then open the component tree and type in ‘AnswerOptionDataList’ into the search component field. See it highlighted in the list of components below.

Click on ‘AnswerOptionDataList’ twice. In the field ‘Rows per page,’ you can increase the number up to 50. Recompile the page and you can have more than 20 interactions.

Let’s look at this example to make things more clear.

There are two questions within one section. The second one is set to hidden:

Now we need to select the first question’s type. Choose ‘Multiple choice (Single answer)’. Then you will have to fill in a few options. As my question is “What is your top priority while looking for a job?”, I will make up a few answer options: “Salary” and “Possibility to grow”. In the ‘Add question to show’ choose the “Question 2” option. Click on ‘Add’ next to it.

Now question 2 “What are your salary expectations?” is going to be shown as the next question for a user to answer.

Once you click on 'Save and submit', the questionnaire will be created and published. Now you can invite users to answer the questionnaire. There are two ways of doing this: inviting them by email or copying the link and sending it to respondents (for them to answer anonymously).

When you invite a user by email, two things happen. First, their email address is being saved in the application so the next time you want to invite them for a new questionnaire, the autocomplete will suggest the full email address to you. Secondly, a questionnaire to answer is being created for them. A unique link to this questionnaire is being sent to them by email.

The newly created questionnaire will appear on your home page. You can also invite users to participate in it at any time by clicking on the ‘Invite users’ in the appropriate column.

Click on ‘Details’ to be redirected to the details page of the questionnaire.

The questionnaire details page shows you the name, description, and current version of the template. The rest of the page is separated by tabs: 'Received responses', 'Pending invites', and 'View questionnaire'.

Received responses

This tab contains a button that brings up a dialog to invite more users to answer the questionnaire and the data table showing you all the responses you have received on the questionnaire.

When a user has been invited via email, their email address will be shown in the response. If the user has answered the questionnaire via the link, the value shown will be anonymous.

The version shown on a response is the version of the questionnaire that the user has answered. More on versions in a bit.

Clicking on ‘View answers’ will bring you to a page that shows you all the answers the user has given to the questions in your questionnaire.

Pending invites

In the ‘Pending invites’ tab, a data table is shown with all the invites you have sent out to users who have not yet answered the questionnaire or are in the process of answering the questionnaire.

View questionnaire

In the ‘View questionnaire’ tab, the whole questionnaire is shown in the way you have created it. All fields are not editable on this page. If you would like to edit the questionnaire, click on the ‘Edit questionnaire’ button at the top.