Es posible que ya se hayan realizado inversiones en procesos de integración SIS en el campus. Si es así, puede seguir usando los procesos de integración existentes como siempre y evaluar, a la vez, la adopción de los tipos de integración del marco de trabajo de integración LIS. Sin embargo, es importante tener en cuenta que a medida que Learn evolucione, los procesos de integración heredados dejarán de ser compatibles con los objetos más nuevos introducidos en favor de las nuevas características y funciones de Learn.
Acerca de la integración SIS y el marco de trabajo de integración SIS de Learn
La integración del sistema de información de alumnos (SIS) ayuda a los administradores a incorporar los datos de cursos, usuarios e inscripciones a Blackboard Learn. Los datos pueden proceder de diferentes fuentes en formatos variados. La integración SIS ofrece un método sencillo para actualizar Blackboard Learn desde otro sistema de administración de aprendizaje (LMS, Learning Management System), como CET o Vista, ya que admite el mismo formato de fuente de datos generado por esos sistemas para el intercambio de datos. La integración SIS también permite que las actualizaciones del sistema se deleguen a otros administradores de Blackboard y esto flexibiliza su integración en el sistema.
El marco de trabajo de integración SIS es un marco ampliable en Building Blocks que proporciona una funcionalidad común para todas las integraciones y facilita, a la vez, la creación, la configuración y la administración de la integración en la interfaz de usuario del Panel del administrador de Blackboard Learn. El principio se basa en una separación de funcionalidades. El marco de trabajo SIS proporciona las funciones de creación, configuración y operación/mantenimiento basadas en la interfaz del usuario y los tipos de integración (basados en Building Blocks) para proporcionar la lógica específica a cada tipo de integración SIS. Esto permite que el marco de trabajo SIS admita un enfoque de combinación de elementos ante la integración, pero permitiendo también varias instancias de un tipo de integración. Esto proporciona mucha flexibilidad a la hora de crear soluciones de integración SIS, ya que permite responder a las necesidades de integración, desde las más sencillas hasta las más complejas.
Más información sobre los tipos de integración SIS
Una función adicional disponible para todos los tipos de integración es la asignación de datos al momento. Mediante esta función, los objetos de datos entrantes se pueden asignar de forma personalizada a objetos de datos de Blackboard Learn y esta asignación permite aplicar scripts personalizados basados en JavaScript a los datos entrantes. En el caso de un tipo de integración Archivo de instantánea sin formato, puede aplicar asignaciones de encabezado personalizadas para que los formatos de datos existentes coincidan con los formatos de Blackboard. Dispone de más información sobre la asignación personalizada para cada tipo de integración en la sección de ejemplos de cada tipo.
Planificación
Las integraciones SIS ofrecen ventajas muy importantes a la hora de introducir datos en Blackboard Learn para rellenar y actualizar automáticamente el sistema. La primera es que la gestión de los datos de cursos y usuarios se puede delegar a uno o varios administradores, que no necesitan acceder mediante línea de comandos a los servidores de Blackboard. Otra ventaja es que los datos se pueden transferir de manera rápida y eficaz del sistema de información a Learn.
Es esencial implicar a todos los interesados en el proceso de planificación de la integración; aprovechar la participación de los equipos de administración de SIS, secretaría y de Learn garantizará que la integración se complete correctamente.
Una buena integración requiere conocer bien las opciones de configuración de SIS, seleccionar el tipo de integración de Learn que mejor se ajuste a sus necesidades y entender bien los requisitos de los datos para el tipo de integración. En el caso de los tipos de integración Instantánea y Enterprise 1.1, también es necesario entender el scripting del servidor para facilitar la transferencia de los datos a los extremos de la integración.
Más información sobre la planificación de las integraciones SIS
Servicios de asesoramiento
Una asociación de servicios con Blackboard Consulting puede ayudarlo a planificar, ampliar y actualizar sus integraciones. Blackboard Consulting ofrece un programa integral de integraciones que se ajusta a sus necesidades.
Asesoramiento para el marco de trabajo de la integración SIS
El objetivo de este servicio de asesoramiento es ayudar a los clientes con la implementación del marco de trabajo de integración SIS de Blackboard Learn. Este servicio, completamente remoto, proporciona a su distrito consultoría para orientarlo en lo referente a los elementos de datos básicos, la configuración, la limpieza de los datos, las técnicas de scripting y la resolución de problemas.
Proyectos
- Asignar un consultor remoto a su institución durante todo el proyecto.
- Identificar los elementos de datos básicos, los comportamientos y las reglas empresariales para automatizar los procesos de creación de cuentas de usuario y cursos, de inscripción y de asignación de personal docente / otro personal a los cursos.
- Documentación de las decisiones relativas a los elementos de datos clave en un libro de trabajo de planificación de los datos para que el cliente pueda usarlo posteriormente.
- Proporcionar orientación en todo lo relacionado con la configuración del marco de trabajo de integración SIS para satisfacer los requisitos de documentación de datos.
- Ayudarle en la limpieza de los datos de las cuentas de usuario existentes en el entorno de Blackboard Learn para garantizar que sean compatibles con un entorno automatizado e integrado.
- Proporcionar información general sobre las técnicas básicas de creación de secuencias de comandos que se utilizarán para transformar los datos en la herramienta del marco de trabajo de integración SIS.
- Revisión de las técnicas de solución de problemas en caso de incidencias con los datos y la integración.
- Revisar la administración del ciclo de vida de los datos y la información general sobre prácticas recomendadas para archivar y borrar los datos de Blackboard.
- Realizar la configuración inicial de los artefactos del programa del marco de trabajo de integración SIS:
- Documentación de los requisitos del proceso empresarial (libro de trabajo de planificación de los datos)
- Documentación de configuración de la integración (libro de trabajo de operaciones)
- documentación y materiales de referencia del producto central de Blackboard Learn.
Dé un paso más
Póngase en contacto con el representante de ventas de Blackboard para concertar una cita para tratar las opciones recomendadas y los siguientes pasos. Céntrese en implicar y ayudar a los alumnos, y olvídese de la complejidad de la integración de datos. Deje que Blackboard Consulting le ayude.
El servicio de asesoramiento para el marco de trabajo de la integración SIS, incluido en los servicios de consultoría, le proporcionará toda la asistencia necesaria para automatizar la transferencia de toda la información de los usuarios, los cursos y las inscripciones de un sistema de origen (como SIS, MLS, HR, ERP u otro sistema de registro) a Blackboard Learn. EL personal de consultoría trabajará con usted para identificar los elementos de datos, los comportamientos y las reglas empresariales clave.
Cómo funciona el marco de trabajo de integración SIS
Dejando aparte las opciones de configuración y los tipos de datos de la integración (que se tratan en las secciones específicas de cada tipo de integración), el funcionamiento del marco de trabajo de integración SIS se basa en cuatro conceptos clave:
- Formato de los datos
- Transferencia de datos
- Propiedad de los datos
- Procesamiento de los datos
En resumen, cada instancia configurada según un tipo de integración recibe los datos con el formato adecuado de acuerdo con los requisitos de la integración (1) para transferirlos a Learn mediante un conjunto de servicios específicos de la integración (2) con un identificador único para cada instancia de la integración configurada que controle la propiedad de los datos (3) para que el marco de trabajo SIS de Learn los procese (4).
Todos estos pasos presentan conceptos importantes para entender cómo funciona el marco de trabajo de integración SIS, para determinar la mejor configuración según las características de la integración y para crear la mejor estructura de integración posible en el marco de trabajo de integración SIS.
Formato de la fecha
Cada tipo de integración de datos requiere un formato de datos específico. Por ello, los datos de Enterprise 1.1 son distintos de los de Enterprise 1.1 Vista, que a su vez requiere una integración diferente de la del archivo de instantánea sin formato y LIS. Conocer todos estos formatos de datos proporciona información no solo de los tipos de objetos admitidos por la integración asociada, sino también de la sintaxis de asignación personalizada correspondiente al tipo de integración.
La integración de los formatos de los datos se trata en profundidad en los temas correspondientes a cada tipo de integración específico.
Transferencia de los datos
Cada tipo de integración de datos requiere que los datos se transfieran mediante extremos de servicio basados en HTTP específicos del tipo de integración en lo que respecta al formato y al método usados. En todos los casos, se considera una práctica recomendada transferir los datos mediante una conexión HTTPS.
Dispone de detalles sobre el modelo de transferencia de los datos y los extremos de Learn de cada tipo de integración en los temas específicos de cada tipo.
Todos los tipos de integración pueden recibir datos por la red dirigiendo los datos a la URL de integración. Esto resulta útil en el contexto de Enterprise 1.1 y tipos de instantáneas, ya que ahora pueden realizar las transferencias de los datos y publicar los datos basados en los archivos.
Propiedad de los datos
El marco de trabajo de integración SIS permite administrar los datos usando más de un tipo de integración. Cada configuración de integración implementada administra los datos específicos de esa integración en particular, pero no los del resto de integraciones. Aunque las claves de origen de datos pueden usarse para agrupar los datos y administrarlos mediante la interfaz de usuario y las herramientas complementarias, el marco de trabajo de integración SIS no las usa para limitar los cambios en los datos asociados. Así, los objetos de Learn son propiedad de la integración que los crea y no de las claves del origen de datos asociadas. Esto significa que una integración puede actuar en todos los puntos de datos de la que es propietaria independientemente de las claves de origen de datos que tengan asignadas.
Más información sobre las claves del origen de datos
Las instancias individuales del mismo tipo de integración se identifican de manera única mediante una UID generada por el sistema que se muestra en la página de configuración de la integración y que se puede usar, en el caso de LIS, en la configuración del SIS y, en el caso de los tipos de integración Enterprise o Instantánea, en los servicios proporcionados por el cliente que transmiten los datos de la integración al extremo. Para obtener más información sobre la configuración de LIS o el servicio del cliente, consulte los temas de configuración y automatización de cada tipo de integración.
Procesamiento de los datos
Independientemente del tipo de integración o del formato de los datos, todo el procesamiento se efectúa del mismo modo:
- El marco de integración SIS recibe una solicitud en un extremo específico de un tipo de integración.
- Según la UID entrante, se carga la configuración del tipo de integración.
- Si el procesamiento previo de los datos para la validación se completa correctamente, ActiveMQ actúa como intermediario para que la tarea se ejecute en un servidor de aplicaciones de Learn.
- Los datos se procesan según la configuración y los encabezados y la asignación personalizados si los usa la integración.
- Todas las operaciones de procesamiento de objetos se registran por objeto, se escriben en un archivo de registro y se almacenan en la base de datos de Learn para que el visor de registros de la interfaz de usuario pueda recuperarlas.
El marco de trabajo de la integración SIS no procesa los datos en paralelo (esto introduciría un alto riesgo de condiciones de carrera de datos); en su lugar, los datos se procesan de manera que el primero en entrar es el primero en salir a fin de garantizar que los datos se procesen en la secuencia requerida. Por lo tanto, siempre se debe esperar que un conjunto de datos finalice el procesamiento antes de enviar el siguiente conjunto de datos.
Tipos de integración, objetos admitidos y requisitos
El marco de trabajo SIS de Learn admite cinco tipos de integración en una instalación predeterminada compuesta por tipos de integración estándares y diseñados para Blackboard. Pueden desarrollarse y añadirse tipos de personalización adicionales a través del administrador de Building Blocks. Gracias a la posibilidad de ampliar los tipos admitidos, el valor del marco de trabajo SIS en la empresa incrementa considerablemente y eso, a la vez, nos permite actualizar los tipos de integración basados en Building Blocks y listos para usar fuera del ciclo en caso necesario.
Todos los tipos de integración proporcionados por Learn tienen requisitos específicos relativos al sistema de información y a la compatibilidad de los objetos de Learn. A continuación se ofrece una descripción de alto nivel de los tipos de integración, de los objetos que admiten y de los requisitos del sistema de información para admitir la integración.
Tenga en cuenta que cada tipo de integración admite unos objetos de Learn específicos; no hay un solapamiento del 100 % de los objetos entre tipos de integración en ningún caso. Este es un punto clave para considerar a la hora de seleccionar el tipo de integración. Otro punto importante es la capacidad del sistema de información para admitir un tipo de integración y formato de datos. Para obtener más información sobre un tipo de integración, el formato de los datos y los medios de transporte de los datos, consulte las secciones específicas de cada tipo de integración.
A medida que Learn avanza en la integración del sistema de información, nos centraremos en los tipos de integración LIS 2.0 y del archivo de instantánea sin formato, que deben considerarse objetivos prioritarios. Los tres tipos de integración restantes se proporcionan a los clientes que utilizan integraciones existentes y que están interesados en emplear el marco de trabajo SIS. Tenga en cuenta que los tipos de integración Enterprise 1.1, Enterprise 1.1 Vista e Instantánea XML no se seguirán desarrollando en favor de los nuevos objetos de Learn.
Enterprise 1.1 y Enterprise 1.1 Vista
Enterprise 1.1: Enterprise 1.1 se introdujo en 2002 y estaba diseñado para reemplazar a Enterprise 1.0 (1999). Proporcionaba una descripción de datos basada en XML para transmitir los valores de persona, grupo y afiliación a grupos. Diseñado para el intercambio de datos internamente en los sistemas empresariales institucionales y entre dichos sistemas, los proveedores más importantes (entre los cuales estaban WebCT y Learn) adoptaron el estándar para fines de integración.
A menudo, se hace referencia a Enterprise 1.1 en el contexto de integraciones "dirigidas por eventos", aunque también se ha usado para generar archivos de datos sin formato. Las dos "versiones" de Enterprise 1.1 compatibles con Learn son la versión Vista original y una versión Ellucian Banner que contiene ampliaciones de la especificación para los clientes que usan encabezados. Son los tipos de integración Enterprise 1.1 Vista y Enterprise 1.1 del marco de trabajo SIS.
Objetos admitidos
Diseñado para instituciones que:
- Ofrecen información general del proceso empresarial.
- Ofrecen orientación para configurar el marco de trabajo de integración SIS.
- Revisan las técnicas básicas de scripting.
- Proporcionan técnicas de resolución de problemas para incidencias en la integración y en los datos.
- Documentan las decisiones tomadas sobre los elementos de datos clave.
| Objeto | Descripción |
|---|---|
| Cursos | Datos para crear y administrar cursos |
| Usuarios | Datos para crear y administrar usuarios del sistema (estudiantes, personal docente, personal, etc.) |
| Matriculaciones | Datos para crear y administrar afiliaciones a cursos (inscripciones) |
| Nodos | Datos para crear y administrar las relaciones jerárquicas |
| Periodos | Datos para la creación y la administración de elementos |
| Cursos interdisciplinares | Datos para combinar cursos principales y secundarios |
| Roles institucionales | Datos para administrar las relaciones entre roles de usuario El rol de institución principal (solo) se puede establecer en el objeto de usuario de esta integración con una asignación de campo personalizada. Las integraciones totalmente compatibles con el rol de la institución admiten los roles principal Y secundario. |
| Organizaciones | Datos para crear y administrar los sitios de la organización de Learn En esta integración se pueden crear organizaciones mediante la asignación personalizada de un campo de objetos de curso. Las integraciones totalmente compatibles con las organizaciones tienen fuentes independientes dedicadas a las organizaciones. |
Sistemas de información
Versiones de Peoplesoft:
Peoplesoft Campus Solutions 9, paquete 21 o anteriores
Versiones Ellucian Banner:
Banner General
- 8.0 o versiones posteriores para Intcomp 8.0.1
- 8.1 o versiones posteriores para Intcomp 8.0.2
Banner Student
- 8.0 o versiones posteriores para Intcomp 8.0.1
- 8.1 o versiones posteriores para Intcomp 8.0.2
Banner Intcomp - 8.0.1 o versiones posteriores
Banner Financial Aid - 8.x
Banner Integration for eLearning 8.0
Ellucian Colleague
Requiere herramientas para extraer y convertir los datos antes de enviarlos a Learn.
Antes de adaptar el sistema para que admita Enterprise 1.1, confirme la compatibilidad con las versiones posteriores de los sistemas de terceros.
Consulte la sección correspondiente a Enterprise 1.1 para obtener una descripción detallada de dicho tipo de integración. Tenga en cuenta que el formato de los datos es ligeramente distinto entre las dos versiones compatibles de Enterprise 1.1 (estándar y Vista).
LIS 2.0
LIS 2.0: Learner Information Services 2.0, el programa que sustituye a Enterprise 1.1, es una solución basada en todo lo aprendido de las deficiencias de Enterprise 1.1. LIS 2.0 no solo describe los datos, también describe los métodos de transporte y publicación/consumo de dichos datos. Esto permite una asignación 1 a 1 de los datos del sistema de origen compatible con LIS con los procesos de consumo de dichos datos; y esto es bueno para las integraciones "plug and play". LIS 2.0 se basa en los servicios web. Los sistemas compatibles transmiten los datos en función de los servicios conocidos, y para el intercambio de datos entre dos sistemas solo es necesario indicar los extremos de dichos sistemas.
LIS 2.0 es un modelo dirigido por eventos, aunque se pueden generar archivos sin formato que cumplan con la descripción del formato de datos LIS2.0 XML destinados a la carga manual.
Objetos admitidos
| Objeto | Descripción |
|---|---|
| Cursos | Datos para crear y administrar cursos |
| Usuarios | Datos para crear y administrar usuarios del sistema (estudiantes, personal docente, personal, etc.) |
| Matriculaciones | Datos para crear y administrar afiliaciones a cursos (inscripciones) |
| Periodos | Datos para la creación y la administración de elementos |
| Roles institucionales | Datos para administrar las relaciones entre roles de usuario El rol de institución principal (solo) se puede establecer en el objeto de usuario de esta integración con una asignación de campo personalizada. Las integraciones totalmente compatibles con el rol de la institución admiten los roles principal Y secundario. |
| Organizaciones | Datos para crear y administrar los sitios de la organización de Learn En esta integración se pueden crear organizaciones mediante la asignación personalizada de un campo de objetos de curso. Las integraciones totalmente compatibles con las organizaciones tienen fuentes independientes dedicadas a las organizaciones. |
Sistemas de información
Versiones de Peoplesoft:
Peoplesoft Campus Solutions 9, paquete 22 o versiones posteriores;
http://www.oracle.com/us/industries/education-and-research/056908.pdf
Versiones Ellucian Banner:
Banner General
- Se requieren la versión 8.1 o versiones posteriores.
Banner Student
- Se requieren la versión 8.1 o versiones posteriores.
Banner Intcomp
- Se requieren la versión 8.0.2 o versiones posteriores.
Banner Financial Aid
- 8,11
Para el servidor de aplicaciones Oracle
- 10.1.3
Ellucian Colleague
Requiere la versión 3.5 de ILP.
Antes de adaptar el sistema para que admita Enterprise 1.1, confirme la compatibilidad con las versiones posteriores de los sistemas de terceros.
Más información sobre LIS - Servicios de información del aprendizaje de IMS
Archivo de instantáneas sin formato
Learn también admite el archivo de instantánea sin formato para importar los datos. La herramienta Instantánea fue el primer método de integración admitido en Learn Enterprise y cuenta con un largo historial de éxitos gracias a la sencillez de su funcionamiento. Originalmente, la herramienta Instantánea admitía tanto archivos XML como CSV (archivos delimitados); un archivo creado por tarea de administración de datos para las asignaciones de usuarios, cursos, inscripciones y personal. El marco de trabajo SIS admite archivos de instantánea con los tipos de integración Instantánea XML o archivo de instantánea sin formato. Tenga en cuenta, sin embargo, que el archivo de instantánea sin formato es el único que se actualiza y se sigue desarrollando para mantener su compatibilidad con los objetos de datos nuevos. El desarrollo de Instantánea XML a este respecto se ha congelado y puede que no cumpla los requisitos de la integración en el futuro.
Objetos admitidos
| Objeto | Descripción |
|---|---|
| Cursos | Data for creating and managing courses and course view |
| Usuarios | Datos para crear y administrar usuarios del sistema (estudiantes, personal docente, personal, etc.) |
| Matriculaciones | Datos para crear y administrar afiliaciones a cursos (inscripciones) |
| Nodos | Datos para crear y administrar las relaciones jerárquicas |
| Periodos | Datos para la creación y la administración de elementos |
| Categorías de catálogo | Datos para crear y administrar el catálogo de cursos de Learn |
| Roles institucionales | Datos para administrar las relaciones entre roles de usuario El rol de institución principal (solo) se puede establecer en el objeto de usuario de esta integración con una asignación de campo personalizada. Las integraciones totalmente compatibles con el rol de la institución admiten los roles principal Y secundario. |
| Organizaciones | Datos para crear y administrar los sitios de la organización de Learn En esta integración se pueden crear organizaciones mediante la asignación personalizada de un campo de objetos de curso. Las integraciones totalmente compatibles con las organizaciones tienen fuentes independientes dedicadas a las organizaciones. |
| Cursos interdisciplinares | Datos para combinar cursos principales y secundarios |
| Observadores | Datos para la creación y la administración de los observadores |
Sistemas de información
Versiones de Peoplesoft:
Requiere herramientas para extraer y convertir los datos antes de enviarlos a Learn.
Versiones Ellucian Banner:
Requiere herramientas para extraer y convertir los datos antes de enviarlos a Learn.
Ellucian Colleague
Requiere herramientas para extraer y convertir los datos antes de enviarlos a Learn.
Antes de adaptar el sistema al archivo de instantánea sin formato, confirme la compatibilidad con la extracción de datos de las versiones de los sistemas de terceros que tenga instaladas.
Más información sobre el archivo de instantánea sin formato
XML de Instantánea
La herramienta Instantánea XML está estrechamente vinculada a la especificación de Enterprise 1.1 con adiciones específicas de Learn. De manera similar a Enterprise 1.1, Instantánea XML ha mejorado en flexibilidad, de modo que los archivos XML pueden contener un tipo de datos o combinar varios tipos para que se procesen a la vez.
Otro punto que vale la pena destacar es que el formato de datos Instantánea XML no debe ser la primera opción de integración, ya que para este formato solo se ofrece mantenimiento, no se garantiza la compatibilidad con los objetos nuevos ni habrá nuevos desarrollos. Así, es probable que en algún momento más adelante se anuncie la finalización de la asistencia técnica para este formato, siempre con suficiente antelación para que el cliente realice los ajustes necesarios.
Objetos admitidos
| Objeto | Descripción |
|---|---|
| Cursos | Datos para crear y administrar cursos |
| Usuarios | Datos para crear y administrar usuarios del sistema (estudiantes, personal docente, personal, etc.) |
| Matriculaciones | Datos para crear y administrar afiliaciones a cursos (inscripciones) |
| Categorías de catálogo | Datos para crear y administrar el catálogo de cursos de Learn |
| Roles institucionales | Datos para administrar las relaciones entre roles de usuario El rol de institución principal (solo) se puede establecer en el objeto de usuario de esta integración con una asignación de campo personalizada. Las integraciones totalmente compatibles con el rol de la institución admiten los roles principal Y secundario. |
| Organizaciones | Datos para crear y administrar los sitios de la organización de Learn En esta integración se pueden crear organizaciones mediante la asignación personalizada de un campo de objetos de curso. Las integraciones totalmente compatibles con las organizaciones pueden disponer de fuentes independientes dedicadas a las organizaciones. |
| Observadores | Datos para la creación y la administración de los observadores |
Sistemas de información
Versiones de Peoplesoft:
Requiere herramientas para extraer y convertir los datos antes de enviarlos a Learn.
Versiones Ellucian Banner:
Requiere herramientas para extraer y convertir los datos antes de enviarlos a Learn.
Ellucian Colleague
Requiere herramientas para extraer y convertir los datos antes de enviarlos a Learn.
Antes de adaptar el sistema para que admita el formato Instantánea XML, confirme la compatibilidad con la extracción de datos de las versiones de los sistemas de terceros que tenga instaladas.
Más información sobre el formato Instantánea XML
Integraciones personalizadas
Dado que el sistema de trabajo de integración SIS es ampliable en Building Blocks, puede usar sus API para crear tipos de integración personalizados que se adapten a las necesidades específicas de su empresa. Esto se aplica si el sistema de información no admite uno de los tipos de integración proporcionados por Learn o si tiene necesidades de integración específicas fuera del alcance de los tipos de integración de Learn. En estos casos, puede crear su propio Building Block de integración y tomar el control de los objetos de Learn que admite su integración y de la lógica de interacción específica del sistema de información que usa.
Asistencia y configuración generales
Los servicios de asistencia técnica de Blackboard ofrecen soporte para los tipos de integración de Learn. Si tiene preguntas o problemas con los procesos de integración o de configuración, puede ponerse en contacto con el servicio de asistencia; para ello, complete un formulario de asistencia en Behind the Blackboard.
Debe configurar Learn para recibir datos de todos los tipos de integración mediante las páginas de configuración de la integración SIS del administrador de Learn. Para configurar una integración, una vez determinado el tipo más adecuado para los objetivos de su empresa y las características de la información, debe completar nueve pasos desde la página principal de configuración de SIS.
- Cree la integración; para ello, seleccione el tipo de integración en el menú desplegable Crear.
- Configure la integración que acaba de crear.
- Establezca la integración en modo de prueba.
- Realice los cambios de asignación personalizada necesarios.
- Pruebe la integración (cuando la integración está en modo de prueba, no se efectúan cambios en los datos de Learn).
- Confirme la configuración; para ello, revise los registros de la integración en la interfaz de usuario.
- Repita los pasos del 4 al 6 hasta que la integración funcione según lo previsto.
- Cuando el resultado de la prueba sea satisfactorio, active la integración para empezar.
- Supervise la integración; para ello, revise los registros.
Para obtener más información, consulte los temas de configuración de cada tipo de integración.
Registro de la integración
El registro de todos los tipos de integración está disponible a través de la interfaz de usuario de registro del marco de trabajo de integración SIS. Desde la interfaz de usuario, dispone de acceso a los registros que contienen el estado de las integraciones configuradas para cada objeto y nivel de registro admitido, de modo que estará informado de todas las operaciones de integración.
La página de registro permite ordenar los mensajes según el tipo y la integración.
Además del acceso a la interfaz de usuario, los registros también se escriben en el disco con fines de archivo y análisis y estudio a largo plazo.
Las marcas de tiempo que se muestran en "Última entrada del registro " (en la página de registro) y "Último evento" (en la página de integraciones) indican cuándo se registraron los eventos según los niveles de registro seleccionados.
Puede utilizar también los servicios web de REST para tener acceso a los registros y los errores ocurridos durante el procesamiento de los datos.
Para acceder a los registros, agregue /learn/api/v1/logs/sis/{dataSetUid} a su dominio de Blackboard Learn. El sistema le proporcionará un código de referencia, dataSetUid, cada vez que se procese un archivo de fuente. Este parámetro es obligatorio para que la búsqueda arroje resultados. Los mensajes de error y de operación correcta se registran en la tabla DATA_INTGR_LOG.
Hay otros parámetros disponibles para segmentar los datos:
- Parámetro logLevel: /learn/api/v1/logs/sis/{dataSetUid}?logLevel=(DEBUG,WARNING,ERROR,INFORMATION).
- Parámetros de paginación estándar: /learn/api/v1/logs/sis/{dataSetUid}?limit=25&&offset=10. De forma predeterminada, la solicitud estándar tiene un límite de 20 páginas, a menos que usted cambie este valor.
El proceso para solucionar los problemas de registro a través de los servicios web no se ha modificado respecto del proceso para solucionar los problemas de los registros de errores en la UI. Si recibe un mensaje de error "no encontrado", es posible que dataSetUid no exista en el sistema o que el archivo de fuente todavía esté en proceso.
