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

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

​

Forrásvégpontok

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