प्रति-व्यक्ति अनुपालन

यह रिपोर्ट किसी पिछले प्रदाता के प्रति-व्यक्ति अनुपालन एक्सपोर्ट का Training वाला भाग है: डायरेक्टरी पहचान, तथा प्रत्येक व्यक्ति के प्रत्येक Training enrollment के लिए एक पंक्ति (मॉड्यूल की स्थिति और तिथियाँ)। इसका ग्रेन लॉन्ग-फ़ॉर्म है — व्यक्ति × assignment — क्योंकि GET /v1/assignments/{id}/enrollments पहले से यही लौटाता है। क्वेरी मॉड्यूल को कॉलम में पिवट नहीं करती। सेटअप, क्रेडेंशियल, पेजिनेशन और रेट-लिमिट रीट्राई की प्रक्रिया Power BI / Excel कनेक्टिविटी गाइड के समान है। पहले साझा Fn_FetchAll क्वेरी जोड़ें; यह रिपोर्ट उसे नाम से कॉल करती है।

​

आवश्यक key scopes

​

स्रोत endpoints

यह क्वेरी GET /v1/entities को कॉल नहीं करती। enrollment पंक्ति में पहले से ही email और display_name मौजूद हैं, और entity सूची में विभाग या पदनाम नहीं है — इसलिए उसे वॉक करने से भी ऐसे डायरेक्टरी कॉलम नहीं भरे जा सकते जो enrollment पंक्ति में पहले से उपलब्ध नहीं हैं।

​

ग्रेन

प्रति enrollment (व्यक्ति × assignment) एक पंक्ति। यदि किसी व्यक्ति को एक ही course दो assignments के माध्यम से सौंपा गया है, तो दो पंक्तियाँ बनती हैं। जिस व्यक्ति का कोई enrollment नहीं है, वह दिखाई नहीं देता — /v1 ईमेल के बिना उपयोगी डायरेक्टरी पंक्ति नहीं बना सकता, और केवल-व्यक्ति वाली पंक्तियाँ गढ़ने से ग्रेन मिश्रित हो जाएँगे। अनुरोध बजट: प्रत्येक assignment के लिए एक पेजयुक्त वॉक, क्रमिक रूप से, साझा प्रति-key रेट लिमिट के अंतर्गत। limit = "500" हमेशा सेट करें।

​

कॉलम मैपिंग

Legacy कॉलम के नाम आपके पिछले प्रदाता के एक्सपोर्ट से हैं। /v1 फ़ील्ड सार्वजनिक API नाम हैं; क्वेरी रिपोर्ट के लिए उनमें से कुछ के alias बनाती है। स्टार-स्कीमा मॉडल के लिए रखी गई जॉइन कुंजियाँ: entity_id, assignment_id, course_id, user_assignment_id। क्वेरी course_slug, assignment_title, passed, attempts, assignment_lifecycle_status और assignment_created_at भी रखती है। enrollment_status Learner की प्रगति है, assignment का जीवनचक्र नहीं (active / paused / completed)।

​

पुराने एक्सपोर्ट से भिन्नताएँ

• पॉलिसी स्वीकृतियाँ उपलब्ध नहीं हैं। इस प्लेटफ़ॉर्म में कोई पॉलिसी डोमेन नहीं है — कोई /policies, /policy_acceptances या समकक्ष /v1 संसाधन नहीं है। उन कॉलमों को लंबित मैपिंग न समझें। वे दायरे से बाहर हैं।
• अतिरिक्त डायरेक्टरी फ़ील्ड हटाए गए हैं, null नहीं किए गए। विभाग, पदनाम, मैनेजर और स्थान /v1 पर उपलब्ध नहीं हैं। क्वेरी उनके लिए खाली कॉलम नहीं बनाती।
• Due date शामिल है, भले ही legacy एक्सपोर्ट में वह न रहा हो, क्योंकि Enrollment.due_at API पर उपलब्ध है।
• Course नाम के लिए कैटलॉग शीर्षक को प्राथमिकता दी जाती है। Course.title ही मॉड्यूल का नाम है। Assignment.title का उपयोग केवल तभी होता है जब कैटलॉग पंक्ति उपलब्ध न हो (हटाई गई या अप्रकाशित)।
• लॉन्ग-फ़ॉर्म, पिवट नहीं किया गया। प्रति enrollment एक पंक्ति, न कि प्रति व्यक्ति एक पंक्ति जिसमें प्रत्येक मॉड्यूल के लिए एक कॉलम हो।

​

अगले चरण