> ## 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. # Henkilökohtainen vaatimustenmukaisuus > Luo uudelleen aiemman toimittajan henkilökohtainen koulutuksen vaatimustenmukaisuusvienti /v1-rajapinnan tehtävistä (assignments), ilmoittautumisista (enrollments) ja kursseista (courses). Tämä raportti vastaa aiemman toimittajan henkilökohtaisen vaatimustenmukaisuusviennin koulutusosaa: hakemistotunnistetiedot sekä yksi rivi henkilöä kohden jokaista koulutukseen ilmoittautumista kohden (moduulin tila ja päivämäärät). Rakenne on pitkä muoto – henkilö × tehtävä – koska juuri sen `GET /v1/assignments/{id}/enrollments` jo palauttaa. Kysely ei muuntele moduuleja sarakkeiksi. Käytäntöjen hyväksynnät eivät kuulu tähän raporttiin. Living Securityllä ei ole käytäntöjen hyväksyntään liittyvää rajapintaa, joten kyseiset vanhat sarakkeet eivät kuulu laajuuteen, eivätkä ne ole odottava yhdistämiskohde. Katso [Erot vanhaan vientiin verrattuna](#erot-vanhaan-vientiin-verrattuna). Määritys, tunnistetiedot, sivutus ja nopeusrajoituksen uudelleenyritys ovat samat kuin [Power BI / Excel -yhteysoppaassa](/fi/developers/v1/powerbi). Lisää ensin jaettu `Fn_FetchAll`-kysely; tämä raportti kutsuu sitä nimellä. ## Vaaditut avaimen oikeudet | Oikeus | Käyttötarkoitus | | - | - | | `training:read` | `GET /v1/assignments` ja `GET /v1/assignments/{id}/enrollments` | | `course:read` | `GET /v1/courses` (luettelon nimikkeet) | ## Lähteenä käytettävät päätepisteet | Päätepiste | Rooli | | - | - | | `GET /v1/assignments` | Tehtäväluettelo: `assignment_id`, otsikko, `course_id`, elinkaaren tila, `created_at`. Kysely ei suodata tilan mukaan, joten aktiiviset, keskeytetyt ja päättyneet tehtävät näkyvät kaikki (historiallinen vaatimustenmukaisuus). | | `GET /v1/assignments/{id}/enrollments` | Oppijakohtainen edistyminen. Yksi sivutettu läpikäynti tehtävää kohden. Tämä on faktojen rakenne, ja se on tämän raportin ainoa `/v1`-resurssi, joka sisältää sähköpostiosoitteen raportoinnin liitosavaimena. | | `GET /v1/courses` | Muuntaa `course_id`-arvon kurssin nimeksi (koulutusmoduulin nimi). `Assignment.title` on kampanjan tunniste, ei moduulin nimi. | Tämä kysely **ei** kutsu `GET /v1/entities`. Ilmoittautumisrivi sisältää jo `email` ja `display_name`, eikä entiteettiluettelossa ole osastoa tai tehtävänimikettä, joten sen läpikäynti ei täyttäisi hakemistosarakkeita, joita ilmoittautumisrivi ei jo sisältäisi. ### Rakenne Yksi rivi ilmoittautumista kohden (henkilö × tehtävä). Jos henkilölle on määritetty sama kurssi kahden tehtävän kautta, syntyy kaksi riviä. Henkilö, jolla ei ole ilmoittautumisia, ei näy – `/v1` ei voi tuottaa käyttökelpoista hakemistoriviä ilman sähköpostiosoitetta, ja pelkkien henkilörivien keksiminen sekoittaisi rakenteita. Pyyntöbudjetti: yksi sivutettu läpikäynti tehtävää kohden, peräkkäin, jaetun avainkohtaisen nopeusrajoituksen puitteissa. Aseta aina `limit = "500"`. ## Sarakkeiden vastaavuus Vanhojen sarakkeiden nimet ovat aiemman toimittajan viennistä. `/v1`-kentät ovat julkisen rajapinnan nimiä; kysely antaa joillekin niistä raportissa aliaksen. | Vanha sarake | `/v1`-kenttä tai johtaminen | Raportin sarake | | - | - | - | | Email | `Enrollment.email` | `email` | | Full name | `Enrollment.display_name` | `full_name` | | Department | Ei kohteessa `/v1` | Jätetty pois, ei tyhjäarvona | | Other directory (title, manager, location, …) | Ei kohteessa `/v1` – entiteetit sisältävät vain sähköpostiosoitteen ja näyttönimen. | Jätetty pois | | Training module / course name | `Course.title`, varana `Assignment.title` | `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` (vanhassa viennissä tätä ei välttämättä ollut; mukana, koska rajapinta sisältää sen) | `due_at` | | Policy acceptance / acknowledgement | Ei käytäntöaluetta | Jätetty pois | | Policy name, accepted date | Ei käytäntöaluetta | Jätetty pois | Tähtimallia varten säilytetyt liitosavaimet: `entity_id`, `assignment_id`, `course_id`, `user_assignment_id`. Kysely säilyttää myös kentät `course_slug`, `assignment_title`, `passed`, `attempts`, `assignment_lifecycle_status` ja `assignment_created_at`. `enrollment_status` on oppijan edistyminen, ei tehtävän elinkaari (`active` / `paused` / `completed`). ## Erot vanhaan vientiin verrattuna * **Käytäntöjen hyväksynnät eivät ole saatavilla.** Tässä alustassa ei ole käytäntöaluetta – ei ole `/policies`-, `/policy_acceptances`- tai vastaavaa `/v1`-resurssia. Älä käsittele näitä sarakkeita odottavana yhdistämiskohteena. Ne eivät kuulu laajuuteen. * **Hakemiston lisätiedot jätetään pois, ei tyhjäarvoina.** Osasto, tehtävänimike, esihenkilö ja sijainti eivät ole kohteessa `/v1`. Kysely ei keksi niille tyhjiä sarakkeita. * **Eräpäivä sisältyy** vaikka vanhassa viennissä sitä ei olisi ollut, koska `Enrollment.due_at` on rajapinnassa. * **Kurssin nimessä suositaan luettelon nimikettä.** `Course.title` on moduulin nimi. `Assignment.title`-arvoa käytetään vain, kun luettelorivi puuttuu (poistettu tai julkaisematon). * **Pitkä muoto, ei muunnettu sarakkeiksi.** Yksi rivi ilmoittautumista kohden, ei yksi rivi henkilöä kohden ja sarake moduulia kohden. ## Seuraavat vaiheet Tunnistetiedot, sivutus ja näiden kyselyjen lataaminen Power BI:hin tai Exceliin. Tietojenkalasteluvuorovaikutukset tapahtumatasolla viimeisen 12 kuukauden ajalta. Henkilökohtainen 12 kuukauden yhteenveto klikkauksista, tunnistetiedoista ja ilmoituksista. Myönnä `training:read` ja `course:read` avaimelle, joka päivittää tämän raportin. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.