xAPI in Learning Manager

Zoeken

Laatst bijgewerkt op 24 jan. 2024

Wat is xAPI?

De Experience API (xAPI) is een e-learning softwarespecificatie die systemen voor leerinhoud en leersystemen met elkaar laat communiceren zodat alle leerervaringen worden vastgelegd en bijgehouden. Leerervaringen worden vastgelegd in een LRS (Learning Record Store). LRS's kunnen zich binnen traditionele Learning Management Systems (LMS's) bevinden of op zichzelf staan.

Zie voor meer informatie over xAPI: https://github.com/adlnet/xAPI-Spec.

Hoe ondersteunt Learning Manager xAPI?

Learning Manager heeft een ingebouwde Learning Record Store. Deze LRS heeft de volledige capaciteit om xAPI-statements te accepteren van content die binnen Learning Manager wordt gehost. Het accepteert zelfs xAPI-statements die door derden worden gegenereerd. Deze xAPI-statement worden binnen Learning Manager opgeslagen en kunnen vervolgens buiten Learning Manager worden geexporteerd voor visualisatie in een extern datawarehousingsysteem.

Wanneer gebruikt u xAPI?

Er is een groeiende behoefte om de leerervaringen van de eindgebruiker, die over meerdere systemen verspreid zijn, vast te leggen. Ook wil men de exacte betrokkenheid van de student bij de trainingsinhoud volgen. Het gaat verder dan Start, In voortgang en Voltooiing (de enige attributen die door SCORM worden vastgelegd).

xAPI in Learning Manager gebruiken

Uw toepassing instellen

Meld u aan als integratiebeheerder. Selecteer Toepassingen > Registreren.

Appregistratie
Registreer een nieuwe toepassing.

Toepassing maken
Bepaal het bereik van de toepassing.
- Als xAPI lees- en schrijftoegang voor de beheerdersrol is ingeschakeld, kan de beheerder xAPI-statements en -documenten plaatsen en ophalen.
- Als xAPI lees- en schrijftoegang voor de studentrol is ingeschakeld, kan de beheerder xAPI-statements en -documenten plaatsen en ophalen.
Wijzigingen opslaan. U krijgt uw ontwikkelaars-ID en -geheim.

Eindpunten :

Klik op de onderstaande link om het xAPI-document (Swagger) te bekijken:

https://learningmanagereu.adobe.com/docs/learningmanagerapi/xapi/

Opmerking: xAPI-versie die wordt ondersteund in Learning Manager is 1.0.3.

API-verificatie

Learning Manager xAPI gebruikt OAuth 2.0 framework om uw cliëntapplicaties te verifiëren en autoriseren. Nadat u uw aanvraag hebt geregistreerd, kunt u de clientId en het clientSecret ophalen. De URL wordt opgevraagd in bij het verifiëren van de Learning Manager-gebruikers die hun vooraf geconfigureerde accounts gebruiken zoals SSO en Adobe ID.

KRIJG https://learningmanager.adobe.com/oauth/o/authorize?client_id=<Enter your clientId>&redirect_uri=<Enter a url to redirect to>&state=<Any String data>&scope=<admin:xapi or learner:xapi>&response_type=CODE.

xAPI-statements bijhouden als LO van Learning Manager

Als auteur kunt u nu de xAPI-module kiezen terwijl u cursussen maakt om de gebruikerservaring buiten Learning Manager te volgen. U kunt deze functie bijvoorbeeld gebruiken om de activiteiten te evalueren van gebruikers op een extern platform dat wordt gebruikt om cursussen te volgen.

Gebruik het pop-upmenu om xAPI-module te selecteren bij de optie Type tijdens het maken van de module Activiteit.

x-API-module maken
U wordt gevraagd een IRI op te geven. Indien niet beschikbaar, genereert Leermanager er automatisch een.
Opmerking:
De IRI voor een activiteit is uniek voor een account. Dat houdt in dat twee modules in Learning Manager niet dezelfde IRI kunnen hebben. In de volgende gevallen wordt een nieuwe IRI gegenereerd:

Wanneer een cursus met xAPI- module wordt gedeeld tussen accounts.

Wanneer een certificering met xAPI-module terugkeert
Elk xAPI-statement met de genoemde IRI wordt gevolgd in de bovenstaande module en weerspiegeld in de Learning Manager-rapporten.
Ga terug naar de pagina Activiteitenmodule om de automatisch gegenereerde IRI opnieuw te bezoeken.
Publiceer de module.

Aandachtspunten:

Leerbeheer ondersteunt momenteel alleen mbox als id. Andere ID's, zoals mboz_sha1, openid, account, worden niet ondersteund.
De stateId en profielId zijn een UUID wanneer ze met Learning Manager worden gebruikt.
PUT-aanvraag overschrijft het document voor xAPI's agenten/profiel, activiteit/profiel en activiteit/status niet
Niet-geïdentificeerde groep wordt niet ondersteund in Actor.
De parameter 'related_activities' wordt niet ondersteund in GET-statement
De parameters 'format=ids' en 'format=canonical' worden niet ondersteund in GET-statements.
Ongeldig maken van xAPI-statement maakt geen acties ongedaan die zich in Learning Manager voordeden toen de statement werd geplaatst.

Rapporten genereren

xAPI- rapporten kunnen als Excel-rapporten worden gegenereerd. Open Rapporten > Excel-rapporten > xAPI-activiteitsrapport als beheerder.

Het gedownloade rapport haalt alle informatie op die door de student en beheerder voor elke statement is geplaatst.

Dezelfde rapporten kunnen worden gegenereerd / gepland met behulp van FTP- en Box-connectors voor elke externe integratie. Volg deze stappen:

Log in als Integratiebeheerder > Open FTP/Box-connector > Selecteer xAPI-activiteitsrapport in het linkerdeelvenster > Kies om een rapport te plannen/te genereren.

Opmerking:

Wanneer alleen de onbewerkte score wordt verzonden in een xAPI-instructie zonder maximale score, wordt de quizscore niet weergegeven in LT.
Om de percentagescore op te halen in Learning Manager, worden geschaalde scores verzonden via xAPI.

Voorbeeldrapport

Downloaden

Bestand ophalen

Voorbeeld xAPI-rapport.

Krijg sneller en gemakkelijker hulp

Nieuwe gebruiker?