De Service voor opdrachten en score (AGS) is een LTI-extensie (Learning Tools Interoperability). LTI 1.3 is een uitbreiding die is ontworpen om geavanceerde interacties tussen een tool en een platform te verwerken. Het biedt ontwikkelaars een reeks subservices waarmee ze score-objecten en -waarden in Brightspace® kunnen beheren.
De Service voor opdrachten en score (AGS) bestaat uit drie services:
- 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.
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.
LineItem-service
Gebruik de LineItem-service 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 de LineItem wanneer er maar één LineItem aan de bronkoppeling is gekoppeld. Als er meer dan één LineItem 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 stuurt, wilt u wellicht de volgende resultaten filteren:
- resource_link_id: Retourneer alleen de items die zijn gekoppeld aan de opgegeven ResourceID van het toolplatform voor de koppeling in de inhoud.
- resource_id: Retourneer alleen die items zijn gekoppeld aan de opgegeven ResourceID van de tool. Meerdere regelitems kunnen dezelfde ResourceID 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 terugsturen van regelitems werkt bij toevoeging via Insert Stuff® of bij gebruik van de diepe koppeling voor Course Builder™. 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 kan een tool 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": "This is exceptional work." }]
|
Opmerking: Met het Brightspace®-scorerapport kunnen instructeurs opmerkingen geven met behulp van een volledige HTML-editor. De LTI-service (Learning Tools Interoperability) accepteert echter opmerkingen alleen als onbewerkte tekst, dus elke HTML-opmaak wordt uit de opmerking verwijderd. Als de opmerking die via de Resultaatservice is ontvangen niet overeenkomt met de opmerking die het meest recent door de tool is gegeven, heeft een instructeur de feedback in het Brightspace®-scorerapport waarschijnlijk bijgewerkt. Gebruik de Scoreservice alleen om de scorewaarde bij te werken, zonder de opmerking van de instructeur te overschrijven. |
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 ziet u een voorbeeldweergave van een resultaat:
{"timestamp": "2017-04-16T18:54:36.736+00:00", "scoreGiven" : 83, "scoreMaximum" : 100, "comment" : "This is exceptional work.", "activityProgress" : "Completed", "gradingProgress": "FullyGraded", "userId" : "5323497" >}
|
Opmerking: Gebruik, waar nodig, de Scoreservice alleen om de score bij te werken. Hierdoor kan de tool opmerkingen behouden die door een instructeur in het Brightspace®-scorerapport zijn ingevoerd, inclusief opmerkingen die een HTML-opmaak hebben, in plaats van ze met een nieuwe opmerking in platte tekst te overschrijven. |
Tijdstempel is een verplichte waarde die aangeeft wanneer de score is gewijzigd. Deze functie 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. Als u details over de voortgang van de beoordeling wilt zien, raadpleegt u de officiële IMS-documentatie.
Als deze optie is ingeschakeld, worden scores die zijn gemaakt via Services voor opdrachten en scores (AGS) worden 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 instructeur 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 AGS-verwijderopdracht verzendt. Als het score-onderdeel een score heeft, wordt het AGS-regelitem verwijderd, maar blijft het score-onderdeel in Brightspace® staan.
|
Opmerking: Externe LTI-tools die ondersteuning bieden voor degradesReleasedeigenschap kunnen automatisch de zichtbaarheid van score-onderdelen in Brightspace® beheren. DegradesReleasedeigenschap wordt toegewezen aan de instelling Verbergen voor gebruikers van het score-onderdeel, waardoor Brightspace® de zichtbaarheid van het score-onderdeel kan bijwerken op basis van de waarde die door de externe tool wordt opgegeven. Door deze synchronisatie blijft de zichtbaarheid van scores consistent tussen de externe tool en Brightspace® en hoeven instructeurs minder vaak de zichtbaarheid van scores handmatig bij te werken. Ga bij uw LTI-toolprovider na of de tool deze functionaliteit ondersteunt. |
Automatisch score-onderdelen maken
De instelling Score-onderdelen automatisch maken biedt functiepariteit met de resultatenservice in LTI 1.1. Wanneer deze instelling is ingeschakeld, maak Brightspace® automatisch een regelitem voor elke LTI-koppeling. Dit kan tot verwarrende situaties leiden als de tool niet het automatisch gemaakte regelitem gebruikt en in plaats daarvan de Service voor opdrachten en score (AGS) gebruikt om de bijbehorende eigen regelitems te maken.
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).
|
Belangrijk: Deze instelling is een verouderde compatibiliteitsoptie waarvan de buitengebruikname al gepland staat en deze wordt niet aanbevolen voor nieuwe integraties. In Brightspace®-apps heet deze instelling Beheer van verouderde LTI-scores. |
Automatisch 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.
- 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).
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 ResourceLinkID 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 LTI-ResourceLinkID en een associatie met een regelitem heeft.
AGS kan worden gebruikt om handmatig een score te maken die aan een koppeling is gekoppeld door de ResourceLinkID die bij het starten is ontvangen, op te nemen. Dit werkt voor alle koppelingen, behalve voor widgets.
HTML Editor en diepe koppelingen
Een kan de Service voor opdrachten en score (AGS) gebruiken om een score-onderdeel te maken voor elke LTI-koppeling in de bijbehorende implementatie. Wanneer LTI-koppelingen via een diepe koppeling aan HTML-pagina's worden toegevoegd (ofwel met Insert Stuff® of met Quicklink), negeert Brightspace® het regelitem dat door de tool wordt geleverd. In plaats daarvan kan de tool het score-onderdeel later maken door AGS te gebruiken wanneer een instructeur of cursist de LTI-koppeling opent.
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 score stuurt die hoger is dan de maximaal toegestane score, dan wordt de maximale score weergegeven in het scorerapport. De werkelijke score die door de tool wordt verzonden, wordt opgeslagen in een interne tabel. Tools en klanten hebben geen toegang tot deze tabel.