> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Compliance per persona
> Recreeu l'exportació de compliment de la formació per persona d'un proveïdor anterior a partir d'assignacions, inscripcions i cursos de /v1.
Aquest informe és la part de formació de l'exportació de compliment per persona d'un proveïdor anterior: identitat del directori més una fila per persona i per inscripció a una formació (estat i dates del mòdul).
El grau de detall és de format llarg (persona × assignació), perquè és el que `GET /v1/assignments/{id}/enrollments` ja retorna. La consulta no pivota els mòduls en columnes.
Les acceptacions de polítiques no formen part d'aquest informe. Living Security no disposa d'una API d'acceptació de polítiques, de manera que aquestes columnes heretades queden fora de l'abast i no són una correspondència pendent. Consulteu [Divergències respecte a l'exportació anterior](#divergences-from-the-legacy-export).
La configuració, les credencials, la paginació i el reintent per límit de velocitat són els mateixos que a la [guia de connectivitat de Power BI / Excel](/ca/developers/v1/powerbi). Afegiu primer la consulta compartida `Fn_FetchAll`; aquest informe la crida pel nom.
## Required key scopes
| Scope | Ús |
| - | - |
| `training:read` | `GET /v1/assignments` i `GET /v1/assignments/{id}/enrollments` |
| `course:read` | `GET /v1/courses` (títols del catàleg) |
## Source endpoints
| Endpoint | Funció |
| - | - |
| `GET /v1/assignments` | Llista d'assignacions: `assignment_id`, títol, `course_id`, estat del cicle de vida, `created_at`. La consulta no filtra per estat, de manera que apareixen les assignacions actives, en pausa i completades (compliment històric). |
| `GET /v1/assignments/{id}/enrollments` | Progrés per Learner. Un recorregut paginat per assignació. Aquest és el grau de detall dels fets i l'únic recurs `/v1` d'aquest informe que inclou el correu electrònic com a clau de combinació per a l'informe. |
| `GET /v1/courses` | Resol `course_id` → títol del curs (el nom del mòdul de Training). `Assignment.title` és una etiqueta de campanya, no el nom del mòdul. |
Aquesta consulta **no** crida `GET /v1/entities`. La fila d'inscripció ja inclou `email` i `display_name`, i la llista d'entitats no té departament ni càrrec, de manera que recórrer-la no ompliria columnes del directori que la fila d'inscripció no tingui ja.
### Grain
Una fila per inscripció (persona × assignació). Una persona assignada al mateix curs mitjançant dues assignacions genera dues files. Una persona sense inscripcions no apareix: `/v1` no pot emetre una fila de directori utilitzable sense correu electrònic, i inventar files només de persona barrejaria graus de detall.
Pressupost de sol·licituds: un recorregut paginat per assignació, de manera seqüencial, sota el límit de velocitat compartit per clau. Definiu sempre `limit = "500"`.
## Column mapping
Els noms de les columnes heretades provenen de l'exportació del vostre proveïdor anterior. Els camps de `/v1` són els noms de l'API pública; la consulta n'anomena alguns amb àlies per a l'informe.
| Columna heretada | Camp o derivació de `/v1` | Columna de l'informe |
| - | - | - |
| Email | `Enrollment.email` | `email` |
| Full name | `Enrollment.display_name` | `full_name` |
| Department | No és a `/v1` | Omesa, no es deixa en blanc |
| Other directory (title, manager, location, …) | No és a `/v1`; les entitats només inclouen el correu electrònic i el nom visible. | Omesa |
| Training module / course name | `Course.title`, amb `Assignment.title` com a alternativa | `course_name` |
| Assignment / module status | `Enrollment.status` — `not_started` \| `in_progress` \| `completed` \| `overdue` \| `withdrawn` | `enrollment_status` |
| Assigned date | `Enrollment.assigned_at` | `assigned_at` |
| Completed date | `Enrollment.completed_at` | `completed_at` |
| Due date | `Enrollment.due_at` (és possible que l'exportació anterior no la tingués; s'inclou perquè l'API la proporciona) | `due_at` |
| Policy acceptance / acknowledgement | Sense domini de polítiques | Omesa |
| Policy name, accepted date | Sense domini de polítiques | Omesa |
Claus de combinació conservades per a un model d'esquema en estrella: `entity_id`, `assignment_id`, `course_id`, `user_assignment_id`.
La consulta també conserva `course_slug`, `assignment_title`, `passed`, `attempts`, `assignment_lifecycle_status` i `assignment_created_at`. `enrollment_status` és el progrés del Learner, no el cicle de vida de l'assignació (`active` / `paused` / `completed`).
## Divergences from the legacy export
* **Les acceptacions de polítiques no estan disponibles.** Aquesta plataforma no té cap domini de polítiques: no hi ha `/policies`, `/policy_acceptances` ni cap recurs `/v1` equivalent. No tracteu aquestes columnes com una correspondència pendent. Estan fora de l'abast.
* **Els camps addicionals del directori s'ometen, no es deixen en blanc.** El departament, el càrrec, el responsable i la ubicació no són a `/v1`. La consulta no inventa columnes buides per a aquests camps.
* **S'inclou la data de venciment** encara que l'exportació anterior no la tingués, perquè `Enrollment.due_at` és a l'API.
* **El nom del curs dona prioritat al títol del catàleg.** `Course.title` és el nom del mòdul. `Assignment.title` només s'utilitza quan falta la fila del catàleg (eliminada o no publicada).
* **Format llarg, no pivotat.** Una fila per inscripció, no una fila per persona amb una columna per mòdul.
## Next steps
Credencials, paginació i càrrega d'aquestes consultes a Power BI o Excel.
Interaccions de phishing a nivell d'esdeveniment dels darrers 12 mesos.
Resum per persona dels clics, les credencials i els informes dels darrers 12 mesos.
Concediu `training:read` i `course:read` a la clau que actualitza aquest informe.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.