Skip to main content

Ejemplos de usuario de archivos planos de instantáneas

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. El análisis del sistema de información de su institución y los requisitos y la planificación del registrador ayudarán a determinar la profundidad de los datos necesarios para completar correctamente Blackboard y cumplir con sus metas de datos y ciclo de vida.

Nota

Los ejemplos se basan en la configuración predeterminada de Blackboard que se puede ver en la interfaz de usuario de configuración de integración. Si se cambian estos elementos de configuración, también cambiarán los resultados del ejemplo. Las explicaciones de esta configuración están disponibles en Información general sobre el marco SIS o Sistema de información del estudiante y Configuración de integración de archivos sin formato de instantáneas. 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 de usuario son el conjunto de información principal que describe quién tiene acceso a Blackboard, su función en su institución y su función dentro del sistema Blackboard. 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. Anterior a muchos de estos estándares, Blackboard usa "PERSONA" y "USUARIO" para referirse a los registros relacionados con el usuario según el contexto. En los ejemplos siguientes usaremos "PERSON" para referirnos al registro y "USER" para referirnos a la persona.

Gestión de datos de archivos planos de instantáneas

El marco SIS o Sistema de información del estudiante admite cargas de fuentes de datos de archivos sin formato de instantáneas a través de una carga de fuente de interfaz de usuario y a través de un conjunto de URL proporcionadas por el sistema Blackboard.

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.

Nota

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. Para automatizar o utilizar operaciones de línea de comandos/programación, consulte Automatización de archivos sin formato de instantáneas.

Los datos pueden proporcionarse a Blackboard y luego actualizarse, eliminarse o modificarse. 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.

Aviso

Tenga en cuenta que la carga de un archivo correctivo corto con la operación Actualización completa o Actualización completa por fuente de datos puede conducir inadvertidamente a la eliminación o desactivación masiva de datos. Para evitar esto, desaconsejamos el uso manual de los tipos de operación Actualización completa o Actualización completa por origen de datos. Estas opciones no están disponibles de forma predeterminada en la página Carga archivo de fuente. Sin embargo, si habilita ambas opciones, active la casilla Habilitar opciones avanzadas en Tipo de operación.

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 conocer la "propiedad" de los datos, el origen de datos y las claves, consulte Información general sobre el marco SIS o Sistema de información del estudiante.

Completar la actualización

Almacenar, actualizar o deshabilitar una presencia proporcionada por un registro en Feed y Blackboard. 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. Debe seleccionar Habilitar opciones avanzadas para que esta opción esté disponible al realizar la carga de un archivo manualmente.

Borrar

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. Debe seleccionar Habilitar opciones avanzadas para que esta opción esté disponible al cargar un archivo manualmente

Los objetos asociados con las operaciones PERSON son:

Aviso

Tenga en cuenta que la carga de un archivo correctivo corto con la operación Completar actualización o Completar actualización por fuente de datos puede conducir inadvertidamente a la eliminación o desactivación masiva de datos. Para evitar esto, desaconsejamos el uso manual de los tipos de operación Completar actualización o Completar actualización por origen de datos. Estas opciones no están disponibles de forma predeterminada en la página Carga archivo de fuente. Sin embargo, si habilita ambas opciones, active la casilla Habilitar opciones avanzadas en Tipo de operación.

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

Nota

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. Para automatizar o utilizar operaciones de línea de comandos/programación, consulte Automatización de archivos sin formato de instantáneas.

Un recordatorio sobre las claves de la fuente de datos

Todos los objetos de datos admiten la capacidad de modificar la clave de la fuente de datos para la agrupación de ese conjunto de datos y se pueden utilizar para modificar la fuente de datos asociada. - Nota: este no es un campo obligatorio en las fuentes de datos basadas en Framework y, a menos que se indique lo contrario, los siguientes ejemplos asumen que la integración está configurada para utilizar una única fuente de datos.

Para obtener más información, consulte Administración de claves de la fuente de datos.

Una nota sobre el mapeo de campos

La asignación de campos proporciona la capacidad de modificar los datos entrantes antes de que se almacenen en Blackboard. Esto le permite tener un control total sobre los datos que se almacenan y le habilita cumplir con las reglas específicas de Blackboard cuando los datos del SIS o Sistema de información del estudiante que se le proporcionan son insuficientes, como la creación de contraseñas de usuario. Cuando se aplica a un campo de objeto de usuario, el script asociado se ejecuta por usuario, modificando o proporcionando los datos antes de que se almacenen en Blackboard. Se proporciona una explicación completa de la asignación de campos para archivos planos de instantáneas en Asignación de campos de archivos planos de instantáneas.

Nota sobre contraseñas

Las contraseñas son necesarias para iniciar sesión en Blackboard, pero no son un campo obligatorio en las fuentes de datos de PERSONA. Si no se proporciona una contraseña en la fuente de datos, se genera una contraseña SHA512 aleatoria y se almacena en la base de datos de Blackboard. Esto no es un problema si está utilizando autenticación externa (como LDAP), pero ¿qué sucede si está utilizando la base de datos de Blackboard para almacenar contraseñas de inicio de sesión de usuario? 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. En una operación de actualización, puede seleccionar no actualizar el campo de contraseña. Esto permitirá a Blackboard conservar la contraseña actual en 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, y este no es un patrón de alimentación SIS or Sistema de información del estudiante, pero vale la pena mencionarlo, también puede deshabilitar y eliminar basándose solo en DSK utilizando la herramienta de gestión de las fuentes de datos disponible en la interfaz de usuario. Debe tener mucho cuidado al administrar de este modo los datos proporcionados por SIS. Esto es extremadamente útil cuando se eliminan datos que nunca se proporcionaron o ya no se proporcionan a través del SIS o Sistema de información del estudiante, como los datos que son el resultado de operaciones de examen.

Solo lo básico: Personas

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 de archivo sin formato de instantánea y Encabezado de archivo sin formato de instantánea.

Nota

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.

Resumen de datos

El conjunto de datos o encabezados mínimos necesarios para crear una cuenta de usuario en Blackboard consiste en:

  • EXTERNAL_PERSON_KEY: un identificador único para el registro del usuario.

  • DATA_SOURCE_KEY: un identificador único para el conjunto de datos de este registro. Nota: esto se proporciona en el feed o a través de 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 de este usuario

    Para obtener un ejemplo de asignación dinámica de una contraseña si no puede proporcionar una en la fuente de datos, consulte Asignación de campos personalizados de archivos sin formato de instantáneas.

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. Se requiere EMAIL para corresponder y proporcionar notificaciones por correo electrónico a los usuarios de Blackboard a través del correo electrónico de Blackboard, por lo que debe considerar proporcionar estos datos en su feed. SYSTEM_ROLE tiene un valor predeterminado de NONE (ninguno).

Nota

Cada uno de estos encabezados se describe completamente en Formato de datos de archivos planos de instantánea.

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. La segunda es ACTUALIZAR la información de la PERSONA que ya está en Blackboard, lo que da como resultado la adición de registros nuevos o la actualización de los existentes tal como se presentan en el archivo de datos, al tiempo que se deshabilitan los registros existentes que no están presentes en el archivo de datos.

Ejemplos de operaciones de guardado
Ejemplo #1: Crear cuentas personales

Desea agregar usuarios a Blackboard sin afectar 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 la 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 personas para aanderson_test, bbrown_test y gcarlin_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 producirán en los registros creados anteriormente, los datos incluidos cuando no existe un registro en Blackboard darán como resultado la creación del 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|aanderson@test.com

Nota

Debido a que STORE solo opera con los datos contenidos en el archivo, los registros bbrown_examen y gcarlin_examen enviados anteriormente no se ven 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

El registro de personas de aanderson_test se actualiza para incluir la dirección de correo electrónico proporcionada.

Los registros de personas de bbrown_test y gcarlin_test no se ven afectados.

Persona: Operación de actualización completa

Aviso

Tenga en cuenta que la carga de un archivo correctivo corto con la operación Completar actualización o Completar actualización por fuente de datos puede conducir inadvertidamente a la eliminación o desactivación masiva de datos. Para evitar esto, desaconsejamos el uso manual de los tipos de operación Completar actualización o Completar actualización por origen de datos. Estas opciones no están disponibles de forma predeterminada en la página Carga archivo de fuente. Sin embargo, si habilita ambas opciones, active la casilla Habilitar opciones avanzadas en Tipo de operación.

La operación COMPLETE REFRESH funciona de forma diferente a STORE. COMPLETE REFRESH realiza dos operaciones que equivalen a una comparación de los datos en el archivo de fuente y los registros en Blackboard propiedad de la integración: almacenar nuevos registros, actualizar registros existentes o deshabilitar registros en Blackboard que no están en el archivo de datos.

Ejemplo: Actualización completa

Los datos que proporciona su SIS o Sistema de información del estudiante contienen una instantánea completa de las PERSONAS que deben tener acceso a Blackboard. Estos datos contienen registros de personas para agregar, registros de personas para actualizar y registros que se han eliminado desde operaciones anteriores de COMPLETE REFRESH que deben manejarse adecuadamente según la configuración (deshabilitar o eliminar).

Requisitos previos

Ninguno.

Requisitos mínimos de la fuente de datos
EXTERNAL_PERSON_KEY
USER_ID
PASSWD
FIRSTNAME
LASTNAME
Solución

Usar los datos de nuestra última operación de tienda y eliminar gcarlin_examen 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

Nota

Si esta integración gestiona otros registros de personas, se deshabilitarán o eliminarán debido a su ausencia en la fuente de datos anterior.

Condición posterior

El registro de personas de aanderson_test se conserva y no se ve afectado.

El registro de personas de bbrown_test se conserva y actualiza para incluir la dirección de correo electrónico.

El registro de PERSON de gcarlin_test se marcará como deshabilitado o listo para borrarse, según la configuración de la integración.

Persona: Actualización completa por operación de origen de datos

Aviso

Tenga en cuenta que la carga de un archivo correctivo corto con la operación Completar actualización o Completar actualización por fuente de datos puede conducir inadvertidamente a la eliminación o desactivación masiva de datos. Para evitar esto, desaconsejamos el uso manual de los tipos de operación Completar actualización o Completar actualización por origen de datos. Estas opciones no están disponibles de forma predeterminada en la página Carga archivo de fuente. Sin embargo, si habilita ambas opciones, active la casilla Habilitar opciones avanzadas en Tipo de operación.

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: Actualización completa por origen de datos

Los datos que proporciona su SIS o Sistema de información del estudiante contienen una instantánea completa de las PERSONAS que deben tener acceso a Blackboard. Estos datos contienen registros de personas para agregar, registros de personas para actualizar y registros que se han eliminado desde operaciones REFRESH anteriores que deben manejarse adecuadamente según la configuración (deshabilitar o eliminar). 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 la 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 personas de aanderson_test se conserva y no se ve afectado.

El registro de personas de bbrown_test se conserva y actualiza para incluir la dirección de correo electrónico.

El registro de PERSON de gcarlin_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 personas, NO se deshabilitarán ni eliminarán debido a su ausencia en la fuente de datos anterior, a menos que tengan la misma fuente de datos especificada por la integración.

Disponibilidad de cuenta de persona

Aviso

Tenga en cuenta que la carga de un archivo correctivo corto con la operación Completar actualización o Completar actualización por fuente de datos puede conducir inadvertidamente a la eliminación o desactivación masiva de datos. Para evitar esto, desaconsejamos el uso manual de los tipos de operación Completar actualización o Completar actualización por origen de datos. Estas opciones no están disponibles de forma predeterminada en la página Carga archivo de fuente. Sin embargo, si habilita ambas opciones, active la casilla Habilitar opciones avanzadas en Tipo de operación.

La configuración de disponibilidad de la cuenta PERSON permite que una cuenta en Blackboard inicie 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.

Nota

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 la cuenta personal

Su SIS o Sistema de información del estudiante controla la disponibilidad de acceso a Blackboard para los usuarios y su fuente de datos indica si los usuarios individualmente tienen acceso a Blackboard. 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 la fuente de datos
EXTERNAL_PERSON_KEY
USER_ID
PASSWD
FIRSTNAME
LASTNAME
AVAILABILE_IND
Solución

Agregue el encabezado AVAILABLE_IND a su fuente de datos y proporcione el carácter único de Y para disponible y N para no disponible.

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 gcarlin_test (se crearon anteriormente) y se crea ddarling_test.

COMPLETE REFRESH

Los registros de PERSON de aanderson_test, bbrown_test y gcarlin_test se actualizan (se crearon anteriormente) y se crea ddarling_test. Todos los demás registros se deshabilitarán o marcarán para su eliminación debido a su ausencia en la fuente de datos anterior.

ACTUALIZACIÓN COMPLETA POR ORIGEN DE DATOS

Los registros de PERSON de aanderson_test, bbrown_test y gcarlin_test se actualizan (se crearon anteriormente) y se crea ddarling_test.

Si esta integración administra otros registros de personas, NO se deshabilitarán ni eliminarán debido a su ausencia en la fuente de datos anterior, a menos que tengan la misma fuente de datos especificada por 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

Al deshabilitar un registro de personas en Blackboard, no se puede acceder a él para fines de inicio de sesión (el estado deshabilitado anula la configuración de disponibilidad) y también hace que el registro sea inaccesible para las operaciones de la 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 eliminar un registro de Blackboard, primero se debe deshabilitar ese registro.

Nota

Al deshabilitar un registro y su posterior eliminación, se eliminan todas las referencias a ese registro de Blackboard. Blackboard recomienda que la eliminación de registros deshabilitados se realice solo después de un período de tiempo determinado por su negocio o prácticas legales que, de otro modo, podrían requerir un registro de actividad.

La deshabilitación de registros puede seguir dos modelos: Deshabilitación mediante la exclusión de datos de fuente en operaciones REFRESH y Deshabilitación mediante el uso del encabezado de fuente 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.

Ejemplo: Deshabilitar registros de personas

Los estudiantes se matriculan o ya no están obligados a tener acceso a Blackboard. Debe eliminar por completo su acceso y presencia en Blackboard (a diferencia de hacer que el registro no esté disponible, lo que solo restringe el inicio de 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 de destino existen dentro del sistema Blackboard.

Requisitos mínimos de la 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 los registros de PERSON de aanderson_test, bbrown_test, gcarlin_test y ddarling_test se crean o actualizan con el ROW_STATUS se actualiza explícitamente.

COMPLETE REFRESH

Se crean o actualizan los registros de PERSON de aanderson_test, bbrown_test, gcarlin_test y ddarling_test; Todos los demás registros se deshabilitarán o marcarán para su eliminación debido a su ausencia en la fuente de datos anterior.

ACTUALIZACIÓN COMPLETA POR ORIGEN DE DATOS

Los registros de PERSON de aanderson_test, bbrown_test, gcarlin_test y ddarling_test se crean o actualizan con el ROW_STATUS se actualiza explícitamente.

Si esta integración administra otros registros de personas, NO se deshabilitarán ni eliminarán debido a su ausencia en la fuente de datos anterior, a menos que tengan la misma fuente de datos especificada por 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: Adición de roles de institución secundaria de 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 la 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 los registros de la función de institución secundaria para aanderson_examen, bbrown_examen, gcarlin_examen y d se crean o actualizan con la función de institución secundaria.

COMPLETE REFRESH

Se crean o actualizan los registros de rol de institución secundaria para aanderson_examen, bbrown_examen, gcarlin_examen y d; Todos los demás registros se deshabilitarán o marcarán para su eliminación debido a su ausencia en la fuente de datos anterior.

ACTUALIZACIÓN COMPLETA POR ORIGEN DE DATOS

Se crean o actualizan los registros de rol de institución secundaria para aanderson_examen, bbrown_examen, gcarlin_examen y d.

Si esta integración administra otros registros de personas, NO se deshabilitarán ni eliminarán debido a su ausencia en la fuente de datos anterior, a menos que tengan la misma fuente de datos especificada por 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 observadores

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 un external_person_key (test_student_100 en este ejemplo) y un observador identificado por un external_person_key (test_student_100_observer y test_student_200_observer en este 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: Actualización de un registro de asociación de observadores

Necesita cambiar una asociación.

Requisitos previos

Creó una asociación entre test_estudiante_200_observer y test_estudiante_100, pero la cuenta de estudiante asociada debe ser test_estudiante_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 la carga de este archivo a través del tipo de datos de asociación de observadores mediante 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 observadores

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:

  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.

Deshabilitar 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 de eliminación:

EXTERNAL_OBSERVER_KEY|EXTERNAL_USER_KEY test_student_200_observer|test_student_200

Deshabilitar un subconjunto de asociaciones de observadores mientras se almacenan asociaciones nuevas/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, utilizando 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_estudiante_200_observer|test_estudiante_200 está deshabilitado.

Aprende más