> ## 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 pr. person

> Genskab en tidligere udbyders compliance-eksport af træning pr. person ud fra /v1-assignments, -enrollments og -courses.

Denne rapport er træningsdelen af en tidligere udbyders compliance-eksport pr. person: katalogidentitet plus én række pr. person pr. træningstilmelding (modulstatus og datoer).

Granulariteten er langformet – person × assignment – fordi det er, hvad
`GET /v1/assignments/{id}/enrollments` allerede returnerer. Forespørgslen
pivoterer ikke moduler til kolonner.

<Note>
  Politikbekræftelser er ikke en del af denne rapport. Living Security har
  ingen API til politikgodkendelse, så disse ældre kolonner er uden for omfanget og er ikke en afventende mapping. Se [Afvigelser fra den tidligere eksport](#afvigelser-fra-den-tidligere-eksport).
</Note>

Opsætning, legitimationsoplysninger, paginering og genforsøg ved rate limit er de samme som i
[vejledningen til Power BI/Excel-forbindelse](/da/developers/v1/powerbi). Tilføj først den fælles
`Fn_FetchAll`-forespørgsel; denne rapport kalder den ved navn.

## Påkrævede nøgleomfang

| Omfang | Anvendes til |
| - | - |
| `training:read` | `GET /v1/assignments` og `GET /v1/assignments/{id}/enrollments` |
| `course:read` | `GET /v1/courses` (katalogtitler) |

## Kildeendepunkter

| Endepunkt | Rolle |
| - | - |
| `GET /v1/assignments` | Liste over assignments: `assignment_id`, titel, `course_id`, livscyklusstatus, `created_at`. Forespørgslen filtrerer ikke på status, så aktive, satte på pause og gennemførte assignments vises alle (historisk compliance). |
| `GET /v1/assignments/{id}/enrollments` | Fremdrift pr. kursist. Ét pagineret gennemløb pr. assignment. Dette er faktagranulariteten og den eneste `/v1`-ressource i denne rapport, der har e-mail som rapporteringsnøgle til joins. |
| `GET /v1/courses` | Omsætter `course_id` → kursustitel (navnet på træningsmodulet). `Assignment.title` er en kampagnebetegnelse, ikke modulnavnet. |

Denne forespørgsel kalder **ikke** `GET /v1/entities`. Tilmeldingsrækken
indeholder allerede `email` og `display_name`, og enhedslisten har ingen
afdeling eller jobtitel – så et gennemløb af den ville ikke udfylde katalogkolonner,
som tilmeldingsrækken ikke allerede har.

### Granularitet

Én række pr. tilmelding (person × assignment). En person, der er tildelt det samme
kursus via to assignments, giver to rækker. En person uden
tilmeldinger vises ikke – `/v1` kan ikke udlede en brugbar katalogrække
uden e-mail, og at opfinde rækker med kun personer ville blande granulariteter.

Forespørgselsbudget: ét pagineret gennemløb pr. assignment, sekventielt, under den
fælles rate limit pr. nøgle. Angiv altid `limit = "500"`.

## Kolonnemapping

Navnene på de ældre kolonner stammer fra din tidligere udbyders eksport. `/v1`-felter
er de offentlige API-navne; forespørgslen giver nogle af dem et alias i rapporten.

| Ældre kolonne | `/v1`-felt eller afledning | Rapportkolonne |
| - | - | - |
| E-mail | `Enrollment.email` | `email` |
| Fulde navn | `Enrollment.display_name` | `full_name` |
| Afdeling | Findes ikke på `/v1` | Udeladt, ikke sat til null |
| Andet katalog (titel, leder, lokation, …) | Findes ikke på `/v1` – entiteter har kun e-mail og visningsnavn. | Udeladt |
| Træningsmodul / kursusnavn | `Course.title` med `Assignment.title` som reserve | `course_name` |
| Status for assignment / modul | `Enrollment.status` — `not_started` \| `in_progress` \| `completed` \| `overdue` \| `withdrawn` | `enrollment_status` |
| Tildelingsdato | `Enrollment.assigned_at` | `assigned_at` |
| Gennemførelsesdato | `Enrollment.completed_at` | `completed_at` |
| Forfaldsdato | `Enrollment.due_at` (den ældre eksport havde den muligvis ikke; medtaget, fordi API'et har den) | `due_at` |
| Politikgodkendelse / bekræftelse | Intet politikdomæne | Udeladt |
| Politiknavn, godkendelsesdato | Intet politikdomæne | Udeladt |

Nøgler til joins, der bevares til en stjerneskemamodel: `entity_id`, `assignment_id`,
`course_id`, `user_assignment_id`.

Forespørgslen bevarer også `course_slug`, `assignment_title`, `passed`,
`attempts`, `assignment_lifecycle_status` og `assignment_created_at`.
`enrollment_status` er kursistens fremdrift, ikke assignmentets livscyklus
(`active` / `paused` / `completed`).

## Afvigelser fra den tidligere eksport

* **Politikgodkendelser er ikke tilgængelige.** Denne platform har intet politikdomæne – der er ingen `/policies`, `/policy_acceptances` eller tilsvarende
  `/v1`-ressource. Behandl ikke disse kolonner som en afventende mapping. De er uden for omfanget.
* **Ekstra katalogfelter er udeladt, ikke sat til null.** Afdeling, jobtitel,
  leder og lokation findes ikke på `/v1`. Forespørgslen opfinder ikke tomme
  kolonner til dem.
* **Forfaldsdato er medtaget**, selv om den ældre eksport ikke havde den,
  fordi `Enrollment.due_at` findes i API'et.
* **Kursusnavnet foretrækker katalogtitlen.** `Course.title` er modulnavnet. `Assignment.title` bruges kun, når katalograden mangler
  (slettet eller ikke udgivet).
* **Langformet, ikke pivoteret.** Én række pr. tilmelding, ikke én række pr.
  person med en kolonne pr. modul.

## Næste trin

<CardGroup cols={2}>
  <Card title="Opsætning af Power BI og Excel" href="/da/developers/v1/powerbi">
    Legitimationsoplysninger, paginering og indlæsning af disse forespørgsler i Power BI eller Excel.
  </Card>

  <Card title="Log over phishing-e-mails" href="/da/developers/v1/reports/email-phishing-log">
    Phishing-interaktioner på hændelsesniveau for de seneste 12 måneder.
  </Card>

  <Card title="Mest modtagelige brugere" href="/da/developers/v1/reports/most-susceptible-users">
    Opsummering pr. person af klik, legitimationsoplysninger og rapporteringer over 12 måneder.
  </Card>

  <Card title="API-nøgler" href="/da/developers/developer-hub/api-keys">
    Tildel `training:read` og `course:read` på den nøgle, der opdaterer denne rapport.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.