Format overzicht

Hieronder is een eenvoudige gids voor de structuur van een typisch IMS Enterprise databestand. Veel meer informatie kun je vinden op de IMS Enterprise official website.

Lees de conformance summary die beschrijft welke IMS data-elementen je met deze plugin kan verwerken.

Basisgids voor het IMS Enterprise bestandsformaat

Voor alle IMS aanmeldingen heb je een <group> tag die de cursus bepaalt, een <person> tag die de gebruikersaccount specifieert, en een <membership> tag die <member> tags bevat. Die specifiëren welke rol iemand heeft binnen een cursus.

Denk er aan dat de numerieke sleutelwaarden die gebruikt worden in de Moodle databank, niet als werkbare gegevens kunnen gebruikt worden - een leerlingengegevenssyseem gaat nooit op voorhand weten dat Jan de 20ste gebruiker is die aan de Moodledatabank is toegevoegd - dus die sleutels worden niet uitgewisseld.

Om een cursus te definiëren moet die zowel een referentiecode als een naam hebben, laat ons er vanuitgaan dat de code MOODLE101 is. Om je cursus te definiëren, kun je het volgende gebruiken

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

Het aanmeldingsscript zal zoeken naar een cursus met code MOODLE101, en (optionneel) de cursus aanmaken als die niet bestaat. Hetzelfde geldt voor gebruikers - laat ons uitgaan van een gebruiker "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>

Als Joe nog geen account heeft, kan het script(optionneel) een nieuwe account voor hem aanmaken.

We zorgen nu voor het lidmaatschap door de gebruiker aan de cursus toe te voegen:

  <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>

De IMS Enterprise specificatie geeft ook de mogelijkheid om start/eind datums voor aanmeldingen mee te geven, zodat deze in de <timeframe> tag gezet kunnen worden als nodig.

Als iemand al in een groep in de cursus zit, dan zal het script dat niet wijzigen. Als de leerlingen niet gegroepeerd zijn, dan wordt de ingestelde groepering toegepast.