Knowledge Base

Creating forms in Vantify CAFM

Creating forms in Vantify CAFM


Tutorial


Vantify CAFM offers you the ability to create forms for use within assets, ppm and jobs. This tutorial will guide you through creating a basic form, giving you everything you need to create forms.


Accessing the forms section

You will need to speak with your Vantify contract manager or admin team to add forms to your user account in either Admin > Forms, or Client Admin > Forms. Both methods work in exactly the same manner.


When it has been added, log in to Vantify CAFM and navigate to the Forms section.


Any forms that have been previously added will be listed here, but to add a new one click


The resulting page asks for some basic information to set your form up:



Provide a summary, description if necessary and choose the type. We will talk further about how to apply these later.



  • Job form will allow you to carry out the form through a reactive job

  • Asset form will associate it with an asset, allowing you to fill the form in from the asset pages

  • Task form will associate the form with a PPM Click create when you’re ready.


Creating the form

After you’ve clicked create, you’ll be taken to the form overview page which will show the previous settings, and a preview of the form. This will be blank at present.

To start adding to the form click edit:


The form builder overview


The settings are self-explanatory, you can change font size, colours, alignment etc of your form so we won’t go through these in details.


Add form elements

The sections at the top will allow you to add form elements, we will add each of the above to the form starting with…


Add text


Click to add text



This will add a line of text to the form, it can be a title, or it can appear based on the results of another question. We’ll discuss conditioning later.


Enter the text you want in Text, choose the size, colour and alignment.


The section at the bottom – Condition relates to conditions as mentioned above.


PRESS UPDATE AS YOU GO TO SAVE YOUR CHANGES


Previewing


At any point you can preview what you have created by clicking one of the two preview icons:



And you’ll see the header we’ve created. To continue to add elements to your form, return to the form builder.


Add a question


Click to add a question


Every question is posed the same way, you provide the question summary and the type of question:





We will add each one:


Text Single Line



Presents like this:


Placeholder text is what is displayed in the background of the box before you start typing and assists the form filler.

For example, when logging a job on Vantify:


Minimum length will ensure the filler enters a minimum amount of information; maximum sets a maximum. Leave it as 0 to remove the requirement.

Allow not applicable will allow the form filler to mark the question as N/A Required will make it mandatory, so you can’t skip the question.


Text Multiple Lines



This works the same as above, the only difference being the filler can now enter multiple lines of text. Either by pressing enter or entering a paragraph of information.

See the field Number of Rows. This will determine how big the box is.



Dropdown select


This allows the filler to select from a dropdown list of options. You can allow them to tick more than one option by checking allow multiple by holding ctrl.

Sort alphabetically arranges them A-Z.




Radio select

Radio selects allow you to check circular boxes. There are two ways to display them, either in a list by selecting 1 column, or across the screen by selecting multiple columns. For example:







Checkbox Select

Checkbox select works similarly to radio selects, the difference being checkboxes are multiselect. Creating them works the same way.






Sliding scale

This provides you a sliding scale which is useful for questionnaires or for ratings.




Set the minimum value and the maximum value and the steps between.


Date picker


This allows you to choose a date and time.

Check allow time if you want a time to also be chosen.


Offset is how far back and how far into the future they can choose dates. For example, if you only wanted them to be able to choose from 1 week in the past to 1 week in the future set both as 7. If you want it to be unrestricted just check the unrestricted boxes (below)




File Upload




This allows the filler to upload a file. The only option is to set it as mandatory or not.


Other elements


Add a divider


Click to add a divider

This adds a simple line divider between elements:



Add a page break


Click to add a page break

This will split the form into separate pages. Anything before the break is a different page to anything after. It can be useful if you have a very long form.




Add Macros


Click to add a macro

Macros will give you the ability to automatically pull through certain information from the job, asset or task that the form is linked with. If you cast your mind back to the start of this process we had to determine if the form was for an asset, task or job. This can save the filler having to type the information that is already there.


Using them is simple, add the macro and then choose from the available detail:


Jobs


Assets


Tasks


Previewing our form

Press update and you can preview your form:



Conditions

Now that we have created a basic form, we can add some more advanced features, and this comes in the form of conditions. As you’ve been adding your elements, you’ll have noticed the conditions section at the bottom:


This allows you to display elements based on the answer from a different question. Setting these up requires a certain element of planning, it is worth laying out your form as a decision tree before starting, especially if your form is long or in depth.


We can use a very simple example to explain this Firstly, we’ll add a question


If we select red, we want to display the word red in red font, if we select blue, we want it to display blue.




In order to do this, we will create both eventualities:



Then using the conditions section at the bottom, we need to click select an element:


When the symbol appears, you know it is waiting for an element to be selected. Scroll to the question we created and click here:


This will insert the question into the condition in the text, red:




Click on matching, and this is how we determine what controls this, we want it to show red writing when the previous question matches “red” so we use contains Red:


And repeat for blue


But there are several options you can use:


Depending on what it is you need to display. You could for example have different options depending on how something was rated out of 10, you could display a different question if anything other than good or very good is chosen.


This is where your design comes in, there are infinite possibilities, so it is impossible to show all here.



Our basic example shows the working however, and the finished result is this:



But this could lead to another question, macro etc.


Going live

Finally, when you are ready, click publish form



Applying your form to a job, asset or task

Once you have created your form, you will now be able to apply it to a job, asset or task, depending on which you set up.



Jobs

To apply a form to a job, go through the process of raising a reactive job as usual, and once it has been submitted, awaiting approval or pending acknowledgment, go to the forms section:



From within this page Click add a form and select the form from the drop down:



The form is now added to the job and the service provider will be able to carry it out when completing the job.


Assets

Go to the assets page of Vantify CAFM, and choose the asset you would like to apply the form to by clicking view:


From within the asset go to the forms section:



Click Add form, and click create:



Tasks

To apply it to a PPM, firstly navigate to the manage tasks page from Vantify CAFM, filter and click view on the task you are looking for:


Go to Forms:



Choose the form and click create:


Any jobs that are subsequently generated from the task will automatically have the forms assigned to them.




Related Guides

ELOGCAFM-N-53

ELOGCAFM-N-54



Vantify CAFM Support

For further assistance on anything covered in this guide or others, please contact the Vantify admin team on 01480 499740 or helpdesk.cafm@vantify.com.

This guide was created by Vantify's Product Team and reflects the latest updates as of the specified date. Please note that the information provided may evolve with future system updates or changes. Additionally, some details may vary based on your specific user permissions and account settings within Vantify.