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

# תאימות לפי אדם

> יצירה מחדש של ייצוא תאימות ההדרכה לפי אדם של ספק קודם, מתוך assignments, enrollments ו-courses של /v1.

דוח זה הוא חלק ההדרכה בייצוא התאימות לפי אדם של ספק קודם: זהות מתוך הספרייה בתוספת שורה אחת לכל אדם לכל רישום להדרכה (סטטוס המודול ותאריכים).

הפירוט הוא בצורה ארוכה (long-form) — אדם × הקצאה — מפני שזה מה ש-`GET /v1/assignments/{id}/enrollments` מחזיר כבר כיום. השאילתה אינה הופכת מודולים לעמודות (pivot).

<Note>
  אישורי מדיניות אינם חלק מדוח זה. ל-Living Security אין API לאישור מדיניות, ולכן העמודות הישנות הללו אינן בתחום הדוח ואינן מיפוי שממתין להשלמה. ראו [הבדלים לעומת הייצוא הקודם](#%D7%94%D7%91%D7%93%D7%9C%D7%99%D7%9D-%D7%9C%D7%A2%D7%95%D7%9E%D7%AA-%D7%94%D7%99%D7%99%D7%A6%D7%95%D7%90-%D7%94%D7%A7%D7%95%D7%93%D7%9D).
</Note>

ההגדרה, האישורים, חלוקה לעמודים (pagination) וניסיון חוזר במקרה של חריגה ממגבלת הקצב זהים ל[מדריך החיבור ל-Power BI / Excel](/he/developers/v1/powerbi). יש להוסיף תחילה את השאילתה המשותפת `Fn_FetchAll`; דוח זה קורא לה בשמה.

## היקפי מפתח נדרשים

| היקף | שימוש |
| - | - |
| `training:read` | `GET /v1/assignments` ו-`GET /v1/assignments/{id}/enrollments` |
| `course:read` | `GET /v1/courses` (כותרות הקטלוג) |

## נקודות קצה של המקור

| נקודת קצה | תפקיד |
| - | - |
| `GET /v1/assignments` | רשימת הקצאות: `assignment_id`, כותרת, `course_id`, סטטוס מחזור חיים, `created_at`. השאילתה אינה מסננת לפי סטטוס, ולכן הקצאות פעילות, מושהות ושהושלמו מופיעות כולן (תאימות היסטורית). |
| `GET /v1/assignments/{id}/enrollments` | התקדמות לכל לומד. מעבר מחולק לעמודים אחד לכל הקצאה. זהו פירוט העובדות, והמשאב היחיד `/v1` בדוח זה שנושא דוא"ל כמפתח צירוף לדיווח. |
| `GET /v1/courses` | מתרגם `course_id` → כותרת קורס (שם מודול ההדרכה). `Assignment.title` הוא תווית קמפיין, ולא שם המודול. |

שאילתה זו **אינה** קוראת ל-`GET /v1/entities`. שורת הרישום כבר נושאת `email` ו-`display_name`, ולרשימת הישויות אין מחלקה או תפקיד — ולכן מעבר עליה לא ימלא עמודות ספרייה שאינן קיימות כבר בשורת הרישום.

### פירוט

שורה אחת לכל רישום (אדם × הקצאה). אדם שהוקצה לו אותו קורס דרך שתי הקצאות יפיק שתי שורות. אדם ללא רישומים אינו מופיע — `/v1` אינו יכול להפיק שורת ספרייה שמישה ללא דוא"ל, והמצאת שורות של אדם בלבד תערבב רמות פירוט שונות.

תקציב בקשות: מעבר אחד מחולק לעמודים לכל הקצאה, ברצף, במסגרת מגבלת הקצב המשותפת לכל מפתח. יש להגדיר תמיד `limit = "500"`.

## מיפוי עמודות

שמות העמודות הישנות לקוחים מהייצוא של הספק הקודם שלכם. שדות `/v1` הם שמות ה-API הציבוריים; השאילתה נותנת לחלקם כינוי לצורך הדוח.

| עמודה ישנה | שדה `/v1` או נגזרת | עמודה בדוח |
| - | - | - |
| Email | `Enrollment.email` | `email` |
| Full name | `Enrollment.display_name` | `full_name` |
| Department | לא קיים ב-`/v1` | מושמטת, לא מאופסת |
| Other directory (title, manager, location, …) | לא קיים ב-`/v1` — ישויות נושאות דוא"ל ושם תצוגה בלבד. | מושמטת |
| Training module / course name | `Course.title`, ובמקרה של היעדר — `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` (ייתכן שבייצוא הישן שדה זה לא היה קיים; הוא נכלל משום שה-API מספק אותו) | `due_at` |
| Policy acceptance / acknowledgement | אין תחום מדיניות | מושמטת |
| Policy name, accepted date | אין תחום מדיניות | מושמטת |

מפתחות צירוף שנשמרו עבור מודל כוכב (star-schema): `entity_id`, `assignment_id`, `course_id`, `user_assignment_id`.

השאילתה שומרת גם את `course_slug`, `assignment_title`, `passed`, `attempts`, `assignment_lifecycle_status` ו-`assignment_created_at`. `enrollment_status` הוא ההתקדמות של הלומד, ולא מחזור החיים של ההקצאה (`active` / `paused` / `completed`).

## הבדלים לעומת הייצוא הקודם

* **אישורי מדיניות אינם זמינים.** לפלטפורמה זו אין תחום מדיניות — אין `/policies`, `/policy_acceptances` או משאב `/v1` מקביל. אין להתייחס לעמודות אלה כמיפוי שממתין להשלמה. הן מחוץ לתחום הדוח.
* **נתוני ספרייה נוספים מושמטים, ולא מאופסים.** מחלקה, תפקיד, מנהל ומיקום אינם קיימים ב-`/v1`. השאילתה אינה ממציאה עבורם עמודות ריקות.
* **תאריך היעד נכלל** גם אם הוא לא היה קיים בייצוא הישן, משום ש-`Enrollment.due_at` זמין ב-API.
* **שם הקורס מעדיף את כותרת הקטלוג.** `Course.title` הוא שם המודול. `Assignment.title` משמש רק כאשר שורת הקטלוג חסרה (נמחקה או שאינה מפורסמת).
* **צורה ארוכה, ללא pivot.** שורה אחת לכל רישום, ולא שורה אחת לכל אדם עם עמודה לכל מודול.

## השלבים הבאים

<CardGroup cols={2}>
  <Card title="הגדרת Power BI ו-Excel" href="/he/developers/v1/powerbi">
    אישורים, חלוקה לעמודים וטעינת השאילתות הללו ב-Power BI או ב-Excel.
  </Card>

  <Card title="יומן פישינג בדוא&#x22;ל" href="/he/developers/v1/reports/email-phishing-log">
    אינטראקציות פישינג ברמת האירוע ב-12 החודשים האחרונים.
  </Card>

  <Card title="המשתמשים הפגיעים ביותר" href="/he/developers/v1/reports/most-susceptible-users">
    סיכום לפי אדם של קליקים, הזנת פרטי גישה ודיווחים ב-12 החודשים האחרונים.
  </Card>

  <Card title="מפתחות API" href="/he/developers/developer-hub/api-keys">
    יש להעניק `training:read` ו-`course:read` למפתח שמרענן דוח זה.
  </Card>
</CardGroup>


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