WWM:Wikiwijs arrangement importeren

Uit Kennisnet Developers Documentatie
Naar navigatie springen Naar zoeken springen

Wikiwijs Maken-symbol.png Wikiwijs Maken: Wikiwijs arrangement importeren

Wat kun je met een arrangement in eigen systeem doen?

Een Wikiwijs arrangement kan geëxporteerd worden in de vorm van een bestand dat ingelezen kan worden in een elektronische leeromgeving (vaak afgekort als ELO). Hiervoor maken we gebruik van het open standaard format IMS Content Package. Hiermee is het mogelijk dat het leermateriaal in de ELO afgespeeld kan worden. Dit biedt vervolgens de volgende mogelijkheden:

  • De look-and-feel van de ELO blijft behouden
  • De ELO kan de voortgang van de leerling in het materiaal volgen
  • De resultaten van toetsen kunnen in de ELO worden opgeslagen
  • Met deze resultaten kunnen learning analytics worden uitgevoerd
  • In de ELO kunnen opdrachten worden ingeleverd en kan de docent makkelijker nakijken

Deze wiki pagina legt uit hoe het exportbestand (een IMS Content Package) technisch in elkaar steekt


Hoe download je IMS Content Package van arrangement?

De URL van de IMS Content Package halen van een Wikiwijs Arrangement kan je uit een LOM record uit Edurep halen. Een voorbeeld van de verwijzing naar een IMS Content Package in een LOM record is te zien in deze snippet uit een LOM record:

<czp:relation>
  <czp:kind>
    <czp:source>
      <czp:langstring xml:lang="x-none">
        http://purl.edustandaard.nl/relation_kind_nllom_20131211
      </czp:langstring>
    </czp:source>
    <czp:value>
      <czp:langstring xml:lang="x-none">
        hasformat
      </czp:langstring>
    </czp:value>
  </czp:kind>
  <czp:resource>
    <czp:description>
      <czp:langstring xml:lang="x-none">
        application/x-imscp+zip
      </czp:langstring>
    </czp:description>
  <czp:catalogentry>
    <czp:catalog>
      URI
    </czp:catalog>
    <czp:entry>
      <czp:langstring xml:lang="x-none">
        http://arrangeren.wikiwijs.nl/45035/Geloven___Hindoe_sme___kastenstelsel?p=imscp
      </czp:langstring>
    </czp:entry>
  </czp:catalogentry>
 </czp:resource>
</czp:relation>

In dit voorbeeld is de locatie van het IMS Content Package:

http://arrangeren.wikiwijs.nl/45035/Geloven___Hindoe_sme___kastenstelsel?p=imscp

Dit triggert een download van een IMS Content Package van het betreffende arrangement. Deze downloads worden gecachet, als er geen versie in de cache beschikbaar is word er een nieuwe versie door Wikiwijs Maken gegenereerd. Dit wordt ook gedaan als er wijzigingen zijn gemaakt in het arrangement sinds de datum van het cache bestand. In dit geval duurt het downloaden iets langer.


Hoe steekt een IMS Content Package in elkaar?

Een IMS Content Package is een open standaard formaat voor het uitleveren van lesmateriaal. Het gebruiken van een open standaard is handig omdat hiermee verschillen partijen, onafhankelijk van elkaar, gebruik kunnen maken van dezelfde, publiek beschikbare, specificatie. Meer achtergrond informatie over IMSCP is te vinden in het informatieblad van Edustandaard over het verpakken van leermateriaal.

Wikiwijs volgt het advies van Edustandaard over welke versie van IMS Content packaging toe te passen. Dit betreft dus IMS CP versie: 1.1.4 - Final Specification.

Structuur

Structuur Wikiwijs Maken IMSCP export

Een IMS Content Package is in feite een Zip bestand dat folders en losse bestanden zoals html, plaatjes, pdf en andere documenten bevat. Daarnaast bevat het altijd een manifest (imsmanifest.xml), deze 'vrachtbrief' bevat Informatie over de structuur van het lesmateriaal. Dit xml bestand bevat de volgende blokken:

<metadata>

Indien de auteur van het Wikiwijs arrangement metadata heeft toegevoegd aan het materiaal komt hier een samenvatting van alle metadata in te staan. Het betreft dan het leerniveau waar het materiaal van toepassing is, de begrippen waarmee de vakinhouden worden aangegeven die van toepassing zijn op het materiaal. De velden in de metadata komen vervolgens uit het NL LOM schema

Voor details over de metadata kijk verder in de sectie over Metadata en over het Onderwijsbegrippenkader. Hierin wordt met name de begrippen uit het Onderwijsbegrippenkader uitgelegd. Deze zijn in de metadata te herkennen aan de UUID's zoals bijvoorbeeld:

b924d4ad-65a1-41dc-b704-c7786eb4aec0

Deze UUID staat overigens voor het begrip "VWO, 3", een leerniveau.


<organizations>

Dit stuk van de xml bevat de inhoudsopgave van het lesmateriaal, de zogenaamde Table of Contents (TOC). De titels van elk kopje van een arrangement komt hierin terug. Overigens kent een Wikiwijs Arrangement maar twee niveaus (koppen met subkoppen). Als de auteur fijnmazige metadata heeft toegevoegd dan wordt er per kopje een blok metadata meegeleverd over het betreffende onderdeel van het arrangement.


<resources>

Dit blok van de xml vormt een index van alle gebruikte bestanden. Hier is de koppeling te vinden tussen de items die in de inhoudsopgave in het blok <organizations> genoemd worden. Deze items, ofwel content blokken, zijn in de folder "files" te vinden als html bestanden. Dit betreft dan de html van de betreffende hoofdstukken. Deze html pagina's kunnen vervolgens zowel links bevatten naar content dat in het pakket zit en links die naar externe content gaan.


Folder: "Files"

Het zip bestand bevat altijd een folder, genaamd "Files" waarin de html bestanden zitten voor elk hoofstuk. Alle bestanden die auteurs in het arrangement hebben geüpload worden hier ook in geplaatst. Dit zijn natuurlijk plaatjes, maar ook documenten (Word, PDF) of multimedia bestanden (filmpjes of audio). Mocht een arrangement een toets of oefening bevatten die in Wikiwijs Maken is gemaakt, dan wordt deze toegevoegd als QTI bestand (zip). Zie de sectie QTI over details over dit format.


Let op!

De HTML van het materiaal bevat geen stylesheets of iets dergelijks. De bedoeling van deze exports is dat het in elk systeem kan draaien en dat deze systemen de mogelijkheid hebben om het met eigen styling aan te passen. Wel bevat de HTML natuurlijk plaatjes, embeds, bold, italic, etc.