Tab Separated Value survey structure/pt-br

Importação de Valores Separados por Tabulação e Exportação de Estrutura de Questionário

Esse recurso foi projetado para facilitar o uso de um software de planilhas como o LibreOffice, o Excel ou o Google Docs para criar e editar questionários. Elimina completamente a dependência dos códigos do SGQA.

Esse recurso oferece suporte à importação de arquivos TSV (Tab Separated Value) codificados em ASCII ou UTF-8 que possuem uma extensão .txt.

Verifique o seguinte exemplo para entender melhor essa funcionalidade.

Começando

A maneira mais fácil é tomar um questionário existente e exportá-lo no formato Valores Separados por Tabulação. Use o botão utilizado normalmente para exportação de questionário e, em vez de selecionar o formato .Iss, selecione Formato "Valores Separados por Tabulação (*.txt)". Ele será salvo como um arquivo de Valores Separados por Tabulação no formato adequado (arquivo unicode delimitado por tabulações), com todos os cabeçalhos de colunas corretos.

Qualquer software de planilhas que suporte valores separados por tabulações será bom (por exemplo, OpenOffice ou LibreOffice). O LimeSurvey ignora qualquer formatação na planilha, mas fique à vontade para adicionar algumas se isso te ajudar.

Observe que o arquivo exportado está em formato UTF-8 com a Marca de Ordem de Byte (BOM) como os três primeiros caracteres (ocultos). Se você clicar duas vezes no arquivo .txt e tentar abri-lo diretamente com o Excel, ele não será aberto corretamente, porque o Excel não detecta que ele está formatado em UTF-8. Para abrir esses arquivos, primeiro abra o Excel, selecione Arquivo: Abrir, selecione o arquivo .txt e informe ao programa que ele está usando a codificação UTF-8.

Haverá uma linha para cada grupo, pergunta, subquestão e resposta. Há também linhas para variáveis globais do questionário e para variáveis do questionário específicas do idioma. O idioma principal será listado primeiro, seguido por quaisquer idiomas secundários. Portanto, se houver vários idiomas, todo o conteúdo do idioma base aparecerá primeiro (por exemplo, todos os grupos, perguntas, subquestões e respostas). Isto será seguido por uma cópia traduzida para cada idioma secundário (com exatamente o mesmo número e ordem ou linhas para o conjunto traduzido).

Relacionamentos são inferidos pela proximidade. Então, as perguntas que seguem um grupo fazem parte desse grupo; subquestões após uma pergunta fazem parte dessa questão e as respostas após uma pergunta fazem parte dessa questão. Assim, você não precisa saber os IDs (gid, qid, sqid) para qualquer pergunta. Aqueles serão computados automaticamente na importação. Na verdade, esse formato não usa gid, qid ou sqid (nem códigos SGQA).

Dicas

O objetivo da importação/exportação em formato de Valores Separados por Tabulações é permitir que você crie rapidamente seu questionário usando uma planilha. Esperamos que você importe a planilha com frequência, verifique sua validade usando o recurso "Mostrar lógica do questionário" e teste-o. Cada vez que você importá-la, você terá um novo questionário. Então, você pode acabar com muitos questionários parcialmente desenvolvidos, mas tudo bem. Adquira o hábito de acompanhar qual é o mais recente ou exclua o antigo depois de importar os novos. Como você nunca usa códigos do SGQA no formato de Valores Separados por Tabulações, nunca precisa se preocupar com os códigos que o LimeSurvey atribui às chaves de questionário, grupo, pergunta e resposta principais. Portanto, sinta-se à vontade para importar e exportar quantas vezes quiser.

Aqui estão algumas coisas convenientes que você pode fazer com este formato para instrumentos de autoria:

1. Use as mesmas respostas para muitas perguntas. Apenas copie as linhas 'A' (para respostas) e cole após cada pergunta que deve ter o mesmo conjunto.
2. Use as mesmas subquestões para muitas perguntas. Basta copiar as linhas 'SQ' (para subquestões) e colá-las após cada pergunta que precisar.
3. "Looping" - use o mesmo grupo várias vezes. Depois que o grupo estiver do jeito que você deseja, copie-o quantas vezes forem necessárias. Use a filtragem do Excel para exibir apenas as linhas "G" (para grupos) e use o recurso de arrastar colunas do Excel para atualizar as equações de relevância de cada grupo (por exemplo, para um censo, a primeira relevância pode ser "numPeople> 1"). O próximo deve ser "numPeople> 2". O recurso de arrastar atualizará automaticamente o número). Filtre por linhas 'Q' (para questões) e assegure-se de que cada pergunta tenha um valor único (por exemplo, nomeie suas variáveis g1_q1, g1_q2, g1_qN, use localizar/substituir para converter g1 em g2 o segundo grupo; g3 para o terceiro, etc.)
4. Reordenar perguntas/grupos. Simplesmente reordene as linhas do arquivo de planilha.
5. Testando módulos do questionário. Para questionários longos, você pode querer dividir o teste em módulos. Basta criar novos arquivos de planilhas para cada módulo, excluindo as linhas que você não precisa. Isso evita a necessidade de inserir muitos dados para testar seções posteriores do questionário.
6. Testando questões obrigatórias. Uma queixa comum não é a necessidade de tornar muitas perguntas obrigatórias, mas a necessidade de desativar o recurso obrigatório para testes. Basta criar a planilha principal com o conjunto obrigatório para os valores finais desejados. Em seguida, para testá-lo, basta excluir a coluna "obrigatória" e salvar a versão de teste da planilha. Quando você importa essa versão, nenhuma das perguntas será obrigatória. Depois de concluir o teste, importe a cópia principal.
7. Configurando padrões. Em vez de usar a GUI, você pode inserir os padrões desejados na coluna padrão. Isso é especialmente útil para casos em que a GUI não permite inserir o valor desejado, como expressões, para definir o padrão para itens da lista (como preencher uma lista de um atributo participante do questionário).
8. Tradução. Você pode criar cópias de sua planilha - uma por idioma. Inclua todas as linhas do idioma principal, copie e cole-as abaixo e use o recurso de arrastar para alterar o campo de idioma para o idioma de destino. Estes podem ser distribuídos aos seus tradutores e reintegrados em um único arquivo de planilha quando eles forem concluídos.
9. Configuração em massa de atributos de perguntas avançadas. Você pode querer que todas as suas equações se tornem visíveis (para que você possa ver os valores delas ao coletar dados), mas depois ocultá-las antes de ir para a produção. Simplesmente filtre a planilha em class = 'Q' e tipo de pergunta = '*' (equação) e defina always_hide como 1 para cada uma dessas perguntas. Da mesma forma, depois de criar o questionário, você decide quais perguntas devem aparecer nas estatísticas públicas. Em vez de editar cada questão através da GUI, filtre em class = 'Q' e defina public_statistics = 1 para todas as questões que devem estar visíveis nas estatísticas.
10. Localizar e substituir. Digamos que você decida alterar algumas frases em todas as suas perguntas. Você pode usar o Excel para encontrar e substituir para fazer essas alterações. Da mesma forma, digamos que você decida fazer uma renomeação em massa de suas variáveis, localizar e substituir pode vir ao resgate. Se você precisar localizar e substituir com base na expressão regular, poderá selecionar a coluna desejada, copiar para um editor de texto, localizar e substituir e colar a coluna de volta na planilha.
11. Ganhando aprovações. Se você está fazendo um questionário, você pode ter um Conselho de Revisão Institucional que insiste em ver o texto das perguntas. Esta pode ser uma maneira conveniente de compartilhá-lo. Da mesma forma para discussões com um cliente.
12. Consenso da equipe. Se você estiver tentando fazer com que um grupo concorde com a redação ou a aparência de uma pergunta ou grupo, você poderá rapidamente criar um protótipo/editar a planilha, importá-la e mostrar à equipe exatamente por meio da pergunta ou da visualização do grupo . Dessa forma, você pode obter aprovação da equipe antes de sair da sala, em vez de precisar documentar os requisitos, montá-los e obter aprovação em reuniões futuras.
13. Atualizando de outros formatos de questionário. Se seu questionário estiver em formato XML, Word ou outro formato, você poderá criar um processo de tradução para mapeá-los para esse formato. Embora você também possa tentar mapear para o formato .lss, a vantagem desse formato é que ele não exige que você acompanhe os relacionamentos de chaves estrangeiras entre grupos, perguntas, subquestões, respostas e padrões.

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
2. related_id
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

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