Resumen
La página de Integrations es el área de administración central donde gestiona cada conexión entre KnowledgeCity y sistemas externos. Agrupa la configuración relacionada, incluidos Content Providers, Integration Platforms, LTI Tools, API Tokens, Web Hooks y Logs, para que pueda agregar, habilitar, desactivar y eliminar integraciones desde un solo lugar. Este artículo explica para qué sirve cada agrupación y cómo trabajar con ella.
Introducción
KnowledgeCity se conecta a muchos sistemas externos para que los usuarios, cursos, credenciales e informes puedan fluir automáticamente entre plataformas. La página de Integrations reúne todas esas conexiones en un único centro de administración, dándole una visión clara de lo que está configurado, lo que está activo, y dónde hacer cambios.
Esta página la utilizan Super Admins y administradores responsables de conectar KnowledgeCity con herramientas de terceros. Resuelve el problema de la configuración dispersa al agrupar cada tipo de integración en un solo lugar, de modo que no tenga que buscar en pantallas separadas para agregar una fuente de contenido, registrar una herramienta externa, emitir credenciales de API, o comprobar que una conexión esté funcionando.
Conceptos clave
- Content Providers (proveedores de contenido): conexiones a catálogos externos y fuentes de cursos cuyo contenido puede mostrarse dentro de KnowledgeCity.
- Integration Platforms (plataformas de integración): conexiones a sistemas externos más amplios (por ejemplo, sistemas de RR. HH. y otras plataformas de aprendizaje) que intercambian usuarios, inscripciones y resultados con KnowledgeCity.
- LTI Tools (herramientas LTI): conexiones registradas de Learning Tools Interoperability, cada una identificada por una plataforma y un client ID, que permiten que KnowledgeCity y las plataformas externas se lancen entre sí.
- API Tokens (tokens de API): credenciales OAuth (un client ID y un client secret) que permiten que las aplicaciones externas y las integraciones personalizadas accedan a sus datos a través de la API de KnowledgeCity.
- Web Hooks: notificaciones salientes que permiten que KnowledgeCity señale a los sistemas externos cuando ocurren eventos relevantes.
- Logs (registros): un registro de la actividad de integración que puede revisar para confirmar qué sucedió y solucionar comportamientos inesperados.
- Integration status (estado de la integración): cada integración refleja si está configurada y activa, para que pueda habilitarla, desactivarla o eliminarla según sea necesario.
Pasos a seguir
Abrir la página de Integrations
Inicie sesión como Super Admin, abra el menú Settings en el panel superior de la interfaz del LMS, y seleccione Integrations. Esto abre la página de detalles de Integrations, donde las diferentes agrupaciones de integración están organizadas en sus propias secciones.
Elegir una agrupación de integración
En la página de Integrations, elija la sección que coincida con lo que desea gestionar: Content Providers, Integration Platforms, LTI Tools, API Tokens, Web Hooks, o Logs. Cada agrupación mantiene su propia configuración y su propia lista de elementos configurados para que pueda concentrarse en un tipo de integración a la vez.
Agregar y habilitar una integración
Dentro de una agrupación, agregue la integración que necesita y proporcione sus detalles de conexión, y luego guarde. Una vez configurada, una integración puede habilitarse para que se active y comience a intercambiar datos con el sistema externo. Confirme las credenciales y cualquier identificador requerido (como una plataforma o client ID) con la parte integradora antes de depender de la conexión.
Trabajar con API Tokens
Abra la sección API Tokens para emitir credenciales OAuth para aplicaciones externas. Cree un token, déle un nombre descriptivo para que su propósito quede claro más adelante, y confirme la declaración de autorización. Después de la creación, copie el client ID y el client secret en su herramienta externa. Trate el client secret como una contraseña y nunca lo comparta públicamente.
Trabajar con LTI Tools
Abra la sección LTI Tools para registrar y gestionar conexiones de Learning Tools Interoperability. Cada herramienta registrada se asocia con una plataforma y un client ID y tiene su propio estado. Registre las herramientas que necesita la cuenta y verifique un lanzamiento antes de depender de él en producción.
Desactivar o eliminar una integración
Cuando una conexión ya no sea necesaria, desactívela para detener el intercambio de datos, o elimínela por completo. Eliminar credenciales como un token de API bloquea inmediatamente el acceso de cualquier aplicación externa que las use, así que confirme antes de eliminar algo de lo que dependan otros sistemas.
Revisar los Logs
Abra la sección Logs para revisar la actividad de integración. Úsela para confirmar que una conexión se ejecutó como se esperaba, ver qué cambió, y solucionar problemas cuando una sincronización o un lanzamiento no se comporten como se pretende.
Conclusión
La descripción general de la configuración de Integrations es su centro único para conectar KnowledgeCity con el mundo exterior. Al agrupar Content Providers, Integration Platforms, LTI Tools, API Tokens, Web Hooks y Logs en una sola página, le permite agregar, habilitar, desactivar y eliminar integraciones con una visión clara del estado de cada conexión, y confiar en los registros para mantener rastreable cada cambio.