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

# Shoda s požadavky po jednotlivých osobách

> Znovu vytvořte export shody školení po jednotlivých osobách od předchozího poskytovatele z přiřazení, registrací a kurzů v rozhraní /v1.

Tento report představuje část exportu shody po jednotlivých osobách od předchozího poskytovatele, která se týká školení: identita z adresáře a jeden řádek na osobu a registraci do školení (stav a data modulu).

Granularita je dlouhý formát – osoba × přiřazení – protože přesně to již vrací
`GET /v1/assignments/{id}/enrollments`. Dotaz nepřevádí moduly do sloupců.

<Note>
  Potvrzení zásad nejsou součástí tohoto reportu. Living Security nemá
  žádné API pro přijetí zásad, takže tyto původní sloupce jsou mimo rozsah a nejde o čekající mapování. Viz [Odchylky od původního exportu](#odchylky-od-p%C5%AFvodn%C3%ADho-exportu).
</Note>

Nastavení, přihlašovací údaje, stránkování a opakování při překročení limitu požadavků jsou stejné jako v
[průvodci připojením Power BI / Excel](/cs/developers/v1/powerbi). Nejprve přidejte sdílený
dotaz `Fn_FetchAll`; tento report jej volá podle názvu.

## Požadované rozsahy klíče

| Rozsah | Použití |
| - | - |
| `training:read` | `GET /v1/assignments` a `GET /v1/assignments/{id}/enrollments` |
| `course:read` | `GET /v1/courses` (názvy z katalogu) |

## Zdrojové koncové body

| Koncový bod | Role |
| - | - |
| `GET /v1/assignments` | Seznam přiřazení: `assignment_id`, název, `course_id`, stav životního cyklu, `created_at`. Dotaz nefiltruje podle stavu, takže se zobrazí aktivní, pozastavená i dokončená přiřazení (historická shoda s požadavky). |
| `GET /v1/assignments/{id}/enrollments` | Průběh jednotlivých účastníků. Jedno stránkované procházení na přiřazení. Toto je faktová granularita a jediný zdroj `/v1` v tomto reportu, který obsahuje e-mail jako klíč pro propojení v reportingu. |
| `GET /v1/courses` | Převádí `course_id` na název kurzu (název školicího modulu). `Assignment.title` je označení kampaně, nikoli název modulu. |

Tento dotaz **nevolá** `GET /v1/entities`. Řádek registrace
již obsahuje `email` a `display_name` a seznam entit neobsahuje
oddělení ani pracovní pozici, takže jeho procházení by nenaplnilo
sloupce adresáře, které řádek registrace již neobsahuje.

### Granularita

Jeden řádek na registraci (osoba × přiřazení). Osoba, které byl stejný
kurz přiřazen prostřednictvím dvou přiřazení, vytvoří dva řádky. Osoba bez
registrací se nezobrazí – `/v1` nemůže vytvořit použitelný řádek adresáře
bez e-mailu a vymýšlení řádků pouze s osobou by smíchalo různé granularity.

Rozpočet požadavků: jedno stránkované procházení na přiřazení, postupně, v rámci
sdíleného limitu požadavků na klíč. Vždy nastavte `limit = "500"`.

## Mapování sloupců

Názvy původních sloupců pocházejí z exportu vašeho předchozího poskytovatele. Pole `/v1`
jsou veřejné názvy API; dotaz některá z nich pro report přejmenovává.

| Původní sloupec | Pole nebo odvození `/v1` | Sloupec reportu |
| - | - | - |
| E-mail | `Enrollment.email` | `email` |
| Celé jméno | `Enrollment.display_name` | `full_name` |
| Oddělení | Není v `/v1` | Vynecháno, nenahrazeno hodnotou null |
| Ostatní údaje adresáře (pozice, nadřízený, lokalita, …) | Nejsou v `/v1` – entity obsahují pouze e-mail a zobrazované jméno. | Vynecháno |
| Školicí modul / název kurzu | `Course.title`, s náhradou `Assignment.title` | `course_name` |
| Stav přiřazení / modulu | `Enrollment.status` — `not_started` \| `in_progress` \| `completed` \| `overdue` \| `withdrawn` | `enrollment_status` |
| Datum přiřazení | `Enrollment.assigned_at` | `assigned_at` |
| Datum dokončení | `Enrollment.completed_at` | `completed_at` |
| Termín splnění | `Enrollment.due_at` (původní export jej nemusel obsahovat; je zahrnut, protože jej API poskytuje) | `due_at` |
| Přijetí zásad / potvrzení | Žádná doména zásad | Vynecháno |
| Název zásady, datum přijetí | Žádná doména zásad | Vynecháno |

Klíče pro propojení ponechané pro model hvězdicového schématu: `entity_id`, `assignment_id`,
`course_id`, `user_assignment_id`.

Dotaz dále zachovává `course_slug`, `assignment_title`, `passed`,
`attempts`, `assignment_lifecycle_status` a `assignment_created_at`.
`enrollment_status` je průběh účastníka, nikoli stav životního cyklu přiřazení
(`active` / `paused` / `completed`).

## Odchylky od původního exportu

* **Přijetí zásad není k dispozici.** Tato platforma nemá doménu
  zásad – neexistuje `/policies`, `/policy_acceptances` ani ekvivalentní
  zdroj `/v1`. Tyto sloupce nepovažujte za čekající mapování. Jsou
  mimo rozsah.
* **Dodatečné údaje adresáře jsou vynechány, nikoli nahrazeny hodnotou null.** Oddělení, pracovní pozice,
  nadřízený a lokalita nejsou v `/v1`. Dotaz pro ně nevytváří
  prázdné sloupce.
* **Termín splnění je zahrnut**, i když jej původní export neobsahoval,
  protože `Enrollment.due_at` je dostupné v API.
* **Název kurzu upřednostňuje název z katalogu.** `Course.title` je název
  modulu. `Assignment.title` se použije pouze tehdy, když řádek katalogu chybí
  (byl odstraněn nebo nebyl publikován).
* **Dlouhý formát, nikoli převedený do sloupců.** Jeden řádek na registraci, nikoli jeden řádek na
  osobu se sloupcem pro každý modul.

## Další kroky

<CardGroup cols={2}>
  <Card title="Nastavení Power BI a Excelu" href="/cs/developers/v1/powerbi">
    Přihlašovací údaje, stránkování a načítání těchto dotazů v Power BI nebo Excelu.
  </Card>

  <Card title="Protokol phishingových e-mailů" href="/cs/developers/v1/reports/email-phishing-log">
    Phishingové interakce na úrovni událostí za posledních 12 měsíců.
  </Card>

  <Card title="Nejvíce ohrožení uživatelé" href="/cs/developers/v1/reports/most-susceptible-users">
    Souhrn kliknutí, zadání přihlašovacích údajů a nahlášení za 12 měsíců po jednotlivých osobách.
  </Card>

  <Card title="Klíče API" href="/cs/developers/developer-hub/api-keys">
    Udělte `training:read` a `course:read` klíči, který obnovuje tento report.
  </Card>
</CardGroup>


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