Survey Integration

Using SurveyJS to create and integrate surveys

SurveyJS is used to create custom surveys that can be smoothly integrated into LiteFarm’s current processes. Current and planned integrations include the FAO TAPE survey, region-specific TAPE surveys, and RegenScore.

Survey creation process

1. Collaborate with the research group to define the survey requirements and create a custom survey in SurveyJS through projects.

Open

2. Review the survey structure and ensure the questions, logic, and formatting are correct.

3. Make sure you add these in the end of the JSON to ensure they are saved correctly in the database (version control - TAPE example)

   1. "calculatedValues": [ { "name": "survey_version", "expression": "'TAPE_Mornington_CAET_STEP1_2026_V1_TEST_REVISED'", "includeIntoResult": true }, { "name": "project_id", "expression": "'Mornington'", "includeIntoResult": true }, { "name": "survey_step", "expression": "'STEP1'", "includeIntoResult": true } ],

4. Format and download the SurveyJS JSON file.

5. Share the JSON with the development team so they can integrate it with the LiteFarm app.

6. Once integrated, the survey data is stored through the LiteFarm application workflow.

Uploading the SurveyJS file

1. Upload the SurveyJS JSON file to the appropriate storage bucket, starting with Beta and then moving to the app environment.

2. Create a custom folder if needed for the survey or region-specific version.

3. Upload the file step by step screenshots of the process is here:

   1. Pick the folder

   2. Open

      

      Press upload

   3. Open

      

      Make sure to press “Public” once file is selected

   4. Open

      

      Press “Replace” if the file is already there. ENSURE YOU NAME IT EXACTLY AS IT IS if you are replacing/updating a survey

   5. Open

      

      You will see 2 surveys; don't worry, just hit refresh

   6. Press on the 3 dots and select “Manage Metadata”

      Open

      

       

   7. Ensure you write “no-cache” in Cache-Control and then click “Save”

      Open

      

4. Once these steps are completed, the survey is ready to be viewed and tested.