Import the Questionnaire

February 6, 2024

A questionnaire document prepared in the Designer site needs to be imported to the Survey Solutions data server before the data collection may start in that survey. This article outlines how to import a questionnaire from the Designer to the HQ.

  1. In the main menu select Survey setup, then Questionnaires.

  2. Click the Import questionnaire button.

  3. Enter the Designer credentials (under which you’ve designed your questionnaire).

  4. Select the questionnaire that you want to import from the list. The list of questionnaires shows the questionnaires owned by you and shared with you together. You can navigate the pages, search the questionnaires and sort them by title, date of last modification, or owner.

  5. Once the questionnaire is selected, type an import comment, which is a memo to yourself and colleagues working in HQ regarding this survey or version of the questionnaire. The maximum length of this comment obeys the maximum number of characters permitted in comments to assignments.

  6. If you’ve imported the same questionnaire to the same workspace before, you may wish to upgrade the assignments from an earlier version. Indicate if you wish to do so at this stage, and pick the version of an earlier questionnaire from the list. If you need to upgrade assignments from multiple versions, you can upgrade them one-by-one using the Upgrade assignments menu item in the Survey Setup → Questionnaires page.

  7. Press the IMPORT button.

After the questionnaire is imported it will appear in the list of the questionnaires. If this is the first time you import this questionnaire, it will get assigned a numeric version identifier 1. For subsequent imports of the same questionnaire, the assigned version numbers will increment by one.

Error messages

During the process of importing a questionnaire you may encounter the following situations:

#
Message
Description
1Questionnaire 'NAME' already exists. Please choose another name.You are importing a questionnaire with exactly the same title as another questionnaire already imported to this workspace. To be able to distinguish between them in the interface (in the reports, assignments, etc) the questionnaires must be titled differently. The user needs to modify the title of the questionnaire in the questionnaire settings before importing.
2You have already imported another questionnaire with questionnaire variable 'NAME' from Designer. If you still want to import this particular one, please give it a different questionnaire variable in Designer.You are importing a questionnaire with exactly the same questionnaire variable as another questionnaire already imported to this workspace. The questionnaire variable must be unique. The user needs to modify the questionnaire variable of the questionnaire in the questionnaire settings before importing.
3The questionnaire "NAME" has compilation errors. Please correct them in Designer.Only questionnaires without compilation errors may be imported from the Designer to the data server. If your questionnaire contains any errors, they must be corrected in the Designer tool first.
4The questionnaire "NAME" cannot be found. Please refresh the list of questionnaires.The questionnaire was deleted in the Designer during the import process (by you or a different user, the questionnaire owner). You may not proceed, but must restart the import process and pick a different questionnaire.
5Requested questionnaire cannot be found. Please refresh the list of questionnairesThe questionnaire was deleted in the Designer during the import process (by you or a different user, the questionnaire owner). You may not proceed, but must restart the import process and pick a different questionnaire.
6Your questionnaire "NAME" contains new functionality: ... . New feature(s) is not supported by your installation. Please update.The version of the software that is installed in your data server is too old to facilitate data collection with the questionnaire you are trying to import. The message usually includes hints on what specific functionality is not supported. An update of the data server is recommended in this case, but if an update is not possible, then the Designer tool must be used to edit the questionnaire to remove the not-supported features.
7Designer unavailable. Please make sure that Designer is not in maintenance modeThe server you are trying to import the questionnaire to experienced a problem communicating with the Designer server.

  • First, try to repeat the import procedure. If it doesn't succeed continue troubleshooting.
  • If there is a planned maintenance, a note on this may appear in the users' forum.
  • Access the Designer site directly from the server. Check that you can login from that device. If you can't access it from the browser, the Survey Solutions server will face the same issue (note, that the reverse is not necessarily true).
  • Check with the tools in the Is the Designer tool online now? article to see if this is a user-specific or wide-spread issue.
  • Check the Healthcheck page of the Survey Solutions data server, refer to "Designer connection check" item. (requires the user to be in the role administrator.)
  • You may also want to inspect the server logs, see Data Server Errors for details (this requires file access to the system that is hosting Survey Solutions server).