WWM:Wikiwijs arrangement importeren: verschil tussen versies

Uit Kennisnet Developers Documentatie
Ga naar: navigatie, zoeken
k (add cat)
(Hoe download je IMS Content Package van arrangement?: nieuw export formaat)
 
Regel 61: Regel 61:
  
 
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.
 
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.
 +
 +
=== nieuw export formaat ===
 +
De huidige IMSCP export heeft twee complicaties.
 +
# In de nieuwe stercollecties 2.0 is de content in veel kleinere arrangementen verdeeld. Het hoofdarrangement (en dus de bijbehorende IMSCP) bevat alleen links naar de onderliggende content op de Wikiwijs Maken servers.
 +
# Er zijn diverse aspecten van het pakketje die problemen opleveren bij het inlezen omdat er afwijkingen zijn met de IMS-QTI standaard zoals deze door de inlezende applicaties is vastgesteld. Deze interpretaties van de standaard zijn niet altijd even duidelijk, en per aansluitende partij komen we verschillende uitdagingen tegen.
 +
 +
Omdat er diverse partijen zijn die de huidige IMSCP gewoon gebruiken en we deze niet willen verrassen met aanpassingen in de opbouw en inhoud van de pakketjes hebben we besloten om een tweede generaties pakketjes te ontwikkelen. We zijn nu met een beperkte groep partijen aan het testen of deze nieuwe generatie voldoet aan hun inhoudelijke en technische eisen.
 +
 +
We hebben besloten om tot het 1e kwartaal van 2020 deze pakketjes in een test versie beschikbaar te maken, en nodigen de diverse afnemende partijen uit om met dit format te experimenteren. We hebben ons voorlopig gericht op het converteren van de Stercollecties van VO-content en daarvan is momenteel 90% beschikbaar op een test platform.
 +
 +
Bent u geïnteresseerd in het testen van dit nieuwe export format vragen wij u om contact op te nemen met info@wikiwijs.nl met dit verzoek. U ontvangt dan van ons een mail met instructies.
 +
 +
{{Info|We adviseren om deze test versie alleen te gebruiken in test situaties. Alhoewel we trachten om updates door te voeren als er wijzigingen in de content zijn kunnen we niet garanderen dat de exports altijd "up-to-date" zijn, of dat alle stercollecties beschikbaar zijn gemaakt.}}
  
 
==Hoe steekt een IMS Content Package in elkaar?==
 
==Hoe steekt een IMS Content Package in elkaar?==

Huidige versie van 11 sep 2019 om 07:45

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.

nieuw export formaat

De huidige IMSCP export heeft twee complicaties.

  1. In de nieuwe stercollecties 2.0 is de content in veel kleinere arrangementen verdeeld. Het hoofdarrangement (en dus de bijbehorende IMSCP) bevat alleen links naar de onderliggende content op de Wikiwijs Maken servers.
  2. Er zijn diverse aspecten van het pakketje die problemen opleveren bij het inlezen omdat er afwijkingen zijn met de IMS-QTI standaard zoals deze door de inlezende applicaties is vastgesteld. Deze interpretaties van de standaard zijn niet altijd even duidelijk, en per aansluitende partij komen we verschillende uitdagingen tegen.

Omdat er diverse partijen zijn die de huidige IMSCP gewoon gebruiken en we deze niet willen verrassen met aanpassingen in de opbouw en inhoud van de pakketjes hebben we besloten om een tweede generaties pakketjes te ontwikkelen. We zijn nu met een beperkte groep partijen aan het testen of deze nieuwe generatie voldoet aan hun inhoudelijke en technische eisen.

We hebben besloten om tot het 1e kwartaal van 2020 deze pakketjes in een test versie beschikbaar te maken, en nodigen de diverse afnemende partijen uit om met dit format te experimenteren. We hebben ons voorlopig gericht op het converteren van de Stercollecties van VO-content en daarvan is momenteel 90% beschikbaar op een test platform.

Bent u geïnteresseerd in het testen van dit nieuwe export format vragen wij u om contact op te nemen met info@wikiwijs.nl met dit verzoek. U ontvangt dan van ons een mail met instructies.

Info.gif We adviseren om deze test versie alleen te gebruiken in test situaties. Alhoewel we trachten om updates door te voeren als er wijzigingen in de content zijn kunnen we niet garanderen dat de exports altijd "up-to-date" zijn, of dat alle stercollecties beschikbaar zijn gemaakt.

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.