__TOC__

<div class="simplebox">'''Hint:''' This page describes how you can find out an SQGA identifier. For information how to use it please refer to the page [[Adding a question]]. </div>

=General Description=

The SGQA (Survey/Group/Question/Answer) identifier is a shortcut to the answer of a question. Every survey, group and question you are creating gets a unique number assigned in your database. You can see this number in the admin interface in the title of the survey, group and question bar.

<center>[[File:SGQA.png]]</center>

To determine the SGQA identifier, you have to put these numbers together with the letter 'X' in between.

<div class="simplebox">'''Note:''' Always use capital letters ("X" instead of "x")!</div>

=Identifier for Single Choice Questions=

For example: Survey has ID 1, Group has ID 6, Question has ID 12. Your identifier for a single choice question would look like this:

1X6X12

=Identifier for Multiple Choice Questions=

Since it is a multiple choice question the particular answer must be identified too. Just add the code of that answer without an X. For example: Survey has ID 1, Group has ID 6, Question has ID 12. The particular answer has code 'ber1'.

Your identifier for this multiple choice question answer would look like this:

1X6X12ber1

=Identifier for Array question types=

Since it is a array question the particular subquestion within the cell must be identified too. Add the subquestion code of the row without an X. For example: Survey has ID 1, Group has ID 6, Question has ID 12. The particular subquestion has code 'ber1'. Your identifier for this "Array" question answer would look like this:

1X6X12ber1

=Identifier for Array (Text) or Array (Number) Questions=

Since it is a combined array question the particular answer within the cell must be identified too. Add the subquestion code of the row without an X, then append the underscore char and finally add the subquestion code that indentifies the column. For example: Survey has ID 1, Group has ID 6, Question has ID 12. The particular subquestion has code 'ber1', and the column is identified by the subquestion with code 'lab1'

Your identifier for this "Array (Text)" question answer would look like this:

1X6X12ber1_lab1

=Uses of the SGQA identifier=

The SGQA identifier can be used to load the answers to previously saved questions into the question text of later questions. (See [[Adding a question]] - Information from previous answers)

It can also be used in the query URL of a survey to "prefill" answers to a survey. eg: for SGQA 1X6X121ab1, your query URL could include "&1X6X121ab1=Y" to prefill that answer with a "Y". (See workarounds -> [http://docs.limesurvey.org/tiki-index.php?page=Workarounds#Prefilling_survey_answers_using_the_survey_URL Prefilling survey answers using the survey URL])

The SGQA identifier is also the field name where the data for each question is stored in the database survey responses table.

Some people may find a need to reference a question dynamically. For instance, if you would like to hide the input text field of a short text answer. You can use some Javascript to do this by using the {SGQ} identifier (as of SVN build 9755).

Localization

2011-01-25T20:18:29Z

Timbee:

{maketoc title="On this page:"}

There are two places where language specific localization are defined and stored.

One is in the Installation directory where built-in messages to the PHP code are stored in language specific files. These must be translated and installed by the system administrator before that language is available for the administrative interface and for some basic buttons and built-in messages seen by survey participants. Normally, a survey developer would not have access to edit but only select these translations.

The other source of language specific localization is in the surveys themselves. These translations for each survey consist of the survey title, overview, and each group, question, answer and labelset text. All these translations are stored in the SQL database tables themselves. Normally, a survey developer must define all the desired translations beyond the base language.

=== Languages for administration interface and built-in messages for survey participants===

The public survey screens and the admin interface can be localized so that built-in messages and text will appear in your preferred language. For example "yes" and "no" would appear as "ja" and "nein" in the Deutsch/German version. Limesurvey has about 50 different languages of built-in messages already translated. To see the translation status for these languages please follow the link:

[http://www.limesurvey.org/en/contribute/translations-status Translations Status]

You can create/update your own translation locally by using these instructions:

[[How to translate LimeSurvey]]

If you do modify or create a new translation, please consider contributing it for future releases. Also, if you do modify or create a new translation, remember to take care of this when upgrade to a newer version later.

<div class="simplebox">'''Note:''' The template files are not currently localized and thus are language independent. Try to avoid putting text directly into the template files. Instead, define the necessary language in other files that are localized.</div>

So far we only discussed translating the built-in text of the administration interface that the survey participants and developers see; that part that is independent of any survey. Each survey can have one or more languages associated with it as well independent of this interface. So care must be taken to offer the appropriate translations there as well.

=== Languages for surveys themselves===

If more than one language is defined for a survey, then when editing that survey or each question, answer or labelset within it -- you then need to make sure to add all the language translations desired. Otherwise, the default language of the survey will appear if no translation is available. This is available when editing a Survey, Group, Question, Answer set or labelset.

<div class="simplebox">'''Note:''' If you do not have permission to edit labelsets, you will not be able to provide the translation of that labelset either. Talk to your survey administrator about either giving you the permission to edit the labelset or providing the translation in your desired language.</div>