How To use the Pruvan Survey Builder

The Pruvan Survey Builder is a Tool that allows you to create Mobile Forms with Answer Triggers and Photo Requirements which allows Admin users to dictate what information is collected from the field. This information is relayed back to your Pruvan online account and is downloaded as a PDF document where all of the answers can be viewed. Make sure to check out the Pruvan Survey Best Practices article!


1. Menu Bar

This contains controls for the survey as well as the title fields

  • Exit - Exits the survey, does NOT save changes!
  • New - Creates a new survey template, does NOT save changes to the current template!
  • Template ID - this is the ID the system uses to identify your survey
    • You will need to use this ID if the survey is attached to a work order via an integration
  • Title - The name of your survey
    • This will also be the name of the Task on the mobile device the user sees
  • Preview Survey - This brings up a window that allows you to walk through the survey as if you were on a mobile device
    • Useful for testing survey flow and triggers
  • Export JSON - Used to grab the code that defines your survey
    • This can be saved to a file as a backup or copied in to another account or system
  • Import JSON - Used to import a survey from another account, system, or from a local backup file
  • Save - Saves all of your changes to the current survey template
    • You will receive an error if you have a question in your Question List that is NOT defined; that is all required fields in the Selected Question section are filled out

2. Survey Questions

This is your question list.  It is ordered with the first question at the top and the final question at the bottom.  Indented questions are not enabled by default; more on that later.  The following buttons are used in this section:

  • Add Question - Adds a new question to the list immediately after the selected question
  • Duplicate Question - Duplicates the selected question and adds it immediately after the selected question
  • Up / Down Arrows - Moves the selected question up or down the question list
  • Delete Question - Deletes the selected question

3. Selected Question

This is where you set up each question.  The following goes over each field, from top to bottom:

  • Question ID - An ID field for the system to track the question and for you to be able to quickly identify a question from the list in the Survey Builder
  • Answer Type - Sets what kind of answer is allowed for the question
    • Yes No – a simple yes or no question
    • Text – Allows for free-form text answers, paragraph style
    • Integer – Only allows for number answers
    • Date – Opens the devices calendar picker to choose a date
    • Choose One – Presents a list of answers that you define, only one can be selected
    • Choose Multiple – Presents a list of answers that you define, where one to all can be selected
    • None - This is used to make a statement instead of a question; there is no answer.  Commonly used for Photo Requirements
  • Required  - Controls if the question has to be answered for the survey to be submitted
    • Checked - Will not let the user submit the survey until the question is answered
    • Not Checked - The user can skip the question and still submit the survey
  • Enabled By Default - Controls if the question is displayed for the user to read / answer
    • Checked - Will be presented to the user after the preceding 'enabled' question
    • Not Checked - Will only be presented to the user if enabled by a previous answer trigger; these questions are indented in the Question List
  • Question Text - The actual question text displayed to the user in the mobile app
  • Question Hint - Display additional information to the user
    • Only intended for short statements

4. Answer Options

This is where you can define your answers.  This section only appears for Choose One and Choose Multiple answer types.  The following goes over each field, from top to bottom:

  • Add Option - Adds an answer option to the bottom of the list
  • Up / Down Arrows - Move the selected answer up or down the list
  • Answer Column - Shows the Answer ID, used by the system to identify an answer
  • Display Column - The text that is displayed as the answer in the mobile device
  • Delete Option - Deletes the selected answer

5. Answer Triggers

Answer Triggers control the flow of a Survey and optimize the number of Questions that you ask the user.  You create answer triggers to enable future questions based on the answer of the current question. The format of an answer trigger is "When the answer is X, enable the following questions."

Example:  When the ‘Does the property have a pool’ answer is 'Yes', enable these questions that are only relevant to pools

  • Add Answer Trigger - Create a new answer trigger
  • Answer Column - The answer that enables questions
  • Enables Column - The question IDs that are enabled from the specified answer
  • Delete Answer Trigger - Deletes the selected answer trigger

6. Photo Requirements

Photo Requirements dictate how many photos are required for each answer. You can specify minimum and maximum numbers of photos for each answer.  Each photo requirement must have a minimum and maximum listed.  Please note that if the question that this photo requirement belongs to is not marked as 'required' then the photo requirement will not be required to submit the survey either.

Example:  If the answer for the ‘Does the property have any external damage’ is 'Yes', then require 10 to 25 photos of the damage

  • Add Photo Requirement - Create a new photo requirement
  • Answer Column - The answer that enables the photo requirement
    • An asterisk (*) in the answer column will apply the photo requirement on the selected question no matter what the selected answer is
    • For yes/no answer types, be sure to use lowercase yes and no in your photo requirements
  • Min Column - The minimum number of photos allowed for this answer
  • Max Column - The maximum number of photos allowed for this answer
  • Delete Photo Requirement - Deletes the selected photo requirement


Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request