Resumen
La integración con Oracle Learning permite que KnowledgeCity actúe como proveedor de contenido, mientras que Oracle Learning (parte de Oracle Fusion Cloud HCM) es la plataforma donde los estudiantes inician la capacitación y hacen seguimiento de los resultados.
Admite tres flujos principales:
- User Import: Importar usuarios desde Oracle HCM hacia KnowledgeCity
- Course Export: Exportar cursos elegibles de KnowledgeCity hacia Oracle Learning
- Course Completion Export: Exportar finalizaciones de cursos de KnowledgeCity hacia Oracle Learning
Algunas operaciones de sincronización pueden ejecutarse automáticamente mediante un programador (según la zona horaria local del LMS).
Introducción
El propósito de esta integración es agilizar las operaciones de aprendizaje empresarial permitiendo a los administradores:
- Mantener las cuentas de usuario alineadas entre Oracle HCM y KnowledgeCity
- Publicar cursos de KnowledgeCity en Oracle Learning para el lanzamiento de cursos
- Enviar los datos de finalización de vuelta a Oracle Learning para reportes centralizados y cumplimiento normativo
Esto reduce la gestión manual de cuentas y mantiene los registros de aprendizaje consistentes entre sistemas.
Requisitos
Antes de configurar la integración con Oracle Learning, confirme los siguientes prerrequisitos.
Permisos de Administrador
- Debe tener acceso de Administrator en KnowledgeCity LMS para habilitar y configurar integraciones.
Acceso a la API de Oracle
Debe obtener los siguientes detalles de API de su administrador de Oracle Fusion Cloud HCM:
- Oracle Fusion Cloud REST API Base URL
- Oracle API Username
- Oracle API Password
Roles de Usuario de la API de Oracle
El usuario de API en Oracle Fusion HCM debe tener asignados los siguientes job roles:
- Learning Specialist (
ORA_WLF_LEARNING_SPECIALIST_JOB) – Necesario para todas las operaciones relacionadas con el aprendizaje - HCM Integration Specialist (
ORA_HRC_HUMAN_CAPITAL_MANAGEMENT_INTEGRATION_SPECIALIST_JOB) – Necesario para integraciones basadas en REST y HDL - Human Resource Specialist (
ORA_PER_HUMAN_RESOURCE_SPECIALIST_JOB) – Necesario para ver y validar los registros de trabajadores - Application Implementation Consultant (
ASM_APPLICATION_IMPLEMENTATION_CONSULTANT_JOB) – Necesario para la validación de la configuración
Importante: la Data Security es necesaria tanto para User Import como para Completion Export. Oracle HCM tiene dos capas de seguridad separadas: Function Security (los job roles anteriores): controla si el usuario puede llamar a la API Data Security (HCM Data Role + Person Security Profile) — controla a qué registros de trabajadores puede leer o escribir el usuario Asignar los job roles directamente al usuario de API no es suficiente. Cada job role requerido debe estar envuelto dentro de un HCM Data Role con un Person Security Profile apropiado (por ejemplo, "View All Workers"). Sin esto:/publicWorkers(User Import) devuelve 0 usuarios sin ningún error. Las solicitudes POST alearnerLearningRecords(Completion Export) devuelven HTTP 400 con un cuerpo nulo — Oracle rechaza silenciosamente la solicitud porque las políticas de data security dentro del job role asignado directamente nunca se instancian.
Acceso a la API de KnowledgeCity
- Debe tener un secreto/token de API de KnowledgeCity válido creado en el LMS (o proporcionado por un administrador de KnowledgeCity).
Programación (Opcional)
- Si planea usar la sincronización programada, confirme que el horario se alinee con la cadencia interna de actualización de sus datos y sus necesidades de reportes.
Pasos a Seguir
1) Habilitar la Integración con Oracle Learning
- Inicie sesión en KnowledgeCity LMS como Administrator.
- Vaya a la página Integrations.
- Encuentre la tarjeta de integración de Oracle Learning.
- Haga clic en Enable.
2) Configurar los Ajustes Generales
Complete la configuración general de conexión usando los valores proporcionados por su administrador de Oracle Fusion Cloud HCM:
- Oracle Fusion Cloud REST API Base URL
- Oracle API Username
- Oracle API Password
- KnowledgeCity API Secret
- KnowledgeCity API URL
Guarde sus cambios.
Opción 1: User Import (Oracle HCM → KnowledgeCity)
Esta opción mantiene a los usuarios de KnowledgeCity sincronizados con Oracle HCM. Oracle se trata como la fuente de verdad para la identidad del usuario.
Cómo Funciona
KnowledgeCity llama a la API REST /publicWorkers de Oracle para recuperar los registros de empleados, y crea o actualiza las cuentas de usuario en el LMS en consecuencia.
Configuración
Habilite User Import y configure las siguientes opciones:
- Add users: Crear nuevas cuentas de KnowledgeCity para los usuarios encontrados en Oracle HCM
- Reactivate users: Reactivar usuarios en KnowledgeCity si vuelven a estar activos en Oracle HCM
- Deactivate inactive users: Desactivar usuarios en KnowledgeCity si están inactivos en Oracle HCM
- Remove license for inactive users: Eliminar opcionalmente la licencia al desactivar
- Username field: Seleccionar qué campo de Oracle HCM se usará como nombre de usuario de KnowledgeCity
- Username prefix: Prefijo opcional para evitar colisiones de nombres de usuario
- Automatically assign license for new users + Subscription — Controla la asignación de licencias para los usuarios recién importados
Prerrequisitos del Administrador de Oracle (Requeridos)
Además de los job roles listados en la sección de Requisitos, su administrador de Oracle debe:
- Asignar al usuario de API un HCM Data Role que envuelva el job role HCM Integration Specialist e incluya un Person Security Profile que cubra a los trabajadores que deban ser visibles (por ejemplo, "All Workers" o la unidad de negocio relevante)
- Confirmar que la integración apunta al entorno correcto (producción vs. sandbox)
- Confirmar que existen trabajadores activos en HCM dentro de las unidades de negocio accesibles
Sin el HCM Data Role + Person Security Profile, la importación de usuarios se ejecutará sin errores pero devolverá 0 usuarios.
Resultado Esperado
- Los usuarios de Oracle HCM se crean/actualizan/desactivan en KnowledgeCity según las reglas que configuró
- El registro del trabajo de sincronización mostrará el número de usuarios recuperados y las acciones realizadas
Opción 2: Course Export (KnowledgeCity → Oracle Learning)
Esta opción publica los cursos de KnowledgeCity en el catálogo de Oracle Learning para que los estudiantes puedan descubrirlos y lanzarlos desde Oracle.
Cómo Funciona
KnowledgeCity envía los metadatos del curso a Oracle Learning usando la API REST Self-Paced Learning Items de Oracle. Oracle Learning almacena los metadatos y la URL de lanzamiento de KC — el contenido real permanece alojado en KnowledgeCity.
Configuración
- Habilite Course Export
- Asegúrese de que sus cursos cumplan con los criterios de elegibilidad (vea el Resultado Esperado a continuación)
Resultado Esperado
Los cursos se vuelven disponibles en Oracle Learning según las siguientes reglas de elegibilidad:
- El curso está activo en KnowledgeCity
- El curso está dentro de una categoría visible
- Todas las categorías padre del curso también son visibles
Los cursos no elegibles (inactivos, categorías ocultas) no se exportarán.
Opción 3: Course Completion Export (KnowledgeCity → Oracle Learning)
Esta opción envía los registros de finalización de aprendizaje de KnowledgeCity de vuelta a Oracle Learning, manteniendo actualizado el expediente académico del estudiante en Oracle.
Cómo Funciona
Después de que un estudiante completa un curso en KnowledgeCity, se envía un registro de finalización a Oracle Learning mediante la API REST learnerLearningRecords (POST). Oracle Learning actualiza el expediente del estudiante con el estado de finalización y los metadatos.
Configuración
- Habilite Course Completion Export
Prerrequisitos del Administrador de Oracle (Requeridos)
Además de los job roles listados en la sección de Requisitos, su administrador de Oracle debe completar lo siguiente — esta es la causa más común de fallos en la exportación de finalizaciones:
- Envolver el job role Learning Specialist dentro de un HCM Data Role. Asignar
ORA_WLF_LEARNING_SPECIALIST_JOB(o una variante personalizada comoLBT_LEARNING_SPECIALIST_CUSTOM) directamente al usuario de API no es suficiente — las políticas de data security dentro del job role solo se instancian a través de un Data Role. - Adjuntar un Person Security Profile al Data Role, con acceso a todos los trabajadores que pueden completar la capacitación (por ejemplo, "View All Workers").
- Confirmar que el Data Role otorga privilegios de escritura/POST en
learnerLearningRecords, no solo acceso de solo lectura. El rol debe incluir: Use REST Service - Learner Learning Records(la versión de escritura — no la variante_RO_de solo lectura)Manage Learning Assignment/Manage Learning Record- Después de realizar los cambios de seguridad, ejecute el proceso programado "Retrieve Latest LDAP Changes" y espere a que se complete antes de realizar pruebas.
Síntoma de la falta de Data Role + privilegios de escritura: los trabajos de exportación de finalización fallan conHTTP 400 — Response: nulldesde Oracle. El cuerpo nulo es intencional por parte de Oracle cuando al usuario le falta el contexto de data security requerido. La solicitud llega a Oracle Fusion (se devuelve unx-oracle-dms-ecidválido en los encabezados de la respuesta), pero no se incluye ningún mensaje de error.
Resultado Esperado
- Los registros de finalización se envían a Oracle Learning después de que el estudiante termina un curso
- El expediente de Oracle Learning refleja el estado de finalización actualizado y los metadatos según su configuración
- El usuario de la API de Oracle debe tener el rol Learning Specialist para que se acepten las finalizaciones — asignado mediante un HCM Data Role con privilegios de escritura, no directamente
Solución de Problemas
| Problema | Causa | Solución |
|---|---|---|
| La integración no logra conectarse / credenciales rechazadas | URL de la REST API de Oracle, nombre de usuario, contraseña o secreto de API de KC incorrectos | Vuelva a verificar todos los valores con su administrador de Oracle y confirme que el secreto de API de KC esté activo y sea válido. |
| Los usuarios no se importan | User import deshabilitado, o discrepancia en el campo de nombre de usuario | Habilite User import y verifique que el campo de nombre de usuario seleccionado coincida con lo que existe en Oracle HCM. |
| User import se ejecuta con éxito pero devuelve 0 usuarios: sin error | Los job roles están asignados pero no se ha configurado un HCM Data Role con un Person Security Profile. Oracle devuelve una respuesta vacía cuando no se otorga visibilidad de datos — esto es silencioso y no produce un error. | Pida a su administrador de Oracle que asigne al usuario de API un HCM Data Role que incluya un Person Security Profile que otorgue visibilidad a los trabajadores relevantes (por ejemplo, "All Workers"). Esto es independiente de los job roles y debe configurarse además de ellos. |
| Los usuarios se importan pero no reciben licencias | Asignación automática de licencia deshabilitada o suscripción no configurada | Habilite la asignación automática de licencia y seleccione una suscripción para los nuevos usuarios. |
| Los usuarios no se actualizan/reactivan/desactivan como se esperaba | Reglas de actualización/reactivación/desactivación no habilitadas | Revise y habilite las reglas específicas de estado de usuario que desea aplicar durante la sincronización. |
| Los cursos no se exportan a Oracle Learning | Course export deshabilitado, curso inactivo, o reglas de visibilidad de categoría no cumplidas | Habilite Course export, asegúrese de que los cursos estén activos, y confirme la visibilidad de la categoría (incluyendo las categorías padre). |
La exportación de finalizaciones falla con HTTP 400: Response: null desde Oracle | El job role Learning Specialist está asignado directamente al usuario de API, no a través de un HCM Data Role. La function security pasa pero las políticas de data security nunca se instancian, por lo que Oracle rechaza silenciosamente el POST. | Pida a su administrador de Oracle que: (1) envuelva el job role Learning Specialist dentro de un HCM Data Role, (2) adjunte un Person Security Profile con acceso a todos los trabajadores ("View All Workers"), (3) confirme que el rol otorga privilegios de escritura/POST en learnerLearningRecords (no solo lectura), y (4) ejecute el proceso programado "Retrieve Latest LDAP Changes" después del cambio. |
La exportación de finalizaciones falla con HTTP 400: "You don't have the required security privileges..." | El usuario de API tiene el rol Learning Specialist pero le faltan privilegios de escritura en learnerLearningRecords. | Asegúrese de que el rol Learning Specialist incluya Use REST Service - Learner Learning Records (versión de escritura, no la variante _RO_ de solo lectura) y los privilegios Manage Learning Assignment / Manage Learning Record. |
| Las finalizaciones no aparecen en Oracle Learning | Completion export deshabilitado, o al usuario de la API de Oracle le falta el rol Learning Specialist asignado mediante un Data Role | Habilite Completion export y confirme que el usuario de la API de Oracle tiene el rol Learning Specialist asignado mediante un HCM Data Role con un Person Security Profile y privilegios de escritura — no como un job role directo. |
| La sincronización no se ejecuta según lo programado | Programador deshabilitado o configurado en horarios inesperados | Habilite el programador y verifique que el horario sea correcto en la zona horaria local del LMS. |