Tab Separated Value survey structure/es

Importación y exportación de valores separados por tabulaciones de la estructura de la encuesta

Esta función está diseñada para facilitar el uso de un software de hoja de cálculo como LibreOffice, Excel o Google Docs para crear y editar encuestas. Elimina por completo la dependencia de los códigos SGQA.

Esta función admite la importación desde archivos de valores separados por tabulaciones (TSV) codificados en ASCII o UTF-8 que tienen una extensión .txt.

Template:Nota

Empezando

La forma más sencilla es tomar una encuesta existente y exportarla en formato de valores separados por tabulaciones. Utilice el botón de exportación de encuesta normal y, en lugar de seleccionar el formato .lss, seleccione "Formato de valores separados por tabulaciones (*.txt)". Se guardará como un archivo de valores separados por tabulaciones en el formato adecuado (archivo Unicode delimitado por tabulaciones), con todos los encabezados de columna correctos.

Cualquier software de hoja de cálculo que admita valores separados por tabulaciones está bien (por ejemplo, OpenOffice o LibreOffice). LimeSurvey ignora cualquier formato dentro de la hoja de cálculo, pero siéntete libre de agregar alguno si te ayuda.

Tenga en cuenta que el archivo exportado está en formato UTF-8 con la marca de orden de bytes (BOM) como los primeros tres caracteres (ocultos). Si hace doble clic en el .txt e intenta abrirlo directamente con Excel, no se abrirá correctamente porque Excel no se da cuenta de que tiene formato UTF-8. Para abrir estos archivos con Excel, primero abra Excel, luego seleccione Archivo:Abrir, seleccione el archivo .txt e indique a Excel que está usando codificación UTF-8.

Habrá una fila para cada grupo, pregunta, subpregunta y respuesta. También hay filas para las variables de la encuesta global y para las variables de la encuesta específicas del idioma. El idioma principal aparecerá primero, seguido de los idiomas secundarios. Por lo tanto, si hay varios idiomas, todo el contenido del idioma base aparecerá primero (por ejemplo, todos los grupos, preguntas, subpreguntas y respuestas). A esto le seguirá una copia traducida para cada idioma secundario (con exactamente el mismo número y orden o filas para el conjunto traducido).

Las relaciones se infieren por proximidad. Entonces, las preguntas que siguen a un grupo son parte de ese grupo; las subpreguntas que siguen a una pregunta son parte de esa pregunta, y las respuestas que siguen a una pregunta son parte de esa pregunta. Por lo tanto, no necesita conocer los ID (gid, qid, sqid) para cualquier pregunta. Estos se calcularán automáticamente al momento de la importación. De hecho, este formato no utiliza gid, qid o sqid (o códigos SGQA) en absoluto.

Consejos

El objetivo de la importación/exportación de valores separados por tabulaciones es permitirle diseñar rápidamente su encuesta utilizando una hoja de cálculo. Esperamos que importe la hoja con frecuencia, verifique su validez utilizando la función "Mostrar lógica de encuesta" y la pruebe. Cada vez que la importe, obtendrá una nueva encuesta. Por lo tanto, es posible que termines con muchas encuestas parcialmente desarrolladas, pero está bien. Simplemente adquiera el hábito de realizar un seguimiento de cuál es el más reciente o elimine el anterior después de importar los nuevos. Dado que nunca utiliza códigos SGQA en el valor separado por tabulaciones, nunca tendrá que preocuparse por los códigos que asigna LimeSurvey para las claves principales de encuesta, grupo, preguntas y respuestas. Así que siéntete libre de importar y exportar tantas veces como quieras.

Aquí hay algunas cosas convenientes que puede hacer con este enfoque para crear instrumentos:

1. Use las mismas respuestas para muchas preguntas. Simplemente copie las filas 'A' y péguelas después de cada pregunta que debería tener el mismo conjunto.
2. Use las mismas subpreguntas para muchas preguntas. Simplemente copie las filas 'SQ' y péguelas después de cada pregunta que las necesite.
3. "Looping" - use el mismo grupo muchas veces. Una vez que el grupo esté como lo desea, cópielo tantas veces como sea necesario. Utilice el filtrado de Excel para ver solo las filas 'G' (para grupos) y utilice la función de arrastre de columnas de Excel para actualizar las ecuaciones de relevancia para cada grupo (por ejemplo, para un censo, la primera relevancia podría ser "numPersonas > 1", la El siguiente debería ser "numPeople > 2". La función de arrastre actualizará automáticamente el número). Filtre por filas 'Q' y asegúrese de que cada pregunta tenga un valor único (por ejemplo, digamos que nombra sus variables g1_q1, g1_q2, g1_qN, use buscar/reemplazar para convertir g1 a g2 el segundo grupo; g3 para el tercero, etc.) .
4. Reordenación de preguntas/grupos. Simplemente reordene las filas del archivo de hoja de cálculo.
5. Probando módulos de encuesta. Para encuestas largas, es posible que desees dividir las pruebas en módulos. Simplemente cree nuevos archivos de hoja de cálculo para cada módulo y elimine las filas que no necesite. Esto evita la necesidad de ingresar muchos datos para probar secciones posteriores de la encuesta.
6. Prueba de preguntas obligatorias. Una queja común no es la necesidad de hacer que muchas preguntas sean obligatorias, sino la necesidad de desactivar la función obligatoria para las pruebas. Simplemente cree la hoja de cálculo maestra con el conjunto obligatorio de los valores finales deseados. Luego, para probarlo, simplemente elimine la columna "obligatoria" y guarde la versión de prueba de la hoja de cálculo. Cuando importe esa versión, ninguna de las preguntas será obligatoria. Una vez que haya terminado las pruebas, importe la copia maestra.
7. Configuración predeterminada. En lugar de utilizar la GUI, puede ingresar los valores predeterminados que desee en la columna predeterminada. Esto es especialmente útil para los casos en los que la GUI no le permite ingresar el valor deseado, como expressions para establecer el valor predeterminado para los elementos de la lista (como completar una lista a partir de un [[Participantes de la encuesta|participante de la encuesta] ] atributo).
8. Traducción. Puedes crear copias de tu hoja de cálculo, una por idioma. Incluya todas las filas para el idioma principal, luego cópielas y péguelas a continuación, y use la función de arrastrar para cambiar el campo de idioma al idioma de destino. Estos pueden distribuirse a sus traductores y reintegrarse en un único archivo de hoja de cálculo cuando hayan terminado.
9. Configuración masiva de atributos avanzados de preguntas. Es posible que desee que todas sus ecuaciones comiencen a ser visibles (para que pueda ver sus valores a medida que recopila datos), pero luego ocultarlas todas antes de pasar a producción. Simplemente filtre la hoja de cálculo por clase = 'Q' y tipo de pregunta = '*' (ecuación), y establezca siempre_hide en 1 para cada una de esas preguntas. De manera similar, digamos que después de crear la encuesta, usted decide qué preguntas deben aparecer en las estadísticas públicas. En lugar de editar cada pregunta a través de la GUI, filtre por clase = 'Q' y establezca public_statistics = 1 para todas las preguntas que deberían estar visibles en las estadísticas.
10. Buscar y reemplazar. Supongamos que decide que necesita cambiar algunas frases en todas sus preguntas, puede usar Excel para buscar y reemplazar para realizar esos cambios. De manera similar, supongamos que decide cambiar el nombre de sus variables en masa, buscar y reemplazar puede venir al rescate. Si necesita buscar y reemplazar basado en expresiones regulares, puede seleccionar la columna deseada, copiarla a un editor de texto, buscar y reemplazar y pegar la columna nuevamente en la hoja de cálculo.
11. Obteniendo aprobaciones '. Si está investigando, es posible que tenga una junta de revisión institucional que insista en ver el texto de las preguntas. Esta puede ser una manera conveniente de compartirlo. Lo mismo ocurre con las discusiones con un cliente.
12. Consenso del equipo. Si está intentando lograr que un grupo se ponga de acuerdo sobre la redacción o la apariencia de una pregunta o grupo, puede crear un prototipo/editar rápidamente la hoja de cálculo, importarla y mostrarle al equipo (a través de una pregunta o una vista previa del grupo) exactamente lo que verán los usuarios. . De esa manera, puede obtener la aprobación del equipo antes de que abandonen la sala en lugar de tener que documentar los requisitos, crearlos y obtener aprobación en reuniones futuras.
13. Actualización desde otros formatos de encuesta. Si su encuesta está en XML, Word u otro formato, puede crear un proceso de traducción para asignarla a este formato. Aunque también podría intentar mapear al formato .lss, la ventaja de este formato es que no requiere que realice un seguimiento de las relaciones de clave externa entre grupos, preguntas, subpreguntas, respuestas y valores predeterminados.

Limitations

1. By design, this feature only works properly for surveys that use qcode (rather than SGQA) naming. This feature assumes that variable names (question identifiers) are unique throughout the survey. Subquestion names can be repeated, as long as they are unique within the scope of a particular question.

File Format

General

We use the same set of column headings for multiple purposes. The first 14 columns serve different purposes depending upon the type of entity (e.g., group, question, answer). The remaining columns are an alphabetical list of the database field names for the advanced question codes. Below is the syntax for each entity type

The first 14 columns are:

1. id ^{(New in 3.14.0 )}
2. related_id ^{(New in 3.14.0 )}
3. class
4. type/scale
5. name
6. relevance
7. text
8. help
9. language
10. validation
11. mandatory
12. other
13. default
14. same_default

 Hint: Columns id and related_id are used only for quota and are optional. If you don't have quota, you can directly remove this 2 columns.

Survey Global Parameters

There is one row per parameter in the surveys table.

1. class => 'S'
2. name => database field name
3. text => value

Survey Language-Specific Parameters

There is one row per field per language in the surveys_languagesettings table. All entries for a given language are collected before doing the insert into that table.

1. class => 'SL'
2. name => database field name
3. text => value
4. language => language

Groups

One group row per survey language (e.g., there would be 3 group rows if survey has 3 languages).

1. id => unique numeric identifier for the group, starting with number 1, use the same ID for additional languages belonging to current group
2. class => 'G'
3. name => group_name -- the unique identifier for the group
4. relevance => grelevance -- the group-level relevance equation, without curly braces
5. text => description -- the language-specific description of the group
6. language => language -- the language for the group (e.g., 'en')

Questions

One question row per survey language (e.g., there would be 3 question rows if survey has 3 languages). Questions are assumed to belong to the group that precedes them.

1. id => unique numeric identifier for the question, starting with number 1, use the same ID for additional languages belonging to current question
2. class => 'Q'
3. type/scale => type -- the (usually one letter) question type (e.g., 'M' is Multiple Choice)
4. name => title -- the unique question name (the root of the qcode naming system)
5. relevance => relevance -- the relevance equation for the question
6. text => question -- the language-specific text of the question
7. help => help -- the language-specific help text
8. language => language -- the language for the group (e.g., 'en')
9. validation => preg -- the optional regular expression validation criteria for the question
10. mandatory => mandatory -- 'Y' if mandatory
11. other => other -- 'Y' if the "Other" option should be available (only for some question types)
12. default => default -- if set, this value is inserted into the defaultvalues table for this question
13. same_default => same_default -- 'Y' for true, in which case any defaultvalue set for primary language applies to other languages

Subquestions

One subquestion row per survey language. Subquestions are assumed to belong to the question that precedes them.

1. id => same unique numeric identifier which is used for the questions. Subquestions should use next available value, question and subquestion IDs should be different (e.g. use ID 1 for question and IDs 2, 3 and 4 for subquestions belonging to question 1, next question ID should be 5 and so on). Use the same subquestion ID for additional languages belonging to current subquestions.
2. class => 'SQ'
3. type/scale => scale_id -- 0 or 1, depending upon question type (e.g. array text will have two scales)
4. name => title -- the "name" of the subquestion, e.g. the one used for exclude_all_others
5. relevance => relevance -- (Future) to support subquestion-level relevance
6. text => question -- the language-specific text of the subquestion
7. help => help -- (Future) to support subquestion-level help
8. language => language -- the language for the subquestion
9. validation => preg -- (Future) to support subquestion-level regular expression validation (e.g. for address parts)
10. mandatory => mandatory -- (Future) to support subquestion-level mandatory (e.g. make only a few subquestions mandatory)
11. default => default -- if set, then this is the default value for the subquestion (inserted into defaultvalues table)
12. same_default => same_default -- if set, then the default for the primary language is  used for all other languages

Answers

One answer row per survey language (e.g., there would be 3 answer rows if survey has 3 languages). Answers are assumed to belong to the question that precedes them, and be in the desired sort order.

1. id => use the same ID as the ID of the question it belongs to
2. class => 'A'
3. type/scale => scale_id -- 0 or 1 (e.g. for dual-scale)
4. name => code -- the unique answer identifier
5. relevance => assessment_value -- if using assessment option, this is the assessment value for the answer
6. text => answer -- the language-specific text of the answer
7. language => language -- the language for this answer (e.g. 'en')

Assessments

One assessment row per survey language (e.g., there would be 3 assessment rows if survey has 3 languages). Assessments are written at the end of file.

1. id => unique numeric identifier for the assessment, starting with number 1, use the same ID for additional languages belonging to current assessment
2. related_id => id of group to which current assessment belongs to
3. class => 'AS'
4. type/scale => assessment scope: T-Total, G-group
5. name => name
6. text => message
7. min_num_value => Minimum
8. max_num_value => Maximum
9. language => language -- the language for this answer (e.g. 'en')

Quotas

One row per quota. Quotas are written at the end of file.

1. id => unique numeric identifier for the quota, starting with number 1
2. class => 'QTA'
3. name => quota name
4. mandatory => limit
5. other => quota action
6. default => active
7. same_default => autoload URL

Quota language settings

One quota row per survey language. Quota language settings are assumed to belong to the quota that precedes them.

1. id => unique numeric identifier for the quota language settings, starting with number 1. Each row for different survey languages should have different IDs
2. related_id => quota id of quota to which this setting belongs to
3. class => 'QTALS'
4. relevance => message
5. text => URL
6. help => URL description
7. language => language -- the language for this quota (e.g. 'en')

Quota members

One row per quota member, no language dependent. Quota member row should be placed immediately after question it relates to. Quota members are assumed to belong to the question that precedes them.

1. id => unique numeric identifier for the quota members, starting with number 1
2. related_id => quota id of quota to which this member belongs to
3. class => 'QTAM'
4. name => answer code

Conditions

One row per condition, no language dependent. Condition row should be placed immediately after question it relates to. Conditions are assumed to belong to the question that precedes them.

1. id => unique numeric identifier for the condition, starting with number 1.
2. related_id => question id of related question, if applicable
3. class => 'C'
4. type/scale => scenario
5. name => answer field name
6. relevance => comparison operator
7. text => expected answer