קבל מידע על תיעוד למפתחים של שירות הדיווח הארגוני

מאמר זה מספק מידע עבור מפתחים ומבקשות המיישמים את השירות של הדיווח הארגוני של Microsoft Learn. מומלץ גם ל עיין במאמר שיטות עבודה מומלצות עבור שירות Learn Organizational, הערות מוצרו- נפוצות כדי לתמוך במסע הפיתוח שלך.

מילון נתונים

ערכות נתונים ספציפיות לדייר

נתונים ספציפיים לדייר מסופקים על-ידי ערכות הנתונים הישגים, AppliedSkills,אישורים, התקדמות ומשתמשים.

חשוב

המזהה userId הנתונים הספציפיים לדייר הוא מזהה המשתמש של פרופיל Learn, השונה מ- Microsoft Entra ObjectId.

כדי לקבל רשומות התקדמות עם displayName עבור משתמשים בדייר שלך:

• הצטרף לנתונים של Microsoft Entra משלך עם objectId ספציפי לדייר ספציפי משתמשים נתונים AADObjectId
• הצטרף לדייר הספציפי משתמשים ערכת userId לטבלת ההתקדמותuserId
• בחר נתונים משלך של Microsoft Entra displayName נתוני התקדמות ישימים.

בעת הורדת פרטי משתמש במרכז הניהול של Microsoft Entra, הייצוא יכלול displayName ומאפיינים אחרים בתבנית CSV.

הישגים

The achievements dataset contains information about all the awards the users in this tenant have earned, typically as result of completing modules and learning paths. לאחר השלמת המודול, המשתמשים יקבלו תג ולאחר השלמת נתיב הלמידה, הם ירוויחו גביע.

הישגי משתמשים מוצגים באתר החי על-ידי הצגת פרופיל של משתמש. (דוגמה)

מזהה דייר	מזהה משתמש	פרס על ההענקה	סוג פרס	ממשק פרס	סוג מקור	ממשק מקור	הוענקה על-ידי
{guid}	{guid}	badge.module.basic.completed	התג	learn.intro-to-compute.badge	מודול	learn.intro-to-compute	{datetimeoffset}
{guid}	{guid}	trophy.path.basic.completed	גביע	learn.cloud-foundations.trophy	LearningPath	learn.cloud-foundations	{datetimeoffset}

קילות שהוחלו

ערכת הנתונים AppliedSkills מכילה מידע אודות כל הכישורים שהוחלו שהרווחו המשתמשים בדייר זה, בדרך כלל כתוצאה מהשלמת הפעלות המעבדה. לאחר השלמת הפעלת המעבדה המוצלחת, המשתמשים עשויים לזכות במיומנות.

מזהה דייר	מזהה משתמש	appliedSkillsUid	labProfileName	examScoredDate
{guid}	{guid}	applied-skill.build-azure-ai-vision-solution	APL-3004: בניית פתרון Azure AI Vision	{datetime}
{guid}	{guid}	applied-skill.build-collaborative-apps-microsoft-teams	APL-4001: בניית אפליקציות שיתופיות עבור Microsoft Teams	{datetime}

אישורים ותעודות

ערכת הנתונים מכילה מידע אודות כל האישורים שהמשתמשים בדייר זה הרוויחו, שעדיין פעילים או שתוקףם פג בשנתיים האחרונות, כתוצאה מהשלמת מבחן אחד או יותר (כנדרש לאישור).

tenantID	מזהה משתמש	סוג פרס	שם תעתיק	ממשק מקור	הוענקה על-ידי	תאריך התחלה של אישור	CertificationEndDate	הישאר ב-CurrentEligibilityStartDate
{guid}	{guid}	הסמכה	Microsoft Certified: Azure AI Engineer Associate	certification.azure-ai-engineer	{int}	{int}	{int}	{int}
{guid}	{guid}	הסמכה	Microsoft Certified: Power Platform Fundamentals	certification.power-platform-fundamentals	{int}	{int}	{int}	{int}

תאריך {int} הערכים מעוצבים כערכים YYYYMMDD.

התקדמות

ערכת ההתקדמות מכילה מידע אודות מספר נקודות XP שהרווחו המשתמשים בדייר זה מהשלמת חלקי תוכן (כגון יחידות בודדות, מודולים מלאים נתיבים ללמידה). לא כל התוכן שווה, ולכן המשתמשים עשויים להרוויח נקודות נוספות אם הוא הכיל אינטראקטיביות, או אם הם השלמו בדיקת ידע של 100 נקודות% הראשונה.

מזהה דייר	מזהה משתמש	XPReason	סוג מקור	ממשק מקור	XP	הוענקה על-ידי
{guid}	{guid}	points.unit.basic.completed	יחידה	learn.intro-to-compute.1-introduction	100	{datetimeoffset}
{guid}	{guid}	points.module.basic.completed	מודול	learn.create-azure-account	200	{datetimeoffset}
{guid}	{guid}	points.path.basic.completed	LearningPath	learn.cloud-foundations	2100	{datetimeoffset}

משתמשים

ערכת משתמשים מכילה מידע של כל המשתמשים שאליהם מתבצעת הפניה בערכות הנתונים הספציפיות לדייר האחרות. שים לב שערכות נתונים אלה אינן מכילות מידע PII. מזהה userId הוא מזהה המשתמש של פרופיל Learn, השונה מ- Microsoft Entra ObjectId (AADObjectId). כאשר אתה מדווח, תצטרך לצרף נתונים אלה לרשימת משתמשי Microsoft Entra שלך כדי לראות רשימה הוליסטית יותר של פרטי משתמשים מול הנתונים האחרים.

מזהה דייר	מזהה משתמש	AADObjectId	CreatedOn
{guid}	{guid}	{guid}	{datetime}

ערכות נתונים של Microsoft Learn

נתוני Microsoft Learn (לא ספציפיים לדייר בודד) מסופקים על-ידי HierarchyAppliedSkills, HierarchyCertification, HierarchyLearningPath, HierarchyLearningPathModule, HierarchyModuleו- HierarchyUnit.

HierarchyAppliedSkills

הירארכיית AppliedSkills מכילה פרטי קטלוג אודות כל המיומנויות שהוחלו ב- Microsoft Learn.

כדי ללמוד עוד אודות מיומנויות שהוחלו וכיצד הם קשורים לסוגי תוכן אחרים, עיין בסעיף מיומנויות שהוחלו על במאמר Learn content types.

appliedSkillsUid	כותר	כתובת URL	רמות	מוצרים	תפקידי	נושאים	פעילויות
applied-skill.build-azure-ai-vision-solution	בניית פתרון Azure AI Vision	/credentials/applied-skills/build-azure-ai-vision-solution/	["ביניים"]	["azure-computer-vision"]	["developer","ai-engineer","maker"]	["בינה מלאכותית"]	["יצירת משאב ראייה של מחשב","ניתוח תמונות","יצירת מודל ניתוח תמונה מותאם אישית","תרגול והערכה של המודל","צריכת מודל מותאם אישית"]
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"]	["Build a bot","Create a messaging extension","Build webhooks","Create a Teams tab","Integrate Microsoft Graph into a Teams app","Distribute a Teams app"]

HierarchyCertification

ערכת של HierarchyCertification מכילה פרטי קטלוג אודות כל האישורים ב- Microsoft Learn.

לקבלת מידע נוסף אודות אישורים וכיצד הם קשורים לסוגי תוכן אחרים, עיין בסעיף Certification במאמר Learn content types.

certificationUid	סוג נתונים	כותר	תקציר	כתובת URL	סמלUrl	רמות	מוצרים	תפקידי	בחינות
certification.azure-administrator	0	Microsoft Certified: Azure Administrator 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

ערכת של HierarchyLearningPath מכילה מידע קטלוג אודות כל נתיבי הלמידה ב- Microsoft Learn.

לקבלת מידע נוסף על נתיבי למידה ועל האופן שבו הם קשורים לסוגי תוכן אחרים, עיין בסעיף נתיבי Learning במאמר Learn content types.

LearningPathUid	כותר	כתובת URL	משך זמןInMinutes	נקודות	סמלUrl	רמות	מוצרים	תפקידי	שפות
learn.create-serverless-applications	יצירת יישומים ללא שרת	/training/paths/create-serverless-applications/	517	1925	/training/achievements/create-serverless-applications.svg	["מתחיל","ביניים"]	["azure","azure-functions","azure-portal","azure-cosmos-db","azure-storage","azure-cloud-shell"]	["developer","student"]	["powershell"]

HierarchyLearningPathModule

ערכת של HierarchyLearningPathModule מכילה את המיפוי של מודולים לנתיבים למידה. (הערה: מודול יכול להיות חלק מנתיב למידה מרובים.)

כדי ללמוד עוד אודות מודולים נתי נתיבי למידה וכיצד הם קשורים לסוגי תוכן אחרים, עיין במאמר Module ו- Learning path במאמר Learn content types.

LearningPathUid	ממשק מודול
learn.security-ops-sentinel	azure.query-data-sentinel
learn.architect-data-platform	learn.access-data-with-cosmos-db-and-sql-api

מצב הירארכיה

ערכת HierarchyModule מכילה פרטי קטלוג אודות כל המודולים (קורסים).

כדי ללמוד עוד אודות מודולים וכיצד הם קשורים לסוגי תוכן אחרים, עיין בסעיף Module במאמר Learn content types.

ממשק מודול	כותר	כתובת URL	סמלUrl	משך זמןInMinutes	נקודות	רמות	מוצרים	תפקידי	שפות
learn.languages.powershell-write-first	כתוב את קוד PowerShell הראשון שלך	/training/modules/powershell-write-first/	/training/achievements/powershell/powershell-write-first-code.svg	17	200	["מתחיל"]	["dotnet"]	["developer","student"]	["powershell"]

יחידת הירארכיה

ערכת מסוג HierarchyUnit מכילה מידע קטלוג אודות כל היחידות (יחידות של מודולים).

כדי ללמוד עוד אודות יחידות וכיצד הן קשורות לסוגי תוכן אחרים, עיין בסעיף יחידות במאמר למד סוגי תוכן.

ממשק יחידה	כותר	כתובת URL	משך זמןInMinutes	נקודות	ממשק מודול
learn.azure.query-data-sentinel.1-introduction	מבוא	/training/modules/query-data-sentinel/1-introduction/	5	100	azure.query-data-sentinel
learn.azure.query-data-sentinel.2-exercise-setup	תרגיל - ביצוע שאילתה והמחשה של נתונים באמצעות חוברות עבודה של Azure Sentinel	/training/modules/query-data-sentinel/2-exercise-setup/	10	100	azure.query-data-sentinel

השלבים הבאים

עיין במשאבים הבאים שיעזרו לך במסע הפיתוח:

• שיטות העבודה המומלצות של שירות הדיווח הארגוני
• שאלות נפוצות אודות שירות הדיווח הארגוני
• מידע על הערות מוצר של שירות הדיווח הארגוני