La plataforma Paquete de integración para sistemas de información de estudiantes (IPSIS)
La plataforma Paquete de integración para sistema de información de estudiantes (IPSIS) es una plataforma de integración en Brightspace que consta de componentes comunes y una colección de productos que le permiten importar información del sistema de información de la organización a Brightspace, por ejemplo, la estructura de la organización, los usuarios y la información de inscripción. Una vez que la información se importa a Brightspace, puede seguir actualizando el sistema de información e importar dichos datos a Brightspace mediante la plataforma IPSIS.
Sistemas de información compatibles
La plataforma IPSIS se integra en los siguientes tipos comunes de sistemas de información:
- Sistema de información de estudiantes (SIS): una herramienta de software que las organizaciones educativas utilizan para administrar estudiantes, cursos e inscripciones.
- Sistema de información de recursos humanos (HRIS): una herramienta de software que las organizaciones corporativas utilizan para administrar a los empleados y sus datos.
- Sistema de información de estudiantes (LIS): una herramienta de software que las organizaciones educativas utilizan para administrar el registro de las inscripciones de los estudiantes.
Componentes y productos en la plataforma IPSIS
En la plataforma IPSIS, hay componentes comunes y varios productos con funciones únicas para integrar su sistema de información específico en Brightspace. La colección de componentes y productos es la siguiente:
- CSV estándar de D2L: se utiliza para la integración en los sistemas SIS/HRIS mediante archivos de valores separados por coma (CSV) definidos por D2L.
- ILP de Ellucian: se utiliza para la integración en los sistemas de Banner o Colleague, según las especificaciones de LIS.
- CSV o REST de OneRoster: se utiliza para la integración en sistemas de información K-12 compatibles con la especificación OneRoster de IMS Global Learning Consortium.
- Adaptador LIS v2.0: se utiliza para la integración en sistemas de información compatibles con la especificación LIS de IMS Global Learning Consortium.
- Combinación de cursos del SIS: una interfaz en Brightspace que permite a los instructores combinar y separar varios cursos procesados por IPSIS en una oferta de cursos principal o a partir de esta.
- Interfaz de asociación de sección (UI): una interfaz en Brightspace utilizada para manejar manualmente las relaciones entre los cursos o las secciones que permiten inscripciones en un SIS y las ofertas de cursos en Brightspace.
- Interfaz de administración de IPSIS (IU del administrador): una interfaz de administración en Brightspace que se utiliza para configurar y revisar el estado de las integraciones de SIS en Brightspace.
Acerca de OneRoster 1.1 REST
OneRoster es el IMS estándar diseñado para permitir el intercambio seguro de las listas de clase y los datos relacionados entre un sistema de información de estudiantes (SIS) y cualquier otro sistema. El estándar OneRoster es compatible con la exportación e importación de hojas de cálculo (CSV), así como intercambios directos de sistemas que utilizan las API de REST. Esta guía de administración se enfoca en la especificación REST.
Antes de utilizar OneRoster REST 1.1
D2L es compatible con la especificación IMS OneRoster v1.1 y se vuelve a certificar cada año en la suite de certificación de productos de IMS Global. D2L es compatible con las siguientes certificaciones de conformidad:
- REST Data Provider Gradebook Push Core
- REST Data Consumer Rostering Core
La implementación de Brightspace de la especificación OneRoster v1.1 permite a los administradores programar los datos que se sacarán de su SIS para completar los datos relacionados con la lista (escuelas, clases, usuarios, inscripciones, etc.) en la plataforma de Brightspace. La nueva interfaz de usuario de IPSIS OneRoster REST incluye una programación que permite a los administradores configurar la hora del día en que se realiza la extracción de datos. Además, para un socio de SIS que admita el servicio de Cuaderno de calificaciones, los administradores pueden configurar las calificaciones para que se devuelvan con la sincronización diaria de datos o permitir que un miembro del cuerpo docente inicie una sincronización manual.
Extremos utilizados
| Tipo |
Dirección URL |
|---|
| GET |
ims/oneroster/v1p1/academicSessions |
| GET |
ims/oneroster/v1p1/classes |
| GET |
ims/oneroster/v1p1/enrollments |
| GET |
ims/oneroster/v1p1/orgs |
| GET |
ims/oneroster/v1p1/orgs/{id} |
| GET |
ims/oneroster/v1p1/schools/{id} |
| GET |
ims/oneroster/v1p1/schools/{id}/classes |
| GET |
ims/oneroster/v1p1/schools/{id}/courses |
| GET |
ims/oneroster/v1p1/schools/{id}/enrollments |
| GET |
ims/oneroster/v1p1/users |
| GET |
ims/oneroster/v1p1/categories (se requieren +metadatos) |
| PUT |
ims/oneroster/v1p1/categories (IC) |
| PUT |
ims/oneroster/v1p1/lineitems |
| PUT |
ims/oneroster/v1p1/results |
Cómo se asigna OneRoster REST a Brightspace
Valores de asignación generales
A continuación, se muestran los valores de asignación entre un tipo de objeto de OneRoster y un tipo de objeto de Brightspace
| OneRoster |
D2L Brightspace |
|---|
| Sesiones académicas |
Unidades de organización* |
| Organizaciones |
Unidades de organización* |
| Escuelas |
Unidades de organización* |
| Cursos |
Plantilla de curso |
| Clases |
Oferta de cursos y sección del curso |
| Usuarios |
User |
| Inscripciones |
Inscripción |
| LineItems |
Elemento de calificación |
| Resultados |
Valor de calificación |
* Los tipos de unidad de organización, por lo general, son tipos de unidades de organización personalizados que se pueden asignar durante el proceso de configuración.
Sesiones académicas
| OneRoster |
Valores admitidos |
Utilizado por Brightspace para |
Obligatorio |
|---|
| sourcedId |
|
N/A |
Sí |
| status |
active o tobedeleted (activo o para eliminar) |
Crear, Reemplazar o Eliminar |
Sí |
| dateLastModified |
YYYY-MM-DDTHH:mm:SS.sssZ |
N/A |
Sí |
| metadatos |
N/A |
N/A |
|
| título |
|
Nombre de la unidad de organización y código de la unidad de organización |
Sí |
| StartDate |
AAAA-MM-DD |
Expuestos para la sesión académica en el cuaderno de calificaciones |
Sí |
| EndDate |
AAAA-MM-DD |
Expuestos para la sesión académica en el cuaderno de calificaciones |
Sí |
| type |
|
Tipo de unidad de organización |
Sí |
| Elemento principal |
N/A |
N/A |
N/A |
| Niños |
N/A |
N/A |
N/A |
| SchoolYear |
N/A |
N/A |
N/A |
Organizaciones
| OneRoster |
Valores admitidos |
Utilizado por Brightspace para |
Obligatorio |
|---|
| SourcedId |
|
N/A |
Sí |
| Estado |
active o tobedeleted (activo o para eliminar) |
Reemplazar o Eliminar |
Sí |
| Fecha de última modificación |
YYYY-MM-DDTHH:mm:SS.sssZ |
N/A |
Sí |
| MetaData |
N/A |
N/A |
|
| Nombre |
|
Nombre de la unidad de organización y código de la unidad de organización |
Sí |
| Identificador |
|
Código de la unidad de organización (si lo hubiera) |
No |
| StartDate |
AAAA-MM-DD |
N/A |
Sí |
| EndDate |
AAAA-MM-DD |
N/A |
Sí |
| Tipo |
|
Tipo de unidad de organización |
Sí |
| Elemento principal |
|
Unidades de organización principales |
Necesario para crear la estructura organizativa |
| Niños |
N/A |
N/A |
N/A |
Cursos
| OneRoster |
Valores admitidos |
Utilizado por Brightspace para |
Obligatorio |
|---|
| SourcedId |
|
N/A |
Sí |
| Estado |
active o tobedeleted (activo o para eliminar) |
Activo |
Sí |
| Fecha de última modificación |
YYYY-MM-DDTHH:mm:SS.sssZ |
N/A |
Sí |
| MetaData |
N/A |
N/A |
|
| Título |
|
Nombre de la unidad de organización y código de la unidad de organización |
Sí |
| SchoolYear |
|
Unidades de organización principales |
No |
| Código del curso |
|
Código de la unidad de organización (si lo hubiera) |
No |
| Calificaciones |
N/A |
N/A |
|
| Asuntos |
N/A |
N/A |
|
| Org |
|
Unidades de organización principales |
No |
| StartDate |
AAAA-MM-DD |
N/A |
|
| EndDate |
AAAA-MM-DD |
N/A |
|
| SubjectCodes |
N/A |
N/A |
|
| Recursos |
N/A |
N/A |
|
Clases
| OneRoster |
Valores admitidos |
Utilizado por Brightspace para |
Obligatorio |
|---|
| SourcedId |
|
N/A |
Sí |
| Estado |
active o tobedeleted (activo o para eliminar) |
Activo o inactivo |
Sí |
| Fecha de última modificación |
YYYY-MM-DDTHH:mm:SS.sssZ |
N/A |
Sí |
| MetaData |
No asignado |
| Título |
|
Nombre de la unidad de organización y código de la unidad de organización |
Sí |
| ClassCode |
|
Código de la unidad de organización (si lo hubiera) |
No |
| ClassType |
N/A |
| Ubicación |
N/A |
| Calificaciones |
N/A |
| Asuntos |
N/A |
| Curso |
|
Unidades de organización principales |
Sí |
| Escuela |
|
Unidades de organización principales |
Sí |
| Términos |
|
Unidades de organización principales |
Sí |
| SubjectCodes |
N/A |
| Períodos |
N/A |
| Recursos |
N/A |
Usuarios
| OneRoster |
Valores admitidos |
Utilizado por Brightspace para |
Obligatorio |
|---|
| SourcedId |
|
OrgDefinedId |
Sí |
| Estado |
active o tobedeleted (activo o para eliminar) |
IsActive |
Sí |
| Fecha de última modificación |
YYYY-MM-DDTHH:mm:SS.sssZ |
N/A |
Sí |
| MetaData |
No asignado |
| UserName |
|
UserName |
Sí |
| UserIds |
No asignado |
| EnabledUser |
|
IsActive |
Sí |
| GivenName |
|
FirstName |
Sí |
| FamilyName |
|
LastName |
Sí |
| MiddleName |
|
MiddleName |
No |
| Rol |
|
Rol en la organización |
Sí |
| Identificador |
|
OrgDefinedId (si lo hubiera) |
No |
| Correo electrónico |
|
ExternalEmail |
No |
| Sms |
|
N/A |
No |
| Teléfono |
|
N/A |
No |
| Agentes |
|
Brightspace Parent & Guardian |
No |
| Organizaciones |
Inscripciones en la unidad de organización superior (con rol en la organización) |
| Calificaciones |
N/A |
| Contraseña |
|
Contraseña del usuario |
No |
Inscripciones
| OneRoster |
Valores admitidos |
Utilizado por Brightspace para |
Obligatorio |
|---|
| SourcedId |
|
N/A |
Sí |
| Estado |
active o tobedeleted (activo o para eliminar) |
Activo |
Sí |
| Fecha de última modificación |
YYYY-MM-DDTHH:mm:SS.sssZ |
|
Sí |
| MetaData |
N/A |
| User |
|
Usuario que se inscribirá |
Sí |
| Clase |
|
Oferta de cursos y Sección para inscribirse |
Sí |
| Escuela |
N/A |
| Rol |
|
Rol |
Sí |
| Principal |
N/A |
| BeginDate |
N/A |
| EndDate |
N/A |
Supuestos y limitaciones
Supuestos.
D2L puede trabajar con cualquier SIS compatible con OneRoster 1.1 REST y que cuente con la certificación de IMS Global o esté trabajando para obtenerla.
Proceso de REST
- Las ejecuciones programadas se llevan a cabo a partir de la fecha de ejecución anterior del extracto de datos y hasta la fecha de inicio del extracto de datos actual. Si esta es la primera ejecución, actúa como una operación de sincronización y se ejecuta sin fecha de inicio hasta el rango de fechas.
- Existe una opción para activar de forma manual una ejecución desde la fecha de ejecución anterior, desde una fecha específica o para todos los registros del sistema
- Orden de llamada: el orden en el que se llaman los distintos extremos o en que se consumen los diversos archivos.
Escuelas
Sesiones académicas
Organizaciones
Cursos
Clases
Usuarios
Inscripciones
- El orden en que los datos se envían de vuelta a Infinite Campus
- Lineitems (enviados a petición o por la noche según los permisos de exportación de calificaciones)
- Resultados (enviados a petición o por la noche según los permisos de exportación de calificaciones)
Exportación de calificaciones
Para que se exporte una calificación, el curso se debe haber creado a través de OneRoster, y el sistema de origen OneRoster IPSIS debe tener activada la exportación de calificaciones. El curso solo se puede asignar a un sistema de origen activo con calificaciones. Las calificaciones deben pertenecer a las Categorías de calificación que tengan marcada la opción “Exportar a SIS” y la calificación debe tener seleccionada una Sesión académica.
Sesiones académicas
El menú desplegable de Sesión académica está visible cuando crea un elemento de calificación nuevo El menú se completa buscando todas las unidades de organización creadas por el mismo SIS del curso en el que la asignación de SIS sea de la Sesión académica. La Sesión académica debe ser un elemento principal de la oferta de cursos.
Categorías
Infinite Campus no admite Categorías; sin embargo, en Brightspace sigue siendo necesaria una Categoría. Esta categoría se utiliza para vincular elementos de calificación para que Brightspace sepa qué elementos de calificación se deben enviar y cuáles no.
Cómo funciona la sincronización de calificaciones
Los elementos de calificación (elementos de línea) se sincronizan si cumplen con cualquiera de las siguientes condiciones:
- El elemento de línea nunca se ha enviado.
- El elemento de línea se actualizó desde su último envío (esto incluye nombre, sesión académica, puntos, eliminación, restauración después de una eliminación).
- El elemento de línea no se pudo enviar durante la última exportación.
- Los elementos de línea utilizan las fechas finales de la sesión académica asociada a la calificación; la fecha final se envía tanto para la fecha de asignación como para la fecha de vencimiento.
Nota: El ID de origen del artículo de línea que se envía es específico de la clase y se genera de la siguiente manera: {lineItemSourcedId}_{classSourcedId}
Las calificaciones (resultados) se sincronizan si cumplen con cualquiera de las siguientes condiciones:
Nota: El ID de origen del artículo de línea que se envía es específico de la clase y se genera de la siguiente manera: {lineItemSourcedId}_{classSourcedId}
Las calificaciones (resultados) se sincronizan si cumplen con cualquiera de las siguientes condiciones:
- El resultado nunca se ha enviado.
- El resultado se actualizó desde su último envío.
- El resultado no se pudo enviar durante la última exportación.
- El elemento de línea principal se modificó desde la última exportación.
Nota: Los elementos de línea y los resultados que se enviaron al SIS como eliminados no aparecen en la interfaz de usuario del Historial de exportación.
Limitaciones
- Los registros con un estado de tobedeleted solo se eliminan si se elimina el elemento secundario.
- Las inscripciones en las unidades de organización superiores que se crearon antes de la versión de junio de 2024/20.24.6 no pueden anularse mediante la integración de OneRoster.
- Las inscripciones que se crearon manualmente en Brightspace no se pueden anular mediante la integración de OneRoster.
- Caracteres no admitidos: hay varios caracteres que no se admiten en el Código de la unidad de organización Brightspace. Estos caracteres se reemplazan con un guion bajo (_). Caracteres no admitidos: \ : * ? “ ” < > | ‘ # , % &
- Truncados: la longitud máxima del Código de unidad de organización en Brightspace es de 50 caracteres. Si supera esta longitud, se trunca en la interfaz de usuario.
- OneRoster permite varios ScoreStatus: Brightspace solo envía una calificación completa o exenta
Opciones de configuración para OneRoster REST
Trabajará con su consultor de implementación de Brightspace para configurar su sistema de origen OneRoster REST. Brightspace se establece de manera automática en su configuración más común. Sin embargo, esta configuración se puede editar en cualquier momento con los permisos correspondientes.
Antes de configurar el sistema de origen, asegúrese de haber completado los siguientes elementos:
Requisitos generales
Comuníquese con su representante de Infinite Campus para obtener información de la API. Necesitará:
- URL terminal
- Clave del consumidor
- Contraseña secreta del consumidor
Configuración
Después de la configuración inicial, puede actualizar la configuración de su sistema de origen OneRoster REST:
- En el menú Herramientas de administración, seleccione Administración del Paquete de integración para sistema de información de estudiantes y la pestaña Configuración.
- Las credenciales proporcionadas durante la configuración inicial aparecerán primero; estas credenciales se pueden editar en caso necesario. (Infinite Campus admite OAuth1.0a y OAuth Signature HMAC-SHA256).
- Sistema de origen
- Nombre de SIS: el campo Nombre de SIS es editable y se recomienda que se mantenga actualizado.
- Actualizaciones programadas: la hora en que Brightspace se sincronizará automáticamente con SIS. Se recomienda completar este proceso durante la noche.
- Sobrescritura en Brightspace: opciones granulares para identificar qué campos de Brightspace puede sobrescribir su SIS.
- Personas
- Asignaciones de roles del SIS: esta sección contiene el rol específico de OneRoster para asignar nombres de roles del SIS a los nombres de roles de Brightspace. Los roles de profesor y estudiante están incluidos de manera predeterminada, pero se pueden eliminar. Los siguientes son los roles disponibles en OneRoster:
- Administrador
- Ayudante
- Tutor
- Elemento principal
- Supervisor
- Relativo
- Estudiante
- Profesor
Para agregar nombres de rol del Sistema de información de estudiantes adicionales a fin de asignarlos a los roles de Brightspace, haga clic en + Agregar rol.Nota: Si SIS envía un rol que no está configurado, se produce un error y no se puede crear el usuario.
- Asignar entradas de SIS a usuarios existentes: proporciona la opción de asignar entradas SIS basadas en el nombre de usuario u OrgDefinedId a los usuarios existentes que se crearon fuera del SIS (manualmente, operaciones por lote, API, etc.). Si las asignaciones están desactivadas, se pueden crear duplicados.
- Cursos y secciones
- Cursos y secciones: Asignaciones: esta sección contiene los tipos de unidades de organización específicas de OneRoster para asignar las organizaciones SIS a los nombres de las organizaciones de Brightspace.
- Haga clic en + Agregar tipo de unidad de organización para agregar más nombres de unidad de organización específicos de SIS. Se requieren los siguientes tipos de unidad de organización para Infinite Campus:
- Organizaciones de SIS
- Tipo de sesión académica
- Semestre
- Término
- SchoolYear
- GradingPeriod
- Grupo SIS
- Oferta de cursos
- Sección de curso
- Plantilla de curso
- Asociación de sección
- Eliminación: proporciona tres opciones sobre cómo afecta un estado tobedeleted a una unidad de organización en Brightspace.
- No hacer nada: la asignación de unidad de organización se eliminará de las asignaciones de IPSIS, pero la unidad de organización permanecerá sin cambios en Brightspace.
- Desactivar oferta de cursos: la asignación de unidad de organización se eliminará de las asignaciones de IPSIS; la oferta de cursos se marcará como inactiva en Brightspace, la sección y las inscripciones se mantendrán.
- Contenido del curso: proporciona la capacidad de copiar el contenido del curso desde un curso principal o una plantilla al curso recién creado. Seleccione Sí y elija una de las siguientes opciones:
- Plantilla principal del curso nuevo
- Se copiará el contenido de la plantilla principal del curso a la nueva oferta de cursos secundaria.
- Curso relacionado en el cual el código de unidad de organización coincide con la plantilla principal
- El contenido se copia de una oferta de cursos principal a la oferta de cursos secundaria cuando la oferta de cursos principal y la plantilla de cursos comparten el mismo código de unidad de organización.
- Anular inscripción: ofrece la opción de anular la inscripción de usuarios desde las secciones y cursos basados en la Fecha final de la inscripción proporcionada por el Sistema de información de estudiantes, y la opción de anular la inscripción de usuarios de las organizaciones de SIS si ya no están asociados con ellos dentro del SIS.
- Exportación de calificaciones
- Proporciona la opción de permitir la sincronización de calificaciones de todos los elementos de calificación modificados en el momento de la actualización programada o de permitir la exportación de calificaciones iniciada por el profesor desde la oferta de cursos.
- Una vez que haya finalizado, seleccione Guardar configuración.
Solución de problemas
El Panel brinda el estado de procesamiento del último lote. Tanto la página del Panel como la de Lotes mostrarán un indicador final si el lote se completó correctamente o con errores. Cada lote tiene un enlace rápido al Registro de auditoría y, si se completa con errores, un enlace a los Mensajes de error.
Revise todos los registros para comprobar que los extremos se procesaron adecuadamente. Si se registraron mensajes de error, expanda el error para revisar los metadatos capturados a fin de identificar el error, corrija los datos en su SIS y espere hasta el día siguiente para la actualización programada o solicite una actualización desde el Panel. El objetivo es que las ejecuciones se completen sin errores.
Cómo sincronizar las calificaciones
Las calificaciones se pueden configurar para que se sincronicen todas las noches con la actualización diaria de la lista, por solicitud a través de la interfaz de calificaciones o de ambos modos. Estas opciones se configuran en Administración de IPSIS > Configuración > Exportar calificaciones.
Para enviar calificaciones, se requieren una categoría, un elemento de calificación y una calificación. Consulte la sección Exportación de calificaciones para ver las reglas generales para enviar una calificación.
Creación de una categoría
- En la página de inicio del curso, desplácese hasta Calificaciones.
- En el área de Administrar calificaciones, en el botón Nuevo, haga clic en Categoría.
- Establezca las preferencias y opciones de la categoría deseadas.
- Haga clic en Exportar a SIS para indicar que todos los elementos de línea asociados a esta categoría se deben sincronizar con el SIS.
- Haga clic en Guardar y cerrar.
Crear un elemento de calificación
- En el área Administrar calificaciones, haga clic en Nuevo y seleccione Elemento.
- Establezca las preferencias y opciones de la categoría deseadas.
- Seleccione una sesión académica en el menú desplegable.
- Asigne el elemento de calificación a la Categoría sincronizada con el SIS.
- Haga clic en Guardar y cerrar.
Exportar a sistema de información estudiantil
Para sincronizar manualmente las calificaciones con SIS, haga lo siguiente:
- En la página de inicio del curso, vaya a Calificaciones – Ingresar calificaciones – Exportar al SIS
- En la interfaz de usuario de Exportar calificaciones, se le mostrará una página de resumen que incluye:
- Sección: un menú desplegable que le permite elegir entre diferentes secciones del curso (si hay varias secciones presentes).
- Sección académica: un menú desplegable que le permite elegir entre diferentes Años escolares asociados con el curso (si se utilizaron varias secciones académicas).
- Descripción general: enumera la cantidad de categorías y la cantidad de calificaciones dentro de las categorías que cumplen con los criterios seleccionados anteriormente en la Sección y Sesión académica y que se pueden exportar.
- Exportación programada: solo es visible si está establecida en la configuración de Integración de SIS y se puede editar en la pestaña Configuración en Administración de IPSIS.
- Haga clic en Exportar. La página se actualiza y lo lleva a la página Ver todas las exportaciones. Esta interfaz de usuario proporciona una descripción general de quién envió las calificaciones y cuándo.
- Una vez que se haya completado la exportación, haga clic en el Nombre de exportación para ver los detalles que incluyen: nombre del curso, fechas de inicio y final de la exportación y el usuario que inició la exportación.
Nota: Si las calificaciones se envían a través de la sincronización nocturna, se muestra al usuario del servicio IPSIS.
- Detalles de exportación correcta e incorrecta de Categorías, Elementos de calificación y Resultados:
- Puede volver a las exportaciones históricas a través de Calificaciones > Ingresar calificaciones > Exportar a SIS y haciendo clic en Ver historial de exportación en la parte superior derecha.
Utilice la información de la sesión académica para las fechas de inicio y final del curso.
En la página de administración del IPSIS, la casilla de selección Usar las fechas de ofertas de cursos le permite usar información académica de la sesión para las fechas de inicio y final de las ofertas de cursos. Esta casilla de selección se encuentra desactivada de manera predeterminada. Esta opción le permite elegir si las fechas de las sesiones académicas (semestre, período, año escolar o período de calificación) están asociadas a la oferta de cursos (esta opción se establece de forma predeterminada en el período). La fecha de inicio y la fecha final de un curso también pueden trasladarse un número específico de días. Si hay varias sesiones académicas configuradas para una sola oferta de cursos, la primera sesión académica recibida del SIS se usará para las fechas de inicio y final.