مشاركة عبر


تعرف على الوثائق المرجعية لمطور خدمة التقارير التنظيمية

توفر هذه المقالة معلومات للمطورين والمطالبين الذين ينفذون خدمة التقارير التنظيمية ل Microsoft Learn. نوصي أيضا بالتحقق من مقالة أفضل ممارسات خدمة مؤسسة Learn وملاحظات الإصدار والأسئلة المتداولة لدعم رحلة التطوير الخاصة بك.

قاموس البيانات

مجموعات بيانات خاصة بالمستأجر

يتم توفير البيانات الخاصة بالمستأجر بواسطة مجموعات بيانات الإنجازاتوالتطبيقاتوالشهاداتوالتقدموالمستخدمين .

هام

في userId البيانات الخاصة بالمستأجر هو معرف مستخدم ملف تعريف Learn، والذي يختلف عن Microsoft Entra ObjectId.

للحصول على سجلات التقدم مع displayName للمستخدمين في المستأجر الخاص بك:

  • ضم بيانات objectId Microsoft Entra الخاصة بك مع مجموعة بيانات المستخدمين الخاصة بالمستأجر AADObjectId
  • انضم إلى مجموعة بيانات المستخدمينuserIdبالمستأجرين إلى التقدمuserId
  • حدد بيانات displayName Microsoft Entra وبيانات التقدم القابلة للتطبيق.

عند تنزيل تفاصيل المستخدم في مركز إدارة Microsoft Entra، سيتضمن displayName التصدير وخصائص أخرى بتنسيق CSV.

الإنجازات

تحتوي مجموعة بيانات الإنجازات على معلومات حول جميع الجوائز التي حصل عليها المستخدمون في هذا المستأجر، عادةً نتيجة لإكمال الوحدات ومسارات التعلم. عند الانتهاء من الوحدة، سيحصل المستخدمون على شارة وعند إكمال مسار التعلم، سيحصلون على كأس.

يتم عرض «إنجازات» المستخدم على الموقع المباشر من خلال عرض ملف تعريف المستخدم. (مثال)

معرف المستأجر معرف المستخدم awardReason نوع الجائزة معرف الجائزة نوع المصدر مصدر المعرّف الفريد تم المنح في
{guid} {guid} اكتملت الوحدة الأساسية للشارة الشارة تعلم مقدمة لشارة الحوسبة الوحدة النمطية تعلم مقدمة للحوسبة {datetimeoffset}
{guid} {guid} اكتمل. مسار. trophy. الأساسي الجائزة تعلم.أسس-السحابة المسار التعليمي learn.cloud-foundations {datetimeoffset}

AppliedSkills

تحتوي مجموعة بيانات AppliedSkills على معلومات حول جميع المهارات التطبيقية التي اكتسبها المستخدمون في هذا المستأجر، عادة نتيجة لإكمال جلسات العمل المعملية. عند الانتهاء من جلسة العمل المعملية بنجاح، قد يكتسب المستخدمون مهارة.

معرف المستأجر معرف المستخدم appliedSkillsUid labProfileName examScoredDate
{guid} {guid} applied-skill.build-azure-ai-vision-solution APL-3004: إنشاء حل Azure الذكاء الاصطناعي Vision {datetime}
{guid} {guid} applied-skill.build-collaborative-apps-microsoft-teams APL-4001: إنشاء تطبيقات تعاونية ل Microsoft Teams {datetime}

الشهادات

تحتوي مجموعة بيانات الشهادات على معلومات حول جميع الشهادات التي حصل عليها المستخدمون في هذا المستأجر والتي لا تزال نشطة أو انتهت صلاحيتها خلال العامين الماضيين، نتيجة لإكمال اختبار واحد أو أكثر (كما هو مطلوب للشهادة).

معرف المستأجر معرف المستخدم نوع الجائزة اسم النسخ مصدر المعرّف الفريد تم المنح في CertificationStartDate CertificationEndDate StayCurrentEligibilityStartDate
{guid} {guid} الشهادة Microsoft Certified: Azure الذكاء الاصطناعي Engineer Associate certification.azure-ai-engineer {int} {int} {int} {int}
{guid} {guid} الشهادة معتمد من Microsoft: أساسيات Power Platform certification.power-platform-fundamentals {int} {int} {int} {int}

يتم تنسيق قيم التاريخ {int} ك YYYYMMDD.

التقدم

تحتوي مجموعة بيانات Progress على معلومات حول عدد نقاط الامتياز التي حصل عليها المستخدمون في هذا المستأجر مقابل إكمال أجزاء من المحتوى (مثل الوحدات الفردية والموضوعات الكاملة ومسارات التعلم). ليس كل المحتوى متساويا، لذلك قد يكسب المستخدمون المزيد من النقاط إذا احتوى على التفاعل، أو إذا أكملوا فحص المعرفة بنسبة 100٪ في المرة الأولى.

معرف المستأجر معرف المستخدم XPReason نوع المصدر مصدر المعرّف الفريد البرمجة السريعة تم المنح في
{guid} {guid} اكتمال.وحدة.النقاط.الأساسية الوحدة تعلم.مقدمة-في-الحوسبة.1-مقدمة 100 {datetimeoffset}
{guid} {guid} اكتمال.أساس.نقاط.الوحدة الوحدة النمطية تعلم.إنشاء-حساب-على-azure 200 {datetimeoffset}
{guid} {guid} اكتمال.نقاط.المسار.الأساسي المسار التعليمي learn.cloud-foundations 2100 {datetimeoffset}

المستخدمون

تحتوي مجموعة بيانات المستخدمون على معلومات لكل المستخدمين المُشار إليها في مجموعات البيانات الأخرى الخاصة بالمستأجر. لاحظ أن مجموعة البيانات هذه لا تحتوي على أي معلومات PII. userId هو معرف مستخدم ملف تعريف Learn، والذي يختلف عن Microsoft Entra ObjectId (AADObjectId). عند إعداد التقارير، ستحتاج إلى ضم هذه البيانات إلى قائمة مستخدمي Microsoft Entra للاطلاع على قائمة أكثر شمولية بمعلومات المستخدم مقابل البيانات الأخرى.

معرف المستأجر معرف المستخدم AADObjectId تاريخ الإنشاء
{guid} {guid} {guid} {datetime}

مجموعات بيانات Microsoft Learn

يتم توفير بيانات Microsoft Learn (غير الخاصة بمستأجر فردي) بواسطة مجموعات بيانات HierarchyAppliedSkills و HierarchyCertification و HierarchyLearningPath و HierarchyLearningPathModule و HierarchyModule و HierarchyUnit.

HierarchyAppliedSkills

تحتوي مجموعة بيانات HierarchyAppliedSkills على معلومات الكتالوج حول جميع المهارات التطبيقية في Microsoft Learn.

لمعرفة المزيد حول المهارات التطبيقية وكيفية ارتباطها وأنواع المحتويات الأخرى، اعرض قسم المهارات التطبيقية في مقالة أنواع محتويات Learn.

appliedSkillsUid العنوان عنوان URL المستويات المنتجات أدوار المواضيع المهام
applied-skill.build-azure-ai-vision-solution إنشاء حل رؤية Azure الذكاء الاصطناعي /credentials/applied-skills/build-azure-ai-vision-solution/ ["وسيط"] ["azure-computer-vision"] ["المطور"،"مهندس الذكاء الاصطناعي"،"صانع"] ["الذكاء الاصطناعي"] ["Create a computer vision resource","Analyze images","Create a custom image analysis model","Train and evaluate the model","Consume a custom model"]
applied-skill.build-collaborative-apps-microsoft-teams إنشاء تطبيقات تعاونية ل Microsoft Teams /credentials/applied-skills/build-collaborative-apps-microsoft-teams/ ["وسيط"] ["office-teams","ms-graph","entra-id","ms-copilot"] ["المطور"] ["backend-development","frontend-development","custom-app-development"] ["إنشاء روبوت"، "إنشاء ملحق مراسلة"، "إنشاء خطافات الويب"، "إنشاء علامة تبويب Teams"، "دمج Microsoft Graph في تطبيق Teams"، "توزيع تطبيق Teams"]

التسلسل الهرمي

تحتوي مجموعة بيانات HierarchyCertification على معلومات كتالوج حول كل الشهادات في Microsoft Learn.

لمعرفة المزيد حول الشهادات وكيفية ارتباطها وأنواع المحتويات الأخرى، اعرض قسم الشهادة في مقالة أنواع محتويات Learn.

معرف الشهادة النوع العنوان الملخص. عنوان URL عنوان iconUrl المستويات المنتجات أدوار الاختبارات
certification.azure-administrator 1 مُعتمدة من مسؤول Microsoft: Azure Developer Associate يتولى مسؤولو Azure تنفيذ بيئة Microsoft Azure للمؤسسة وإدارتها ومراقبتها. /certifications/azure-administrator/ /media/learn/certification/badges/microsoft-certified-associate-badge.svg ["وسيط"] ["azure","azure-virtual-machines","azure-storage","azure-active-directory","azure-virtual-network","azure-resource-manager"] ["مسؤول"] ["exam.az-104"]

التسلسل الهرمي التعليم

تحتوي مجموعة البيانات HierarchyLearningPath على معلومات الكتالوج حول كل مسارات التعلم في Microsoft Learn.

لمعرفة المزيد حول مسارات التعلم وكيفية ارتباطها وأنواع المحتويات الأخرى، اعرض قسم مسارات التعلم في مقالة أنواع محتويات Learn.

المعرّف الفريد لمسار التعلم العنوان عنوان URL المدة بالدقائق نقاط عنوان iconUrl المستويات المنتجات أدوار لغات
learn.create-serverless-applications إنشاء تطبيقات بلا خادم /training/paths/create-serverless-applications/ 517 1925 /تدريب/إنجازات/create-serverless-applications.svg ["مبتدئ"، "متوسط"] ["azure","azure-functions","azure-portal","azure-cosmos-db","azure-storage","azure-cloud-shell"] ["مطور"، "طالب"] ["powershell"]

وحدة تعلم المسار الهرمي

تشمل مجموعة بيانات HierarchyLearningPathModule تعيين الموضوعات إلى مسارات التعلم. (ملاحظة: يمكن أن يكون الموضوع الواحد جزءاً من مسارات تعلم متعددة.)

لمعرفة المزيد حول الوحدات النمطية ومسارات التعلم وكيفية ارتباطها وأنواع المحتويات الأخرى، اعرض قسم الوحدة النمطية ومسارالتعلم في مقالة أنواع محتويات Learn.

المعرّف الفريد لمسار التعلم وحدة المعرّف الفريد
حارس.أمن-عمليات-Learn azure.query-data-sentinel
منصة.البيانات- الهندسية- لـlearn learn.access-data-with-cosmos-db-and-sql-api

وحدة التسلسل الهرمي

تحتوي مجموعة البيانات HierarchyModule على معلومات الكتالوج حول كل الموضوعات (الدورات التدريبية).

لمعرفة المزيد حول الوحدات النمطية وكيفية ارتباطها وأنواع المحتويات الأخرى، اعرض قسم الوحدة النمطية في مقالة أنواع محتويات Learn.

المعرّف الفريد للوحدة العنوان عنوان URL عنوان iconUrl المدة بالدقائق نقاط المستويات المنتجات أدوار لغات
learn.languages.powershell-write-first كتابة أول تعليمة برمجية خاصة بـ PowerShell /training/modules/powershell-write-first/ /training/achievements/powershell/powershell-write-first-code.svg 17 200 ["مبتدئ"] ["dotnet"] ["مطور"، "طالب"] ["powershell"]

وحدة التسلسل الهرمي

تحتوي مجموعة بيانات HierarchyUnit على معلومات الكتالوج حول كل الوحدات (أجزاء من الموضوعات).

لمعرفة المزيد حول الوحدات وكيفية ارتباطها وأنواع المحتويات الأخرى، اعرض قسم الوحدات في مقالة أنواع محتويات Learn.

وحدة المعرّف الفريد العنوان عنوان URL المدة بالدقائق نقاط المعرّف الفريد للوحدة
تعلم.رصد-بيانات-azure. 1- مقدمة مقدمة /training/modules/query-data-sentinel/1-introduction/ 5 100 azure.query-data-sentinel
تعلم.تعقب-بيانات-azure.2-إعداد-التدريب تمرين - الاستعلام عن البيانات وعرضها بشكل بياني باستخدام مصنفات Azure Sentinel /training/modules/query-data-sentinel/2-exercise-setup/ 10 100 azure.query-data-sentinel

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

راجع الموارد أدناه لمساعدتك في رحلة التطوير الخاصة بك: