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>

Nota: Pendiente de Traducir. ¡Anímese a traducir esta página!.     ( y otras páginas pendientes)

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 (casila 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 conlos 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> . Unit tags have names and multipliers. E.g. if the main answer is in kilometres, an additional answer could be the equivalent in metres with a multiplier of 1000.

Note: prior to 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 ppor 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 has a question type which consists of taking short answer questions in the same quiz and displaying them as a pair matching exercise. Sin embargo, Moodle no puede ni importar ni exportar este tipo de pregunta.

Formatos de texto

Moodle XML files should explicity specify the text format (html, moodle_auto_format, plain_text and markdown - these correspond to the constants , FORMAT_HTML, FORMAT_MOODLE, etc used in the Moodle code) for each piece of content. Note that, by default, the format should be specified on the parent of the <text> element. This is slightly odd, but a remnant of history.

If the format is not specified for the questiontext, then html is the default. If the format is not specified on any other part of the question, then the format of the questiontext is the default.

(This default changed around November 2011. Before that, the default was moodle_auto_format whenever the format was not specified.)

Utilerías útiles

  • Online Moodle XML converter Convert from existing text files glossaries and quizzes to Moodle XML format. Also can convert from Moodle XMl to text.
  • Word Template for generating Moodle XML.
  • 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.

Vea también