Este documento proporciona instrucciones para integrar la plataforma Panorama en su sistema de gestión del aprendizaje (LMS) Canvas con LTI 1.1. Antes de continuar con los pasos siguientes, asegúrese de tener acceso completo a su instancia de Canvas como administrador. Si tiene preguntas sobre alguno de los pasos de este proceso, comuníquese con su administrador de cuenta dedicado.
Cómo obtener su clave de consumidor, el secreto de LTI y el archivo XML para su integración
Antes de continuar con los pasos siguientes, deberá haber recibido un correo electrónico de su administrador de cuenta en el que se le pide registrarse para obtener su cuenta de Panorama. Regístrese para obtener su cuenta y luego continúe con los pasos siguientes.
- Inicie sesión en su cuenta de Panorama.
- Haga clic en Configuraciones en el menú del lado izquierdo y luego seleccione Configuración de Integración.
- Seleccione LTI 1.1.
- Haga clic en Descargar XML LTI 1.1, y luego copie su Clave de consumidor y su Secreto LTI. Los necesitará en la siguiente sección de esta guía.
Cómo generar un ID de cliente y un secreto
- Haga clic en + Clave de desarrollador > Clave de API.
-
Ingrese la siguiente información:
- Nombre de la clave: Panorama API Integration
-
URL de redireccionamiento: https://<zoneURL>/canvas-auth
- Zona de EE. UU.: https://panorama-api.yuja.com/canvas-auth
- Zona de Canadá: https://panorama-api-cz.yuja.com/canvas-auth
- Zona de la UE: https://panorama-api-ez.yuja.com/canvas-auth
- Zona de Australia: https://panorama-api-az.yuja.com/canvas-auth
- (Opcional) Habilite Aplicar ámbitos.
Nota: No recomendamos aplicar ámbitos. Esto le exigirá volver a integrar Panorama con la API de Canvas cada vez que Panorama agregue nuevas funcionalidades que usen la API. Si no desea hacerlo, asegúrese de que Aplicar ámbitos esté deshabilitado y luego continúe con el paso 5. - Marque Permitir parámetros de inclusión y luego marque los siguientes parámetros:
- Cuentas
- url:GET|/api/v1/accounts
- url:GET|/api/v1/accounts/:id
- url:GET|/api/v1/accounts/:account_id/courses
- url:GET|/api/v1/accounts/:account_id/sub_accounts
- Administradores
- url:GET|/api/v1/accounts/:account_id/admins
- Tareas
- url:GET|/api/v1/courses/:course_id/assignments
- url:GET|/api/v1/courses/:course_id/assignments/:id
- url:PUT|/api/v1/courses/:course_id/assignments/:id
- Cursos
- url:GET|/api/v1/courses
- url:GET|/api/v1/courses/:id
- url:GET|/api/v1/courses/:course_id/users
- url:GET|/api/v1/courses/:course_id/users/:id
- url:PUT|/api/v1/courses/:id
- url:POST|/api/v1/courses/:course_id/files
- Temas de discusión
- url:GET|/api/v1/courses/:course_id/discussion_topics
- url:GET|/api/v1/courses/:course_id/discussion_topics/:topic_id
- url:PUT|/api/v1/courses/:course_id/discussion_topics/:topic_id
- url:PUT|/api/v1/courses/:course_id/discussion_topics/:topic_id/entries/:id
- Inscripciones
- url:GET|/api/v1/users/:user_id/enrollments
- url:GET|/api/v1/courses/:course_id/enrollments
- Períodos de inscripción
- url:GET|/api/v1/accounts/:account_id/terms
- url:GET|/api/v1/accounts/:account_id/terms/:id
- Archivos
- url:GET|/api/v1/courses/:course_id/files
- url:GET|/api/v1/files/:id
- url:POST|/api/v1/files/:id
- url:PUT|/api/v1/files/:id
- Páginas
- url:GET|/api/v1/courses/:course_id/pages
- url:GET|/api/v1/courses/:course_id/pages/:url_or_id
- url:PUT|/api/v1/courses/:course_id/pages/:url_or_id
- url:POST|/api/v1/courses/:course_id/pages
- Cuestionarios
- url:GET|/api/v1/courses/:course_id/quizzes
- url:GET|/api/v1/courses/:course_id/quizzes/:id
- url:GET|/api/quiz/v1/courses/:course_id/quizzes/:assignment_id
- url:GET|/api/quiz/v1/courses/:course_id/quizzes
- url:PUT|/api/v1/courses/:course_id/quizzes/:id
- url:PATCH|/api/quiz/v1/courses/:course_id/quizzes/:assignment_id
- Roles
- url:GET|/api/v1/accounts/:account_id/roles
- url:GET|/api/v1/accounts/:account_id/roles/:id
- Rúbricas
- url:GET|/api/v1/courses/:course_id/rubrics
- url:GET|/api/v1/courses/:course_id/rubrics/:id
- Enlaces de recursos LTI
- url:GET|/api/v1/courses/:course_id/lti_resource_links
- url:GET|/api/v1/courses/:course_id/lti_resource_links/:id
- Cuentas
- Haga clic en Guardar.
- Busque la clave de desarrollador Panorama API Integration recién creada y copie el ID de cliente en Detalles.
- Haga clic en Mostrar clave y copie el Secreto del cliente.
- Inicie sesión en Panorama y, en el menú del lado izquierdo, haga clic en Configuración > Configuración de Integración.
- En el menú desplegable Seleccione la integración, seleccione API de LMS.
- Haga clic en Agregar clave de acceso.
- Para el método de autenticación de Canvas, elija ID de cliente.
- Ingrese el ID del paso 8 en el campo ID de cliente .
- Ingrese el secreto del cliente del paso 9 en el campo Secreto del cliente .
- Si utilizó ámbitos forzados, habilite Usar Ámbitos Forzados. De lo contrario, omita este paso.
- Haga clic en Autenticar con Canvas.
Nota: Asegúrese de haber iniciado sesión en Canvas como administrador con todos los privilegios. - Haga clic en Autorizar.
- Copie la respuesta de autenticación y regrese a Panorama. Pegue la respuesta en el campo Respuesta de Autenticación de Canvas.
- Haga clic en Agregar clave de acceso.
- Haga clic en Guardar cambios para completar la configuración.
Cómo agregar Panorama a Canvas
Una vez que haya obtenido su clave de consumidor, su clave secreta y la configuración XML, puede agregar Panorama a su instancia de Canvas.
- Inicie sesión en Canvas como administrador. En la barra lateral izquierda, haga clic en Administrador y seleccione la cuenta de Canvas de su institución.
- Haga clic en Configuración > Aplicaciones > Ver configuraciones de aplicaciones.
- Haga clic en + Aplicación, complete la siguiente información y luego haga clic en Enviar para completar la configuración de Panorama para Canvas.
- Tipo de configuración: Pegar XML
- Nombre: Panorama Configuration
- Clave de consumidor: Obtenida en la primera sección de esta guía.
- Clave secreta: El secreto de LTI obtenido en la primera sección de esta guía.
- Configuración XML: Abra el archivo XML descargado en la primera sección de esta guía. Copie el contenido en un editor de texto, como el Bloc de notas, y péguelo aquí.
Cómo instalar LMS Visualizer
Este paso requiere que su instancia de Canvas tenga habilitada la función de anulaciones de CSS/JavaScript personalizado. Si no está habilitada, comuníquese con su administrador de cuenta de Canvas. LMS Visualizer permitirá que se muestren los íconos de accesibilidad de Panorama.
- Inicie sesión en su cuenta de Panorama.
- Haga clic en Configuraciones > Configuración de Integración.
- Seleccione LMS Visualizer > Descargar visualizador.
- A continuación, inicie sesión en Canvas como administrador. En la barra lateral izquierda, haga clic en Administrador y seleccione la cuenta a la que aplicará YuJa Panorama - LMS Viewer.
- Seleccione Configuración en la barra de navegación izquierda y asegúrese de que la pestaña Configuración esté seleccionada en la fila superior.
- Desplácese hacia abajo hasta la sección Funciones .
- Si la opción Anulaciones de CSS/JavaScript personalizado está disponible, asegúrese de que esté marcada. Luego, desplácese hacia abajo y haga clic en Actualizar configuración.
- Si la opción Anulaciones de CSS/JavaScript personalizado no está disponible, comuníquese con su administrador de cuenta de Canvas para habilitar Anulaciones de CSS/JavaScript personalizado en el Editor de temas.
- Si la opción Anulaciones de CSS/JavaScript personalizado está disponible, asegúrese de que esté marcada. Luego, desplácese hacia abajo y haga clic en Actualizar configuración.
- A continuación, haga clic en Temas en la barra de navegación izquierda y luego elija el botón + Tema. Seleccione cualquier plantilla de tema del menú desplegable.
- En el Editor de temas de Canvas, vaya a la pestaña Cargar y seleccione el archivo Canvas Visualizer que descargó en el paso 3 de esta sección. Importante: La pestaña Cargar solo está disponible cuando su administrador de cuenta la habilita.
- A continuación, haga clic en Vista previa de los cambios, luego elija Aplicar tema. Cuando se le pida darle un nombre a su tema, escriba Panorama Theme.
Cómo desinstalar Panorama de una instancia de Canvas
Para eliminar Panorama de una instancia de Canvas, el administrador deberá eliminar la aplicación LTI y el LMS Viewer. Para saber cómo eliminar estas funciones, siga los pasos que se indican a continuación.
- Inicie sesión en Canvas como administrador. En la barra lateral izquierda, haga clic en Administrador y seleccione la cuenta de Canvas de su organización.
- Seleccione Configuración en la barra de navegación izquierda.
- Seleccione la pestaña Aplicaciones de la fila superior y luego haga clic en Ver configuración de aplicaciones.
- Seleccione el ícono de engranaje de la aplicación LTI de Panorama y haga clic en Eliminar.
- Seleccione Eliminar para confirmar la eliminación de la herramienta y deshabilitar la integración de Panorama para LTI 1.1.
- Por último, como administrador, deberá eliminar LMS Viewer haciendo clic en Temas en el menú de navegación.
- A continuación, seleccione el tema de Panorama, y haga clic en Abrir en el Editor de temas.
- En el panel izquierdo, haga clic en Cargar.
- En Archivo JavaScript, haga clic en la X para eliminar el script de Panorama .
- Haga clic en Guardar tema. Panorama se ha desinstalado correctamente de la instancia de Canvas.