Actions

Display/Export survey

From LimeSurvey Manual



Important.png
Under construction
Help.pngThe following wiki represents an update of the exporting a survey structure wiki.


Introduction

Once a survey gets too complex, it is recommended to backup your work. There could also be situations in which a certain you need to export the survey so that you can continue to edit it in a Spreadsheet software. Or, perhaps you would like to print it and walk throughout the city and ask random people to fill it out, adding them later via the data entry function.

There are two ways to export your survey. The quick version has been described in our introduction to surveys.

For more export-related features, the export process must be done within the survey. Access any survey-related setting, look on the top toolbar for Display/Export to see the available export options from the dropdown menu:


Display and Export location.png


  • Survey strucutre (.lss): it exports the structure of the whole survey (groups, questions, subquestions, answers, and conditions) into a XML file.
  • Survey archive (.lsa): the following option is used when you wish to create a complete backup of your survey, including the already-stored responses.
  • queXML format (*.xml): the *.xml option is used if you wish to have your respondents filling in offline your survey. If selected, please note that not all the question exports can be exported. A .zip file can be downloaded if clicked. The files within it can be used to create a PDF to be printed for your offline respondents.
  • queXML PDF export: it is similar to the option described above. The only difference is that LimeSurvey helps you create the PDF within the software, easing the process of PDF creation.
  • Tab-separated-values format (*.txt): the following option is used when authors use to perform bulk editing of their surveys - useful especially if we discuss about big surveys. In a Spreadsheet software such as Microsoft Excel or LibreOffice actions such as find-replace, bulk-reordering, looping, and testing are faster.
  • Printable survey (*.html): To create a HTML-based survey, click on this option. A .zip file will be downloaded that will contain all the stylesheets necessary to put the survey on any HTML-ready devices or browsers.
  • Printable survey: If selected, LimeSurvey automatically prepares the HTML-based version of your survey - useful to quickly print your survey.


Important.png
Warning : Before selecting one of the above options, please make sure that you read the more detailed explanations of each option from below to better understand the pros and cons of each method! A short summary of each of them is also displayed when selecting each option from the export menu:


Display and export - types.png


Display/Export options

Export survey structure (.lss)

Naturally once you've finished a small masterpiece of a survey, with branching, hundreds of questions that has taken you 5 days to create you'll want to make a backup. This export will dump all the groups, questions, answers and conditions for your survey into a .LSS file (which is basically an XML file). This dump file can be used with the 'Import survey' feature when creating a new survey.

Please note: This file does not contain any collected responses.

Also if you have made a specific template for your survey you have to export that separately. A survey which uses a custom template will import fine, but the template it refers to will not exist on the new server. Go to the template editor on the original server and export the template as a zip file. Import this template on the new server and things should work fine.


Export survey archive (.lsa)

This export is intended to create a complete backup of an active survey for archival purposes. It will include the following data in a ZIP file.


Important.png
Warning : The response data that corresponds to fileupload-questions is currently not exported!


The goal of this format is to be able to check out results of a past survey by re-importing it into LimeSurvey again.


Export queXML format (*.xml)

queXML is an XML description of a questionnaire. It is not suitable for backing up a LimeSurvey instrument as it cannot export conditions, or all question types. Exporting a questionnaire to queXML allows you to create PDF documents that can be printed, filled then scanned and processed using queXF software.

It currently exports the following Question types:

  • Arrays
    • Array 5 point choice (A)
    • Array 10 point choice (B)
    • Array Yes/Uncertain/No (C)
    • Array Increase/Same/Decrease (E)
    • Array flexible row format (F)
    • Array flexible column format (H)
    • Array (flexible Labels) Dual Scale (1)
    • Array (Multi Flexible) (Numbers) (:)
    • Array (Multi Flexible) (Text) (;)
  • Mask questions
    • Date (D)
    • Gender drop down list (G)
    • Numerical question type (N) - defaults to width of 10
    • Multiple Numerical Input (K)
    • Boilerplate (X)
    • Yes/no radio buttons (Y)
  • Multiple choice questions
    • Multiple options checkbox (M)
  • Single choice questions
    • Drop down list (!)
    • 5 point choice (5)
    • Drop down/radio button list (L)
    • Drop down list (W)
    • List with comment (O)
  • Text questions
    • Multiple short text (Q)
    • Short free text (S) - defaults to text input width of 240 "boxes"
    • Long free text (T) - defaults to longtext field with 1024 display rows
    • Huge free text (U) - defaults to longtext field with 2048 display rows
  • Not yet implemented:
    • Ranking style (R)
    • Slider control (^)
    • Multiple options with comments (P)


Export queXML PDF

Export tab-separated-values format (.txt)

This feature is designed to make it easy to use Excel to author and edit surveys. It completely eliminates the dependence upon SGQA codes.

It also makes it easy to do bulk editing of your survey, such as find-replace, bulk-reordering, looping (repeating groups), and testing (such as temporarily disabling mandatory or validation criteria). Check out the dedicated documentation for this format.


Export printable survey (*.html)

The survey can also be exported in two printable formats.


Export printable survey