Los servicios de asignaciones y calificaciones (AGS) son una extensión de LTI. LTI 1.3 está diseñado para manejar interacciones de calificaciones avanzadas entre una herramienta y una plataforma. Brinda a los desarrolladores una serie de subservicios que permiten la administración de los recursos y valores de calificación dentro de Brightspace.
Los servicios de asignaciones y calificaciones (AGS) incluyen los tres siguientes servicios:
- Servicio de LineItem
- Servicio de resultados
- Servicio de puntuación
Comprensión del comportamiento de las calificaciones con AGS
Los administradores deben tener en cuenta las siguientes consideraciones que afectan el comportamiento de las calificaciones cuando usan los servicios de Asignaciones y Calificaciones. Los puntajes AGS se almacenan solo cuando la opción Puede calificarse en Calificaciones está habilitada para el usuario que está siendo evaluado. Si se envía un elemento de calificación para un usuario con un rol que no se puede calificar, la calificación ya no se almacena y se envía un mensaje de error a la herramienta de envío.
Para establecer los comportamientos de la herramienta:
- En la página de inicio de su organización, seleccione Herramientas de administración.
- En la sección Seguridad, haga clic en Roles y permisos.
- Haga clic en el menú Más acciones junto al rol para el que desea definir la opción Puede calificarse en Calificaciones.
- Haga clic en Editar configuración.
- En Opciones de comportamiento de la herramienta, seleccione Puede calificarse en Calificaciones.
- Haga clic en Guardar y cerrar.
Figura: Cuando activa la opción Puede calificarse en Calificaciones, puede evaluar a los usuarios inscritos con este rol en la herramienta Calificaciones.
Los administradores también deben tener en cuenta que, si la opción Puede exceder no se establece para un elemento de calificación, y una herramienta envía una calificación superior al conjunto máximo para el elemento de calificación:
- El puntaje máximo permitido (no la calificación más alta enviada) aparecerá en el cuaderno de calificaciones.
- El puntaje enviado desde la herramienta que es superior al máximo se registra en una tabla interna para consulta futura.
Nota: Las herramientas de LTI y los clientes de D2L no tienen acceso a esta tabla interna.
Para activar o desactivar el estado Puede exceder para un elemento de calificación:
- En la barra de navegación del curso, haga clic en Calificaciones.
- Haga clic en la pestaña Administrar calificaciones y seleccione el elemento de calificación.
- En la pestaña Propiedades, en Calificación, confirme o actualice la casilla de selección Puede exceder, según corresponda.
Figura: La opción Puede exceder en el área Calificación de Propiedades de un elemento de calificación.
Servicio de LineItem
El servicio de LineItem se utiliza para administrar los elementos de calificación de las herramientas de aprendizaje. Permite que una herramienta cree, elimine y obtenga detalles de los elementos de calificación que posee la herramienta. Este servicio ofrece las siguientes capacidades:
- LineItems.url: el punto de conexión URL para acceder al contenedor LineItem para el contexto actual.
- LineItem.url: el punto de conexión URL para acceder al elemento de línea cuando existe un solo elemento de línea asociado al enlace del recurso; si hay más de un elemento de línea, esta propiedad debe estar en blanco.
Existen diferentes tipos de medios definidos por el servicio LineItem:
-
application/vnd.ims.lis.v2.lineitem+json, con una muestra:
{ "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, con un ejemplo:
[{ "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" }]
Al probar una solicitud GET para el punto de conexión del contenedor, es posible que desee filtrar los siguientes resultados:
- resource_link_id: devuelve solo los elementos asociados con la ID de recurso de la plataforma de herramientas especificada para el enlace en el contenido.
- resource_id: devuelve solo los elementos asociados con el identificador de recursos de herramienta especificado. Varios elementos de línea pueden compartir el mismo resourceId en un contexto.
- tag: devuelve solo los elementos asociados con la etiqueta especificada. Siempre hay una cadena.
- limit: restringe la cantidad de elementos de línea devueltos. Si existen más elementos después de los devueltos, se DEBE incluir en la respuesta un encabezado http del "enlace" con una dirección URL que apunte a la página siguiente y un "rel." con un valor de "siguiente". D2L limita las llamadas GET a 200.
|
Nota: le recomendamos usar un QuickLink en su lugar si es un LineItem, ya que existen limitaciones en donde el pase de LineItem funciona cuando se agrega a través de Insertar objetos o a través del enlace rápido profundo del generador de cursos.
Para el flujo de trabajo del generador de cursos, si hace clic en el enlace del panel, la herramienta puede enviar la información para crear el LineItem.
|
Muestra de un nuevo elemento de línea
Para crear un nuevo elemento de calificación
Debe PUBLICAR en la application/vnd.ims.lis.v2.lineitem los LineItems.url. Puede aparecer de la siguiente manera:
{ "scoreMaximum" : 60, "label" : "Math 101 Quiz", "resourceId" : "quiz-2031", "tag" : "math", "startDateTime": "2019-07-07T20:05:02Z", "endDateTime": "2019-07-07T22:05:03Z", }
Servicio de resultados
El servicio Resultados brinda a los usuarios la capacidad de hacer que sus herramientas consulten la plataforma para los valores actuales de los recursos de calificación que posee. El resultado del término en sí representa una calificación actual para un recurso determinado o para un usuario en particular. Para sincronizar las calificaciones nuevas, consulte la sección Servicio de puntaje en este tema.
Nota: Un resultado no se puede modificar directamente a través de este servicio, por lo que solo se admiten los comandos GET.
El punto de conexión del servicio es una ruta secundaria de la dirección URL del recurso del elemento de línea. La URL del recurso tiene la ruta anexada con “/results”. Este servicio solo es compatible con las operaciones GET y devolverá todos los resultados del elemento de línea. Por ejemplo:[{ "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." }]Las herramientas pueden filtrar estos resultados utilizando los siguientes parámetros de consulta:
- user_id: filtra los resultados a un solo usuario basándose en su ID.
- limit: restringe la cantidad de resultados devueltos. D2L limita los resultados a 200.
Servicio de puntuación
Una puntuación representa el valor de una actividad que un usuario acaba de completar. El término “puntuación” es ese valor en el momento en que se realizó la actividad. El servicio Puntaje se utiliza como una herramienta para publicar el último puntaje en Brightspace. Debido a que Brightspace solo publica nuevas puntuaciones, este servicio es de solo escritura. Cuando se accede más tarde, D2L accede a él como resultado mediante el servicio de resultados, que es de solo lectura.
Solo hay un tipo de medio definido por este servicio: application/vnd.ims.lis.v1.score+json. El siguiente es un ejemplo de resultado que puede aparecer: {"timestamp": "2017-04-16T18:54:36.736+00:00", "scoreGiven" : 83, "scoreMaximum" : 100, "comment" : "This is exceptional work.", "activityProgress" : "Completed", "gradingProgress": "FullyGraded", "userId" : "5323497" >}La marca de tiempo es un valor obligatorio que indica cuándo se cambia el puntaje y está destinado a ser utilizado por la plataforma para proteger contra actualizaciones de puntaje incorrectas. El valor de la marca de tiempo es una fecha y hora ISO 8601 de la hora del servidor en la que se modifica el estado del puntaje. Para proteger los datos históricos, se espera que este valor aumente con cada solicitud.
Progreso de la actividad indica el estado de una actividad específica en ese momento. Si bien IMS documenta varios valores disponibles, Brightspace ignora estos valores y, en su lugar, solo depende del valor del estado de Progreso de calificaciones.
Calificaciones finales
El campo de progreso de la calificación tiene muchos valores disponibles según lo documentado por 1EdTech. Sin embargo, Brightspace actualmente solo reconoce el valor FullyGraded: el proceso de calificación se completa; el valor del puntaje, si existe, representa la calificación final actual. Consulte los detalles de Progreso de calificaciones en la documentación oficial de IMS.
Cuando está marcada, las calificaciones creadas con AGS se incluyen de forma predeterminada en el cálculo de la calificación final. Cuando no está marcada, las calificaciones creadas con AGS se excluyen de forma predeterminada del cálculo de la calificación final.
La función de sincronización de calificaciones en un modelo de "última actualización", es decir, si un miembro del cuerpo docente actualiza el cuaderno de calificaciones en Brightspace y, luego, vuelva a intentar la sincronización desde la herramienta, se sobrescribirá la calificación. Sin embargo, puede revisar el registro de eventos de calificación para ver los cambios que se producen para un recurso de calificación en particular.
Puede eliminar los elementos de calificación que crea con LTI Advantage si envía un comando de eliminación de servicios de asignaciones y calificaciones (AGS). Si el elemento de calificación tiene una puntuación, el elemento de línea AGS se elimina, pero el elemento de calificación en Brightspace permanece.
Creación automática de elementos de calificación
Las herramientas de LTI 1.3 pueden crear calificaciones automáticamente, de forma opcional, si ninguna ya está configurada. La opción de creación automática de elementos de calificación se controla mediante el ajuste de configuración de Implementación de LTI Advantage de Creación automática de elementos de calificación (el valor predeterminado es DESACTIVADO).
Para habilitar la creación automática de elementos de calificación- En el menú Herramientas de administración, haga clic en Herramientas de aprendizaje externas.
- Seleccione la pestaña de LTI Advantage. Realice una de las siguientes acciones:
- Si desea crear una nueva implementación, haga clic en Nueva implementación.
- Si desea realizar cambios en una implementación existente, haga clic en el nombre de la implementación correspondiente en la tabla.
- En el área de Configuración, seleccione Crear automáticamente elementos de calificación.
Figura: La configuración Crear automáticamente elementos de calificación de la implementación de LTI Advantage está ACTIVADA.
- Realice una de las siguientes acciones:
- Haga clic en Crear implementación (para crear nuevas implementaciones).
- Haga clic en Guardar y cerrar (para editar las implementaciones).
Como resultado, las calificaciones se crean automáticamente en el cuaderno de calificaciones después de recibir una puntuación de la herramienta LTI por primera vez, independientemente de si ya existe una asociación de calificaciones.
Ubicaciones de enlaces y calificaciones
Cada ubicación de un enlace en un curso está asociada al mismo objeto de calificación. Esto se completa haciendo que cada ubicación del enlace tenga el mismo ID de enlace de recursos dentro de ese curso. Si se necesitan elementos de línea adicionales para un enlace específico, se pueden crear enlaces adicionales a través de Herramientas de aprendizaje externas > LTI Advantage o, si la herramienta admite Enlaces profundos, el recurso seleccionado a través del inicio del enlace profundo tiene un ID de enlace de recursos LTI distinto y una asociación de elementos de línea.
AGS se puede utilizar para crear manualmente una calificación asociada a un enlace mediante la inclusión del ID de enlace de recursos recibido desde el inicio, esto funciona para todos los enlaces excepto para los componentes.
Editor HTML y enlaces profundos
Los elementos de línea se pueden crear utilizando el editor HTML y enlaces profundos de dos maneras:
- Mediante el uso de Creación automática de calificaciones: el elemento de línea se crea automáticamente. La calificación es sobre 100 y cualquier actualización adicional del elemento de línea se debe realizar a través de AGS.
- A través de AGS: una herramienta puede usar AGS para crear manualmente un elemento de línea. Para asegurarse de que la calificación tenga la asociación de enlace correcta, la herramienta debe incluir el ResourceLinkId recibido desde el inicio al crear el elemento de línea.
Puntaje máximo
Si Puede exceder no está seleccionado y una herramienta envía un puntaje superior al máximo permitido, el puntaje máximo se muestra en el libro de calificaciones, y el puntaje real enviado desde la herramienta se almacena en una tabla interna, las herramientas y los clientes no tienen acceso a esta tabla.