Assignment and Grade Services (AGS) est une extension d'interopérabilité des outils d'apprentissage (IOA). L’outil LTI (IOA) 1.3 est conçu pour gérer les interactions avancées de notation entre un outil et une plateforme. Il offre aux développeurs une série de sous-services qui permettent de gérer les objets et les valeurs de note dans l'espace d'éclairage.
Assignment and Grade Services (AGS) comprend trois services :
- Service LineItem
- Service de résultat
- Service de notation
Comprendre le comportement des Notes d’appréciation avec STN
Les administrateurs doivent connaître les considérations suivantes qui influent sur le comportement des notes lors de l'utilisation des services Travaux et Notes. Les notes d'appréciation du STN sont uniquement stockées lorsque l'option Peut être noté dans Notes d'appréciation est activée afin que l'utilisateur soit évalué. Si un utilisateur ne pouvant pas être noté soumet élément de note, la note n'est plus stockée et un message d'erreur est envoyé à l'outil de soumission.
Pour définir les comportements de l'outil
- À la page d’accueil de l’organisation, sélectionnez Outils d’administration.
- Dans la section Sécurité, cliquez sur Rôles et autorisations.
- Sélectionnez le menu Plus d'actions du rôle pour lequel vous désirez définir Peut être noté dans Notes d'appréciation.
- Cliquez sur Modifier les paramètres.
- Sous Options de comportement de l’outil, sélectionnez Peut être noté dans Notes d’appréciation.
- Cliquez sur Enregistrer et fermer.
Les administrateurs doivent aussi savoir que si Peut dépasser n’est pas défini pour un élément de note et qu’un outil envoie au cahier de notes une note supérieure au maximum fixé pour l’élément de note :
- La note maximale permise (et non la note la plus élevée soumise) apparaît dans le cahier de notes.
- La note envoyée à partir de l’outil qui dépasse le maximum est enregistrée dans un tableau interne pour référence ultérieure.
|
Remarque: les outils LTI et les clients D2L n'ont pas accès à cette table interne. |
Permet d'activer ou de désactiver l'état Peut dépasser pour un élément de note
- Dans la barre de navigation du cours, cliquez sur Notes.
- Sélectionnez l'onglet Gérer les notes, puis l'élément de note.
- Dans l’onglet Propriétés, sous Notation, confirmez ou cochez la case Peut dépasser, selon le cas.
Service LineItem
Utilisez LineItem Service pour gérer les éléments de note des outils d'apprentissage. Il permet à un outil de créer, supprimer et obtenir des renseignements sur les éléments de note dont l'outil lui-même est propriétaire. Ce service permet ce qui suit :
- LineItems.url : L’URL du point d’extrémité pour accéder au contenant de l’élément de ligne LineItem du contexte actuel.
- LineItem.url: URL de fin pour accéder à LineItem lorsqu'un seul LineItem est associé au lien de ressource; s'il y a plus d'un LineItem, cette propriété doit être vide.
Différents types de médias sont définis par le Service LineItem :
- application/vnd.ims.lis.v2.lineitem+json, avec un échantillon :
{ "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.lineitemconteneur+json, avec un exemple :
[{ "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" }]
Lors de l'envoi d'une demande GET au point d'extrémité du conteneur, vous pouvez filtrer les résultats suivants :
- Resource_link_id: Renvoie uniquement les éléments associés à ResourceID de la plate-forme d'outil spécifiée pour le lien dans le contenu.
- Resource_id: renvoie uniquement les éléments associés à l'identificateur de ressource outil spécifié. Plusieurs éléments de coût peuvent partager le même code de ressource dans un contexte.
- Balise : renvoie uniquement les éléments associés à la balise spécifiée. Toujours une chaîne.
- limite : Limiter le nombre d’éléments de lignes retournés. S'il existe d'autres éléments après ceux renvoyés, un en-tête HTTP « Lien » avec une URL pointant vers la page suivante et une valeur « rel » de « next » DOIT être inclus dans la réponse. D2L limite les appels de type GET à 200.
|
Remarque: il est recommandé d'utiliser un lien rapide à la place pour un élément linéaire, car il existe des restrictions dans l'endroit où le retour d'élément linéaire fonctionne lors de l'ajout via Inclure quelque chose ou via le lien rapide de lien profond du créateur de cours. Pour le flux de travail du créateur de cours, le fait de cliquer sur le lien dans le panneau permet à l'outil d'envoyer l'information pour créer l’élément de ligne. |
Exemple d'un nouvel élément de ligne
Créer un nouvel élément de note d’appréciation
Vous devez PUBLIER à application/vnd.ims.lis.v2.lineitem vers LineItems.url. Il peut s'afficher comme suit :
{ "scoreMaximum" : 60, "label" : "Math 101 Quiz", "resourceId" : "quiz-2031", "tag" : "math", "startDateTime": "2019-07-07T20:05:02Z", "endDateTime": "2019-07-07T22:05:03Z", }
Service de résultat
Le service de résultats permet à un outil d'interroger la plateforme sur les valeurs actuelles des objets de note dont il est propriétaire. Le résultat du terme lui-même représente une note courante pour un objet ou un utilisateur précis donné. Pour synchroniser les nouvelles notes, reportez-vous à la section Score Service de cette rubrique.
|
Remarque: Un résultat ne peut pas être modifié directement par ce service, seules les commandes GET sont donc prises en charge. |
Le point d’extrémité du service est un chemin secondaire de l’URL ressource de l’élément de ligne. Le chemin d'accès de l’URL de la ressource est annexé aux '/résultats'. Ce service ne prend en charge que les opérations GET et il retourne tous les résultats pour l’élément de ligne. Par exemple :
[{ "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." }]
|
Remarque: le carnet de notes permet aux formateurs de fournir des commentaires à l'aide d'un éditeur HTML complet. Toutefois, le service Interopérabilité des outils d'apprentissage (IOA) accepte les commentaires uniquement en texte brut, ce qui élimine toute mise en forme HTML du commentaire. Si le commentaire reçu par l'intermédiaire du service de résultats ne correspond pas au commentaire le plus récemment fourni par l'outil, il est probable qu'un enseignant ait mis à jour le commentaire dans le carnet de notes. Utilisez le service Note pour mettre à jour uniquement la valeur de la note, sans écraser le commentaire de l'enseignant. |
Les outils peuvent filtrer ces résultats en suivant les paramètres de requête suivants :
- user_id : Filtrer les résultats pour un seul utilisateur en fonction de son identifiant.
- Limite : Limiter le nombre de résultats retournés. D2L limite le nombre de résultats à 200.
Service de notation
Une note représente la valeur d'une activité qu'un utilisateur vient de terminer. Le terme « note » représente cette valeur au moment où l'activité a été exécutée. Le Service de note est utilisé par un outil pour publier la plus récente note dans Brightspace. Étant donné que Brightspace ne publie que de nouvelles notes, ce service est en lecture seule. Lorsque vous y accédez à une date ultérieure, nous y accédons par la suite pour utiliser le service de résultat, qui est en lecture seule.
Il n'existe qu'un seul type de média défini par ce service : application/vnd.ims.lis.v1.score+json. Voici comment un résultat d'échantillon peut apparaître :
{"timestamp": "2017-04-16T18:54:36.736+00:00", "scoreGiven" : 83, "scoreMaximum" : 100, "comment" : "This is exceptional work.", "activityProgress" : "Completed", "gradingProgress": "FullyGraded", "userId" : "5323497" >}
|
Remarque: si nécessaire, utilisez le service Score pour mettre à jour uniquement la note. Cela permet à l'outil de conserver les commentaires entrés par un enseignant dans le cahier de notes, y compris les commentaires qui utilisent le format HTML, au lieu de les écraser par un nouveau commentaire en texte brut. |
L'estampille temporelle est une valeur obligatoire qui indique quand le pointage change et qui est destinée à être utilisée par la plateforme pour prévenir les mises à jour de pointage erronées. La valeur d'horodatage est une date-heure ISO 8601 de l'heure du serveur lorsque l'état de la note est modifié. Pour protéger les données de manière historique, cette valeur devrait aller croissant avec chaque demande.
La progression de l’activité indique l'état d’une activité particulière à ce point dans le temps. Bien que IMS documente plusieurs valeurs disponibles , l'espace libre ignore ces valeurs et ne se fie qu'à la valeur de l'état Progression de la notation.
Notes d’appréciation finales
Le champ progrès de notation comporte plusieurs valeurs disponibles documentées par 1EdTech. Cependant, Brightspace ne reconnaît actuellement que la valeur FullyGraded : le processus de notation est terminé; la valeur de la note d’appréciation, le cas échéant, représente la note d’appréciation finale actuelle. Pour afficher les détails de la progression de la notation, reportez-vous à la documentation IMS officielle .
Lorsque cette case est cochée, les notes créées au moyen des outils Travaux et Notes Services sont incluses par défaut dans le calcul de la note finale. Lorsque cette case n’est pas cochée, les notes créées dans STN sont exclues par défaut dans le calcul de la note d’appréciation finale.
Fonction de synchronisation des notes sur un modèle de « dernière mise à jour », ce qui signifie que si un enseignant met à jour le carnet de notes dans Brightspace et déclenche à nouveau une synchronisation à partir de l'outil, la note sera écrasée. Cependant, vous pouvez consulter le journal des événements de note pour afficher les changements qui se produisent pour un objet de note particulier.
Vous pouvez supprimer les éléments de note que vous créez à l'aide de LTI Advantage si vous envoyez la commande AGS DELETE. Si l’élément de note a une note, l’élément de ligne AGS est supprimé, mais l’élément de note dans Brightspace demeure.
Création automatique de l'élément de note
Le paramètre Créer automatiquement des éléments de note offre la parité des fonctions avec le service Résultats dans IOA 1,1. Lorsque ce réglage est activé, l'espace d'éclairage crée automatiquement un élément de coût pour chaque lien IOA. Cela peut créer des situations déroutantes si l'outil n'utilise pas l'élément de coût créé automatiquement et utilise plutôt les services de travaux et de notation (AGS) pour créer ses propres éléments de coût.
L'option Création automatique d'un élément de note est contrôlée par le paramètre de configuration Création automatique d'éléments de note LTI Advantage Deployment (la valeur par défaut est DÉSACTIVÉE).
|
Important: ce paramètre est une option de compatibilité héritée qui est prévue pour la dépréciation et n'est pas recommandé pour les nouvelles intégrations. Dans les applications d'espace d'éclairage, ce paramètre s'appelle Gestion des notes IOA héritées . |
Pour activer la création automatique d'articles
- Dans le menu Outils d'administration, cliquez sur Outils d'apprentissage externes.
- Sélectionnez l'onglet LTI Advantage. Procédez de l'une des façons suivantes :
- Si vous souhaitez créer un nouveau déploiement, cliquez sur Nouveau déploiement.
- Si vous souhaitez apporter des modifications à un déploiement existant, cliquez sur le nom de déploiement correspondant dans le tableau.
- Dans la zone Paramètres de configuration, sélectionnez Créer automatiquement des éléments de note.
- Procédez de l'une des façons suivantes :
- Cliquez sur créer un déploiement (pour créer de nouveaux déploiements).
- Cliquez sur Enregistrer et fermer (pour modifier des déploiements existants).
Ajout de liens et notes d’appréciation
Chaque lien ajouté dans un cours est associé au même objet de note. Pour ce faire, chaque emplacement du lien doit avoir le même code ResourceLink dans ce cours. Si des éléments de ligne supplémentaires sont nécessaires pour un lien spécifique, des liens supplémentaires peuvent être créés à partir de Outils d'apprentissage externes > Avantage LTI ou, si l'outil prend en charge la liaison profonde, la ressource sélectionnée lors du lancement de la liaison profonde possède un identifiant de ressource LTI et une association d'éléments de ligne distincts.
AGS peut être utilisé pour créer manuellement une note associée à un lien en incluant le ResourceLink ID reçu lors du lancement. Cela fonctionne pour tous les liens, à l'exception des widgets.
Éditeur HTML et lien profond
Un outil peut utiliser Assignment and Grade Services (AGS) pour créer un élément de note pour n'importe quel lien IOA dans son déploiement. Lorsque des liens IOA sont ajoutés à des pages HTML au moyen de la fonction Lien profond (au moyen de Inclure quelque chose ou Lien rapide), l'espace d'éclairage ignore l'élément de coût fourni par l'outil. Au lieu de cela, l'outil peut créer l'élément de note plus tard en utilisant AGS lorsqu'un enseignant ou un élève lance le lien IOA.
Pour s'assurer que la note a le bon lien, l'outil doit inclure le ResourceLink ID reçu du lancement lors de la création de l'élément de coût.
Note maximale
Si l'option Peut dépasser n'est pas sélectionnée et qu'un outil envoie une note supérieure au maximum autorisé, la note maximale est affichée dans le cahier de notes et la note réelle envoyée par l'outil est stockée dans un tableau interne. Les outils et les clients n'ont pas accès à ce tableau.