avt_xapi_minimumskrav.md

xAPI Minimumskrav

Listen under spesifiserer minimumskrav for xAPI statements i AVT prosjektet.

• Man må ha med Required-elementene fra selve xAPI-spesifikasjonen (se her for mer info).

• xAPI datastruktur:

  • Id: Hver xAPI statement skal ha en unik statement ID. Basert på xAPI spesifikasjonen skal statement ID være en UUID i henhold til variant 2 av RFC 4122.

    Merk: Statement ID skal knytte (hendelses-)data fra leverandørdatabase til xAPI statement. Derfor må man bruke samme ID hvis man oppdaterer et gitt xAPI statement, eller hvis man sletter og deretter oppretter det samme xAPI statementet på nytt. Et eksempel kan være hvis man har et xAPI statement som har informasjon om fagkart_tag, men man siden ser at "tag-en" som er brukt er feil; da er det viktig at man fortsetter å bruke den samme statement ID-en også etter at man har oppdatert til riktig fagkart_tag. Et annet eksempel kan være et statement hvor man identifiserer at det har skjedd en feil, f.eks. at tjenesteleverandør (feide-clientinfo) mangler. Også her er det viktig å benytte samme statement ID både før og etter at man gjør nødvendige korrigeringer.

  • Actor: Må være en “Nye feide”- (aka Dataporten-) bruker. Tjenesten må altså være en dataporten tjeneste.

  • Verb:

    • Required: Answered. Dette blir vanligvis brukt om enkeltitems (enkeltoppgaver). For et læremiddel med sider (pages) kan man bruke verbet Completed, men i dette tilfellet vil vi være pragmatisk og bruke Answered også her.

  • Object:

    • Required: Id og definition (name, description og type). Det er viktig at at name og description er henholdsvis klart og beskrivende for det aktuelle objektet (f.eks. en enkeltitem eller page).

  • Result:

    • Required: Score (min, max, raw, scaled) og success.
    • Required extensions: Dersom man har informasjon om elevers bruk av hint og antall forsøk (attempts) på en oppgave er denne informasjonen også påkrevd informasjon. Informasjonen legges inn ved hjelp av extensions definert av AVT prosjektet:
      • https://w3id.org/xapi/avt/result-extensions/max-hints (maks antall hint - mulig for oppgave)
      • https://w3id.org/xapi/avt/result-extensions/hints-used (faktiske hint brukt for oppgave)
      • https://w3id.org/xapi/avt/result-extensions/attempts (antall oppgaveforsøk)
      • Se eksempler for mer informasjon om bruk av disse extensions.

  • Context:

    • Required: Skoleeier, skole og tjenesteleverandør (feide-clientinfo) i context.
    • Required: Hver xAPI statement må ha med informasjon om fagkart i context (tagget ved hjelp av verktøyet Fagkart).
    • Required: Hvert object som er en del av context gjennom contextActivities må ha med definition->name, og gjerne også definition->description.

AVT eksemplene viser hvordan minimumkravene kan overholdes i praksis.

For å sjekke at xAPI statements er strukturert i henhold til standarden kan man bruke en xAPI validator, for eksempel denne. NB! Slike validatorer tester i henhold til den generelle xAPI standarden, men tar ikke hensyn til ytterligere minimumskrav som er definert av AVT prosjektet.