Skip to content

limesurvey-setup.md

Latest commit

 

History

History
42 lines (30 loc) · 3.75 KB

limesurvey-setup.md

File metadata and controls

42 lines (30 loc) · 3.75 KB
id limesurvey-setup
title LimeSurvey Setup

⚠️ This document assumes you've already successfully installed the Community Edition of LimeSurvey. If you haven't completed this step yet, please follow the directions provided by LimeSurvey.

Configure LimeSurvey to prepare for file import

A small amount of preparation is required before importing the OSMM survey structure file.
On the Global settings screen in the LimeSurvey admin interface, select General settings from the left sidebar and then Group by group under the "Format:" option. Screenshot of the admin panel, with the 'General settings' and 'Group by group' options circled
Next, select Presentation from the left sidebar and confirm that the options are set to these values:
  • Navigation delay (seconds): 0
  • Show question index/allow jumping: Disabled
  • Show group name and/or group description: Show both
  • Show question number and/or code: Hide both
  • Show "No answer": Off
  • Show "There are X questions in this survey": Off
  • Show welcome screen: On
  • Allow backward navigation: Off
  • Show on-screen keyboard: Off
  • Show progress bar: On
  • Participants may print answers: On
  • Public statistics: On
  • Show graphs in public statistics: On
  • Automatically load end URL when survey complete: On

Import the OSMM survey structure file

The next step is to import the OSMM survey structure file. This will create the OSMM survey in the LimeSurvey system.
Save the OSMM survey structure file to your local system. It's located in the data folder in the OSMM GitHub repository.
At the top of the Admin panel, click the + Create Survey link.
Select the Import option on the Create, import, or copy survey display Screenshot of the Create, import or copy survey panel, with the 'Import' option circled
Select Choose file, navigate to where you saved the survey structure file on your local system, select that file, select the Convert resource links and expression fields? option, then click Import survey. Screenshot of the file selection controls on the Create, import or copy survey panel. The 'Choose file' option is circled.
The survey will not take long to import. Once it's complete, you'll see the import survey summary success report. Screenshot of the import summary success report.

Cautionary notes about modifying the survey

Some portions of the survey setup are required for OSMM operations:

  • The OSMM survey relies upon the question_no field and the question_type value assigned to each question.
  • Some of the survey expressions are required for the aggregation of values at the element and dimension level.

Modifying these can (likely will) have unexpected side-effects on the survey results, including incorrect or invalid results or metrics.

BACK UP THE SURVEY. Before modifying the survey, please make sure either to have the survey structure file handy in case a re-import is required or export the survey structure as a backup file.