WWM:Wikiwijs arrangement importeren

Uit Kennisnet Developers Documentatie
Ga naar: navigatie, zoeken

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:

  • Lesmateriaal presenteren in de look-and-feel van de ELO
  • 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?

Handmatig

Het is mogelijk handmatig een arrangement te exporteren vanuit de presentatie van een arrangement in Wikiwijs Maken. Gebruik hiervoor de knop "Downloaden / aanpassen" onderaan het navigatie menu links:

Handmatige export opties Wikiwijs Maken arrangement

Automatisch

Dit doe je door eerst de URL van de IMS Content Package te halen uit een LOM record van een Wikiwijs Arrangement. 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://maken.wikiwijs.nl/51292/05_H5_Aantrekking_tussen_moleculen?p=imscp
      </czp:langstring>
    </czp:entry>
  </czp:catalogentry>
 </czp:resource>
</czp:relation>

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

http://maken.wikiwijs.nl/51292/05_H5_Aantrekking_tussen_moleculen?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. Wikiwijs volgt het advies van Edustandaard over welke versie van IMS Content packaging toe te passen. Meer achtergrondinformatie over IMSCP is te vinden via de Standaarden Wiki pagina.

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 detail metadata, dus de aparte metadata behorende bij (sub)secties, mits deze door de auteur van arrangement is aangeleverd, is te vinden onder <organisations>. De detail metadata die is ingevuld bij de oefeningen/toetsen is te vinden in de QTI bestanden die worden meegeleverd in een IMS Content Package.

Meer uitleg over de diverse velden en waarden die je in de metadata kan vinden je in de wiki pagina over het inzien van metadata.

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

De HTML bestanden uit de IMS Content Packages bevatten tellers zodat Wikiwijs het gebruik van het lesmateriaal kan 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 dient gemeten te 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 arrangement nummer van het betreffende arrangement en het ID van de sectie uit het arrangement. 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.