Los Adaptadores del IPSIS usan la interfaz de complemento para IReadGradesHandler a fin de respaldar la operación de lectura de las Calificaciones.
La implementación de la interfaz es D2L.IM.IPSIS.OrgUnits.Memberships.Handlers.IReplaceEnrollmentHandler.
Las siguientes listas de configuración de la interfaz ReadGradesHandler se entregan con el producto. Aparecen junto con el punto de extensión al que están destinadas.
IPSIS, Plantilla: Calificaciones
- ReadGradesGradableMappingGetFirstMappingWithGradesHandler (Orden de clasificación = 10)
- ReadGradesResolveGradeTypeFromCourseSettingHandler (Orden de clasificación = 20)
- ReadGradesStatusDefaultAllHandler (Orden de clasificación = 30)
- ReadGradesDisplayTypeDefaultPointsHandler (Orden de clasificación = 40)
- ReadGradesValidateHandler (Orden de clasificación = 50)
- ReadGradesGetGradesForSectionMappingHandler (Orden de clasificación = 60)
- ReadGradesFilterBySISEnrollmentsHandler (Orden de clasificación = 70)
ReadGradesGradableMappingDefaultToFirstMappingHandler
Un objeto orgUnit único en el SIS puede asignarse a varias OrgUnits en Brightspace. Por ejemplo, esto puede ocurrir con los controladores predeterminados de una sección que es parte de una o más asociaciones de sección. Cuando la entrada contiene un SISId de una OrgUnit, pero ningún esquema, es necesario seleccionar una asignación única del conjunto. El controlador Default to First Mapping simplemente elige el primer esquema de la lista devuelta desde la base de datos.
Implementación
D2L.IM.IPSIS.Default.Grades.Handlers.ReadGradesGradableMappingDefaultToFirstMappingHandler
Comportamiento esperado
El controlador realiza las siguientes tareas:
- Si ya existe una OrgUnitMapping adjunta a la solicitud, el controlador no realiza ninguna acción.
- De lo contrario, si no existe un SisId en la solicitud, el controlador genera una IncompleteRequestException.
- Si el SisId existe, el controlador busca las asignaciones de la OrgUnit en la base de datos.
- Si se devuelven varias asignaciones, el controlador selecciona el primero de la lista. Este suele ser el que tiene la ID más baja, es decir, la que se asignó primero.
- La Asignación de objeto de solicitud se actualiza con este valor. Esta información está disponible para controladores posteriores.
Comportamiento de error
Si existe un problema durante el procesamiento, se arroja una excepción, junto con información tan detallada como sea posible.
Nota de configuración
- El controlador GradableMapping debe colocarse antes de que las calificaciones se recuperen desde la base de datos.
- Existen controladores planificados que utilizan otros criterios para seleccionar una asignación, incluida la selección de la primera asignación con calificaciones o el que está marcado como calificable. Para evitar confusiones, solo debe utilizarse un controlador GradableMapping en una lista de configuración determinada.
ReadGradesGradableMappingGetIsGradableMappingHandler
Un objeto orgUnit único en el SIS puede asignarse a varias OrgUnits en Brightspace. Por ejemplo, esto puede ocurrir con los controladores predeterminados de una sección que es parte de una o más asociaciones de sección. Cuando la entrada contiene un SISId de una OrgUnit, pero ninguna asignación, debemos seleccionar una sola asignación del conjunto. El controlador Get Is Gradable Mapping selecciona la primera asignación marcada como Is Gradable.
Implementación
D2L.IM.IPSIS.Default.Grades.Handlers.ReadGradesGradableMappingGetIsGradableMappingHandler
Comportamiento esperado
El controlador realiza las siguientes tareas:
- Si ya existe una OrgUnitMapping adjunta a la solicitud, el controlador no realiza ninguna acción.
- De lo contrario, si no existe un SisId en la solicitud, el controlador genera una IncompleteRequestException.
- Si el SisId existe, el controlador busca sus asignaciones de la OrgUnit en la base de datos.
- Si se devuelven varias asignaciones, el controlador selecciona el primero que tiene el indicador Es calificable establecido en true. Si no existe tal asignación, el controlador genera una NoGradableSectionsException.
- Si se establecen varias asignaciones en Gradable, el controlador genera una MultipleGradableSectionsException.
- La Asignación de objeto de solicitud se actualiza con este valor. Esta información está disponible para controladores posteriores.
Comportamiento de error
Si existe un problema durante el procesamiento, se arroja una excepción, junto con información tan detallada como sea posible.
Notas de configuración
- El controlador GradableMapping debe colocarse antes de que las calificaciones se recuperen desde la base de datos.
- Existen controladores planificados que utilizan otros criterios para seleccionar una asignación, incluida la selección de la primera asignación con calificaciones o, simplemente, la primera asignación en general. Para evitar confusiones, solo debe utilizarse un controlador GradableMapping en una lista de configuración determinada.
ReadGradesResolveGradeTypeFromCourseSettingHandler
Cuando un tipo de calificación (final rectificada/calculada) todavía no se ha establecido (a través de un traductor o un controlador previo), este controlador establece el tipo de calificación según el tipo de variable de configuración correspondiente (Grades.Calculation.ReleaseAdjustedGrade).
El controlador lee la configuración de la oferta de cursos y no la sección. Capta la asignación de la unidad de organización principal (oferta de cursos) para acceder a la variable de configuración.
Implementación
D2L.IM.IPSIS.Default.Grades.Handlers.ReadGradesResolveGradeTypeFromCourseSettingHandler
Comportamiento esperado
El controlador realiza las siguientes tareas:
- Si el tipo de calificación todavía no se ha definido, recupere la variable de configuración para GradeType. Se controla mediante una configuración del cuaderno de calificaciones.
- Establezca el tipo de calificación (ya sea final calculada o final rectificada).
Comportamiento de error
Si existe un problema durante el procesamiento, se arroja una excepción, junto con información tan detallada como sea posible.
Nota de configuración
El controlador ResolveGradeType debe ejecutarse antes de que las calificaciones reales se recuperen desde la base de datos (es decir, antes de ReadGradesGetGradesForSectionHandler) y después de seleccionar la Asignación.
ReadGradesStatusDefaultAllHandler
Este controlador establece el estado de las calificaciones en All.
Implementación
D2L.IM.IPSIS.Default.Grades.Handlers.ReadGradesStatusDefaultAllHandler
Comportamiento esperado
Si el estado de las calificaciones todavía no se ha definido, establezca el estado de las calificaciones en All.
Notas de configuración
- El controlador StatusDefault debe ejecutarse antes del controlador DisplayTypeDefault (Puntos o Símbolos).
- El controlador StatusDefault debe ejecutarse antes de que las calificaciones reales se recuperen desde la base de datos (es decir, antes de ReadGradesGetGradesForSectionMappingHandler).
- Este controlador StatusDefault no debe utilizarse junto con cualquier otro controlador StatusDefault.
ReadGradesGetGradesForSectionMappingHandler
El controlador ReadGradesGetGradesForSectionMappingHandler recupera las calificaciones de la base de datos.
Implementación
D2L.IM.IPSIS.Default.Grades.Handlers.ReadGradesGetGradesForSectionMappingHandler
Comportamiento esperado
El controlador realiza las siguientes tareas:
- Si el ID de SIS de entrada no corresponde a una Sección en la tablas de IM, el controlador genera una excepción.
- De lo contrario, el controlador recupera las Calificaciones reales desde el Administrador de calificaciones, filtradas por las opciones establecidas hasta el momento.
- Recupera las inscripciones en el SIS de todos los usuarios inscritos en la OrgUnit especificada desde la Asignación.
Comportamiento de error
Si existe un problema durante el procesamiento, se arroja una excepción, junto con información tan detallada como sea posible.
Nota de configuración
Este controlador debe ejecutarse después de cualquier controlador que establezca el Tipo, el Estado o la Asignación de la solicitud, pero antes de que se filtren las Calificaciones.
ReadGradesValidateHandler
El controlador ReadGradesValidateHandler valida que se hayan configurado todas las propiedades requeridas y que la orgUnit sea de un tipo que admita calificaciones en Brightspace.
Implementación
D2L.IM.IPSIS.Default.Grades.Handlers.ReadGradesValidateHandler
Comportamiento esperado
- Si el ID de SIS de entrada no corresponde a una Sección de Ofertas en la tablas de IM, el controlador genera una excepción.
- De lo contrario, el controlador valida que los traductores o los controladores previos hayan establecido el GradeStatus y el GradeType del objeto de la solicitud.
Comportamiento de error
Si existe un problema durante el procesamiento, se arroja una excepción, junto con información tan detallada como sea posible.
Nota de configuración
Este controlador debe ejecutarse después de que se seleccionan el tipo y el estado, pero antes de que efectivamente se lean las calificaciones de la base de datos.
ReadGradesMatchGradesToSISEnrolledUsersHandler
El controlador ReadGradesMatchGradesToSISEnrolledUsersHandler acepta una lista de calificaciones y devuelve una lista de calificaciones emparejadas con el UserId de SIS. Las calificaciones que no se corresponden con los usuarios Inscritos en el SIS se omiten.
Implementación
D2L.IM.IPSIS.Default.Grades.Handlers.ReadGradesIncludeOnlySISEnrolledUsersHandler
Comportamiento esperado
El administrador de calificaciones devuelve todas las Calificaciones de la OrgUnit, pero dichas Calificaciones corresponden a un UserId del LMS, no a un UserId de SIS. Este controlador determina el UserId de SIS correspondiente para cada Calificación y devuelve un conjunto de pares de Calificación/SISUserId. Si no existe un UserId de SIS para un usuario determinado, la calificación asociada se omite de los resultados.
El controlador realiza las siguientes tareas:
- Recupere una lista de las Inscripciones de la OrgUnit actual.
- Para cada una, determine el UserId de SIS del usuario inscrito.
- Busque la primera IGrade coincidente de ese Usuario, si corresponde.
- Cree un nuevo objeto que encapsule pares de IGrade y SISUserId y adjúntelo a la respuesta.
Comportamiento de error
Si existe un problema durante el procesamiento, se arroja una excepción, junto con información tan detallada como sea posible.
Notas de configuración
- Este controlador debe ejecutarse después de leer las calificaciones de la base de datos.
- Este controlador es necesario para permitir que el SIS una las calificaciones con los usuarios con una ID que comprendan. Este controlador (o un reemplazo personalizado) debería estar configurado siempre.
ReadGradesStatusDefaultReleasedOnlyHandler
El controlador ReadGradesStatusDefaultReleasedOnlyHandler establece el tipo de calificación en Publicada.
Implementación
D2L.IM.IPSIS.Default.Grades.Handlers.ReadGradesStatusDefaultReleasedOnlyHandler
Comportamiento esperado
Si el tipo de calificación todavía no se ha definido, establezca el tipo de calificación en Publicado.
Comportamiento de error
Si existe un problema durante el procesamiento, se arroja una excepción, junto con información tan detallada como sea posible.
Notas de configuración
- El controlador StatusDefault debe ejecutarse antes del controlador DisplayTypeDefault (Puntos o Símbolos).
- El controlador StatusDefault debe ocurrir antes de que las calificaciones reales se recuperen desde la base de datos (es decir, antes de ReadGradesGetGradesForSectionMappingHandler).
- Este controlador StatusDefault no debe utilizarse junto con cualquier otro controlador StatusDefault.
ReadGradesGradableMappingGetFirstMappingWithGradesHandler
El controlador ReadGradesGradableMappingGetFirstMappingWithGradesHandler establece la asignación de la unidad de organización en el primero (organizado por ID de orgunitmapping) que tiene calificaciones disponibles.
Implementación
D2L.IM.IPSIS.Default.Grades.Handlers.ReadGradesGradableMappingGetFirstMappingWithGradesHandler
Comportamiento esperado
El controlador realiza las siguientes tareas:
- Si la asignación de la unidad de organización no está establecida, el controlador capta todas las asignaciones de la unidad de organización que coinciden con el identificador externo y los califica por ID de las asignaciones de las unidades de organización.
- El controlador comprueba la primera que tiene una calificación marcada como disponible. Las calificaciones comprobadas se eliminan según el indicador del tipo de calificación de la oferta relacionada (es decir, si la oferta de cursos de la sección está configurada para publicar calificaciones FinalAdjusted, el controlador comprueba si hay calificaciones finales rectificadas disponibles). Disponible significa que la calificación tiene un numerador mayor que 0, o que se le ha definido un símbolo. En esencia, disponibilidad significa que la calificación tiene un valor establecido en esa sección.
- El controlador establece la asignación de la unidad de organización de la solicitud en dicha asignación.
Comportamiento de error
- Si existe un problema durante el procesamiento, se arroja una excepción, junto con información tan detallada como sea posible.
- Si no se encuentran asignaciones de la unidad de organización, se genera una OrgUnitMappingNotFoundException.
- Si no se encuentran calificaciones para ninguna de las asignaciones de la unidad de organización, se genera una NoGradableSectionFoundException.
Notas de configuración
- Este controlador debe colocarse antes de las calificaciones que, efectivamente, se leen desde la base de datos. También debe colocarse antes de cualquier controlador que necesite conocer la unidad de organización en la que está trabajando (como el controlador que intenta leer la configuración de la unidad de organización).
- Este controlador es uno de los muchos que selecciona una asignación de la unidad de organización. Nunca debe haber más de uno de estos controladores en la configuración activa a la vez.
ReadGradesDisplayTypeDefaultPointsHandler
El controlador ReadGradesDisplayTypeDefaultPointsHandler establece el tipo de visualización de calificaciones en Puntos. Esto afecta la visualización en la IU de exportación de las calificaciones, así como las calificaciones enviadas al SIS.
Implementación
D2L.IM.IPSIS.Default.Grades.Handlers.ReadGradesDisplayTypeDefaultPointsHandler
Comportamiento esperado
Si el tipo de visualización de las calificaciones todavía no se ha establecido, establezca el tipo de visualización de las calificaciones en Puntos.
Comportamiento de error
Si existe un problema durante el procesamiento, se arroja una excepción, junto con información tan detallada como sea posible.
Notas de configuración
- El controlador DisplayTypeDefault debe ejecutarse antes de que las calificaciones reales se recuperen desde la base de datos (es decir, antes de ReadGradesGetGradesForSectionMappingHandler).
- Este controlador DisplayTypeDefault no debe utilizarse junto con cualquier otro controlador DisplayTypeDefault.
ReadGradesDisplayTypeDefaultSymbolsHandler
El controlador ReadGradesDisplayTypeDefaultSymbolsHandler establece el tipo de visualización de calificaciones en Símbolos. Esto afecta la visualización en la IU de exportación de las calificaciones, así como las calificaciones enviadas al SIS.
Implementación
D2L.IM.IPSIS.Default.Grades.Handlers.ReadGradesDisplayTypeDefaultSymbolsHandler
Comportamiento esperado
Si el tipo de visualización de las calificaciones todavía no se ha establecido, el controlador establece el tipo de visualización de las calificaciones en Símbolos.
Comportamiento de error
Si existe un problema durante el procesamiento, se arroja una excepción, junto con información tan detallada como sea posible.
Notas de configuración
- El controlador DisplayTypeDefault debe ejecutarse antes de que las calificaciones reales se recuperen desde la base de datos (es decir, antes de ReadGradesGetGradesForSectionMappingHandler).
- Este controlador DisplayTypeDefault no debe utilizarse junto con cualquier otro controlador DisplayTypeDefault.