A importação de Questionários permite cadastrar questionários e suas perguntas em lote por meio de um arquivo CSV.
Além da pergunta e das opções de resposta, é possível definir o grupo, tipo de resposta, gênero, exibição de detalhes, obrigatoriedade e opção padrão de cada pergunta.
O arquivo deve possuir uma linha para cada questionário e pode conter até 500 linhas.
Para informações sobre como acessar a importação, realizar a pré-validação, confirmar o processamento e consultar erros, consulte o artigo Como importar dados via CSV.
Estrutura do arquivo
Cada linha do arquivo representa um questionário, contendo suas respectivas perguntas e configurações.
As seguintes colunas são obrigatórias:
description, questionsGroup, quizType
Colunas
Coluna | Obrigatório | Formato | Descrição |
| Sim | Texto | Nome do questionário. Deve ser único |
| Sim | Composto | Perguntas, grupos e configurações de cada pergunta. Consulte a estrutura abaixo |
| Sim |
| Tipo do questionário. Consulte os valores aceitos abaixo |
Tipo do questionário (quizType)
Informe na coluna quizType o código correspondente ao tipo do questionário:
Valor | Descrição |
| Saúde |
| Segurança |
| Ambos |
Quando o valor estiver vazio ou for diferente das opções disponíveis, o questionário será considerado como Saúde.
Estrutura das perguntas (questionsGroup)
Na coluna questionsGroup, utilize @ para separar as diferentes perguntas do questionário.
As informações de cada pergunta devem ser separadas por ;, seguindo esta ordem:
pergunta;opções;grupo;tipo de resposta;gênero;exibe detalhes;obrigatória;opção padrão
Cada pergunta pode possuir até 8 posições:
Posição | Campo | Obrigatório | Valores/Formato | Quando não informado |
1 | Pergunta | Sim | Texto | A pergunta é recusada |
2 | Opções | Não | Separadas por | Sem opções |
3 | Grupo | Não | Texto | Grupo Padrão |
4 | Tipo de resposta | Não |
| Com opções = Única; sem opções = Descritiva |
5 | Gênero | Não |
| Ambos |
6 | Exibe detalhes | Não |
|
|
7 | Obrigatória | Não |
|
|
8 | Opção padrão | Não | Texto correspondente a uma das opções | Sem opção padrão |
Importante: arquivos que utilizam o formato anterior, contendo apenas pergunta;opções, continuam sendo aceitos normalmente. Nesse caso, as perguntas sem grupo informado serão incluídas no Grupo Padrão.
Opções de resposta
Quando a pergunta possuir opções de resposta, utilize & para separá-las.
Por exemplo:
Sim&Não
Dentro da estrutura completa de uma pergunta:
Goza de boa saúde;Sim&Não;Saúde geral;0;2;true;true;Sim
Tipo de resposta
O tipo de resposta deve ser informado por meio do código correspondente:
Valor | Tipo |
| Única |
| Múltipla |
| Descritiva |
| Binária |
Quando o tipo não for informado:
perguntas com opções serão consideradas como Única;
perguntas sem opções serão consideradas como Descritiva.
Gênero
O gênero define para quais colaboradores a pergunta será apresentada:
Valor | Descrição |
| Masculino |
| Feminino |
| Ambos |
Quando não informado, será utilizado Ambos.
Agrupamento das perguntas
As perguntas podem ser organizadas em grupos por meio da terceira posição da estrutura de questionsGroup.
Perguntas que possuem o mesmo nome de grupo serão reunidas no mesmo grupo.
A ordem dos grupos será definida pela primeira vez em que cada grupo aparecer no arquivo. Dentro de cada grupo, as perguntas serão apresentadas na mesma ordem em que foram informadas.
Quando nenhum grupo for informado, a pergunta será incluída no Grupo Padrão.
Validações das perguntas
As configurações informadas no arquivo devem respeitar as mesmas regras disponíveis no cadastro de perguntas do Questionário.
São aplicadas as seguintes validações:
Descritiva: não permite opções de resposta, opção padrão ou Exibe detalhes habilitado;
Binária: não permite Exibe detalhes habilitado. Quando as opções forem informadas, devem ser Sim e Não. Caso não sejam preenchidas, o sistema adicionará automaticamente essas opções. A opção padrão, quando informada, deve ser Sim ou Não;
Única e Múltipla: devem possuir pelo menos uma opção de resposta;
Tipo de resposta e Gênero: devem utilizar um dos códigos disponíveis nas respectivas tabelas.
Quando houver informações inválidas, a importação apresentará uma mensagem identificando a pergunta e o motivo do erro.
Caso existam diferentes erros nas perguntas de um mesmo questionário, todos serão apresentados em conjunto para facilitar a correção do arquivo.
Exemplo de arquivo
description | questionsGroup | quizType
"Admissional" | "Goza de boa saúde;Sim&Não;Saúde geral;0;2;true;true;Sim@Está fazendo algum tratamento médico;Sim&Não;Saúde geral@Descreva sua rotina;;Hábitos;2@Assinou o termo?;;Hábitos;3;2;false;true;Sim" | "0"
Nesse exemplo, será criado o questionário Admissional, do tipo Saúde, contendo:
o grupo Saúde geral, com duas perguntas de resposta Única;
o grupo Hábitos, com uma pergunta Descritiva e uma pergunta Binária;
a pergunta Assinou o termo? será obrigatória e terá Sim como opção padrão.