Importação de Questões via XML

É possível realizar importação de questões no banco de questões de maneira fluida e simples, permitindo que várias questões sejam importadas em lote e facilitando o fluxo de criação de avaliações.

A importação de questões é realizada através de um modelo de arquivo XML em Repositório > Avaliações > Banco de questões

Importante

É necessário requisitar ao suporte a ativação desta funcionalidade para poder realizar a importação de questões na plataforma.

Criar Arquivo XML

A importação de questões é feita por um arquivo XML contendo as questões já pré-definidas. Caso necessário, um exemplo de arquivo XML com questões prontas pode ser baixado aqui.

Para criar um arquivo XML, é possível utilizar um editor de texto simples, como o Bloco de Notas ou o Notepad++. O arquivo deve seguir uma estrutura específica para que o sistema reconheça corretamente as questões.

Exemplo de arquivo

A criação de questões pode ser feita ao copiar e colar todo o trecho do início ao fim da questão, editando de acordo com a necessidade.

Boas práticas

  • Utilize <![CDATA[…]]> para evitar erros com caracteres especiais ou HTML;
  • Revise a estrutura antes de importar (tags abertas e fechadas corretamente);
  • Mantenha a codificação UTF-8 para evitar problemas com acentuação;
  • Teste o arquivo com poucas questões antes de importar em grande volume.

<?xml version="1.0" encoding="UTF-8"?>

<quiz>

<!-- Question entry 1 (Múltipla escolha) -->

<question type="multichoice">

<name>

<text>

<![CDATA[Santa Catarina pertence a qual região?]]>

</text>

</name>

<questiontext format="html">

<text>

<![CDATA[<strong>Santa Catarina</strong> pertence a qual região?]]>

</text>

</questiontext>

<generalfeedback format="html">

<text>

<![CDATA[Este comentário é visto por todos os alunos, independentemente de terem acertado ou não.]]>

</text>

</generalfeedback>

<correctfeedback format="html">

<text>

<![CDATA[Muito bem! Santa Catarina é um estado da região sul.]]>

</text>

</correctfeedback>

<incorrectfeedback format="html">

<text>

<![CDATA[Resposta incorreta. Lembre-se de revisar o mapa das regiões do Brasil.]]>

</text>

</incorrectfeedback>

<answer fraction="0">

<text>

<![CDATA[Nordeste]]>

</text>

</answer>

<answer fraction="0">

<text>

<![CDATA[Sudeste]]>

</text>

</answer>

<answer fraction="100.000">

<text>

<![CDATA[Sul]]>

</text>

</answer>

<answer fraction="0">

<text>

<![CDATA[Norte]]>

</text>

</answer>

<shuffleanswers>0</shuffleanswers>

<single>true</single>

<answernumbering>abc</answernumbering>

</question>

<!-- Question entry 2 (Verdadeiro/Falso) -->

<question type="truefalse">

<name>

<text>

<![CDATA[O Brasil faz parte do Mercosul, essa afirmação é verdadeira ou falsa?]]>

</text>

</name>

<questiontext format="html">

<text>

<![CDATA[O Brasil faz parte do Mercosul, essa afirmação é verdadeira ou falsa?]]>

</text>

</questiontext>

<generalfeedback format="html">

<text>

<![CDATA[Este comentário é visto por todos os alunos, independentemente de terem acertado ou não.]]>

</text>

</generalfeedback>

<correctfeedback format="html">

<text>

<![CDATA[Muito bem! Santa Catarina é um estado da região sul.]]>

</text>

</correctfeedback>

<incorrectfeedback format="html">

<text>

<![CDATA[Resposta incorreta. Lembre-se de revisar o mapa das regiões do Brasil.]]>

</text>

</incorrectfeedback>

<answer fraction="100">

<text>

<![CDATA[true]]>

</text>

</answer>

<answer fraction="0">

<text>

<![CDATA[false]]>

</text>

</answer>

</question>

<!-- Question entry 3 (Associação) -->

<question type="matching">

<name>

<text>

<![CDATA[Associe cada número ordinal a seu respectivo cardinal:]]>

</text>

</name>

<questiontext format="html">

<text>

<![CDATA[Associe cada número ordinal a seu respectivo cardinal:]]>

</text>

</questiontext>

<generalfeedback format="html">

<text>

<![CDATA[Este comentário é visto por todos os alunos, independentemente de terem acertado ou não.]]>

</text>

</generalfeedback>

<correctfeedback format="html">

<text>

<![CDATA[Muito bem! Santa Catarina é um estado da região sul.]]>

</text>

</correctfeedback>

<incorrectfeedback format="html">

<text>

<![CDATA[Resposta incorreta. Lembre-se de revisar o mapa das regiões do Brasil.]]>

</text>

</incorrectfeedback>

<subquestion>

<text>Um</text>

<answer>

<text>Primeiro</text>

</answer>

</subquestion>

<subquestion>

<text>Dois</text>

<answer>

<text>Segundo</text>

</answer>

</subquestion>

<subquestion>

<text>Três</text>

<answer>

<text>Terceiro</text>

</answer>

</subquestion>

<subquestion>

<text>Quatro</text>

<answer>

<text>Quarto</text>

</answer>

</subquestion>

</question>

<!-- Question entry 4 (Múltipla escolha com múltiplas respostas corretas) -->

<question type="multichoice">

<name>

<text>

<![CDATA[Assinale as alternativas verdadeiras. Qual estado mais ao sul do Brasil e qual sua capital:]]>

</text>

</name>

<questiontext format="html">

<text>

<![CDATA[Assinale as alternativas verdadeiras. Qual estado mais ao sul do Brasil e qual sua capital:]]>

</text>

</questiontext>

<generalfeedback format="html">

<text>

<![CDATA[Este comentário é visto por todos os alunos, independentemente de terem acertado ou não.]]>

</text>

</generalfeedback>

<correctfeedback format="html">

<text>

<![CDATA[Muito bem! Santa Catarina é um estado da região sul.]]>

</text>

</correctfeedback>

<incorrectfeedback format="html">

<text>

<![CDATA[Resposta incorreta. Lembre-se de revisar o mapa das regiões do Brasil.]]>

</text>

</incorrectfeedback>

<answer fraction="50.000">

<text>

<![CDATA[Rio Grande do Sul]]>

</text>

</answer>

<answer fraction="0">

<text>

<![CDATA[Florianópolis]]>

</text>

</answer>

<answer fraction="50.000">

<text>

<![CDATA[Porto Alegre]]>

</text>

</answer>

<answer fraction="0">

<text>

<![CDATA[Santa Catarina]]>

</text>

</answer>

<shuffleanswers>0</shuffleanswers>

<single>false</single>

<answernumbering>abc</answernumbering>

</question>

</quiz>

  • Início e fim da questão (azul)

    Observação

    O tipo da questão está incluído no início dela, e é necessário removê-lo da versão final do código.

  • Enunciado da questão (laranja escuro)

  • Texto do feedback (verde-musgo)

  • Início e fim de alternativa (vermelho)

  • Nota da alternativa (verde)

    Importante

    Apenas a alternativa correta recebe o valor 100.000, as demais devem receber 0.

  • Texto da alternativa (roxo/rosa)

Uma vez pronto o arquivo XML, basta realizar a importação do arquivo em Repositório > Avaliações > Banco de Questões.

Importar arquivo XML

A importação de questões só pode ser feita para categorias criadas no banco de questões. Então, antes de importar uma nova leva de questões, adicione uma nova categoria clicando na opção + Categoria e definindo-a de acordo com a necessidade e assunto das questões.

Nova Categoria

Feito isso, localize a categoria criada e clique no botão Importar questão.

Importar Questões

Ao clicar nessa opção, um modal para realizar o upload do arquivo será apresentado e basta concluir a importação como indicado para finalizar a importação de questões.

Este artigo ajudou você?