Services voor opdrachten en scores (AGS) is een LTI-uitbreiding. LTI 1.3 is een uitbreiding die is ontworpen om geavanceerde interacties tussen een tool en een platform te verwerken. Hiermee kunnen ontwikkelaars een reeks subservices bieden die het beheer van hoogwaardige objecten en waarden binnen Brightspace® mogelijk maken.
Services voor opdrachten en scores (AGS) omvat drie diensten:
- LineItem-service
- Resultaatservice
- Scoreservice
Uitleg over het gedrag van scores met AGS
Beheerders dienen rekening te houden met de volgende overwegingen die van invloed zijn op het gedrag van scores bij het gebruik van de service voor opdrachten en scores. AGS-scores worden alleen opgeslagen als de optie Kan worden beoordeeld in Scores is ingeschakeld voor de gebruiker die wordt beoordeeld. Als een score-onderdeel wordt ingediend voor een gebruiker met een rol die niet kan worden beoordeeld, wordt de beoordeling niet meer opgeslagen en wordt er een foutbericht verzonden naar de indienende tool.
Het gedrag van tools instellen:
- Klik op Beheertools op de startpagina van uw organisatie.
- Klik in de sectie Beveiliging op Rollen en machtigingen.
- Klik op het menu Meer acties naast de rol waarvoor u de optie Kan worden beoordeeld in scores wilt instellen.
- Klik op Instellingen bewerken.
- Selecteer onder Opties voor werking van tool de optie Kan worden beoordeeld in scores.
- Klik op Opslaan en sluiten.
Afbeelding: wanneer u de optie Kan worden beoordeeld in scores inschakelt, kunt u gebruikers beoordelen die met deze rol zijn ingeschreven in de tool Scores.
Beheerders moeten zich er ook van bewust zijn dat als Overschrijding mogelijk niet is ingesteld voor een score-onderdeel en een tool een hogere score verzendt naar het scorerapport dan de maximale waarde die is ingesteld voor het score-onderdeel, het volgende gebeurt:
- De maximaal toegestane score (niet de hogere score die is ingediend) wordt weergegeven in het scorerapport.
- De score die door de tool wordt verzonden en die hoger is dan het maximum, wordt in een interne tabel opgeslagen voor toekomstig gebruik.
Opmerking: LTI -tools en D2L®-klanten hebben geen toegang tot deze interne tabel.
De status Overschrijding mogelijk voor een score-onderdeel in- of uitschakelen:
- Klik op de navigatiebalk van de cursus op Scores.
- Klik op het tabblad Scores beheren en selecteer het score-onderdeel.
- Op het tabblad Eigenschappen, onder Score, kunt u het selectievakje Overschrijding mogelijk indien van toepassing controleren of bijwerken.
Afbeelding: de optie Overschrijding mogelijk in het gedeelte Score van de eigenschappen van een score-onderdeel.
LineItem-service
De LineItem-service wordt gebruikt om de score-onderdelen voor leertools te beheren. Deze service stelt een tool in staat om score-onderdelen te maken en te verwijderen en om details van score-onderdelen op te halen die de tool zelf bezit. Deze service biedt de volgende mogelijkheden:
- LineItems.url: de eindpunt-URL voor toegang tot de container met regelitems voor de huidige context
- LineItem.url: de eindpunt-URL voor toegang tot het regelitem als er slechts één regelitem is gekoppeld aan de bronkoppeling; als er meer dan een regelitem is, moet deze eigenschap leeg zijn
Er zijn verschillende gedefinieerde mediatypen bij de regelitemservice:
-
application/vnd.ims.lis.v2.lineitem+json, met een voorbeeld:
{ "id" : https://lms.example.com/context/2923/lineitems/1, "scoreMaximum" : 60, "label" : "Math 202 Quiz", "resourceId" : "a-9334df-33", "tag" : "grade", "resourceLinkId" : "1g3k4dlk49fk", "startDateTime": "2019-03-06T20:05:02Z", "endDateTime": "2019-04-06T22:05:03Z" }
- application/vnd.ims.lis.v2.lineitemcontainer+json, met een voorbeeld:
[{ "id": "https://lms.example.com/context/2923/lineitems/1", "scoreMaximum": 60, "label": "Math 202 Quiz", "resourceId": "a-9334df-33", "tag": "grade", "resourceLinkId": "1g3k4dlk49fk", "endDateTime": "2019-04-06T22:05:03Z"}, { "id": "https://lms.example.com/context/2923/lineitems/47", "scoreMaximum": 100, "label": "Week 3 Assignment", "resourceId": "a-9334df-33", "tag": "originality", "resourceLinkId": "1g3k4dlk49fk" }, {"id": "https://lms.example.com/context/2923/lineitems/69", "scoreMaximum": 60, "label": "Week 4 Assignment", "tag": "grade" }]
Wanneer u een GET-aanvraag naar het eindpunt van de container probeert uit te voeren, wilt u wellicht de volgende resultaten filteren:
- resource_link_id: retourneer alleen de items die zijn gekoppeld aan de opgegeven bron-id van het toolplatform voor de koppeling in de inhoud.
- Resource_id: retourneer alleen de items die zijn gekoppeld aan de opgegeven resource-id van de tool. Meerdere regelitems kunnen dezelfde bron-id binnen een context delen.
- tag: retourneer alleen de items die zijn gekoppeld aan de opgegeven tag. Altijd een tekenreeks.
- limit:: beperk het aantal geretourneerde regelitems. Als er meer items bestaan na de geretourneerde items, moet een 'Koppeling' HTTP-koptekst met een URL die naar de volgende pagina wijst en een 'REL'-waarde van 'Next' in het antwoord worden opgenomen. D2L beperkt GET-aanroepen tot 200 items.
|
Opmerking: Het wordt aanbevolen om een QuickLink te gebruiken in plaats van een regelitem, omdat er beperkingen zijn in de manier waarop de pass-back van regelitems werkt bij toevoeging via Insert Stuff® of bij gebruik van de diepe koppeling voor de cursusbouwer.
Als u voor de workflow van de cursusbouwer op de koppeling in het deelvenster klikt, kunt u de informatie verzenden om het regelitem te maken.
|
Voorbeeld van een nieuw regelitem
Een nieuw score-onderdeel maken
U moet POST gebruiken naar application/vnd.ims.lis.v2.lineitem op de LineItems.url. Kan als volgt worden weergegeven:
{ "scoreMaximum" : 60, "label" : "Math 101 Quiz", "resourceId" : "quiz-2031", "tag" : "math", "startDateTime": "2019-07-07T20:05:02Z", "endDateTime": "2019-07-07T22:05:03Z", }
Resultaatservice
Met de resultaatservice kunnen gebruikers een query uitvoeren op het platform naar de huidige waarden van score-objecten die het bezit. Het termresultaat zelf vertegenwoordigt een huidige score voor een bepaald object of voor een bepaalde gebruiker. Voor het synchroniseren van nieuwe scores raadpleegt u de sectie Scoreservice van dit onderwerp:
Opmerking: Een resultaat kan niet rechtstreeks via deze service worden gewijzigd, dus alleen GET-opdrachten worden ondersteund.
Het service-eindpunt is een subpad van de bron-URL van het regelitem. De bron-URL heeft het pad aangevuld met '/results'. Deze service ondersteunt alleen GET-bewerkingen en retourneert alle resultaten voor het regelitem. Bijvoorbeeld:[{ "id": "https://lms.example.com/context/2923/lineitems/1/results/5323497", "scoreOf": "https://lms.example.com/context/2923/lineitems/1", "userId": "5323497", "resultScore": 0.83, "resultMaximum": 1, "comment": "Dit is uitzonderlijk werk." }]Tools kunnen deze resultaten filteren met behulp van de volgende queryparameters:
- user_id:: filter de resultaten tot één gebruiker op basis van de gebruikers-id.
- limit: beperk het aantal geretourneerde resultaten. D2L beperkt de resultaten tot 200 items.
Scoreservice
Een score staat voor de waarde van een activiteit die een gebruiker zojuist heeft voltooid. De term 'score' verwijst naar de waarde op het moment dat de activiteit werd uitgevoerd. De scoreservice wordt gebruikt door een tool om de nieuwste score te publiceren naar Brightspace. Omdat Brightspace® alleen nieuwe scores plaatst, is deze service alleen-schrijven. Als deze later wordt bekeken, heeft D2L® toegang tot het resultaat via de resultaatservice, die alleen-lezen is.
Er is slechts één mediatype gedefinieerd door deze service: Application/vnd.ims.lis.v1.score+json. Hieronder is een voorbeeld van een resultaat te zien: {"timestamp": "2017-04-16T18:54:36.736+00:00", "scoreGiven" : 83, "scoreMaximum" : 100, "comment" : "Dit is uitzonderlijk werk.", "activityProgress" : "Voltooid", "gradingProgress": "FullyGraded", "userId" : "5323497" >}Timestamp oftewel de tijdstempel is een verplichte waarde die aangeeft wanneer de score is gewijzigd, en is bedoeld om door het platform te worden gebruikt om te voorkomen dat de score wordt bijgewerkt. De tijdstempelwaarde is een ISO 8601-datumtijd van de servertijd waarop de scorestatus is gewijzigd. Om gegevens historisch te beschermen zal deze waarde naar verwachting bij elke aanvraag toenemen.
De voortgang van de activiteit geeft de status van een specifieke activiteit op dat moment aan. Terwijl IMS verschillende beschikbare waarden documenteert, negeert Brightspace® deze waarden en vertrouwt in plaats daarvan alleen op de statuswaarde Scorevoortgang.
Eindscores
De voortgang van de score in het veld heeft veel beschikbare waarden, zoals gedocumenteerd door 1EdTech. Brightspace herkent momenteel echter alleen de FullyGraded-waarde: het scoreproces is voltooid; de scorewaarde, indien aanwezig, vertegenwoordigt de huidige eindscore. Zie de details van de scorevoortgang in de officiële IMS-documentatie.
Als deze optie is ingeschakeld, worden de cijfers die via AGS zijn gemaakt standaard opgenomen in de berekening van de eindscore. Als deze optie niet is ingeschakeld, worden de cijfers die via AGS zijn gemaakt standaard uitgesloten van de berekening van de eindscore.
Scoresynchronisatiefunctie op basis van een "laatste update"-model. Dit betekent dat de score wordt overschreven als een faculteitslid het scorerapport in Brightspace® bijwerkt en vervolgens opnieuw een synchronisatie vanuit de tool uitvoert. U kunt echter het gebeurtenislogboek voor de score controleren om de wijzigingen weer te geven die voor een bepaald score-object zijn opgetreden.
U kunt de score-onderdelen die u maakt verwijderen met LTI Advantage als u een verwijderopdracht voor Services voor opdrachten en scores (AGS) verzendt. Als het score-onderdeel een score heeft, wordt het AGS-regelitem verwijderd, maar blijft het score-onderdeel in Brightspace® staan.
Automatisch score-onderdelen maken
LTI 1.3-gereedschappen kunnen optioneel automatisch scores aanmaken als deze nog niet zijn ingesteld. De optie voor het automatisch maken van score-onderdelen wordt geregeld door de configuratie-instelling voor LTI Advantage Deployment Score-onderdelen automatisch maken (de standaardwaarde is UIT).
Automatisch score-onderdelen maken inschakelen- Klik in het menu Beheertools op Externe cursustools.
- Selecteer het tabblad LTI Advantage. Doe één van de volgende dingen:
- Als u een nieuwe implementatie wilt maken, klikt u op Nieuwe implementatie.
- Als u wijzigingen wilt aanbrengen in een bestaande implementatie, klikt u op de bijbehorende implementatienaam in de tabel.
- Selecteer in het gebied Configuratie-instellingen de optie Automatisch score-onderdelen maken.
Afbeelding: De configuratie-instelling Automatisch score-onderdelen maken voor LTI Advantage Deployment is ON.
- Doe één van de volgende dingen:
- Klik op implementatie maken (voor het maken van nieuwe implementaties).
- Klik op Opslaan en sluiten (voor het bewerken van implementaties).
Als gevolg hiervan worden scores automatisch gemaakt in het scorerapport nadat voor het eerst een score van de LTI-tool is ontvangen, ongeacht of er al een scorekoppeling bestaat.
Plaatsingen en scores koppelen
Elke plaatsing van een koppeling in een cursus staat in verband met hetzelfde scoreobject. Dit wordt bereikt door elke plaatsing van de koppeling toe te kennen aan dezelfde bronkoppeling-ID binnen die cursus. Als er extra regelitems nodig zijn voor een specifieke koppeling, kunnen extra koppelingen worden gemaakt via Externe cursustools > LTI Advantage of wanneer – als Diepe koppeling wordt ondersteund door de tool – de bron die is geselecteerd via de lancering van diepe koppeling, een afzonderlijke ID van de LTI-bronkoppeling en een associatie met een regelitem heeft.
AGS kan worden gebruikt om handmatig een score te maken die in verband staat met een koppeling via integratie van de bronkoppeling-ID die is ontvangen vanuit de lancering. Dit werkt voor alle koppelingen behalve widgets.
HTML Editor en diepe koppelingen
Regelitems kunnen worden gemaakt met behulp van de HTML-editor en diepe koppeling en wel op twee manieren:
- Door gebruik van Automatisch scores maken: het regelitem wordt automatisch gemaakt. De score is op basis van 100 en eventuele verdere updates van het regelitem moeten worden uitgevoerd via AGS.
- Via AGS: een tool kan AGS gebruiken om handmatig een regelitem te maken. Om ervoor te zorgen dat de score de juiste associatie met de koppeling heeft, moet de tool de ResourceLinkId bevatten die is ontvangen vanaf de lancering bij het maken van het regelitem.
Maximumscore
Als Overschrijding mogelijk niet is geselecteerd en een tool een hogere score verstuurt dan de maximaal toegestane score, dan wordt de maximumscore weergegeven in het scorerapport, en de werkelijke score die door de tool wordt verzonden, wordt opgeslagen in een interne tabel. Tools en klanten hebben geen toegang tot deze tabel.