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

# Személyenkénti megfelelőségi jelentés

> Egy korábbi szolgáltató személyenkénti képzési megfelelőségi exportjának újraalkotása a /v1 hozzárendelésekből, beiratkozásokból és kurzusokból.

Ez a jelentés egy korábbi szolgáltató személyenkénti megfelelőségi exportjának képzési fele: címtári azonosító, valamint képzési beiratkozásonként egy sor személyenként (modulállapot és dátumok).

A részletezettségi szint hosszú formátumú – személy × hozzárendelés –, mert ezt adja vissza már most is a `GET /v1/assignments/{id}/enrollments`. A lekérdezés nem forgatja a modulokat oszlopokba.

<Note>
  A szabályzat-elfogadások nem tartoznak ebbe a jelentésbe. A Living Security nem rendelkezik szabályzat-elfogadási API-val, ezért ezek a korábbi oszlopok nem tartoznak a hatókörbe, és nem függőben lévő leképezések. Lásd: [Eltérések a korábbi exporttól](#elt%C3%A9r%C3%A9sek-a-kor%C3%A1bbi-exportt%C3%B3l).
</Note>

A beállítás, a hitelesítő adatok, a lapozás és a sebességkorlát miatti újrapróbálkozás megegyezik a [Power BI / Excel kapcsolódási útmutatóban](/hu/developers/v1/powerbi) leírtakkal. Először adja hozzá a megosztott `Fn_FetchAll` lekérdezést; ez a jelentés néven hivatkozik rá.

## Szükséges kulcshatókörök

| Hatókör | Felhasználás |
| - | - |
| `training:read` | `GET /v1/assignments` és `GET /v1/assignments/{id}/enrollments` |
| `course:read` | `GET /v1/courses` (katalóguscímek) |

## Forrásvégpontok

| Végpont | Szerep |
| - | - |
| `GET /v1/assignments` | Hozzárendelések listája: `assignment_id`, cím, `course_id`, életciklus-állapot, `created_at`. A lekérdezés nem szűr állapot szerint, így az aktív, a szüneteltetett és a befejezett hozzárendelések is megjelennek (korábbi megfelelőség). |
| `GET /v1/assignments/{id}/enrollments` | Tanulónkénti előrehaladás. Hozzárendelésenként egy lapozott bejárás. Ez a ténytábla szintje, és az egyetlen `/v1` erőforrás ebben a jelentésben, amely az e-mail-címet jelentéskészítési illesztőkulcsként tartalmazza. |
| `GET /v1/courses` | A `course_id` értéket kurzuscímre (a képzési modul nevére) oldja fel. A `Assignment.title` kampánycímke, nem a modul neve. |

Ez a lekérdezés **nem** hívja meg a következőt: `GET /v1/entities`. A beiratkozási sor már tartalmazza a `email` és `display_name` mezőket, az entitáslista pedig nem tartalmaz részleget vagy beosztást – így a bejárása nem töltene ki olyan címtári oszlopokat, amelyeket a beiratkozási sor még nem tartalmaz.

### Részletezettségi szint

Beiratkozásonként (személy × hozzárendelés) egy sor. Ha egy személy ugyanazt a kurzust két hozzárendelésen keresztül kapja meg, két sor keletkezik. Az a személy, akinek nincs beiratkozása, nem jelenik meg – a `/v1` e-mail-cím nélkül nem tud használható címtári sort előállítani, a csak személyt tartalmazó sorok kitalálása pedig összekeverné a részletezettségi szinteket.

Kérésköltségvetés: hozzárendelésenként egy lapozott bejárás, egymás után, a kulcsonkénti megosztott sebességkorlát mellett. Mindig állítsa be a következőt: `limit = "500"`.

## Oszlopleképezés

A korábbi oszlopnevek az előző szolgáltató exportjából származnak. A `/v1` mezők a nyilvános API-nevek; a lekérdezés néhányat közülük átnevez a jelentés számára.

| Korábbi oszlop | `/v1` mező vagy származtatás | Jelentésoszlop |
| - | - | - |
| E-mail | `Enrollment.email` | `email` |
| Teljes név | `Enrollment.display_name` | `full_name` |
| Részleg | Nem szerepel itt: `/v1` | Kihagyva, nem null értékkel |
| Egyéb címtári adatok (beosztás, vezető, helyszín, …) | Nem szerepel itt: `/v1` – az entitások csak e-mail-címet és megjelenített nevet tartalmaznak. | Kihagyva |
| Képzési modul / kurzus neve | `Course.title`, ennek hiányában `Assignment.title` | `course_name` |
| Hozzárendelés / modul állapota | `Enrollment.status` — `not_started` \| `in_progress` \| `completed` \| `overdue` \| `withdrawn` | `enrollment_status` |
| Hozzárendelés dátuma | `Enrollment.assigned_at` | `assigned_at` |
| Befejezés dátuma | `Enrollment.completed_at` | `completed_at` |
| Határidő | `Enrollment.due_at` (lehet, hogy a korábbi export nem tartalmazta; azért szerepel, mert az API tartalmazza) | `due_at` |
| Szabályzat elfogadása / tudomásulvétele | Nincs szabályzattartomány | Kihagyva |
| Szabályzat neve, elfogadás dátuma | Nincs szabályzattartomány | Kihagyva |

A csillagséma-modellhez megtartott illesztőkulcsok: `entity_id`, `assignment_id`, `course_id`, `user_assignment_id`.

A lekérdezés továbbá megtartja a következőket: `course_slug`, `assignment_title`, `passed`, `attempts`, `assignment_lifecycle_status` és `assignment_created_at`. A `enrollment_status` a tanuló előrehaladása, nem a hozzárendelés életciklusa (`active` / `paused` / `completed`).

## Eltérések a korábbi exporttól

* **A szabályzat-elfogadások nem érhetők el.** Ez a platform nem rendelkezik szabályzattartománnyal – nincs `/policies`, `/policy_acceptances` vagy azzal egyenértékű `/v1` erőforrás. Ne kezelje ezeket az oszlopokat függőben lévő leképezésként. Nem tartoznak a hatókörbe.
* **A kiegészítő címtári adatok ki vannak hagyva, nem null értékkel szerepelnek.** A részleg, a beosztás, a vezető és a helyszín nem szerepel itt: `/v1`. A lekérdezés nem hoz létre üres oszlopokat ezeknek.
* **A határidő szerepel**, még ha a korábbi export nem is tartalmazta, mert a `Enrollment.due_at` elérhető az API-ban.
* **A kurzusnév a katalóguscímet részesíti előnyben.** A `Course.title` a modul neve. A `Assignment.title` csak akkor szerepel, ha a katalógussor hiányzik (törölt vagy nem közzétett).
* **Hosszú formátum, nem forgatott.** Beiratkozásonként egy sor, nem személyenként egy sor modulonkénti oszloppal.

## Következő lépések

<CardGroup cols={2}>
  <Card title="Power BI és Excel beállítása" href="/hu/developers/v1/powerbi">
    Hitelesítő adatok, lapozás, valamint ezeknek a lekérdezéseknek a betöltése Power BI-ban vagy Excelben.
  </Card>

  <Card title="E-mail-adathalász napló" href="/hu/developers/v1/reports/email-phishing-log">
    Eseményszintű adathalász-interakciók az utolsó 12 hónapra.
  </Card>

  <Card title="Leginkább veszélyeztetett felhasználók" href="/hu/developers/v1/reports/most-susceptible-users">
    Személyenkénti 12 havi kattintási, hitelesítőadat- és jelentési összesítés.
  </Card>

  <Card title="API-kulcsok" href="/hu/developers/developer-hub/api-keys">
    Adja meg a `training:read` és `course:read` jogosultságot a jelentést frissítő kulcson.
  </Card>
</CardGroup>


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