Cumplimiento por persona

Este informe es la parte de capacitación de la exportación de cumplimiento por persona de un proveedor anterior: identidad del directorio más una fila por persona y por inscripción a la capacitación (estado y fechas del módulo). El nivel de detalle es de formato largo (persona × asignación), porque es lo que GET /v1/assignments/{id}/enrollments ya devuelve. La consulta no transforma los módulos en columnas. La configuración, las credenciales, la paginación y el reintento por límite de velocidad son los mismos que en la guía de conectividad de Power BI / Excel. Agregue primero la consulta compartida Fn_FetchAll; este informe la invoca por su nombre.

​

Ámbitos de clave necesarios

​

Endpoints de origen

Esta consulta no llama a GET /v1/entities. La fila de inscripción ya incluye email y display_name, y la lista de entidades no tiene departamento ni puesto, por lo que recorrerla no completaría las columnas del directorio que la fila de inscripción no tenga ya.

​

Nivel de detalle

Una fila por inscripción (persona × asignación). Una persona a la que se asigna el mismo curso mediante dos asignaciones genera dos filas. Una persona sin inscripciones no aparece: /v1 no puede generar una fila de directorio utilizable sin correo electrónico, y crear filas solo de personas mezclaría niveles de detalle. Presupuesto de solicitudes: un recorrido paginado por asignación, de forma secuencial, dentro del límite de velocidad compartido por clave. Establezca siempre limit = "500".

​

Asignación de columnas

Los nombres de las columnas heredadas provienen de la exportación de su proveedor anterior. Los campos de /v1 son los nombres de la API pública; la consulta asigna alias a algunos de ellos para el informe. Claves de unión conservadas para un modelo de esquema en estrella: entity_id, assignment_id, course_id, user_assignment_id. La consulta también conserva course_slug, assignment_title, passed, attempts, assignment_lifecycle_status y assignment_created_at. enrollment_status es el progreso del alumno, no el ciclo de vida de la asignación (active / paused / completed).

​

Diferencias con la exportación heredada

• Las aceptaciones de políticas no están disponibles. Esta plataforma no tiene un dominio de políticas: no existe /policies, /policy_acceptances ni un recurso /v1 equivalente. No considere esas columnas como una asignación pendiente. Están fuera del alcance.
• Los datos adicionales del directorio se omiten, no se establecen como nulos. El departamento, el puesto, el responsable y la ubicación no están en /v1. La consulta no crea columnas vacías para ellos.
• Se incluye la fecha de vencimiento aunque la exportación heredada no la tuviera, porque Enrollment.due_at está disponible en la API.
• El nombre del curso prioriza el título del catálogo. Course.title es el nombre del módulo. Assignment.title se usa solo cuando falta la fila del catálogo (eliminada o no publicada).
• Formato largo, sin transformar en columnas. Una fila por inscripción, no una fila por persona con una columna por módulo.

​

Siguientes pasos