Visión general del formato

A continuación se proporciona una guía simple de la estructura básica de un archivo de datos típico de IMS Enterprise. Puede ver mucha más información en IMS Enterprise official website.

Quizás le interese leer el sumario de conformidad, que describe los elementos de datos IMS que este 'plugin' puede procesar.

Guía básica del formato de archivo IMS Enterprise

Para realizar cualquier matriculación IMS usted necesita una marca <group> que especifica el curso, una marca <person> que especifica la cuenta de usuario, y una marca <membership> que contiene marcas <member>, las cuales especifican el rol de una persona dentro de un curso dado.

Recuerde que las claves numéricas usadas en las bases de datos de Moodle no son datos interoperables -un sistema de datos de estudiantes nunca va a saber con antelación que Joe es el usuario número 20 agregado a la base de datos de Moodle-, de modo que las mencionadas no son las claves intercambiadas en este tipo de datos.

Normalmente un curso debería tener un código de referencia, así como un nombre, de manera que supongamos que su código es MOODLE101. Para definir el curso usted podría usar

  <group>
    <sourcedid>
      <source>MyDataSystem</source>
      <id>MOODLE101</id>
    </sourcedid>
    <description>
      <short>Moodle 101</short>
    </description>
  </group>

El script de matriculación buscará un curso con el código MOODLE101, y (opcionalmente) crearlo en caso de que no exista. Lo mismo hará con la persona - supongamos que es "jmoodle":

  <person>
    <sourcedid>
      <source>MyDataSystem</source>
      <id>jmoodle</id>
    </sourcedid>
    <userid>jmoodle</userid>
    <name>
      <fn>Joe Moodle</fn>
      <n>
        <family>MOODLE</family>
        <given>JOE</given>
      </n>
    </name>
  </person>

Si Joe aún no dispone de una cuenta, el script puede (opcionalmente) crearla para él.

Veamos ahora la pertenencia, agregando la persona al curso:

  <membership>
    <sourcedid>
      <source>MyDataSystem</source>
      <id>MOODLE101</id>
    </sourcedid>
    <member>
      <sourcedid>
        <source>MyDataSystem</source>
        <id>jmoodle</id>
      </sourcedid>
      <role roletype="01">
        <status>1</status>
        <extension><cohort>unit 2</cohort></extension>
      </role>
    </member>
  </membership>

La especificación IMS Enterprise ofrece una facultad de especificar las fechas de inicio y final de las matriculaciones, de modo que pueden incluirse usando la marca <timeframe> si fuera necesario.

Si una persona ya está agregada a un grupo dentro del curso, el script no la modificará. En caso contrario, se aplicará el agrupamiento especificado.