Formato Moodle XML

De MoodleDocs


El formato XML Format es un formato específico de Moodle, para importar y exportar preguntas a emplear con el Módulo de examen. El formato ha sido desarrollado dentro de la comunidad de Moodle, pero puede ser soportado por otros programas en mayor o menor grado.

Unas palabras acerca de validez (y CDATA)

El revisor de XML asume que el archivo XML está bien formado y no detecta ni reporta errores. Si el archivo no está bien formado, Usted muy probablemente obtendrá errores inesperados. Si Usted está escribiendo a mano el archivo XML, se le recomienda encarecidamente que lo pase a traves de algún tipo de verificador XML antes de importarlo a Moodle. Una foma simple de hacer esto es abrir el archivo XML usando Firefox o Internet Explorer.

Tenga en cuenta particularmente que los fragmentos HTML incrustados deberían de estar dentro de secciones CDATA. Ejemplo CDATA:

<questiontext format="html">
      <text><![CDATA[
             Ahora yo puedo incluir cualquier HTML que yo
desee. Sin el CDATA, las marcas (tags) HTML romperían el XML!! ]]> </text> </questiontext>

Estructura general del archivo XML

El archivo está rodeado por marcas (tags) como sigue. Es importante asegurarse de que la marca xml solamente sea realmente la primera línea del archivo. Una primera línea vacía, o marcas adicionales en la primera línea, confundirán al revisor XML de Moodle.

<?xml version="1.0" ?> <quiz>

.
.
.

</quiz>

translator note icon.png Nota del traductor: La palabra inglesa quiz significa examen y la palabra question significa pregunta


Dentro de las marcas <quiz> hay varias marcas <question>. Una de estas marcas <question> puede ser una pregunta de mentiritas con un tipo de category para especificar una categoría para la importación/exportación.

<question type="category">

   <category>
       <text>$course$/XXXX</text>
   </category>

</question>

En donde XXXX es el nombre de la nueva categoría. Si la categoría existe, la(s) pregunta(s) será(n) añadida/s) al curso existente; de lo contrario, se creará una nueva categoría. esto solamente ffunciona si Usted tiene activado "Obtener actegoría a partir del archivo" seleccionado.

Pueden especificarse múltiples categorías en el mismo archivo. Simplemente añada otra pregunta de 'category' de mentiritas cada vez que Usted quiera establecer una nueva categoría y las preguntas que sigan se colocarán allí.

El archivo debe estar codificado en UTF-8

La importación y la exportación de Moodle XML están balanceadas en funcionalidad, por lo que si Usted necesita entender el formato, simplemente fabrique algunas preguntas y expórtelas para observar cómo se ven.

Marcas (Tags) comunes para todos los tipos de preguntas

Una pregunta se escribe como sigue:

<question type="multichoice|truefalse|shortanswer|matching|cloze|essay|numerical|description">

    <name>
        <text>Nombre de la pregunta</text>
    </name>
    <questiontext format="html">
        <text>¿Cual es la respuesta a esta pregunta?</text>
    </questiontext>
    .
    .
    .

</question>

"Format" selecciona los formatos de texto para el texto de la pregunta. Las opciones son html (valor por defecto), moodle_auto_format, plain_text y markdown. La elección afecta la manera en la cual se mostrará el texto.

Más marcas, las que usualmente incluyen al menos una marca <answer>, siguen en el espacio que está señalizado con puntos como nodos hijos a la marca <question>. Las marcas relacionadas con la respuesta están enlistadas más debajo en esta página. Varias marcas (¿opcionales?) son posibles:

  • penalty
  • generalfeedback
  • defaultgrade
  • hidden

La marca <image> contiene la URL de cualquier imagen incluida. Anidada adentro de la marca <image> podría estar una marca <image_base64> que contiene los datos actuales de la imagen codificados en base64.

Nota: Si Usted exporta preguntas desde un servidor Moodle 1.9, las preguntas podrían contener solamente la URL relativa hacia las imágenes alojadas en el servidor 1.9, mientras que las preguntas exportadas desde un servidor Moodle 2.x y 3.x contendrían la imagen en sí codificada en base 64. Esto explica el porqué algunas operaciones de importar-exportar preguntas del banco de preguntas incluyen a todas las imágenes mientras que otras no.


En los siguientes ejemplos de tipos de pregunta las partes comunes de la pregunta no son mostradas para mejorar la claridad. Es una buena idea el exportar Usted mismo algunos ejemplos para ver el ejemplo completo.

Opción múltiple

Las preguntas de Opción Múltiple tienen una marca <answer> para cada opción. Cada opción puede acarrear retroalimentación y ponderación del puntaje (al usar el atributo de fraction). Además, una pregunta de Opción Múltiple tiene las siguientes marcas (tags):

  • single (values: true/false)
  • shuffleanswers (values: 1/0)
  • correctfeedback
  • partiallycorrectfeedback
  • incorrectfeedback
  • answernumbering (valores permitidos: 'none', 'abc', 'ABCD' o '123')
translator note icon.png Nota del traductor: La palabra inglesa single significa única, la palabra shuffleanswers significa barajearrespuestas, la palabra correctfeedback significa retroalimentacióncorrecta, la palabra answernumbering significa numeraciónderesuesta


La marca <single> es usada para distinguir variantes de respuesta única (botón de selección) y respuesta múltiple (casilla de selección).

<question type="multichoice">

<answer fraction="100">
    <text>La respuesta correcta</text>
   <feedback><text>¡Correcto!</text></feedback>
</answer>
<answer fraction="0">
    <text>Un distractor</text>
   <feedback><text>¡Ooops!</text></feedback>
</answer>
<answer fraction="0">
    <text>Otro distractor</text>
   <feedback><text>¡Ooops!</text></feedback>
</answer>
<shuffleanswers>1</shuffleanswers>
<single>true</single>
<answernumbering>abc</answernumbering>

Falso/verdadero

Se dan dos marcas para respuesta, una es verdadera y la otra es falsa. El atributo fraction de la marca de respuesta identifica cual opción es la correcta (100) y cual es la falsa (0). Está soportada la retroalimentación. El ejemplo siguiente muestra el formato cuando la respuesta correcta es verdadera y la falsa es errónea.

<question type="truefalse">
<answer fraction="100">
   <text>verdadero</text>
   <feedback><text>¡Correcto!</text></feedback>
</answer>
<answer fraction="0">
   <text>falso</text>
   <feedback><text>¡Ooops!</text></feedback>
</answer>

Respuesta corta

El tipo de pregunta de respuesta corta soporta respuestas correctas alternas, cada una de ellas con su propia ponderación y retroalimentación. El formato Moodle XML usa solamente una marca <answer> para cada una de las respuestas correctas alternas.

La marca <usecase> alterna entre sensibilidad a MAYÚSCULAS/minúsculas con los valores de 1/0.

<question type="shortanswer">
<answer fraction="100">
    <text>La respuesta correcta</text>
    <feedback><text>¡Correcto!</text></feedback>
</answer>
<question type="shortanswer">
<answer fraction="100">
    <text>La respuesta correcta</text>
    <feedback><text>¡Correcto!</text></feedback>
</answer>
<answer fraction="100">
    <text>Una respuesta alterna</text>
    <feedback><text>¡Correcto!</text></feedback>
</answer>

Respuesta numérica

La siguiente es una versión simplificada del formato Moodle XML para respuestas numéricas:

<question type="numerical">
<answer fraction="100">
    <text>23</text>
    <feedback><text>Retroalimentación</text></feedback>
</answer>

Moodle también soporta una marca de <tolerance> (¿qué tan exacto debe ser el número?) y una o más marcas <unit> . Las marcas de unidad tienen nombres y multiplicadores.Esto es, si la respuesta correcta está en kilómetros, una respuesta adicional codría ser el equivalente en metros con unmultiplicador de 1000.

Nota: antes de Moodle 1.7.2 la fracción era expresada como un valor entre 0 y 1 en un elemento <fraction> y el valor de la respuesta no estaba rodeado por marcas <text>. El formato del tipo de pregunta numérica está deprecado pero todavía es importado correctamente si se encuentra (por ahora).

Relación de columnas (emparejamiento)

Las respuestas de relación de columnas (emparejamiento) usan la marca <shuffleanswers> para determinar si es que el orden de los ítems debería de alatorizarse (barajearse). Cada par está contenido adentro de una marca <subquestion>. El primer ítem de cada par está contenido con una marca <text>, mientras que el segundo tiene una marca <answer> a su alrededor también. No están soportadas la retroalimentación ni la ponderación del puntaje por Moodle para este tipo de respuesta.

<question type="matching">
<subquestion>
    <text>Este es el 1er ítem del 1er par.</text>
    <answer>
        <text>Este es el 2do ítem del 2do par.</text>
    </answer>
</subquestion>
<subquestion>
    <text>Este es el 1er ítem del 2do par.</text>
    <answer>
        <text>Este es el 2do ítem del 2do par.</text>
    </answer>
</subquestion>
<shuffleanswers>true</shuffleanswers>

Ensayo

Un ejemplo de una pregunta del tipo de ensayo...

 <question type="essay">
   <answer fraction="0">
       <text></text>
   </answer>
 </question>

En este caso no hay una respuesta ni tampoco hay una calificación.

Nota: antes de la versión 1.7.2 la fraction era expresada como un valor entre 0 y 1 en un elemento <fraction> y el valor de la respuesta no estaba incluido entre marcas <text>. Este formato del tipo de pregunta de ensayo está deprecado pero todavía será importado correctamente si se encuentra (por ahora).

Otros tipos de preguntas

Cloze (preguntas incrustadas)

Está soportado, y depende de un formato especial para la marca <questiontext>.

Tipo de respuesta descripción

Este tipo de respuesta no tiene más marcas que aquellas contenidas adentro del encabezado de la pregunta (como <questiontext>).

Relación de columnas (emparejamiento) aleatorias

Moodle tiene un tipo de pregunta que consiste en tomar preguntas de respuesta corta en el mismo examen y mostrarlas como un ejercicio de relaconar columnas. Sin embargo, Moodle no puede ni importar ni exportar este tipo de pregunta.

Formatos de texto

Los archivos Moodle XML deberían especificar explícitamente el formato del texto (html, moodle_auto_format, plain_text y markdown - estos corresponden a las constantes , FORMAT_HTML, FORMAT_MOODLE, etc usadas en el código de Moodle) para cada parte del contenido. Tenga en cuenta que, por defecto, el formato debería ser especificado en el padre del elemento <text>. Esto es ligeramente peculiar, pero es una herencia histórica.

Si el formato no es especificado en questiontext (el texto de la pregunta), entonces html es el valor por defecto. Si el formato no está especificado en ninguna otra parte de la pregunta, entonces el formato de questiontext es el valor por defecto.

(Este comportamientopor defecto cambió en Novembre del 2011. Antes de eso, el valor por defecto era moodle_auto_format cuando el formato no estaba especificado.)

Utilerías útiles

  • Cross XML format This input format plugin is a handy utility that converts question from one question type to another.
  • Online Moodle XML converter Convert from existing text files glossaries and quizzes to Moodle XML format. Also can convert from Moodle XMl to text.
  • MoodleXMLBuilder converts commonly-used test generator output into Moodle XML. MoodleXMLBuilder currently supports converting tests and question banks created in Blackboard, ExamView, TestGen, and EZTest. Images are fully supported within all question fields where images are allowed within the Moodle quiz module.
  • MoXMLE - A Java based application MoXMLE is a Java based application that converts a Simple TXT file into a Moodle XML format.
  • R script for converting spreadsheet quiz questions into Moodle XML - This is an R script to turn a spreadsheet with quiz questions into a Moodle XML file. I included an example spreadsheet. I wrote up a quick start guide, but I can only upload two files. Feel free to modify for personal use. If you make useful modifications, please share them with me. I have only written support for multichoice (single correct answer), shortanswer, or truefalse question types. I have only tested this with Moodle 3.7
  • XeradorXML es un generador de preguntas XML para Moodle. Permite la creación de un archivo XML importable por Moodle.
  • getmarked es una herramienta para exportar exámenes (de Google Frms hacia Moodle, por ejemplo). De acuerdo a this post "To move your Google Form quiz into Moodle, give getmarked permission to access your forms through OAuth, then you export it as a Moodle XML. If you want to move your Moodle question bank to Google Form, simply do the reverse by exporting your Moodle questions as Moodle XML, upload to getmarked and they can generate a Google Form from it.In addition, they can also import and export to QTI, Zoom, kahoot , quizizz and many other platforms too, it's really amazing!"


Vea también