WWM: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 overzicht van de metadata in te staan die het gehele Wikiwijs Maken arrangement betreft. Denk hierbij aan informatie over in welke educatieve context het materiaal te gebruiken is, zoals: het leerniveau, het vak, onderwerp, leerdoel, etc.

De gebruikte velden en waarden in de metadata komen uit het NL LOM schema, daarin zijn de meest interessante begrippen te vinden in veld 9 (Classification) waar Wikiwijs Maken gebruik maakt van het Onderwijsbegrippenkader (afgekort tot OBK). Om specifiek te zijn maakt Wikiwijs Maken gebruik van de Kennisnetset versie van het OBK. Deze begrippen zijn in de metadata te herkennen aan de Universally Unique Identifier (UUID's) die je in als waarden tegenkomt in de metadata 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 (secties met subsecties). Als de auteur fijnmazige metadata heeft toegevoegd dan wordt er per (sub)sectie 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 hoofdstuk. 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.

HTML content

Geen stylesheets

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.

Meting van gebruik

Sinds half oktober 2014 worden in de HTML van de IMS Content Package teller geleverd. Hiermee kan Wikiwijs het gebruik van het lesmateriaal mee meten. Het gebruik wordt gemeten om de volgende redenen:

• Wikiwijs Maken wordt ontwikkeld door Stichting Kennisnet met behulp van publieke middelen. De besteding hiervan moet verantwoord worden. Het gebruik van het open Wikiwijs lesmateriaal in de ELO moet hiervoor dus gemeten worden om de investering te kunnen verantwoorden.
• We willen graag het gebruik van het lesmateriaal, in de vorm van bezoekcijfers, teruggeven aan de auteurs van het lesmateriaal. Zo zien ze wat werkt (omdat het populair is) of wat niet werkt. Hierdoor motiveren we de auteurs om meer materiaal te ontwikkelen en om de kwaliteit ervan op peil te houden.

De implementatie van de teller in de HTML bestaan uit een JavaScript. Deze ziet er als volgt uit:

<script type="text/javascript">
//<![CDATA[
var _paq = _paq || [];(function(){ var u=(("https:" == document.location.protocol) ?
"https://stats.kennisnet.nl/" : "http://stats.kennisnet.nl//");_paq.push(['setSiteId',
8]);_paq.push(['setTrackerUrl', u+'piwik.php']);_paq.push(['setCustomUrl',
'http://maken.wikiwijs.nl/imscp/49900/784742']);_paq.push(['setDocumentTitle',
'imscp/49900/784742']);_paq.push(['setReferrerUrl', document.location.protocol + '//' +
document.location.host]);_paq.push(['enableLinkTracking']);_paq.push(['trackPageView']);var d=document,
g=d.createElement('script'), s=d.getElementsByTagName('script')[0]; g.type='text/javascript'; g.defer=true;
g.async=true; g.src=u+'piwik.js';s.parentNode.insertBefore(g,s); })();
//]]>
</script><noscript>

Met deze teller wordt het gebruik bepaald aan de hand van het ID van het betreffende arrangement en het ID van de sectie uit het arrangment. Hiermee kunnen we aan de kant van Wikiwijs Maken bepalen welke arrangementen bezocht worden in ELO's en welke stukken uit het arrangement. Deze feedback is met name interessant voor de auteurs.