Actions

Display/Export survey

From LimeSurvey Manual


Other languages:
English • ‎日本語 • ‎Nederlands
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 structure (.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 your survey offline. 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 can 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 an 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 any 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 five 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 your work done so far in LimeSurvey 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

It has the same advantages and disadvantages as the as the Export queXML format option. The difference is about the possibility this option gives to the survey administrators to edit the pdf before exporting it. Once the option is selected, the following default options will be loaded:


Export quexml customization.png


Help.png Notes:
  1. To learn more about the available options in LimeSurvey, access the following wiki section: queXML PDF export.
  2. To learn more about queXML, please click on the following external link.

Export tab-separated-values format (.txt)

This feature is designed to make it easy to use Spreadsheet editors 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 questionnaire can also be exported in two printable formats. The first one gives you the possibility to download the .zip file containing the survey in all your selected languages. The .zip file contains the necessary stylesheets to put it up on any HTML-ready devices or browsers.

Please not that it will not contain any logic or EM-functionality! You'll have to take that into account yourself when designing/editing the questionnaire.

Export printable survey

In comparison to the previous option, all necessary styles will be loaded. Therefore, just press Ctrl/Cmd+p or select print from your browser menu to print the document. As the above *.html option, this one also does not contain any logic or EM-functionality, you'll have to take that into account yourself.