Saltar al contenido principal
pdf?stylesheet=default
Blackboard Help

Ejemplos de usuarios

Ejemplos de usuarios

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 que se exponen a continuación se basan en los ajustes predeterminados de Learn, que son 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 Descripción general del marco de trabajo SIS. Además, se presupone que, a menos que se indique lo contrario, la integración se configurará para usar el mismo origen de datos para todos los datos de entrada.

Nota sobre la asignación de campos

La asignación de campos proporciona la capacidad 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 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 en Asignación de campos del archivo de instantánea sin formato.

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, que es anterior a dichos estándares, 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 los datos del archivo de instantánea sin formato

El marco de trabajo SIS admite la fuente de datos de archivos de instantánea sin formato a través de la carga de datos de interfaz de usuario y también a través de un conjunto de direcciones URL proporcionadas por el sistema Learn. 

Puede tener acceso a la información de HTTP y al archivo de carga de datos a través del menú contextual de la interfaz de usuario de integración de los sistemas de información de alumnos de integración de datos de la administración del sistema.>

En ambos casos, el comportamiento de las operaciones de datos viene dado por la configuración de la integración y el 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 satisfacer los objetivos de integración que desee alcanzar.

Los ejemplos proporcionados se explican mediante la capacidad Cargar archivo de fuente de la interfaz de usuario de marco de trabajo de instantánea. Si desea automatizar las operaciones o bien utilizarlas a través de la línea de comandos o en programas, consulte Automatización del archivo de instantánea sin formato.

Es posible suministrar datos a Learn y, en el futuro, actualizarlos, eliminarlos o corregirlos. De este modo, puede empezar con un conjunto de datos muy sencillo e ir ampliándolo 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

Almacena o actualizaun registro proporcionado por la configuración de integración.

Al usar este tipo de operación, los datos contenidos en el archivo de fuente se almacenan o actualizan (según los ajustes de configuración) en todos los orígenes de datos que posee la integración. Para obtener más información sobre la "propiedad" de los datos, los orígenes de datos y las claves, consulte Descripción general del marco de trabajo SIS.

Actualizar

Almacena, actualiza o desactiva un 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

Desactiva el registro proporcionado.

Esta operación desactiva, de acuerdo con los ajustes de configuración, los registros contenidos en las fuentes de datos asociadas con la integración en todos los orígenes de datos.

Actualización completa por origen de datos

Desactiva el registro proporcionado.

Esta operación, introducida en SP 12, lleva a cabo una actualización completa de los datos asociados SOLO con el origen de datos configurado 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 explican mediante la capacidad Cargar archivo de fuente de la interfaz de usuario de marco de trabajo de instantánea. Si desea automatizar las operaciones o bien utilizarlas a través de la línea de comandos o en programas, consulte Automatización del archivo de instantánea sin formato.

Recordatorio sobre las claves de origen de datos

Todos los objetos de datos permiten alterar la clave de origen de datos para la agrupación de ese conjunto de datos y se pueden usar para alterar el origen de datos asociado. 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 SP 12 se introdujo la capacidad de especificar 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 Información general de la clave de origen de datos.

Nota sobre la asignación de campos

La asignación de campos proporciona la capacidad 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 del archivo de instantánea sin formato en Asignación de campos del archivo de instantánea 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 es ningún problema si usa autenticación externa (como, por ejemplo, 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 con PERSON

A alto nivel, se pueden identificar tres patrones de fuente de datos de integración SIS que pueden aplicarse a todas las operaciones de datos User. La selección del patrón depende de los datos que pueda proporcionar y de sus objetivos de integración.

  • Con un único archivo de fuente de datos, puede crear, actualizar o desactivar registros (Guardar) explícitamente 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: elementos PERSON

Para establecer cualquier cuenta de usuario, es necesario un conjunto básico de datos. Este conjunto de información se detalla en Formato de datos del archivo de instantánea sin formato y Encabezado del archivo de instantánea sin formato.

Si en la actualidad está usando las herramientas de lotes de la interfaz de usuario, empezar a usar el marco de trabajo SIS con los datos User mínimos y las capacidades de carga de interfaz de usuario del marco de trabajo SIS le proporcionará mejores funciones de registro e informes de sus cargas de datos sin alterar los procesos de colección de datos.

Información básica sobre datos

El conjunto mínimo de datos o encabezados necesario para crear una cuenta de usuario en Learn consta de los siguientes elementos: 

  • EXTERNAL_PERSON_KEY: un identificador único de este registro de usuario.
  • DATA_SOURCE_KEY: un identificador único del conjunto de datos de este registro. Nota: esto se proporciona en la fuente o mediante 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 si va a usar autenticación externa.
  • FIRST_NAME: el nombre de pila del usuario
  • LAST_NAME: los apellidos del usuario
  • PASSWD: la contraseña de este usuario
    Si desea ver un ejemplo de asignación dinámica de una contraseña en caso de no poder proporcionar una en la fuente de datos, consulte Asignación de campos personalizados del archivo de instantánea 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).

Todos estos encabezados se describen con detalle en Formato de datos del archivo de instantánea sin formato.

Añadir información de PERSON

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.

Ejemplo de GUARDAR

GUARDAR PERSON, caso n.º 1: crear cuentas de PERSON

Desea añadir usuarios a LEARN sin que esto afecte a las cuentas existentes. Tiene su integración configurada para usar el mismo origen 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 crearán los registros de PERSON de aanderson_test, bbrown_test y ccarlin_test.

GUARDAR PERSON, caso n.º 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|...owhere.erehwon

Dado que GUARDAR solo actúa sobre los datos contenidos en el archivo, los registros bbrown_test y ccarlin_test enviados con anterioridad no se verán afectados.

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.

ACTUALIZACIÓN COMPLETA DE PERSON

La operación ACTUALIZACIÓN COMPLETA funciona de forma diferente a GUARDAR. 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.

Caso de ACTUALIZACIÓN COMPLETA

Los datos proporcionados por SIS contienen una instantánea completa de los elementos 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 GUARDAR 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, dichos registros se desactivarán o borrarán por no aparecer 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 actualizará para incluir la dirección de correo electrónico.

El registro de PERSON de ccarlin_test se marcará como desactivado o listo para ser borrado según la configuración de la integración.

ACTUALIZACIÓN COMPLETA POR ORIGEN DE DATOS

ACTUALIZACIÓN COMPLETA POR ORIGEN DE DATOS lleva a cabo una operación ACTUALIZACIÓN COMPLETA, pero restringe los datos que se ven afectados a aquellos que están asociados únicamente con el origen de datos de la integración.

Caso de ACTUALIZACIÓN COMPLETA POR ORIGEN DE DATOS

Los datos proporcionados por SIS contienen una instantánea completa de los elementos 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 tienen como destino el mismo origen de datos que se ha definido en la integración, ya que desea que SOLO resulten afectados los datos relacionados con esta clave de origen 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 STORE y elimine gcarlin_test de la introducción 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 actualizará para incluir la dirección de correo electrónico.

El registro de PERSON anteriormente creado de ccarlin_test se marcará como desactivado o listo para ser borrado según la configuración de la integración.

Si esta integración administra otros registros de PERSON, dichos registros NO se desactivarán ni borrarán a pesar de no estar presentes en la fuente de datos anterior a menos que tengan el mismo origen de datos que se ha especificado en la integración.

Disponibilidad de cuenta de PERSON

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 afecta al uso expuesto anteriormente de las operaciones GUARDAR, ACTUALIZACIÓN COMPLETA y ACTUALIZACIÓN COMPLETA POR ORIGEN DE DATOS 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.

Disponibilidad de cuenta de PERSON, caso 1

SIS controla la disponibilidad de acceso de LEARN y la fuente de datos indica la configuración de disponibilidad sobre los usuarios a fin de controlar cuándo tienen acceso a Learn, en caso de que desee controlar esta configuración de acceso al crear/actualizar elementos PERSON.

Requisitos previos

Ninguno.

Requisitos mínimos de fuente de datos

EXTERNAL_PERSON_KEY

USER_ID

PASSWD

FIRSTNAME

LASTNAME

AVAILABILITY_IND

Solución

Añada 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 actualizarán los registros de PERSON de aanderson_test, bbrown_test y ccarlin_test (habían sido creados con anterioridad) y se creará ddarling_test.

ACTUALIZACIÓN COMPLETA

Se actualizarán los registros de PERSON de  aanderson_testbbrown_testccarlin_test (habían sido creados con anterioridad) y se creará ddarling_test. Todos los demás registros se desactivarán o se marcarán para ser borrados por no aparecer en la fuente de datos anterior. 

ACTUALIZACIÓN COMPLETA POR ORIGEN DE DATOS

Se actualizarán los registros de PERSON de aanderson_testbbrown_testccarlin_test (habían sido creados con anterioridad) y se creará ddarling_test

Si esta integración administra otros registros de PERSON, dichos registros NO se desactivarán ni borrarán a pesar de no estar presentes en la fuente de datos anterior a menos que tengan el mismo origen de datos que se ha especificado en la integración. ACTUALIZACIÓN COMPLETA POR ORIGEN DE DATOS solo actúa sobre los registros del origen de datos de la integración.

Desactivar registros de PERSON

Desactivar un registro de PERSON en Learn hace que resulte inaccesible para iniciar sesión con él (el estado desactivado anula la configuración de disponibilidad) y también hace que el registro no esté disponible para 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.

Para desactivar registros se pueden seguir dos modelos: desactivarlos mediante su exclusión en la fuente de datos en operaciones ACTUALIZAR, o bien desactivarlos mediante el uso del encabezado de fuente de datos ROW_STATUS.

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.

Caso de desactivar registros de PERSON

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 operaciones manuales que quedan fuera del ámbito de las fuentes de datos de SIS.

Requisitos previos

Los registros objetivo 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

Añada el encabezado ROW_STATUS a su fuente de datos e incluya una entrada ENABLED para los registros que desee activar, o bien una DISABLED para los que desee desactivar.

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 valor de ROW_STATUS actualizado explícitamente.

ACTUALIZACIÓN COMPLETA

Se crean o se actualizan los registros de PERSON de aanderson_test, bbrown_test, ccarlin_test y ddarling_test; todos los demás registros se desactivarán o se marcarán para ser borrados por no aparecer en la fuente de datos anterior. 

ACTUALIZACIÓN COMPLETA POR ORIGEN DE DATOS

Se actualizarán los registros de PERSON de  aanderson_testbbrown_testccarlin_test (habían sido creados con anterioridad) y se creará ddarling_test.

Si esta integración administra otros registros de PERSON, dichos registros NO se desactivarán ni borrarán a pesar de no estar presentes en la fuente de datos anterior a menos que tengan el mismo origen de datos que se ha especificado en la integración. ACTUALIZACIÓN COMPLETA POR ORIGEN DE DATOS solo actúa sobre los registros del origen de datos de la integración.

ACTUALIZACIÓN COMPLETA POR ORIGEN DE DATOS

Se crean o se actualizan los registros de PERSON de aanderson_testbbrown_test, ccarlin_test y ddarling_test con el valor de ROW_STATUS actualizado explícitamente.

Si esta integración administra otros registros de PERSON, dichos registros NO se desactivarán ni borrarán a pesar de no estar presentes en la fuente de datos anterior a menos que tengan el mismo origen de datos que se ha especificado en la integración. ACTUALIZACIÓN COMPLETA POR ORIGEN DE DATOS solo actúa sobre los registros del origen de datos de la integración.

Administración de roles de institución secundarios

Como titular de una licencia de comunidad, tiene acceso a roles adicionales que puede asignar a usuarios y que resultan útiles para administrar el acceso a materiales y fichas en Community Portal.

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.

Caso de añadir roles de institución secundarios

Debe proporcionar contenido del portal específico de los alumnos y el personal docente de la facultad de ingeniería.

Requisitos previos

Ha creado un nuevo rol institucional mediante la interfaz de usuario de Administrador del sistema (consulte...) llamada "ENGINEERING_STUDENT".

Requisitos mínimos de fuente de datos

EXTERNAL_PERSON_KEY

ROLE_ID

Solución

Cree una fuente de datos llamada 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 activar o desactivar 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 se actualizan los registros de roles de institución secundarios de aanderson_testbbrown_testccarlin_testd con el rol de institución secundario.

ACTUALIZACIÓN COMPLETA

Se crean o se actualizan los registros de roles de institución secundarios de aanderson_testbbrown_testccarlin_testd; todos los demás registros se desactivarán o se marcarán para ser borrados por no aparecer en la fuente de datos anterior. 

ACTUALIZACIÓN COMPLETA POR ORIGEN DE DATOS

Se crean o actualizan los registros de roles de institución secundarios de aanderson_testbbrown_testccarlin_testd.

Si esta integración administra otros registros de PERSON, dichos registros NO se desactivarán ni borrarán a pesar de no estar presentes en la fuente de datos anterior a menos que tengan el mismo origen de datos que se ha especificado en la integración. ACTUALIZACIÓN COMPLETA POR ORIGEN DE DATOS solo actúa sobre los registros del origen 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.

Una cuenta de observador requiere para su creación de la misma información que una cuenta de usuario, y cuenta con una capa adicional de "Administració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 las dos 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.

Ejemplos de OBSERVER
Caso de creación de 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

Ha creado un alumno identificado por un cierto valor external_person_key (test_student_100 en este ejemplo) y un observador identificado por otro valor external_person_key (test_student_100_observer y test_student_200_observer en el ejemplo).

Requisitos de fuente 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 alumno.

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 GUARDAR. Se creará la asociación y podrá iniciar sesión como observador y ver la actividad del alumno en los cursos.

Actualización del registro de asociación de observador

Necesita cambiar una asociación. 

Requisitos previos

Ha creado una asociación entre test_student_200_observer y test_student_100, pero la cuenta de alumno 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 GUARDAR.

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.

Desactivar 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)

Con anterioridad, ha creado asociaciones usando el método GUARDAR 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 desactivar una asociación de observador en función de sus requisitos:

  1. Desea desactivar un subconjunto de asociaciones de observadores asociadas con la integración/origen de datos actual.
  2. Desea desactivar un subconjunto de asociaciones de observadores y, al mismo tiempo, almacenar o actualizar registros adicionales.
1. Desactivar un subconjunto de asociaciones de observadores

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 ELIMINAR:

EXTERNAL_OBSERVER_KEY|EXTERNAL_USER_KEY
test_student_200_observer|test_student_200

2. Desactivar un subconjunto de asociaciones de observadores y, al mismo tiempo, almacenar asociaciones nuevas/existentes

Para desactivar un subconjunto de datos que, a la vez, 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 desactivar y cárguelo usando la operación ACTUALIZACIÓN COMPLETA. Por ejemplo, usando 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 desactivar la asociación test_student_200_observer|test_student_200, de modo que el archivo solo contendrá la asociación test_student_100_observer|test_student_100. Si además queremos añadir dos asociaciones nuevas (siempre que se cumpla el requisito previo de que las cuentas de usuario deben haberse creado) 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

Se desactivará el registro de test_student_200_observer|test_student_200.