الامتثال لكل شخص

يمثّل هذا التقرير الجزء الخاص بالتدريب من تصدير الامتثال لكل شخص الخاص بمزوّد سابق: هوية الدليل بالإضافة إلى صف واحد لكل شخص عن كل تسجيل في التدريب (حالة الوحدة وتواريخها). الحبيبية (grain) هنا بصيغة طويلة — شخص × تعيين — لأن هذا هو ما يعيده GET /v1/assignments/{id}/enrollments بالفعل. لا يقوم الاستعلام بتحويل الوحدات إلى أعمدة (pivot). إن الإعداد وبيانات الاعتماد وترقيم الصفحات وإعادة المحاولة عند بلوغ حد المعدل هي نفسها الواردة في دليل الاتصال بـ Power BI / Excel. أضف أولًا الاستعلام المشترك Fn_FetchAll؛ إذ يستدعيه هذا التقرير بالاسم.

​

نطاقات المفتاح المطلوبة

​

نقاط النهاية المصدرية

لا يستدعي هذا الاستعلام GET /v1/entities. فصف التسجيل يحمل بالفعل email وdisplay_name، كما أن قائمة الكيانات لا تتضمن القسم أو المسمى الوظيفي، وبالتالي فإن استعراضها لن يملأ أعمدة الدليل غير الموجودة أصلًا في صف التسجيل.

​

الحبيبية

صف واحد لكل تسجيل (شخص × تعيين). الشخص الذي يُعيَّن له المقرر نفسه عبر تعيينين ينتج عنه صفان. أما الشخص الذي لا توجد له أي تسجيلات فلا يظهر — إذ لا يمكن لـ /v1 إنتاج صف دليل صالح للاستخدام دون بريد إلكتروني، كما أن اختلاق صفوف للأشخاص فقط سيؤدي إلى خلط الحبيبيات. ميزانية الطلبات: عملية استعراض مرقّمة واحدة لكل تعيين، بالتتابع، ضمن حد المعدل المشترك لكل مفتاح. اضبط limit = "500" دائمًا.

​

ربط الأعمدة

أسماء الأعمدة القديمة مأخوذة من تصدير مزوّدك السابق. حقول /v1 هي أسماء الواجهة البرمجية العامة؛ ويعيد الاستعلام تسمية بعضها لأغراض التقرير. مفاتيح الربط المحتفظ بها لنموذج المخطط النجمي: 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 متاح في الواجهة البرمجية.
• اسم الدورة يفضّل عنوان الكتالوج. Course.title هو اسم الوحدة. ولا يُستخدم Assignment.title إلا عند غياب صف الكتالوج (محذوف أو غير منشور).
• بصيغة طويلة وليس بتحويل إلى أعمدة. صف واحد لكل تسجيل، وليس صفًا واحدًا لكل شخص مع عمود لكل وحدة.

​

الخطوات التالية