Integrity Advocate se asocia con D2L para ofrecer supervisión directamente con la herramienta de cuestionarios de Brightspace.
Integrity Advocate es una aplicación de supervisión en línea, supervisión de la participación y verificación de identificación que se integra con Brightspace. Esta combina la tecnología de IA con revisores en directo para garantizar el análisis exhaustivo de cada sesión con estudiantes. Integrity Advocate no requiere descargas del usuario y funciona en todos los navegadores modernos (se aplican excepciones cuando se selecciona la opción de usar un navegador seguro).
|
Nota: los administradores deben seguir el proceso de Registro dinámico LTI 1.3 para configurar su herramienta y agregar el componente de LTI recientemente creado a las páginas de inicio del curso. |
Disponibilidad y habilitación de Integrity Advocate
Integrity Advocate se adquiere por separado al paquete Core Brightspace. Si tiene preguntas sobre esta integración o está interesado en acceder a Integrity Advocate en su institución, póngase en contacto con su Administrador de cuenta.
Habilitar y configurar Integrity Advocate
Integrity Advocate se activa de forma predeterminada a nivel de instancia. Sin embargo, se desactiva a nivel de la organización.
Para habilitar y configurar Integrity Advocate:
- En el menú Herramientas de administración, seleccione Herramientas de la organización.
- Busque Integrity Advocate y actívelo.
- En el menú Herramientas de administración, seleccione Explorador de variables de configuración.
- Busque la variable de configuración d2l.3rdParty.IntegrityAdvocate.AppId.
- Ingrese su AppId completa proporcionada por Integrity Advocate como el valor de la instancia.
Para configurar los ajustes de Integrity Advocate:
- En el menú Herramientas de administración, seleccione Herramientas de la organización.
- Busque Integrity Advocate y actívelo.
- En el menú Herramientas de administración, seleccione Configuración de Integrity Advocate.
- En ID de la aplicación, ingrese el ID de la aplicación de Integrity Advocate.
Nota: Para obtenerlo, comuníquese con Integrity Advocate al correo electrónico sales@integrityadvocate.com.
-
En Roles supervisados, seleccione el o los roles, como Estudiante y cualquier otro rol de Estudiante para los que desee tener habilitada la supervisión de Integrity Advocate.
-
Haga clic en Guardar y cerrar.
Registrar una herramienta de aprendizaje externa para Integrity Advocate
- Tome nota de su AppId que proporciona Integrity Advocate.
- En el menú Herramientas de administración, haga clic en Administrar extensibilidad.
- En la pestaña LTI Advantage, haga clic en Herramienta de registro.
- Seleccione el botón de opción Dinámico.
- En el campo Extremo de registro de inicio de la herramienta*, ingrese la siguiente URL y agregue su AppId al final:
https://www.integrityadvocateserver.com/integration/d2l/DynamicRegister?app_id={YourAppIdHere}
Por ejemplo:
https://www.integrityadvocateserver.com/integration/d2l/DynamicRegister?app_id=xc186xxx-xxxx-xxxx-xxxx-xxacb09d5xxx
- Marque la casilla de selección Configurar implementación.
- Haga clic en Registro y siga las indicaciones. Aparecerá un mensaje de transacción exitosa.
- Una vez que haya finalizado, vaya a Administrar extensibilidad y compruebe el registro y la implementación de la nueva herramienta.
- A nivel de la implementación, asegúrese de compartir correctamente la nueva implementación de la herramienta con los cursos para los que desea contar con supervisión disponible.
- A nivel de la implementación, también asegúrese de que se haya activado la siguiente configuración de seguridad:
- Información de la unidad de organización
- Nombre
- Apellido
- Correo electrónico
- ID de usuario
- En Establecer una herramienta como disponible para, haga clic en Agregar unidades de organización.
- Seleccione los cursos deseados o simplemente agregue la unidad de organización de nivel superior y todas las descendientes.
- Haga clic en Agregar.
- Haga clic en Guardar.
- Desplácese hasta la parte inferior y haga clic en Ver enlaces.
- Haga clic en el nombre de enlace de Integrity Advocate LTI 1.3.
- Establezca el campo Altura en 1000.
- Haga clic en Guardar y cerrar.
Habilitar la supervisión en un cuestionario
- En Brightspace, vaya a la página de inicio de un curso.
- En el componente Integrity Advocate, haga clic en la pestaña Cuestionarios para ver la lista de cuestionarios del curso actual.
- Busque el cuestionario en el que desea habilitar la supervisión y marque la casilla de selección de la columna Activar Integrity Advocate.
- Para asociar un elemento de calificación a los resultados de supervisión, marque la casilla de selección Utilizar elemento de calificación.
Nota: Al habilitar la opción de supervisión en un cuestionario también se habilita la calificación automática, lo que garantiza que quienes finalicen el cuestionario se dirijan automáticamente a una vista de envío de cuestionarios. Todos los cuestionarios se redirigen a una vista predeterminada, a menos que esto se anule en la configuración del cuestionario. Consulte Configuración del cuestionario, opciones de la pestaña Vista de envío.
Uso de API
Integrity Advocate aprovecha las solicitudes de API para enviar y recibir datos de Brightspace.
Los usuarios familiarizados con las API de Brightspace saben que la primera vez que un usuario accede a una aplicación API de Brightspace, aparece un mensaje de consentimiento respecto de los permisos. Este mensaje solicita a un usuario individual que autorice a la aplicación a realizar llamadas de API en su nombre. Esta solicitud se mantiene por motivos de seguridad.
La integración utiliza las siguientes API de Brightspace:
Sincronizar el valor de calificación de un recurso de calificación específico para un usuario en particular
Obtener detalles de una calificación específica
Crear un nuevo elemento de calificación (aprobado/reprobado)
Actualizar el valor de un elemento de calificación (aprobado/desaprobado)
Eliminar un elemento de calificación (aprobado/reprobado)
Obtener todos los cuestionarios en un curso específico
Actualizar cuestionario (campos de encabezado e instrucciones)
Crear un rol y una cuenta de servicio de Integrity Advocate
Integrity Advocate utiliza un rol de cuenta de servicio y un usuario para realizar llamadas de API a la instancia de Brightspace de D2L.
Para crear el rol:
- Descargue el archivo de importación de roles para configurar la cuenta de servicio Integrity Advocate.
- Desde el menú Herramientas de administración, seleccione Roles y permisos.
- Haga clic en Crear/copiar.
- Seleccione Comenzar de nuevo y cree el nuevo rol con la siguiente configuración:
- Nombre: cuenta de servicio de Integrity Advocate
- Descripción: Rol de la cuenta de servicio para la integración de Integrity Advocate
- Habilitar rol en cascada
Marque las siguientes casillas de selección:- Acceder a los cursos inactivos
- Acceder a cursos pasados
- Acceda a cursos futuros Seleccionando los siguientes botones de opción:
- Acceder a todas las secciones de cursos
- Acceder a todos los grupos de cursos
Haga clic en Guardar.
En la página Interacciones entre roles, asegúrese de que las cuentas de administrador puedan Buscar, Inscribir y Suplantar el nuevo rol; para ello, marque todas las casillas de selección de administrador correspondientes.
Haga clic en Guardar.
Haga clic en Importar/exportar.
Seleccione Importar permisos de rol de un archivo CSV y haga clic en Siguiente.
Seleccione el nuevo rol de la Cuenta de servicio de Integrity Advocate y haga clic en Siguiente.
Haga clic en el control Elegir archivo, seleccione el archivo de exportación de rol del paso 1 y haga clic en Siguiente.
En la página Vista previa de la importación, ignore los errores y haga clic en Importar.
Nota: Los errores corresponden a controles que no tiene instalados o activados y se pueden ignorar de forma segura.
Haga clic en Aceptar.
Establecer las asignaciones de roles de IMS para la cuenta de servicio de Integrity Advocate
- En el menú Herramientas de administración, seleccione Configuración de IMS.
- Haga clic en Editar asignación de roles en la columna Rol de institución.
- Marque las casillas de Administrador, Personal docente (solo 1.1) e Instructor.
- Haga clic en Guardar.
- Haga clic en Editar asignación de roles en la columna Rol de contexto.
- Marque las casillas de Administrador e Instructor.
- Haga clic en Guardar.
Crear el usuario de la cuenta de servicio de Integrity Advocate
Integrity Advocate utiliza un rol de cuenta de servicio y un usuario para realizar llamadas de API a la instancia de Brightspace de D2L.
Para crear el usuario:
- En el menú Herramientas de administración, seleccione Usuarios.
- Haga clic en Nuevo usuario.
- En la página de creación de nuevos usuarios, ingrese los siguientes detalles:
- OrgDefinedId: ia.serviceaccount
- Nombre legal: IA
- Apellido legal: Serviceaccount
- Correo electrónico: noreply@integrityadvocate.com
- Rol: cuenta de servicio de Integrity Advocate
- Nombre de usuario: ia.serviceaccount
- Contraseña: Genere una contraseña segura
Nota: D2L recomienda utilizar un generador de contraseñas aleatorio, como https://passwordsgenerator.net
Haga clic en Guardar.
Envíe la siguiente información al administrador de cuentas de Integrity Advocate:
Actualizar el rol de la cuenta de servicio de Integrity Advocate
Este tema solo se aplica cuando se actualiza Integrity Advocate y no es necesario cuando se configura una nueva instalación.
Integrity Advocate utiliza un rol de cuenta de servicio y un usuario para realizar llamadas de API a la instancia de Brightspace de D2L. La nueva integración de D2L de Integrity Advocate permite agregar Integrity Advocate no solo a cuestionarios, sino también a actividades de asignaciones y contenido. Es necesario actualizar los permisos del rol para que el sistema tenga acceso a estas actividades.
Para actualizar el rol:
- Descargue el archivo de importación de roles para configurar la cuenta de servicio Integrity Advocate.
- Desde el menú Herramientas de administración, seleccione Roles y permisos.
- Haga clic en Importar/exportar.
- Seleccione Importar permisos de rol de un archivo CSV y haga clic en Siguiente.
- Seleccione el rol de la Cuenta de servicio de Integrity Advocate y haga clic en Siguiente.
- Haga clic en el control Elegir archivo, seleccione el archivo de exportación de rol del paso 1 y haga clic en Siguiente.
- En la página Vista previa de la importación, ignore los errores y haga clic en Importar.
Nota: Los errores corresponden a controles que no tiene instalados o activados y se pueden ignorar de forma segura.
- Haga clic en Aceptar.
Restablecer la contraseña de la cuenta de servicio
Este tema solo se aplica cuando se actualiza Integrity Advocate y no es necesario cuando se configura una nueva instalación.
La nueva integración de D2L de Integrity Advocate utiliza la cuenta de servicio existente que se creó cuando se configuró inicialmente Integrity Advocate en la instancia. La contraseña se establecerá para autorizar la integración de la nueva aplicación global Integrity Advocate con la instancia.
- Genere una contraseña nueva y segura.
Nota: D2L recomienda utilizar un generador de contraseñas aleatorio, como https://passwordsgenerator.net
- En el menú Herramientas de administración, seleccione Usuarios.
- Busque ia.serviceaccount y haga clic en el nombre de la cuenta para editarla.
- Actualice la contraseña a la que generó en el paso 1 y haga clic en Guardar.
- Envíe la contraseña actualizada al administrador de cuentas de Integrity Advocate.
Configuración y uso de la herramienta externa de Integrity Advocate (componente)
Integrity Advocate utiliza la herramienta LTI 1.3 para proporcionar funcionalidades integradas. En este componente, puede revisar los resultados de los participantes, establecer las opciones de administración, revisar el uso de créditos, así como leer noticias o actualizaciones de la herramienta Integrity Advocate.
Para registrar la herramienta externa de Integrity Advocate
- En el menú Herramientas de administración, haga clic en Administrar extensibilidad.
- En la pestaña LTI Advantage, haga clic en Herramienta de registro.
- Seleccione el botón de opción Dinámico.
- En el campo Extremo de registro de inicio de la herramienta, ingrese la siguiente URL y agregue el ID de la aplicación al final. Por ejemplo, https://www.integrityadvocateserver.com/integration/d2l/DynamicRegister?app_id=ESCRIBA-SU-ID-DE-APP-AQUÍ
- Marque la casilla de selección Configurar implementación.
- Haga clic en Registrar.
- Se abrirá una nueva ventana con un mensaje que indica que la operación se realizó correctamente. Cierre la ventana del mensaje de operación correcta y vuelva a la instancia de Brightspace de D2L.
- En el menú Herramientas de administración, haga clic en Administrar extensibilidad.
- Haga clic en la pestaña LTI Advantage y cambie de la vista Activado a Todo. A continuación, haga clic en Todos.
- Haga clic en el nombre de herramienta Integrity Advocate LTI 1.3.
- Coloque el interruptor en Activado.
- Haga clic en Guardar.
- Desplácese hasta la parte inferior y haga clic en Ver implementaciones.
- Haga clic en el nombre de la implementación de Integrity Advocate LTI 1.3 y marque las siguientes casillas en la configuración de seguridad:
- Información de la unidad de organización
- Nombre
- Apellido
- Correo electrónico
- ID de usuario
- En Establecer una herramienta como disponible para, haga clic en Agregar unidades de organización.
- Seleccione los cursos deseados o simplemente agregue la unidad de organización de nivel superior y todas las descendientes.
- Haga clic en Agregar.
- Haga clic en Guardar.
- Desplácese hasta la parte inferior y haga clic en Ver enlaces.
- Haga clic en el nombre de enlace de Integrity Advocate LTI 1.3.
- Establezca el campo Altura en 1000.
- Haga clic en Guardar y cerrar.
Agregar el componente Integrity Advocate a páginas de inicio
- En el menú Herramientas de administración, seleccione Administración de páginas de inicio.
- Seleccione la página de inicio en la cual desea incluir el componente Integrity Advocate.
NOTA: D2L recomienda una pantalla de ancho total (altura 1000) para el componente Integrity Advocate. Si está utilizando el diseño básico, haga clic en Cambiar diseño, luego seleccione Básico Plus y haga clic en Actualizar.
- Haga clic en Agregar componentes en la sección de ancho completo y busque Integrity Advocate.
- Seleccione Integrity Advocate LTI 1.3 y haga clic en Agregar.
- Haga clic en Guardar y cerrar.
Usar el componente Integrity Advocate
Hay cuatro pestañas dentro del componente Integrity Advocate LTI 1.3.
Participantes: Busque resultados de las revisiones de los participantes de todas las actividades del curso que tengan Integrity Advocate activado.
Actividades: Administre la configuración de Integrity Advocate en cada actividad del curso. Active y desactive opciones, cree un elemento de calificación y seleccione reglas para cada actividad.
Administración: Actualice la configuración administrativa (información de contacto) y revise los detalles sobre el uso de créditos.
Noticias: En esta pestaña, se muestran las actualizaciones más recientes sobre las nuevas funciones de Integrity Advocate al igual que las versiones anteriores y futuras.
Eliminar el componente Integrity Advocate LTI 1.0 de las páginas de inicio del curso
Este tema solo se aplica cuando se actualiza Integrity Advocate y no es necesario cuando se configura una nueva instalación.
La nueva integración de Brightspace/Integrity Advocate de D2L utiliza la norma LTI 1.3 para integrarse en la instancia de Brightspace y proporcionarle acceso a los resultados de los participantes de Integrity Advocate, las opciones de administración, el uso de créditos, etc.
Elimine el componente Integrity Advocate LTI existente de las páginas de inicio del curso en las que se muestre actualmente. Para eliminar el componente Integrity Advocate LTI de una página del curso:
- En el menú Herramientas de administración, seleccione Administración de páginas de inicio.
- Haga clic en el nombre de una página de inicio que tenga el componente Integrity Advocate LTI 1.0.
- Desplácese hasta la sección Componentes y haga clic en la X para quitar el componente Integrity Advocate.
- Haga clic en Guardar y cerrar.
Habilitar Integrity Advocate en una actividad
Para habilitar Integrity Advocate en una actividad del curso:
- En el componente Integrity Advocate LTI 1.3, haga clic en la pestaña Actividades.
- Busque la actividad en la que desea habilitar la supervisión de Integrity Advocate.
- Marque la casilla Activar Integrity Advocate para la actividad deseada.
- Si desea utilizar un elemento de calificación, marque la casilla Utilizar elemento de calificación para la actividad deseada.
NOTA: Con esta opción, se crea un nuevo elemento de calificación actualizado por Integrity Advocate con el estado de revisión. Integrity Advocate no cambiará los elementos de calificación que haya configurado.
- Haga clic en Seleccionar reglas y marque las casillas de las reglas deseadas para la actividad.
- Haga clic en Enviar.
Eliminar el código de Integrity Advocate de los cuestionarios
Este tema solo se aplica cuando se actualiza Integrity Advocate y no es necesario cuando se configura una nueva instalación.
La nueva integración de Brightspace/Integrity Advocate de D2L ya no requiere que los instructores ni los administradores peguen el código en las vistas Introducción, Encabezado y Envío de los cuestionarios. Estos bloques de código se deben eliminar en los cuestionarios que desee utilizar en el futuro.
Para eliminar el código de Integrity Advocate de los cuestionarios:
- Determine los cursos que tienen cuestionarios en los que se utiliza Integrity Advocate.
- En la Página de inicio del curso correspondiente, haga clic en Cuestionarios en la barra de navegación o haga clic en Herramientas del curso y seleccione Cuestionarios en el menú desplegable.
- Busque los cuestionarios que tengan instalado Integrity Advocate.
- Haga clic en el nombre del cuestionario correspondiente para editar la configuración del cuestionario.
- En el campo Introducción, haga clic en el ícono </> del editor y elimine el siguiente código:
<iframe src="/shared/IntegrityAdvocate/IntegrityAdvocateHeader.html" style="height: 0px; width: 0px; border: none;"></iframe>
- En el Encabezado de página, haga clic en el ícono </> en el editor y elimine el siguiente código:
<iframe src="/shared/IntegrityAdvocate/IntegrityAdvocateHeader.html" style="height: 0px; width: 0px; border: none;"></iframe>
- Desplácese hacia arriba y haga clic en la pestaña Vistas de envío.
- Haga clic en el nombre de la vista de envío para editarla.
- En el campo Mensaje, haga clic en el ícono </> del editor y elimine el siguiente código:
<iframe src="/shared/IntegrityAdvocate/IntegrityAdvocateClose.html" style="height: 0px; width: 0px; border: none;"></iframe>
- Haga clic en Guardar.
Eliminar los archivos compartidos de Integrity Advocate
Este tema solo se aplica cuando se actualiza Integrity Advocate y no es necesario cuando se configura una nueva instalación.
Como parte de la instalación original de Integrity Advocate, los archivos se agregan a la sección Archivos compartidos de la instancia. La nueva versión de la integración no utiliza estos archivos, por lo que se deben eliminar.
Para eliminar los archivos compartidos de Integrity Advocate:
- En el menú Herramientas de administración, seleccione Archivos compartidos.
- Ubique la carpeta de Integrity Advocate y marque la casilla de selección junto a ella.
- Haga clic en el ícono de papelera en la parte superior de la lista de carpetas y archivos para eliminar la carpeta.
Solución de problemas y preguntas frecuentes
La supervisión no comienza cuando se realiza un cuestionario
Como estudiante, si realiza un cuestionario que no comienza a supervisar, es posible que haya un problema de implementación para ese cuestionario.
- En el componente Integrity Advocate, en la pestaña Configuración del cuestionario, compruebe que el cuestionario esté habilitado para su supervisión.
- Asegúrese de que la herramienta Integrity Advocate esté Activada a nivel del curso y de la organización.
- Asegúrese de que sus variables de configuración en d2l.3rdParty.IntegrityAdvocate estén configuradas con los valores correctos.
Las solicitudes de API para la integración fallan
Esta integración utiliza las llamadas GET básicas (ver arriba) para obtener objetos específicos de los cursos. Si el componente no carga una lista de cuestionarios, es probable que el usuario que está viendo el componente no tenga permisos para obtener/ver la lista de cuestionarios.
- Normalmente, los cuestionarios ocultos/invisibles no estarán disponibles para los estudiantes.
- Los cuestionarios que aún no han comenzado, probablemente no aparecerán para los estudiantes.
- Por lo general, todos los objetos aparecen para los instructores y los administradores, ya sea que estén configurados para que sean visibles o no.
Los resultados de supervisión no aparecen en el componente
Si nota que los resultados de supervisión no aparecen en el componente de su página de inicio de Integrity Advocate:
- Es posible que el usuario no tenga su sesión de supervisión cerrada. En tales casos, debe esperar que transcurra el tiempo de espera automático de 10 minutos para que se cierre la sesión y se la envíe para su revisión.
No se puede ver el componente de Integrity Advocate en la página de inicio
Si un usuario dice que no puede ver el componente de Integrity Advocate en la página de inicio de su curso:
- Asegúrese de que el componente esté agregado a la página de inicio que está actualmente en uso para el curso.
- Asegúrese de que el componente se comparta con el curso mediante la actualización de las reglas de compartir implementación de LTI 1.3.
El sistema marcó una sesión como reprobada, pero debe ser aprobada
Para anular los resultados de actividades a nivel del curso en el componente Integrity Advocate:
- Haga clic en la pestaña Participantes.
- Seleccione un envío y haga clic en Anular para anular manualmente los resultados de supervisión.
Tenga en cuenta que las anulaciones hacen que se actualicen todos los elementos de calificación de aprobación/reprobación de Integrity Advocate, respectivamente. Esta anulación es un cambio a nivel del curso y no refleja una actividad individual.
Cliente existente que busca actualizarse
¿Es usted un cliente existente de Integrity Advocate? Si configura su integración antes de mayo del 2021, está utilizando la versión clásica de Integrity Advocate. Con esta versión, D2L recomienda que todos los clientes existentes consideren actualizarse a la versión más reciente de Integrity Advocate, que proporciona flujos de trabajo mejorados y una mayor flexibilidad en el uso diario.
Consejos y prácticas recomendadas de D2L para utilizar la versión más reciente:
- La integración clásica utiliza LTI 1.1. La versión más reciente utiliza LTI 1.3. Ambas integraciones pueden coexistir dentro de su plataforma y no entran en conflicto entre sí.
Por ejemplo, puede tener el componente de LTI 1.1 y el componente de LTI 1.3 agregados a la misma página de inicio. Ambos componentes mostrarán la misma página. Sin embargo, D2L solo recomienda tener uno en una página por vez para evitar confundir al usuario.
- Configure la nueva versión de la integración y deje la integración existente en su lugar. No quite ni elimine las configuraciones existentes que tenga. Para administrar de forma segura el acceso de los usuarios, recomendamos eliminar solo las reglas de uso compartido para sus proveedores de herramientas de LTI, los enlaces de LTI y el complemento remoto.
- Elimine el componente clásico de LTI 1.1 de las páginas de inicio del curso. Al hacerlo, simplemente lo elimina de sus páginas de inicio y no quita ni elimina ningún dato del curso. Cuando se agrega nuevamente a las páginas de inicio, se vuelven a incluir todos los datos del curso.
- Mientras quita el componente anterior, agregue el nuevo componente de LTI 1.3.
- Informe a los instructores que ya no necesitan copiar y pegar secuencias de comandos HTML en sus cuestionarios. Solo tienen que habilitar la supervisión dentro del componente para ponerse en marcha.
Recursos adicionales
IntegrationHub: Integrity Advocate
Integrity Advocate
Socios del grupo de la Comunidad Brightspace
Notas de publicación
Suscríbase a las actualizaciones de la publicación de notas de Brightspace para asegurarse de recibir notificaciones de las nuevas actualizaciones. También puede revisar las Notas de publicación de Integrity Advocate.
¿Necesita ayuda?
Comuníquese con su administrador de cuenta si tiene preguntas sobre:
- Comprar Integrity Advocate
- Configuración de cuentas
- Facturación
Póngase en contacto con Soporte técnico de D2L si necesita asistencia técnica relacionada con la integración en Brightspace.
Póngase en contacto con Integrity Advocate para enviar un ticket si Integrity Advocate no funciona como espera.