Configuración
- En la página Administración de IPSIS, seleccione la pestaña Configuración.
- Configure su integración:
- Revise y edite la configuración y complete las asignaciones.
- Personas
- Instructor y Estudiante son valores predeterminados, pero se pueden eliminar.
- Haga clic en + Agregar rol para agregar nombres de rol específicos de SIS para asignar al rol de Brightspace. Los siguientes son los roles disponibles en OneRoster:
- Administrador
- Ayudante
- Tutor
- Elemento principal
- Supervisor
- Relativo
- Estudiante
- Cursos y secciones
- Los siguientes son los tipos de organización disponibles en OneRoster:
- Nacional
- Estado
- Local
- Distrito
- Escuela
- Después de hacer esto, seleccione Crear sistema de origen.
- Una vez que se crea el sistema de origen, los administradores pueden seleccionar OAuth1a u OAuth2 como el método de autenticación preferido.
- Genere credenciales de SFTP:
- Haga clic en Crear sitio de SFTP.
- Haga clic en Generar contraseña.
- Guardar dirección, nombre de usuario y contraseña
- Se utilizan credenciales de SFTP para cargar archivos.
- La contraseña está oculta y no se puede recuperar una vez que se ha guardado la página. Se puede volver a generar la contraseña; se deberán actualizar las credenciales de SFTP cuando se transfiera un zip al SFTP.
Nota: la autenticación sin contraseña por medio de una clave pública de SSH no se puede configurar en este momento.
- Seleccione Listo.
Se lo redirigirá al panel CSV de OneRoster. El Panel es la página principal de la Interfaz de administración del sistema IPSIS. Para conocer más detalles, haga clic aquí para acceder a la Comunidad Brightspace.
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.
Procesamiento de archivos CSV
Se debe crear un paquete zip de los archivos CSV. Las carpetas zip se pueden cargar a Brightspace de dos maneras:
- Manualmente, arrastrando un archivo zip desde la computadora a la interfaz de usuario de arrastrar y soltar que se encuentra en Administración de IPSIS: Panel
- A través de programación, cargando una carpeta zip que contiene los archivos CSV al sitio del SFTP que se le proporcionó durante la configuración inicial. Brightspace supervisa el sitio de SFTP a intervalos de diez minutos cuando se trata de nuevas carpetas zip.
Copiar contenidos del curso al nuevo curso
Brightspace ofrece la capacidad de copiar el contenido de una unidad de organización existente al crear un nuevo curso.
- En Administración IPSIS: configuración, desplácese hasta Cursos y secciones.
- En Cuando se crea un curso nuevo, ¿copiar contenido desde una unidad de organización existente?, seleccione Sí.
- 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 será copiado desde una oferta de cursos principal a la oferta de cursos secundaria cuando la oferta de cursos y plantilla de cursos principales compartan el mismo código de unidad de organización.
Los archivos no se duplican al copiar un curso.
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á 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 archivos se procesaron adecuadamente. Si se registraron mensajes de error, maximice el error para revisar los metadatos registrados a fin de identificarlo, corregir los datos en su SIS y exportar una nueva carpeta zip con un archivo CSV que solo contenga los cambios necesarios para corregir los errores. El objetivo es que los lotes se completen sin errores.
Errores comunes
- Excepción ArgumentException a la hora de procesar el mensaje.
- Mensaje de excepción: Se suministró una solicitud incorrecta TypeName. No se encontraron las asignaciones para Type:district en el sistema de origen: 27. Nombre del parámetro: TypeName
- Tipo de excepción: System.ArgumentException
- Normalmente, se produce cuando en el sistema de origen faltan asignaciones de tipo de unidad de organización en la UI de configuración y se envía una solicitud de ese tipo.
- Excepción CourseCreationException a la hora de procesar el mensaje.
- Mensaje de excepción: El código no es válido
- Tipo de excepción: D2L.LP.OrgUnits.Courses.CourseCreationException
- Normalmente, se produce cuando la solicitud de clase tiene caracteres no válidos en el campo classCode. Si no se ha proporcionado el classCode, entonces los caracteres no válidos aparecen en el campo de título.
Caracteres no válidos: \ : * ? “ ” < > | ‘ # , % &
- Excepción RoleMappingNotFoundException a la hora de procesar el mensaje.
- Mensaje de excepción: No se encontró la asignación de roles del sistema de origen: OneRoster - Arrastre y suelte el identificador: tutor
- Tipo de excepción: D2L.IM.Platform.Exceptions.RoleMappingNotFoundException
- Normalmente, se produce cuando en el sistema de origen faltan asignaciones de roles en la interfaz de usuario de configuración y se envía una solicitud de ese tipo.
- Excepción DataNotFoundException a la hora de procesar el mensaje.
- Mensaje de excepción: No se encontró RoleMapping para tutor
- Tipo de excepción: D2L.Data.DataNotFoundException
- Normalmente, se produce cuando en el sistema de origen faltan asignaciones de roles en la interfaz de usuario de configuración y se envía una solicitud de ese tipo.
- Excepción DataNotFoundException a la hora de procesar el mensaje.
- Mensaje de excepción: ReplaceEnrollmentReadIMHandler.Process - IMExternalOrgUnitInfo es nulo.
- Tipo de excepción: D2L.Data.DataNotFoundException
- RecordType: inscripción
- Normalmente, se produce cuando un código incorrecto para la clase o el usuario se envía a LMS.
- Excepción JsonReaderException a la hora de procesar el mensaje.
- Mensaje de excepción: No se puede convertir la cadena a DateTime: 4/30/2016T00:00:00.000Z. Ruta “StartDateUtc”, Línea 1, posición 183.
- Tipo de excepción: Newtonsoft.Json.JsonReaderException
- Normalmente, se produce cuando el formato de fecha de uno de los campos Date o DateTime no sigue el formato correcto.
- Formato compatible: aaaa-mm-ddThh:mm:ssZ
- Excepción OrgUnitMappingNotFoundException a la hora de procesar el mensaje.
- Mensaje de excepción: No se encontró la asignación de unidad de organización para el sistema de origen: 27 identificador: ALGO
- Tipo de excepción: D2L.IM.Platform.Exceptions.OrgUnitMappingNotFoundException
- Normalmente, se produce cuando la solicitud tiene un tipo de unidad de organización que no tiene una asignación configurada en el sistema de origen. Ejemplo: se recibe la solicitud para crear un distrito en el sistema de origen, pero no tiene asignado el distrito a nada.