Archivo de instantáneas sin formato

Es importante tener en cuenta que en el contexto de este documento, el uso del término "instantánea" pertenece al proceso general de la toma de datos puntuales de SIS que se almacenan en un archivo sin formato que, a continuación, es consumido por Learn, no el controlador de instantáneas.

Una instantánea proporciona la capacidad de integrar mediante datos puntuales según se haya aprovisionado en SIS con dos tipos de integración compatibles (léase: formatos de datos) en el marco de trabajo SIS para Instantánea: XML de Instantánea y Archivo de instantánea sin formato (o datos delimitados). Este último, el archivo de instantánea sin formato, es el formato compatible "en adelante" y recibirá actualizaciones para ofrecer compatibilidad a los nuevos objetos de datos. La instantánea XML solo recibirá actualizaciones de mantenimiento.

El procesamiento de ambos tipos de integración de instantáneas se realiza mediante una publicación HTTP del archivo de datos en el extremo correspondiente.

Datos compatibles

Requisitos

La capacidad de SIS de generar datos con el formato para el tipo de integración elegida: instantánea XML o archivo de instantánea sin formato con el delimitador adecuado.

Un punto en el que vale la pena insistir es que el controlador de instantáneas y el formato de datos de instantánea XML no deben ser la primera opción de integración elegida ya que solo recibirán actualizaciones de mantenimiento y no recibirán compatibilidad con nuevos objetos ni el desarrollo de funciones. Se espera que en algún momento en el futuro, se realizará el anuncio de la retirada del soporte con el margen de tiempo suficiente para el ajuste del cliente.

Consulte Enterprise 1.1 en la sección de ejemplos para obtener muestras de datos. Tenga en cuenta que el formato de datos es ligeramente diferente entre las dos vertientes compatibles de Enterprise 1.1 (estándar y Vista).

Instalación: Tipos de integración de instantáneas

Además de comprender los datos involucrados en cualquier integración SIS, la configuración de los tipos de integración de instantáneas requieren los conocimientos de las funciones de SIS y los extremos, y debe tenerse en cuenta si los objetos de datos compatibles en el tipo de instantánea seleccionado cumplen con los objetivos de integración del cliente. Además, es necesario comprender el formato de archivo específico. Puede crear una integración de instantáneas mediante los pasos siguientes en la interfaz del usuario de la integración SIS del administrador del sistema de Learn: Integración de datos > Integraciones del sistema de información de estudiantes

Los pasos a continuación son los mismos para ambos tipos de integración de instantánea, la diferencia clave de la selección del tipo de integración es si los datos son XML (elija XML de instantánea) o delimitados (archivo de instantánea sin formato).

1. Seleccione Crear integración.

2. Seleccione Instantánea XML o Archivo de instantánea sin formato. En la siguiente pantalla, seleccione las opciones de configuración. 

   Para realizar la configuración avanzada (asignación de datos, por ejemplo) debe establecerse una integración en estado de Prueba o Activo.

3. Nombre de integración: introduzca Instantánea XML o Archivo de instantánea sin formato.
4. Descripción (opcional): describa la integración como quiera, por ejemplo, Probar instantánea XML o Probar archivo de instantánea sin formato.
5. Se utiliza un nombre de usuario compartido y una contraseña compartida para las operaciones de publicación de datos.
6. Configure el Estado de la integración:
   1. Inactiva: la integración no realiza ningún procesamiento.
   2. Activa: la integración realiza procesamientos y actualizaciones de los datos de Learn.
   3. En prueba: la integración realiza procesamientos, pero no actualiza Learn.
7. Configure los niveles de detalle del registro: para las pruebas, se recomienda que seleccione Todos los mensajes de diagnóstico y de depuración. Para Activa, recomendamos el uso de una configuración inferior, como Solo errores o Errores y advertencias.
8. Seleccione la clave de la fuente de datos (DSK) que se va a utilizar para esta integración. Puede seleccionar utilizar una DSK existente específico, crear una nueva clave o utilizar el origen de datos proporcionado en la fuente. NOTA:  En todos los casos, debe crearse una DSK antes de que se procesen las fuentes de datos.
9. Únicamente los archivos de instantánea sin formato son compatibles con la gestión de nodos principales. Seleccione adecuadamente para cumplir sus metas.
10. Seleccione los objetos gestionados por esta integración y cómo administrar la paridad. Normalmente, las opciones predeterminadas están bien. NOTA:  Es posible que tenga múltiples tipos de integración, cada uno encargándose de un único subconjunto de objetos de integración disponibles.
11. Seleccione Enviar y su nueva integración de instantánea aparecerá en la lista de integraciones.

Debe completarse un paso más para admitir la integración de instantáneas y es la configuración del sistema SIS para que publique datos en Learn o la configuración de un servidor de aplicación en cron o una tarea por lotes para publicar datos en Learn. Tenga en cuenta que los extremos de instantánea son específicos de la tarea necesaria a realizar.

La publicación por parte del servidor de aplicaciones en Learn se logra mediante CURL o una aplicación similar activada por un cron o una tarea por lotes:

curl -k -w %{http_code} -H "Content-Type:text/plain" -u SHARED_USERNAME:SHARED_PASSWORD --data-binary @PATH_TO_TEST_FILE ENDPOINT_URL

Realice los siguientes reemplazos:

SHARED_USERNAME por el nombre de usuario compartido

SHARED_PASSWORD por la contraseña compartida

PATH_TO_TEXT_FILE por la ruta al archivo de datos XML

Reemplace ENDPOINT_URL por la dirección URL del extremo.

En la página Información de HTTP en el menú contextual de su integración de archivos sin formato, puede ver una lista de los extremos en el servidor:

Administrador del sistema (Building Blocks) > Integración de datos > Integraciones del sistema de información de estudiantes > (Menú contextual de su integración) > Información de HTTP

Si es compatible con una aplicación de nivel medio o con SIS, los datos pueden publicarse directamente en el extremo tras el protocolo anterior.

Una vez se ha completado lo anterior y se ha activado SIS para que genere datos y los publique o los guarde en un archivo para su publicación en Learn, debería empezar a ver registros en la integración.

Evalúe los datos y determine si necesita realizar ajustes con la Configuración avanzada/Asignación de campos en los objetos de datos disponibles. Consulte la sección sobre Asignación de campos al final de la sección de ejemplos para obtener una descripción de esta función.

Para obtener más información acerca del procesamiento de los archivos de datos, consulte Automatización de los archivos de instantánea sin formato.

Integraciones de instantánea

Las integraciones de instantánea se basan en conjuntos de datos que cumplen con propósitos específicos. Por ejemplo, para gestionar usuarios o cursos en el sistema. De los dos tipos admitidos, XML de instantánea y archivo de instantánea sin formato, solo el archivo de instantánea sin formato puede considerarse como el más actualizado con los objetos de datos compatibles de Learn.

Como sucede con todos los tipos de integración "basadas en archivos" (tipos de instantánea y Enterprise 1.1), existen dos procesos para el consumo de datos en estos archivos: el uso de un archivo de fuentes de carga de la interfaz gráfica del usuario o el uso de una transferencia de datos HTTP (por ejemplo: cURL). En el caso de la transferencia de datos HTTP, puede utilizarse cron o a una tarea por lotes para activar la operación. Además se incluye, compatible con SIS o nivel medio, la opción de publicar directamente un flujo de datos.

Cada una de las operaciones se realiza mediante un extremo específico. Estos extremos del servidor de aplicaciones están disponibles a través del enlace de información HTTP de las integraciones desde el menú contextual.

Crear un archivo de datos

1. En la sección Herramientas del administrador, en Integraciones, seleccione Integración de datos.
2. Seleccione Integraciones del sistema de información de los alumnos.
3. En el menú desplegable Crear integración, seleccione Archivo de instantánea sin formato si va a crear un archivo manualmente.
4. Introduzca un Nombre de integración (obligatorio). Tiene la opción de introducir una descripción.
5. Puede agregar seguridad ingresando un Nombre de usuario compartido y una Contraseña compartida. Esto se usa más a menudo para publicar contenido en el extremo.
6. En Delimitador del archivo de introducción, seleccione el carácter que separa los campos en el archivo de datos.
7. En Estado de integración, seleccione inactivo, activo o en prueba.
8. En Nivel de detalle del registro, seleccione qué tan detallados desea que sean sus registros. 

El área Soporte de datos le permite segmentar los datos de manera lógica. Por ejemplo, si tiene dos sistemas de información del estudiante distintos para dos campus diferentes, puede segmentar los datos para esos dos campus independientes. O bien, si desea segmentar los datos para diferentes períodos académicos. 

1. En Fuente de datos de Learn, puede seleccionar si la fuente de datos debe definirse en los datos entrantes o utilizar la misma fuente de datos de Learn para todos los datos entrantes nuevos. 
2. Tiene la opción de introducir un prefijo de UID de lote. Se utiliza para prefijar los identificadores de los objetos creados con esta integración para evitar conflictos de ID. No se recomienda modificar este valor después de la creación de los datos para esta integración.
3. Seleccione la ubicación del nodo en Nodo de jerarquía principal.

En Configuración avanzada, tiene distintas opciones para, por ejemplo, controlar situaciones en las que no se encuentran ciertos registros en un lote. Para este caso de uso, dejaremos las selecciones predeterminadas.

Cuando haya introducido sus datos, seleccione Enviar. De esta forma, se creará el archivo para la integración.

Cargar un archivo de datos para la integración:  

1. En la sección Panel del administrador, en Integraciones, seleccione Integración de datos.
2. Seleccione Integración del sistema de información del estudiante.
3. Seleccione el menú del archivo que desea cargar. Seleccione Cargar archivo de fuente de datos.
4. En el menú Tipo de datos, seleccione el tipo que le corresponda. Los más comunes para las integraciones son Nodo de jerarquía (si el archivo representa su jerarquía), Asociación de curso, Asociación de organización y Asociación de usuario. 
5. Para Tipo de operación, la opción más común es Guardar. 
   • Use la opción Actualización completa cuando realice comparaciones de datos completas y desee eliminar algo que no se encuentra en el archivo. Utilice esta opción con cuidado. 
   • Use Eliminar para eliminar los registros que está cargando. 
6. Seleccione Enviar.

Puede comprobar el registro SIS para confirmar que se agregó. Para archivos más grandes, la carga puede tardar un par de minutos. Seleccione Registros en Herramientas y utilidades y, a continuación, seleccione Registros SIS. 

Extremos de instantánea

Extremos de operación de instantáneas para los archivos sin formato

Utilice esta información para configurar sus archivos de introducción de instantánea sin formato POST a SIS para su integración. Los objetos almacenados van a seguir existiendo y conservando sus datos. Los objetos eliminados van a borrarse. La Actualización completa va a eliminar cualquier objeto existente que no se encuentre en el archivo de introducción. Fallará la publicación de un archivo de un tipo de objeto específico a un extremo que no concuerde. Por ejemplo: fallará la publicación de un archivo de datos de curso a un extremo de persona.

La desactivación de un curso desactivará las afiliaciones de ese curso. Este es un nuevo comportamiento.

También puede encontrar la URL del extremo de una operación en la interfaz de usuario de Blackboard Learn. Diríjase al Panel del administrador > Integración de datos > Integraciones del sistema de información del estudiante. Busque la integración, abra el menú y seleccione Información de HTTP. Se enumeran las URL de extremo de la integración.

Si está familiarizado con las instantáneas anteriores del tipo de archivo sin formato del marco de trabajo SIS, no hay ningún cambio de formato aparte de la adición de los encabezados en los nuevos objetos de datos compatibles. Para obtener más información, consulte Formato de los datos de los archivos de instantánea sin formato y Ejemplos de archivos de instantánea sin formato.

Extremos de operación de instantáneas para XML

Utilice esta información para configurar el SIS para archivos de introducción de datos XML POST en esta integración. Los objetos almacenados van a seguir existiendo y conservando sus datos. Los objetos eliminados van a borrarse. La Actualización completa va a eliminar cualquier objeto existente que no se encuentre en el archivo de introducción. Si publica un objeto que contenga un tipo de objeto incorrecto, se producirá un error.

Más información

Descripción general del marco de trabajo SIS

Descripción general de la clave de la fuente de datos