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/users
|
Cómo se asigna OneRoster REST a Brightspace
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 |
* 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 |
Exposición para la sesión académica en el cuaderno de calificaciones y la oferta de cursos |
Sí |
| EndDate |
AAAA-MM-DD |
Exposición para la sesión académica en el cuaderno de calificaciones y la oferta de cursos |
Sí |
| type |
Semestre, Trimestre, Período de calificación, Año escolar |
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 |
Distrito, Departamento, Local, Nacional, Escuela, Estado |
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 |
Necesario para crear la estructura organizativa |
| 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.
Sesiones académicas
Organizaciones
- Escuelas
Cursos
Clases
Usuarios
Inscripciones
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.
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 OneRoster para obtener información de su API. Necesitará:
- URL terminal
- Clave del consumidor
- Contraseña secreta del consumidor
- Método de firma de OAuth: SHA-256
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 de IPSIS 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.
- Campos del 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 ClassLink:
- Organizaciones de SIS
- Distrito
- Escuela
- Los campos Local, Nacional, Estado y Departamento son opcionales
- 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 dos 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.
- Asignar entradas del SIS a cursos y secciones: proporciona la opción de asignar entradas del SIS basadas en el código de unidad de organización a las unidades de organizaciones existentes que se crearon fuera del SIS (manualmente, operaciones por lote, API, etc.). No se recomienda activarlos para ninguna unidad de organización creada por su SIS, a menos que confirme que los códigos sean únicos en las escuelas y años escolares. Si no son únicos, el SIS puede sobrescribir las unidades de organización existentes con datos de otras unidades de organizació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:
- Si ¿Buscar una unidad de organización desde la cual copiar automáticamente según los criterios especificados? no está seleccionado, 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.
- Si ¿Buscar una unidad de organización desde la cual copiar automáticamente según los criterios especificados? está seleccionado, puede elegir entre dos opciones:
- Plantilla principal del curso nuevo
- Se copiará el contenido de la plantilla principal del curso a la nueva oferta de cursos secundaria.
- Curso secundario en el cual el código de la unidad de organización coincide con la plantilla principal. El contenido se copia desde la oferta de cursos de origen a la nueva oferta de cursos secundaria, en función del curso de origen que se agrega manualmente a Brightspace con el mismo código de unidad de organización que la plantilla principal.
- Fechas de oferta de cursos: Le permite utilizar la información de la sesión académica para las fechas de inicio y final de la oferta 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.
- 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.
- Departamentos, semestres y otros:
Asignar entradas del SIS a unidades de organización existentes: proporciona la opción de asignar entradas del SIS basadas en el código de unidad de organización a las unidades de organizaciones existentes que se crearon fuera del SIS (manualmente, operaciones por lote, API, etc.). No se recomienda activarlos para ninguna unidad de organización creada por su SIS, a menos que confirme que los códigos sean únicos en las escuelas y años escolares.
- Una vez que haya finalizado, seleccione Guardar configuración.
- Cuando esté listo para sincronizar datos. Vaya a Administración de IPSIS: Panel, seleccione la flecha hacia abajo junto a Ejecutar actualización ahora: Volver a sincronizar todos los registros de SIS para sincronizar los datos seleccionados de ClassLink.
Nota: es posible que deba hacer esto dos veces si ClassLink envía el distrito después de enviar las escuelas en el punto final de la organización (se espera que el distrito se envíe primero).
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 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.