Los ejemplos proporcionados demuestran la composición de las fuentes de datos de TERM, que a la vez se aplican a diversos casos de uso. Estos ejemplos utilizan la fuente de datos más sencilla posible que es necesaria para satisfacer el caso práctico. Existen más encabezados de fuentes de TERM que se pueden utilizar en la creación de registros de pertenencia como el análisis del sistema de información de su institución, los requisitos del registro y la planificación le ayudarán a determinar la profundidad de datos necesaria para llenar correctamente Learn conforme a sus datos y objetivos del ciclo de vida de TERM (y el curso/organización asociados).
Los ejemplos se basan en los ajustes predeterminados de Learn que se muestran en la interfaz de usuario de configuración de la integración. Si se cambian estos elementos de la configuración, también se modificarán los resultados del ejemplo. Las explicaciones de estos ajustes están disponibles en la Descripción general del marco de trabajo SIS. Además, se presupone que se configurará la integración para que se use la misma fuente de datos para todos los datos de entrada, a menos que se indique lo contrario.
Acerca del objeto TERM
El objeto TERM proporciona otra una forma útil de organizar y controlar el acceso a los cursos y las organizaciones. Cuando utiliza un objeto de TERM para controlar el acceso al curso, los ajustes especificados por TERM anulan los proporcionados en los datos del curso, lo cual significa que si especifica fechas de inicio o de finalización y duración a nivel de curso, estos se ven sustituidos por los especificados en el TERM asociado.
Este tema describe el uso de un archivo de instantánea sin formato para crear y gestionar objetos de TERM y presenta un único ejemplo de uso del objeto de TERM en una fuente de datos del curso.
Administración de datos del archivo de instantáneas sin formato
El marco de trabajo SIS admite las cargas de fuentes de datos de archivos de instantáneas sin formato a través de la carga de fuentes de interfaz de usuario y de un conjunto de direcciones URL que proporciona el sistema Learn.
Puede acceder a la información de HTTP y cargar un archivo de fuente de datos a través del menú de integración en Administración del sistema > Integración de datos > Sistemas de información del estudiante > Interfaz de usuario de integración.
En ambos casos, el comportamiento de las operaciones de datos depende de la configuración de la integración y del tipo de operación seleccionada. El tipo de operación de datos seleccionada controla la manera en que los datos de la fuente se "interpretan", y cada URL proporcionará diferentes resultados para cumplir los objetivos de integración deseados.
En los ejemplos, se usa la función Cargar archivo de fuente de datos de la interfaz de usuario del marco de trabajo de instantáneas. Si desea automatizar o utilizar las operaciones de programación o línea de comandos, consulte Automatización del archivo de instantáneas sin formato.
Operaciones
Los datos suministrados a Learn pueden actualizarse, eliminarse o corregirse con posterioridad. De ese modo, puede empezar con el conjunto de datos más sencillo y ampliarlo a medida que cambien los requisitos de datos de su institución.
Las siguientes operaciones están disponibles a través de la interfaz de usuario y también mediante HTTP:
| Operación | Descripción |
|---|---|
| Guardar | Guarda o actualiza un registro proporcionado según la configuración de la integración. Al usar este tipo de operación, los datos contenidos en el archivo de fuente se almacenan o actualizan (según los parámetros de la configuración) en todas las fuetes de datos que posee la integración. Para obtener más información sobre la "propiedad" de los datos, consulte la Descripción general del marco de trabajo SIS. Para obtener más información sobre las claves de la fuente de datos, consulte la Descripción general de la clave de la fuente de datos. |
| Actualizar | Almacena, actualiza o deshabilita un registro proporcionado presente en la fuente y en Learn. Esta operación almacena o actualiza los datos contenidos en la fuente de datos y, al mismo tiempo, desactiva los datos no contenidos en la fuente datos que están asociados con la integración en todos los orígenes de datos. |
| Eliminar | Deshabilita el registro proporcionado. Esta operación deshabilita los registros contenidos en la fuente de datos asociada con la integración en todas las fuentes de datos, de acuerdo con los parámetros de la configuración. |
Los objetos asociados con las operaciones de TERM son:
| TERM | Guardar, Actualización completa, Eliminar, Actualización completa por origen de datos |
Los ejemplos proporcionados se demuestran con la función Cargar archivo de fuente de datos de la interfaz de usuario del marco de trabajo de instantáneas. Si desea automatizar o utilizar las operaciones de programación o línea de comandos, consulte Automatización del archivo de instantáneas sin formato.
Recordatorio sobre las claves de la fuente de datos
Todos los objetos de datos permiten alterar la clave de la fuente de datos para agrupar ese conjunto de datos, y se pueden usar para alterar la fuente de datos asociada. Nota: Este campo no es obligatorio en las fuentes de datos basadas en el marco de trabajo. En los ejemplos provistos, se presupone que se configurará la integración para que se use una única fuente de datos, a menos que se indique lo contrario. Consulte la Descripción general de la clave de la fuente de datos
Nota sobre la asignación de campos
La asignación de campos brinda la posibilidad de alterar los datos de entrada antes de almacenarlos en Learn. Esto le permite conservar el control sobre los datos que se guardan y le permite cumplir con las reglas específicas de Learn cuando los datos SIS que se le han proporcionado no son suficientes (por ejemplo, la creación de contraseñas de usuario cuando no se proporciona una contraseña en la fuente de datos).
Cuando se aplica a un campo de objeto de Período, se ejecuta el script asociado al objeto que modifica o proporciona los datos antes de que se guarden en Learn. Puede encontrar una explicación completa sobre la asignación de campos en Asignación de campos personalizados del archivo de instantáneas sin formato.
Ejemplos de TERM
A un nivel elevado, se pueden identificar tres patrones de fuentes de datos de integración SIS, los cuales se pueden aplicar a todas las operaciones de datos de TERM; y la selección de los patrones depende de los datos que se puedan proporcionar.
- Si usa un único archivo de fuente de datos, puede almacenar y actualizar registros (Guardar) y utilizar un proceso independiente para desactivar (Eliminar) registros.
- Con el uso de un único archivo fuente puede Guardar, Actualizar y Desactivar (Actualizar) registros
- Si usa una combinación de archivos, puede almacenar con uno y desactivar con el segundo.
Finalmente, vale la pena mencionar, aunque no sea un patrón de fuente de datos de SIS, que también puede desactivar y borrar únicamente mediante DSK usando la herramienta Administración de origen de datos disponible en la interfaz de usuario. Debe tener mucho cuidado al administrar de este modo los datos proporcionados por SIS. Esta opción resulta muy útil para borrar los datos que SIS ya no proporciona o que nunca proporcionó, o para eliminar los resultados de las operaciones de prueba.
Conceptos básicos: TERM
Todos los objetos de TERM requieren un conjunto básico de información a establecer. Esta información se encuentra detallada en Formato de datos del archivo de instantáneas sin formato y en Descripciones de encabezados del archivo de instantáneas sin formato.
Información básica sobre los datos
El conjunto de datos o encabezados mínimos necesarios para la creación de una cuenta de pertenencia en Learn consiste en:
- EXTERNAL_TERM_KEY: un identificador único para el registro de este período.
- DATA_SOURCE_KEY: un identificador único para el conjunto de datos de este registro. Nota: esto se proporciona en la fuente o mediante la configuración de integración
- NAME: el nombre asociado al TERM. Tenga en cuenta que esto es lo que se busca cuando se buscan los registros de TERM, por lo que resulta útil seguir una convención de nomenclatura para facilitar la diferenciación de sus TERMs a lo largo del tiempo. Por ejemplo: utilice "Artes y ciencias otoño de 2013" en lugar de "Otoño".
Para cada configuración de integración, el marco de trabajo SIS proporciona valores predeterminados para los campos no obligatorios (o los ignora). Hay tres puntos de datos que no son necesarios para las fuentes datos de TERM, pero que resultan muy útiles: DESCRIPTION, AVAILABLE_IND y ROW_STATUS; estos operan del mismo modo que con los demás objetos de Learn. Además, si desea usar el objeto de TERM para controlar el acceso al curso, utilizará los puntos de datos START_DATE y END_DATE. Los abordaremos en el caso de uso a continuación.
Cada uno de estos encabezados se describe por completo en Descripciones de encabezados del archivo de instantáneas sin formato.
Adición de objetos TERM
Para utilizar el objeto de TERM para controlar la disponibilidad del curso, primero debe crear el objeto TERM.
Existen dos casos para añadir información de TERM. El primero es GUARDAR mediante adición de la información de pertenencia lo cual resulta en la adición o actualización de los registros como se presentan en la fuente de datos. El segundo es la información de ACTUALIZAR TERM que ya existe en Learn lo cual resulta en la adición de nuevos registros o la actualización de registros existentes como se presentan en el archivo de datos a la vez que se desactivan los registros de Learn existentes que no están presentes en el archivo de datos de TERM.
Ejemplos de operaciones de guardado
Ejemplo 1: Crear objetos TERM
Si desea añadir TERMs a su curso académico 2013-2014 en LEARN sin afectar a los registros existentes. Necesita distintos TERMs para su escuela de Medicina y su escuela de Artes y ciencias.
Configuró la integración de manera que se use la misma fuente de datos para todos los datos de entrada.
Requisitos previos
Ninguno.
Requisitos mínimos de fuente de datos
EXTERNAL_TERM_KEY
NAME
Solución
Crear un archivo de datos terms.txt que contenga los encabezados necesarios y los datos asociados para el TERM que desee añadir al sistema. Por ejemplo:
EXTERNAL_TERM_KEY|NAME
AS_FA.2013|Arts and Sciences Fall 2013
AS_WI.2014|Arts and Sciences Winter 2014
AS_SP.2014|Arts and Sciences Spring 2014
AS_SU.2014|Arts and Sciences Summer 2014
MED_T1.2013|School of Medicine Term 1 2013
MED_T2.2014|School of Medicine Term 2 2013
MED_T3.2014|School of Medicine Term 3 2013
Utilice la interfaz de usuario para cargar un archivo que contenga lo anterior mediante el tipo de datos de TERM usando la operación STORE. Los registros de TERM se crearán y podrá encontrarlos con las herramientas del Período del administrador del sistema.
Condición posterior
Los objetos del período se crean para ambas escuelas: cuatro para Artes y ciencias y tres para la escuela de Medicina.
Ejemplo 2: Actualizar objetos TERM
Si desea añadir y actualizar TERMs a su curso académico 2013-2014 sin afectar a los registros existentes. Además, desea tener un control explícito de la disponibilidad y el estado habilitado de los registros de TERM. El instituto de Artes y Ciencias tiene diferentes fechas de inicio y finalización para cada período, por lo que es conveniente establecerlas por separado con el fin de controlar la visibilidad de los cursos asociados.
Configuró la integración de manera que se use la misma fuente de datos para todos los datos de entrada.
Requisitos previos
Ninguno.
Requisitos mínimos de fuente de datos
EXTERNAL_TERM_KEY
NAME
AVAILABILITY_IND
DURATION
END_DATE
ROW_STATUS
START_DATE
Solución
Crear un archivo de datos terms.txt que contenga los encabezados necesarios y los datos asociados para el TERM que desee añadir o actualizar en el sistema.
Para utilizar correctamente START_DATE y END_DATE también debe establecerse el campo de duración (RANGE). Por ejemplo:
EXTERNAL_TERM_KEY|NAME|START_DATE|END_DATE|DURATION|AVAILABLE_IND|ROW_STATUS
AS_FA.2013|Arts and Sciences Fall 2013|20130915|20131205|RANGE|Y|ENABLED
AS_WI.2014|Arts and Sciences Winter 2014|20140103|20140418|RANGE|Y|ENABLED
AS_SP.2014|Arts and Sciences Spring 2014|20140420|20140520|RANGE|Y|ENABLED
AS_SU.2014|Arts and Sciences Summer 2014|20140608|20140820|RANGE|Y|ENABLED
MED_T1.2013|School of Medicine Term 1 2013|20130801|20131215|RANGE|Y|ENABLED
MED_T2.2014|School of Medicine Term 2 2014|20140110|20140602|RANGE|Y|ENABLED
MED_T3.2014|School of Medicine Term 3 2014|20140603|20140818|RANGE|Y|ENABLED
Condición posterior
Los objetos de TERM se crean o actualizan con la configuración explícita de disponibilidad del registro de TERM y la fecha de inicio y finalización de cada período. Cuando se asocia con un curso, el período asociado controlará la visibilidad del curso.
Ejemplos de operaciones de actualización
Ejemplo: Crear o deshabilitar objetos TERM
Si desea añadir y actualizar los TERMs a su curso académico 2013-2014 a la vez que desactiva los registros que ya no se necesitan. Además, desea tener un control explícito de la disponibilidad y el estado habilitado de los registros de TERM. El instituto de Artes y Ciencias tiene diferentes fechas de inicio y finalización, por lo que es conveniente establecerlas por separado para cada período con el fin de controlar la visibilidad de los cursos asociados.
Configuró la integración de manera que se use la misma fuente de datos para todos los datos de entrada.
Requisitos previos
Ninguno.
Requisitos mínimos de fuente de datos
EXTERNAL_TERM_KEY
NAME
AVAILABILITY_IND
DURATION
END_DATE
ROW_STATUS
START_DATE
Solución
Crear un archivo de datos terms.txt que contenga los encabezados necesarios y los datos asociados para el TERM que desee añadir o actualizar en el sistema.
Para utilizar correctamente START_DATE y END_DATE también debe establecerse una duración DURATION (RANGE). Por ejemplo: Por ejemplo:
EXTERNAL_TERM_KEY|NAME|START_DATE|END_DATE|DURATION|AVAILABLE_IND|ROW_STATUS
AS_FA.2013|Arts and Sciences Fall 2013|20130915|20131205|RANGE|Y|ENABLED
AS_WI.2014|Arts and Sciences Winter 2014|20140103|20140418|RANGE|Y|ENABLED
AS_SP.2014|Arts and Sciences Spring 2014|20140420|20140520|RANGE|Y|ENABLED
AS_SU.2014|Arts and Sciences Summer 2014|20140608|20140820|RANGE|Y|ENABLED
MED_T1.2013|School of Medicine Term 1 2013|20130801|20131215|RANGE|Y|ENABLED
MED_T2.2014|School of Medicine Term 2 2014|20140110|20140602|RANGE|Y|ENABLED
MED_T3.2014|School of Medicine Term 3 2014|20140603|20140818|RANGE|Y|ENABLED
Condición posterior
COMPLETE_REFRESH
Los registros del período contenidos en el archivo de datos se crean o se actualizan con la configuración explícita de la disponibilidad del registro del período y proporcionando los rangos de disponibilidad en los que los cursos asociados a dichos períodos estarán disponibles (start_date) y cuando dejarán de estarlo (end_date). Como sucede con todas las operaciones COMPLETE_REFRESH, se deshabilitarán todos los registros que no están incluidos en el conjunto de datos enviado (fuente de datos: ROW_STATUS=DISABLED, base de datos: ROWSTATUS=0).
COMPLETE_REFRESH_BY_DATA_SOURCE
Los registros del período contenidos en el archivo de datos se crean o se actualizan con la configuración explícita de la disponibilidad del registro del período y proporcionando los rangos de disponibilidad en los que los cursos asociados a dichos períodos estarán disponibles (start_date) y cuando dejarán de estarlo (end_date). Como sucede con todas las operaciones de actualización por fuente de datos COMPLETE_REFRESH_BY_DATA_SOURCE, se deshabilitan todos los registros que no están incluidos en el conjunto de datos enviado y que tienen una clave de fuente de datos que concuerde con el origen de datos configurado en la integración (fuente de datos: ROW_STATUS=DISABLED, base de datos: ROWSTATUS=0). Los registros del período TERM que no estén asociados al origen de datos de integración configurado no se ven afectados.
Uso de TERM en fuentes del curso
Las organizaciones y los cursos comparten los mismos patrones de gestión de TERM. Los ejemplos proporcionados permanecerán centrados en el uso del objeto TERM en un curso.
Si bien es posible controlar la disponibilidad de los cursos mediante el uso de la duración, las fechas, la disponibilidad y el estado de fila, el uso del objeto TERM permite la aplicación de los mismos ajustes a grupos de cursos según asociados al objeto TERM. TERM es un elemento de datos opcional en las fuentes del curso.
Los resultados operativos normales deben preverse en función de la operación elegida para enviar los datos a Learn.
Ejemplo: Administrar disponibilidad
En el ejemplo, creó objetos TERM para cada uno de sus períodos de 2014 de Artes y Ciencias, y ahora los institutos de Medicina desean gestionar la disponibilidad de algunos de los cursos de cada institución con esos objetos TERM.
Requisitos previos
Creó objetos TERM a los cuales desea asociar sus cursos. No hay requisitos previos; los cursos se crearán y se asociarán con el objeto TERM proporcionado o se actualizarán con la asociación de TERM según se indique en el tipo de duración DURATION de TERM.
Requisitos mínimos de fuente de datos
EXTERNAL_COURSE_KEY
COURSE_ID
COURSE_NAME
DURATION
TERM_KEY
Solución
Crear un archivo de datos termmanagedcourses.txt que contenga los encabezados necesarios y los datos asociados al curso que desee añadir o actualizar en el sistema.
Para utilizar correctamente START_DATE y END_DATE también debe establecerse DURATION (RANGE). Por ejemplo:
EXTERNAL_COURSE_KEY|COURSE_ID|COURSE_NAME|DURATION|TERM_KEY
AHIST.101-01.03.FA2013|AHIST.101-01.03.FA2013|Art History 101|TERM|AS_FA.2013
AHIST.101-01.03.WI2013|AHIST.101-01.03.WI2013|Art History 101|TERM|AS_WI.2014
AHIST.101-01.03.SP2013|AHIST.101-01.03.SP2013|Art History 101|TERM|AS_SP.2014
AHIST.101-01.03.SU2013|AHIST.101-01.03.SU2013|Art History 101|TERM|AS_SU.2014
ANAT.100-01.T1|ANAT.100-01.T1|Basic Anatomy|TERM|MED_T1.2013
ANAT.100-01.T2|ANAT.200-01.T2|Intermediate Anatomy|TERM|MED_T2.2014
ANAT.100-01.T3|ANAT.300-01.T3|Advanced Anatomy|TERM|MED_T3.2014
Condición posterior
Los cursos de la fuente de datos se crean o se actualizan y serán visibles para los usuarios según las indicaciones de los parámetros de TERM asociado con cada curso. El efecto sobre otros datos del sistema depende de la operación utilizada para cargar los datos en Learn:
STORE
Cuando usa la operación de guardado, esta no tiene un impacto sobre ningún otro dato. Solo se agregan o actualizan los datos contenidos en el archivo de fuente de datos.
COMPLETE REFRESH
Cuando utiliza la operación para completar la actualización, se agregan o se actualizan los datos que se encuentran en el archivo, todos los demás datos que gestiona esta fuente de datos se deshabilitan porque no están presentes en el archivo de datos, independientemente de la fuente.
COMPLETE REFRESH by DATA SOURCE
Cuando utiliza la operación para completar la actualización por fuente de datos, se agregan o se actualizan los datos que se encuentran en el archivo; y se deshabilitan todos los demás datos que gestiona esta fuente de datos y los asociados con la fuente de datos configurada de esta integración. Los datos que no se encuentran en el archivo fuente y que no están asociados con la fuente de datos de la integración no se ven afectados.
Más información
Descripción general del marco de trabajo SIS
Descripciones del encabezado del archivo de instantánea sin formato
