To fill your diary you can choose from 7 different field types. They are:

  • Boolean
  • Choice
  • Float
  • Image
  • Integer
  • Text
  • Textline


Read further to learn more about these different field types.


Field options

Overall fields have the following options:

  1. At field title you fill in the question or statement you want to present to the client.
  2. Field name corresponds to the technical unique name of the field. You can use the one that is automatically given, here that is 'boolean_0', or you can think of one your self, for instance like 'Q1'. The client does not see this name. 
  3. At field description you can optionally add more explanation of how the client should fill out this question.
  4. Tick optional if the client is not required to fill in this question.
  5. Tick read only if the field does not require an input from the client. This is really only the case when you are using a computation to compute a score to give back to the client. This option is only availabe when there are computations! Read more about making computations in het CMS manual in your content platform. 
  6. Tick display on timeline if you want the answer to appear in the timeline.
  7. In some cases (for instance with the boolean) you can choose the default setting of the question, meaning you can choose if and how the answer is already prefilled for the client.


When you want to do research with this diary data it is a very good idea to think of 'logical' field names for your questions. This will make your work easier when you are doing your analysis.



Field types

Here you will learn more about the 7 field types. 


Boolean

A boolean is a single tick-box. This is what a boolean looks like for the user:

Browser
App

boolean_app.png


Choice

A choice is a multiple choice question. This is what a choice looks like for the user:

Browser
App



This is how you fill out the choice field menu

The choice field menu consists of 2 parts. The first part asks you to fill in the general field options (see section 'Field options' later in this article). 


The second part of the menu is different. Here you put the answers you want your multiple choice question to have. The menu automatically gives you 2 answer fields for multiple choice answers. You can see these below the item 'default value', which will be explained later. At the bottom of the screen you can add more multiple choice answer fields by clicking on 'add option' if you have more answer options to add. You fill out the multiple choice answer field like this:

  • Value: to make it easy for you, the first 2 answer fields already have a given value. You can change these if you need to with regards to a computation and graph.
  • Title: here you type the answer you want to show to the client ( delete 'default_0' that is also automatically put in).
  • Icon: if you want your multiple choice answer to be represented by an image or icon, you choose the icon here. See more information on using icons below.


If you want, you can set a multiple choice answer as default. This means that when a client fills out his diary, this answer is highlighted; or shown to the client as the default answer. To do this you, after you have put in all your multiple choice answers, select the answer you want from the dropdown menu at 'Default value'.



Using icons in a choice field

If you want to use icons in your diary you must upload them first at the tab 'resources' before being able to use them within your diary. You need to upload your PNG images of the size600 x 600 at the tab 'resources'. After this, you can select the right icon in the dropdown menu of the answer field of your multiple choice answers.


Watch out: if you choose to use icons you must give all the answers of this particular multiple choice question an icon. Make sure you upload all your images before editing this question


Float

A float is a number field that can be used for a slider and time entries. There are three types of float fields:

  1. Float input
  2. Float slider
  3. Float hour


This is what the 3 different float types looks like for the user:

Browser
App

  


How to fill out the float field menu

You can use a float field for giving the client a field to put a number in with decimals. For instance, 3.1 or 2,15 or 1:45. The float field has 3 forms: input, slider or hours. You start by filling out the general first part of the menu. In the second part first you choose what widget you want to use; input-field, slider or hours. See the examples of each forms to get an idea of what they look like and how you can use them

  • Input field: the client can only put in a number in this field. If the client puts in another character, he will get an error message when saving his diary. Optionally you can set a minimum and maximum number for this field.
  • Slider field: a slider field can be used for questions where the client is asked to rate a certain item on a scale. Since it is a scale, a beginning and end of the scale is always required. So for a slider the fields 'Min' and 'Max' are required to fill out for you. The default value (where the slider is set when the client views the slider for the first time) can be set optionally
  • Hours field: an hours field gives the client 2 input fields. 1 for minutes and 1 for hours. Optionally you can set a minimum, maximum and default value.


Image

The image fields provides an upload image possibility. This is what an image looks like for the user:

Browser
App
image_browser.png


This is how you fill out the image field menu

The image field menu is the most simple of all the diary fields. It only has the top menu, as there is nothing else you can edit. The field allows the client to upload a picture. In the top menu of course you can edit the field title, field description and set the field to 'optional', 'read only' and 'display on timeline'. 


It is advisable to always set the image field as 'optional' unless there is an absolute necessity to have an image in the diary.


Integer

The integer field is a number field. There are two types of integer fields:

  1. Integer input
  2. Integer slider


This is what the two types look like for the user:

Browser
App



This is how you fill out the integer field menu

You can use the integer field for giving the client a field to put a number in without decimals. For instance 1 or 2 but not a number in between. The integer field has 2 forms: input and slider. The menu for this field is very similar to the menu of the float field. You start by filling out the first general part of the menu. In the second part first you choose what widget you want to use; input-field or slider. Then you fill out the rest of the menu, where necessary.

  • Input field: the client can only put in a number in this field. If the client puts in another character, he will get an error message when saving his session. Optionally you can set a minimum and maximum number for this field.
  • Slider field: a slider field can be used for questions where the client is asked to rate a certain item on a scale. Since it is a scale, a beginning and end of the scale is always required. So for a slider the fields 'Min' and 'Max' are required to fill out for you. The default value (where the slider is set when the client views the slider for the first time) can be set optionally.


The client cannot see the limit of an input field, so be sure the limit speaks for itself or to name this limit in the field description.


Text

A text field is a 5 line text field.  This is what a text looks like for the user:

Browser
App






This is how you fill out the text field menu

The text field is used to ask the client to write some text. It can be a lot of text, as the field 'grows' when the client types more. The text field menu is very simple to edit, as it has only the top part of the menu. You can edit the field title, field description and set the field to 'optional', 'read only' and 'display on timeline'.


In the app, the text field looks the same as the textline field. However, in browser version you can see the difference, as the text field is a bigger field to type in.


Textline

A textline field is a 1 line text field.  This is what a textline looks like for the user:

Browser
App



This is how you fill out the textline field menu

The textline field is used to ask the client to write a short text, usually no more than 1 word or a short sentence. The textline field menu is again very simple to edit, as it has only the top part of the menu. You can edit the field title, field description and set the field to 'optional', 'read only' and 'display on timeline'.


In the app, the text field looks the same as the textline field. However, in browser version you can see the difference, as the textline field only shows 1 line, and does not 'grow' bigger as the client types more.