Los siguientes ejemplos muestran la composición de las fuentes de datos User (Person) a fin de satisfacer diferentes casos prácticos. Estos ejemplos usan la fuente de datos más sencilla posible. En caso de que su institución necesite más información, puede incorporarla añadiendo los encabezados y datos necesarios a la fuente de datos. Es conveniente analizar el sistema de información de su institución y los requisitos de registro y planificar en consecuencia para determinar la profundidad de datos necesaria y agregar información a Learn que cumpla sus objetivos de ciclo de vida de los datos.
Los ejemplos se basan en los ajustes predeterminados de Learn, que están visibles en la interfaz de usuario de configuración de la integración. Si se cambian estos elementos de configuración, también cambiará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.
Usuarios
Los datos User constituyen el conjunto de información principal que describe quién tiene acceso a Learn, su rol en la institución y su rol en el sistema Learn. En el contexto de los datos SIS, se suele hacer referencia a los objetos USER como "PERSON", lo cual se refleja en los estándares existentes. Learn es anterior a dichos estándares, por lo que usa "PERSON" y "USER" para hacer referencia a los registros relacionados con los usuarios según el contexto. En los ejemplos siguientes usaremos "PERSON" para referirnos al registro y "USER" para referirnos a la persona.
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.
Se pueden suministrar datos a Learn y luego actualizarlos, eliminarlos o corregirlos. De este modo, puede empezar con el conjunto de datos más sencillo y ampliarlo a medida que cambian 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 las claves, la fuente de datos y la "propiedad" de los datos, consulte la Descripción general del marco de trabajo SIS. |
| Actualizar | Almacena, actualiza o desactivaun registro proporcionado presente en la fuente y 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. |
| Completar actualización por fuente de datos | Deshabilita el registro proporcionado. Esta operación, incorporada en el SP 12, lleva a cabo una actualización completa de los datos asociados SOLO con la fuente de datos configurada en la integración. Esta operación simula de forma más o menos exacta el proceso de instantánea desde la línea de comandos para actualizar los datos. |
Los objetos asociados con las operaciones PERSON son:
| Persona | Guardar, Actualización completa, Eliminar, Actualización completa por origen de datos |
| Rol de institución secundario del usuario | Guardar, Actualización completa, Eliminar, Actualización completa por origen de datos |
| Asociación de usuario | Guardar, Actualización completa, Eliminar, Actualización completa por origen de datos |
Se pueden encontrar ejemplos de asociación de usuario en la sección de ejemplos de jerarquía.
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 necesario en fuentes de datos basadas en el marco de trabajo y, a menos que se especifique lo contrario, los ejemplos que se exponen a continuación asumen que la integración está configurada para usar un único origen de datos.
En el SP 12, se incorporó la capacidad para indicar el origen de datos en la fuente de datos de forma independiente a la especificación de un nuevo origen de datos.
Para obtener más información, consulte Gestión de las claves 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 tener control total sobre los datos que se almacenan y le permite satisfacer las reglas específicas de Learn cuando los datos del SIS que proporciona no son suficientes como, por ejemplo, al crear contraseñas de usuario. Cuando se aplica a un campo de objeto User, la secuencia de comandos asociada se ejecuta por cada usuario y, de esta forma, altera o proporciona los datos antes de almacenarlos en Learn. Puede encontrar una explicación completa sobre la asignación de campos para los archivos de instantáneas sin formato en Asignación de campos de archivos de instantáneas sin formato.
Nota sobre contraseñas
Las contraseñas son necesarias para iniciar sesión en Learn, pero no son un campo obligatorio en las fuentes de datos PERSON. Si no se proporciona una contraseña en la fuente de datos, se generará una contraseña SHA512 aleatoria y se almacenará en la base de datos. Esto no representa un problema si usa una autenticación externa (como LDAP), pero ¿qué ocurre si usa la base de datos de Learn para almacenar las contraseñas de inicio de sesión de los usuarios? Debe proporcionar la contraseña al crear cada usuario o, de lo contrario, no podrán iniciar sesión.
Si ejecuta una fuente de datos, establece la contraseña de un usuario y, con posterioridad, este usuario cambia la contraseña, no podrá llevar a cabo el inicio de sesión. Sí y no. En una operación de actualización, puede seleccionar no actualizar el campo de contraseña. De este modo, Learn podrá mantener la contraseña actual al realizar la actualización. Si no se selecciona esta opción, la contraseña se cambiará y será necesario avisar del cambio al usuario.
Ejemplos de operaciones de persona
De manera general, se pueden aplicar tres patrones de fuentes de datos de integración SIS a todas las operaciones de datos de usuario; y la selección de los patrones depende de los datos que se puedan proporcionar y de las metas de integración.
- Con un único archivo de fuente de datos, puede crear, actualizar o deshabilitar registros (Guardar) cambiando explícitamente los registros mediante los datos presentes en el archivo.
- Con un único archivo de fuente de datos puede actualizar datos, es decir, crear, actualizar y desactivar registros (Actualización completa), cambiando los registros mediante la presencia (crear/actualizar) o ausencia de datos en el archivo.
- Con una combinación de archivos puede almacenar con uno y establecer la disponibilidad o desactivar con el otro.
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 datos que SIS ya no proporciona o que no proporcionó en ningún momento como, por ejemplo, los datos resultantes de las operaciones de prueba.
Conceptos básicos: Personas
Para establecer cualquier cuenta de usuario, es necesario un conjunto básico de datos. Esta información se encuentra detallada en Formato de datos del archivo de instantáneas sin formato y en Encabezado del archivo de instantáneas sin formato.
Si en la actualidad utiliza las herramientas de lotes de la interfaz de usuario, puede empezar a usar el marco de trabajo SIS con los datos de usuario mínimos y las funciones de carga de la interfaz de usuario del marco de trabajo SIS para obtener mejores funciones de registro e informes de sus cargas de datos, sin alterar los procesos de recopilación de datos.
Información básica sobre los datos
El conjunto mínimo de datos o encabezados necesarios para la creación de una cuenta de usuario en Learn consiste en los siguiente elementos:
- EXTERNAL_PERSON_KEY: identificador único para el registro del usuario.
- DATA_SOURCE_KEY: identificador único para el conjunto de datos de este registro. Nota: Este elemento se proporciona en la fuente de datos o en la configuración de integración.
- USER_ID: el ID del usuario. Este valor se usa para iniciar sesión con el nombre de usuario y debe asociarse con el CN de LDAP, NET ID o cualquier otro identificador externo del usuario si utiliza una autenticación externa.
- FIRST_NAME: el nombre del usuario.
- LAST_NAME: el apellido del usuario.
- PASSWD: la contraseña del usuario
Si desea ver un ejemplo de la asignación dinámica de una contraseña en caso de que no pueda brindar una en la fuente de datos, consulte Asignación de campos personalizados del archivo de instantáneas sin formato.
Para cada configuración de integración, el marco de trabajo SIS proporciona valores predeterminados para los campos no obligatorios (o los ignora). Hay dos campos que no son obligatorios para una fuente de datos PERSON y que resultan especialmente útiles, EMAIL y SYSTEM_ROLE. EMAIL es necesario para la correspondencia y para proporcionar notificaciones por correo electrónico a los usuarios de Learn a través del servicio de correo electrónico de Learn, por ello es recomendable incluir esta información en la fuente de datos. SYSTEM_ROLE tiene un valor predeterminado de NONE (ninguno).
Cada uno de estos encabezados se describe por completo en Formato de datos del archivo de instantáneas sin formato.
Agregar información de persona
Existen dos casos prácticos para añadir información de PERSON. El primero es GUARDAR la información de PERSON de forma aditiva, lo que da lugar a la adición o actualización de registros según se presentan en la fuente de datos. El segundo es ACTUALIZAR la información de PERSON ya existente en Learn, lo que da lugar a la adición de registros nuevos o a la actualización de los existentes según se presentan en el archivo de datos y también a la desactivación de los registros existentes que no están presentes en el archivo de datos.
Ejemplos de operaciones de guardado
Ejemplo 1: Crear cuentas de persona
Desea agregar usuarios a Blackboard Learn sin que esto afecte a las cuentas existentes. 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_PERSON_KEY
USER_ID
PASSWD
FIRSTNAME
LASTNAME
Solución
Cree un archivo de datos ELEMENTOS PERSON.txt que contenga los encabezados y datos asociados necesarios por cada elemento PERSON que desee añadir al sistema. Por ejemplo:
EXTERNAL_PERSON_KEY|USER_ID|PASSWD|FIRSTNAME|LASTNAME
testPerson1|aanderson_test|changeme|Alpha|Anderson
testPerson2|bbrown_test|changeme|Beta|Brown
testPerson3|gcarlin_test|changeme|Gamma|Carlin
Use la interfaz de usuario para cargar este archivo a través del tipo de datos PERSON usando la operación GUARDAR. Se creará la cuenta de usuario y podrá iniciar sesión como el usuario.
Condición posterior
Se crean registros de PERSON de aanderson_test, bbrown_test, and ccarlin_test.
Ejemplo 2: Actualizar cuentas de usuario
Ha creado cuentas de usuario y necesita cambiarlas. Por ejemplo: en el caso anterior, no se incluyó ninguna dirección de correo electrónico (EMAIL) del usuario. Tiene la dirección de correo electrónico de aanderson_test.
Requisitos previos
Ninguno: las actualizaciones se llevarán a cabo en los registros creados con anterioridad, si se incluyen datos sobre un registro que no existe en Learn, se creará dicho registro.
Solución
Cree un archivo de datos ELEMENTOS PERSON.txt que contenga los encabezados y datos asociados necesarios por cada elemento PERSON que desee añadir al sistema. Por ejemplo:
EXTERNAL_PERSON_KEY|USER_ID|PASSWD|FIRSTNAME|LASTNAME|EMAIL
testPerson1|aanderson_test|changeme|Alpha|Anderson|[email protected]
Dado que la operación STORE solo actúa sobre los datos contenidos en el archivo, no se verán afectados los registros bbrown_test y ccarlin_test enviados con anterioridad.
Use la interfaz de usuario para cargar este archivo a través del tipo de datos PERSON usando la operación GUARDAR. Se actualizará la cuenta de usuario.
Condición posterior
Se actualizará el registro de PERSON de aanderson_test para incluir la dirección de correo electrónico proporcionada.
Los registros de PERSON de bbrown_test y ccarlin_test no se verán afectados.
Persona: Operación Completar actualización
La operación COMPLETE REFRESH funciona de forma diferente a STORE. ACTUALIZACIÓN COMPLETA lleva a cabo dos operaciones, que suponen la comparación de los datos del archivo de fuente de datos y los registros de LEARN que pertenecen a la integración; de este modo se almacenan nuevos registros, se actualizan los existentes y se desactivan en LEARN los que se encuentran en el archivo de datos.
Ejemplo: Completar actualización
Los datos proporcionados por SIS contienen una instantánea completa de los objetos PERSON que deben tener acceso a LEARN. Estos datos contienen los registros de PERSON que se deben añadir o actualizar, y también los registros que se han eliminado desde las operaciones de ACTUALIZACIÓN COMPLETA anteriores y que deben administrarse adecuadamente según la configuración (desactivar o borrar).
Requisitos previos
Ninguno.
Requisitos mínimos de fuente de datos
EXTERNAL_PERSON_KEY
USER_ID
PASSWD
FIRSTNAME
LASTNAME
Solución
Use los datos de nuestra última operación de almacenamiento y elimine gcarlin_test de la fuente de datos:
EXTERNAL_PERSON_KEY|USER_ID|PASSWD|FIRSTNAME|LASTNAME
testPerson1|aanderson_test|changeme|Alpha|Anderson
testPerson2|bbrown_test|changeme|Beta|Brown
Si esta integración administra otros registros de PERSON, estos se deshabilitarán o borrarán porque no aparecen en la fuente de datos anterior.
Condición posterior
El registro de PERSON de aanderson_test se conservará y no se verá afectado.
El registro de PERSON de bbrown_test se conservará y se actualizará para incluir la dirección de correo electrónico.
El registro de PERSON de ccarlin_test se marcará como deshabilitado o listo para borrarse, según la configuración de la integración.
Persona: Operación Completar actualización por fuente de datos
La función COMPLETE REFRESH BY DATA SOURCE ejecuta la operación COMPLETE REFRESH, pero restringe los datos que se ven afectados a aquellos que están asociados únicamente con la fuente de datos de la integración.
Ejemplo: Completar actualización por fuente de datos
Los datos proporcionados por SIS contienen una instantánea completa de los objetos PERSON que deben tener acceso a LEARN. Estos datos contienen los registros PERSON que se deben agregar o actualizar, y también los registros que se han eliminado desde las operaciones REFRESH anteriores y que deben administrarse adecuadamente según la configuración (deshabilitar o borrar). Además, todos los datos de esta actualización se abordan con la misma fuente de datos que se definió en la integración, ya que desea que SOLO resulten afectados los datos relacionados con esta clave de la fuente de datos.
Requisitos previos
Ninguno.
Requisitos mínimos de fuente de datos
EXTERNAL_PERSON_KEY
USER_ID
PASSWD
FIRSTNAME
LASTNAME
Solución
Use los datos de nuestra última operación de guardado y eliminamos gcarlin_test de la fuente de datos:
EXTERNAL_PERSON_KEY|USER_ID|PASSWD|firstname|lastname
testPerson1|aanderson_test|changeme|Alpha|Anderson
testPerson2|bbrown_test|changeme|Beta|Brown
Condición posterior
El registro de PERSON de aanderson_test se conservará y no se verá afectado.
El registro de PERSON de bbrown_test se conservará y se actualizará para incluir la dirección de correo electrónico.
El registro de PERSON de ccarlin_test creado anteriormente se marcará como deshabilitado o listo para borrarse según la configuración de la integración.
Si esta integración administra otros registros de PERSON, estos NO se deshabilitarán ni borrarán aunque no estén presentes en la fuente de datos anterior, a menos que tengan la misma fuente de datos especificada en la integración.
Disponibilidad de cuenta de persona
La configuración de disponibilidad de una cuenta de PERSON define si una cuenta de LEARN puede iniciar sesión (disponible) o no (no disponible). Tenga en cuenta que esta operación no es equivalente a desactivar una cuenta, lo cual no solo hace que la cuenta no esté disponible, sino que también provoca que no se puedan realizar operaciones adicionales sobre él, como la administración de pertenencias. La adición de este encabezado de fuente de datos no modifica el uso explicado anteriormente de las operaciones STORE, COMPLETE REFRESH y COMPLETE REFRESH BY DATA SOURCE para la creación de registros de PERSON.
Los ajustes de integración predeterminados cuando no se proporciona una configuración de AVALABILITY (disponibilidad) hacen que el objeto esté disponible en las operaciones de creación/actualización.
Ejemplo: Disponibilidad de cuenta de persona
El SIS controla la disponibilidad del acceso a LEARN para los usuarios, y la fuente de datos indica si los usuarios tienen acceso a Learn de forma individual. Usted desea realizar cambios en el acceso individual de los usuarios mediante la creación o actualización de PERSON.
Requisitos previos
Ninguno.
Requisitos mínimos de fuente de datos
EXTERNAL_PERSON_KEY
USER_ID
PASSWD
FIRSTNAME
LASTNAME
AVAILABILITY_IND
Solución
Agregue el encabezado AVAILABLE_IND a la fuente de datos junto con el carácter Y si desea que esté disponible, o bien N si desea que no lo esté.
EXTERNAL_PERSON_KEY|USER_ID|PASSWD|FIRSTNAME|LASTNAME|AVAILABLE_IND
testPerson1|aanderson_test|changeme|Alpha|Anderson|Y
testPerson2|bbrown_test|changeme|Beta|Brown|Y
testPerson3|gcarlin_test|changeme|Gamma|Carlin|N
testPerson4|ddarling_test|changeme|Delta|Darling|Y
Condición posterior
GUARDAR
Solo se actualizan los registros de PERSON de aanderson_test, bbrown_test y ccarlin_test (creados con anterioridad) y se crea ddarling_test.
COMPLETE REFRESH
Se actualizan los registros de PERSON de aanderson_test, bbrown_test y ccarlin_test (creados con anterioridad) y se crea ddarling_test. Todos los demás registros se deshabilitarán o se marcarán para su eliminación porque no aparecen en la fuente de datos anterior.
ACTUALIZACIÓN COMPLETA POR ORIGEN DE DATOS
Se actualizan los registros de PERSON de aanderson_test, bbrown_test y ccarlin_test (creados con anterioridad) y se crea ddarling_test.
Si esta integración administra otros registros de PERSON, estos NO se deshabilitarán ni borrarán aunque no estén presentes en la fuente de datos anterior, a menos que tengan la misma fuente de datos especificada en la integración. La operación COMPLETE REFRESH BY DATA SOURCE solo actúa sobre los registros de la fuente de datos de la integración.
Deshabilitar registros de persona
Si se deshabilita un registro de PERSON en Learn, no se podrá iniciar sesión con él (el estado deshabilitado anula la configuración de disponibilidad). El registro tampoco estará disponible para las operaciones de interfaz de usuario. Por ejemplo, no es posible añadir un elemento PERSON a un curso a través de la interfaz de usuario. Además, para borrar un registro de Learn, es necesario desactivarlo en primer lugar.
Desactivar un registro y borrarlo a continuación elimina todas las referencias a dicho registro en Learn. Blackboard recomienda que solo se lleve a cabo el borrado de registros una vez transcurrido un tiempo prudencial dictado por los requisitos legales o las prácticas de su empresa, que pueden requerir guardar un registro de las actividades.
Los registros se pueden deshabilitar de dos maneras: mediante su exclusión de la fuente de datos en operaciones REFRESH, o bien mediante el uso del encabezado ROW_STATUS de la fuente de datos.
Las operaciones anteriores sobre elementos PERSON en las que se usan operaciones ACTUALIZAR muestran la primera de estas opciones. En el caso y ejemplo siguientes se explica la forma de usar ROW_STATUS.
Ejemplo: Deshabilitar registros de persona
Los alumnos se matriculan o no es necesario que sigan teniendo acceso a Learn. Se le solicita que elimine por completo su acceso a Learn y su presencia en el sistema (que no es igual que marcarlos como no disponibles, lo cual solo restringe su capacidad de iniciar sesión). Si usa operaciones GUARDAR, para desactivar usuarios debe hacerlo explícitamente mediante el encabezado ROW_STATUS. Esto también resulta útil en las operaciones manuales fuera del alcance de las fuentes de datos de SIS.
Requisitos previos
Los registros abordados deben existir en el sistema Learn.
Requisitos mínimos de fuente de datos
EXTERNAL_PERSON_KEY
USER_ID
PASSWD
FIRSTNAME
LASTNAME
ROW_STATUS
Solución
Agregue el encabezado ROW_STATUS a su fuente de datos e incluya una entrada ENABLED para los registros que desee habilitar, o bien DISABLED para los que desee deshabilitar.
EXTERNAL_PERSON_KEY|USER_ID|PASSWD|FIRSTNAME|LASTNAME|ROW_STATUS
testPerson1|aanderson_test|changeme|Alpha|Anderson|enabled
testPerson2|bbrown_test|changeme|Beta|Brown|enabled
testPerson3|gcarlin_test|changeme|Gamma|Carlin|disabled
testPerson4|ddarling_test|changeme|Delta|Darling|enabled
Condición posterior
GUARDAR
Solo se crean o actualizan los registros de PERSON de aanderson_test, bbrown_test, ccarlin_test y ddarling_test con el estado ROW_STATUS actualizado de forma explícita.
COMPLETE REFRESH
Se crean o actualizan los registros de PERSON de aanderson_test, bbrown_test, ccarlin_test, y ddarling_test. Todos los demás registros se deshabilitarán o se marcarán para su eliminación porque no aparecen en la fuente de datos anterior.
ACTUALIZACIÓN COMPLETA POR ORIGEN DE DATOS
Se actualizan los registros de PERSON de aanderson_test, bbrown_test y ccarlin_test (creados con anterioridad) y se crea ddarling_test.
Si esta integración administra otros registros de PERSON, estos NO se deshabilitarán ni borrarán aunque no estén presentes en la fuente de datos anterior, a menos que tengan la misma fuente de datos especificada en la integración. La operación COMPLETE REFRESH BY DATA SOURCE solo actúa sobre los registros de la fuente de datos de la integración.
ACTUALIZACIÓN COMPLETA POR ORIGEN DE DATOS
Se crean o actualizan los registros de PERSON de aanderson_test, bbrown_test, ccarlin_test y ddarling_test con el estado ROW_STATUS actualizado de forma explícita.
Si esta integración administra otros registros de PERSON, estos NO se deshabilitarán ni borrarán aunque no estén presentes en la fuente de datos anterior, a menos que tengan la misma fuente de datos especificada en la integración. La operación COMPLETE REFRESH BY DATA SOURCE solo actúa sobre los registros de la fuente de datos de la integración.
Administración de los roles institucionales secundarios del usuario
Como titular de una licencia de comunidad, tiene acceso a roles adicionales que puede asignar a los usuarios y que resultan útiles para administrar el acceso a los materiales y las pestañas en el portal de la comunidad.
La administración de los roles secundarios es una actividad distinta de la creación o actualización de usuarios y, por tanto, no forma parte de la fuente de datos para la creación o actualización de elementos PERSON.
Ejemplo: Agregar roles institucionales secundarios del usuario
Debe proporcionar contenido del portal específico de los alumnos y el personal docente de la facultad de ingeniería.
Requisitos previos
Creó un nuevo rol institucional mediante la interfaz de usuario de Administrador del sistema (consulte...) llamado "ENGINEERING_STUDENT"
Requisitos mínimos de fuente de datos
EXTERNAL_PERSON_KEY
ROLE_ID
Solución
Cree una fuente de datos de Institutional_Role que contenga los registros que desea crear o actualizar.
EXTERNAL_PERSON_KEY|ROLE_ID
testPerson1|engineering_student
testPerson2|engineering_faculty
testPerson3|engineering_faculty
testPerson4|engineering_student
Al igual que ocurre con otros objetos de datos, también puede proporcionar el valor ROW_STATUS para habilitar o deshabilitar el acceso de los elementos PERSON al contenido asociado con el rol secundario. Por ejemplo:
EXTERNAL_PERSON_KEY|ROLE_ID|ROW_STATUS
testPerson1|engineering_student|enabled
testPerson2|engineering_faculty|enabled
testPerson3|engineering_student|disabled
Condición posterior
GUARDAR
Solo se crean o actualizan los registros de roles institucionales secundarios de aanderson_test, bbrown_test, ccarlin_test y d con el rol institucional secundario.
COMPLETE REFRESH
Se crean o actualizan los registros de roles institucionales secundarios de aanderson_test, bbrown_test, ccarlin_test y d. Todos los demás registros se deshabilitarán o se marcarán para su eliminación porque no aparecen en la fuente de datos anterior.
ACTUALIZACIÓN COMPLETA POR ORIGEN DE DATOS
Se crean o actualizan los registros de roles institucionales secundarios de aanderson_test, bbrown_test, ccarlin_test y d.
Si esta integración administra otros registros de PERSON, estos NO se deshabilitarán ni borrarán aunque no estén presentes en la fuente de datos anterior, a menos que tengan la misma fuente de datos especificada en la integración. La operación COMPLETE REFRESH BY DATA SOURCE solo actúa sobre los registros de la fuente de datos de la integración.
Observadores
Los observadores son usuarios de tipo especial en los que la cuenta está vinculada a otra cuenta usuario en una función de supervisión u observación. El observador puede iniciar sesión y ver los cursos y actividades de su usuario asociado.
Para crear una cuenta de observador, se requiere la misma información que para una cuenta de usuario, y dispone de una capa adicional de "Gestión de asociación de usuarios", en la que el observador se asocia con una cuenta de usuario vinculando los valores external_person_keys de ambas cuentas.
La cuenta de observador se crea exactamente del mismo modo en que se crea cualquier otra cuenta de usuario, siguiendo los requisitos de procesamiento de datos de su institución.
Ejemplo 1: Crear asociación de observador
Desea asociar a un alumno con la cuenta de sus padres (o cualquier otro usuario adecuado) para poder realizar un seguimiento de su actividad.
Requisitos previos
Creó un estudiante identificado por external_person_key (test_student_100 en este ejemplo) y un observador identificado por external_person_key (test_student_100_observer y test_student_200_observer en el ejemplo).
Requisitos mínimos de datos
El external_person_key del observador: EXTERNAL_OBSERVER_KEY
El external_person_key del alumno observado: EXTERNAL_USER_KEY
Solución
Cree un archivo de datos que contenga el valor de external_person_key del observador y del estudiante.
EXTERNAL_OBSERVER_KEY|EXTERNAL_USER_KEY
test_student_100_observer|test_student_100
test_student_200_observer|test_student_100
Use la interfaz de usuario para cargar este archivo a través del tipo de datos de asociación de observador usando la operación STORE. Se creará la asociación y podrá iniciar sesión como observador y ver la actividad del estudiante en los cursos.
Ejemplo 2: Actualizar el registro de asociación de observador
Necesita cambiar una asociación.
Requisitos previos
Creó una asociación entre test_student_200_observer y test_student_100, pero la cuenta de estudiante asociada debe ser test_student_200.
Solución
Cree un archivo que contenga la revisión.
EXTERNAL_OBSERVER_KEY|EXTERNAL_USER_KEY
test_student_200_observer|test_student_200
Use la interfaz de usuario para cargar este archivo a través del tipo de datos de asociación de observador usando la operación STORE.
Condición posterior
Se actualizará la asociación y podrá iniciar sesión como observador y ver la actividad del alumno correcto en los cursos.
Ejemplo 3: Deshabilitar registros de asociación de observador
Una asociación de observador ya no es necesaria y desea desactivarla.
Requisitos previos
Ha creado asociaciones entre alumnos y observadores.
Solución
(Usando los datos empleados en este hilo de ejemplo)
Anteriormente, creó asociaciones con el método de guardado y el siguiente archivo:
EXTERNAL_OBSERVER_KEY|EXTERNAL_USER_KEY
test_student_100_observer|test_student_100
test_student_200_observer|test_student_200
Existen dos patrones relativos a la fuente de datos que permiten satisfacer el requisito de deshabilitar una asociación de observador en función de sus necesidades:
- Desea desactivar un subconjunto de asociaciones de observadores asociadas con la integración/origen de datos actual.
- Desea desactivar un subconjunto de asociaciones de observadores y, al mismo tiempo, almacenar o actualizar registros adicionales.
Deshabilitar un subconjunto de asociaciones de observador
Para desactivar un subconjunto de datos, cree una fuente de datos de asociación y cárguelo con la operación Eliminar. Por ejemplo:
Para eliminar la asociación entre test_student_100_observer|test_student_100 en el conjunto de datos de trabajo, cree un archivo de fuente de datos que contenga lo siguiente, y cárguelo usando la operación de eliminación:
EXTERNAL_OBSERVER_KEY|EXTERNAL_USER_KEY
test_student_200_observer|test_student_200
Deshabilitar un subconjunto de asociaciones de observador y, al mismo tiempo, almacenar asociaciones nuevas o existentes
Para deshabilitar un subconjunto de datos que también permita actualizar asociaciones existentes o crear otras nuevas, cree un archivo de asociación que contenga las asociaciones existentes y las nuevas, elimine aquellas que desea deshabilitar y cárguelo usando la operación Completar actualización. Por ejemplo, mediante el conjunto de trabajo de:
EXTERNAL_OBSERVER_KEY|EXTERNAL_USER_KEY
test_student_100_observer|test_student_100
test_student_200_observer|test_student_200
Queremos deshabilitar la asociación test_student_200_observer|test_student_200, de modo que el archivo solo contenga la asociación test_student_100_observer|test_student_100. Si además quisiéramos agregar dos asociaciones nuevas (siempre que se cumpla el requisito previo de creación de las cuentas de usuario), cargaríamos lo siguiente:
EXTERNAL_OBSERVER_KEY|EXTERNAL_USER_KEY
test_student_100_observer|test_student_100
test_student_300_observer|test_student_300
test_student_400_observer|test_student_400
Condición posterior
El registro de test_student_200_observer|test_student_200 está deshabilitado.
Más información
Descripción general del marco de trabajo SIS
Descripciones del encabezado del archivo de instantánea sin formato
