DSI (Delegated SIS Integrator)
Introducción
El integrador SIS delegado es una herramienta de administración en Blackboard Learn, que permite que usuarios no administradores (seleccionados mediante roles institucionales) puedan realizar algunas de las acciones de la integración SIS de manera autonoma mediante la subida de ficheros de texto plano. Estas acciones son:
- Gestión de usuarios
- Gestión de cursos
- Gestión de inscripciones
- Gestión de periodos.
Esta aplicación permite proporcionar autonomía en la gestión de la integración a usuarios o instituciones especificos dentro de Blackboard Learn sin comprometer la integridad de los datos de la instancia.
¿Necesitas mas información? ¿Quieres una demo?
Escribenos y nos podremos en contacto contigo agenda una demo.
Configuración previa
La aplicación funciona en base a roles institucionales y Data Source Keys (DSK) en Blackboard Learn.
Un DSK es una "etiqueta de datos" que permite que se puedan realizar operaciones de integración que solo afecten a un conjunto de registros, preservando la integridad del resto de datos de la instancia de Blackboard Learn.
Una vez instalada la aplicación es necesario comunicar al equipo de eLearning Media un listado de roles institucionales y DSK (Data Source Keys) asociados, esto permitirá a los usuarios con dichos roles el acceso a la herramienta, a través de la cual podran subir ficheros de integración a los DSK a los que tengan acceso.
Los roles y DSK deben ser creados por el cliente en Blackboard Learn de manera previa al uso de la herramienta. Es posible que un mismo usuario tenga acceso a varios DSK de integración configurando varios roles institucionales como roles secundarios.
Acceso a la herramienta
El acceso a la herramienta puede habilitarse desde varios puntos (placements) dentro de la plataforma. Estos son:
- Acceso desde el menu de administración, desde herramientas y utilidades. Este acceso es ideal para usuarios que tienen acceso al panel de administración.
- Acceso desde herramientas en el menu principal de la plataforma. Este acceso es ideal para usuarios que no tienen acceso al panel de administración.
Vista general de la aplicación
La interfaz de la aplicación permite la subida de ficheros de integración a un DSK configurado previamente, en caso de existir varios, se deberá marcar aquel sobre el que se pretenda operar.
En la parte inferior de la aplicación se encuentran disponibles las plantillas de los ficheros con los campos necesarios para entidad (usuarios, cursos, inscripciones, periodos)
Cada archivo, una vez relleno, debe subirse en el apartado correspondiente, pulsando el boton de cargar. Los administradores reciben un mensaje de confirmación de la carga de los archivos, que se procesan a través del SIS integration Framework.
El codigo de confirmación permite realizar una llamada al endpoint SIS Logs de Blackboard, para comprobar el detalle del resultado de la integración (/learn/api/public/v1/logs/sis/dataSets/{id})
Campos de las plantillas
Usuarios
Se deben especificar los siguientes campos
- EXTERNAL_PERSON_KEY - Campo obligatorio. Identificador unico externo del usuario.
- USER_ID - Campo obligatorio. ID del usuario empleado para hacer login en la plataforma.
- FIRSTNAME - Campo obligatorio. Nombre del usuario.
- LASTNAME - Campo obligatorio. Apellidos del usuario.
- EMAIL - Email del usuario.
- ROW_STATUS - Estado de disponibilidad del usuario, los valores incluyen enabled/disabled.
- AVAILABLE_IND - Campo Boleano que indica si el registro esta disponible.
Cursos
Se deben especificar los siguientes campos:
- EXTERNAL_COURSE_KEY - Campo obligatorio. Identificador unico externo del curso.
- COURSE_ID - Campo obligatorio. ID corto del curso.
- COURSE_NAME - Campo obligatorio. Nomnbre del curso.
- TEMPLATE_COURSE_KEY - Identificador externo de un curso cuyos contenidos se copiaran en el curso que se esta creando.
- AVAILABLE_IND - Campo Boleano que indica si el registro esta disponible.
- TERM_KEY - Identificador externo del periodo (TERM) con el que se asocia.
- EXTERNAL_ASSOCIATION_KEY - Identificador del nodo de la jerarquia institucional con el que asociar este curso.
- PRIMARY_EXTERNAL_NODE_KEY - Nodo de la jerarquia institucional desde el que se heredaran las configuraciones iniciales del curso.
Inscripciones
Se deben especificar los siguientes campos:
- EXTERNAL_COURSE_KEY - Campo obligatorio. Identificador externo del curso donde se va a inscribir al alumno.
- EXTERNAL_PERSON_KEY - Campo obligatorio. Identificador externo del alumno que se va a inscribir en el curso.
- ROLE- Campo obligatorio.Rol del alumno en el curso.
- ROW_STATUS - Estado de disponibilidad del usuario, los valores incluyen enabled/disabled.
- AVAILABLE_IND - Campo Boleano que indica si el registro esta disponible.
Periodos
Se deben especificar los siguientes campos
- EXTERNAL_TERM_KEY - Campo obligatorio. Identificador externo del periodo.
- NAME - Campo obligatorio. Nombre del periodo.
¡Ayúdanos a mejorar! ¿Tienes sugerencias o mejoras sobre esta documentación? ¡Escríbenos!