Learn 조직 보고 서비스 개발자 참조 설명서
이 문서에서는 Microsoft Learn 조직 보고 서비스를 구현하는 개발자와 요청자에게 정보를 제공합니다. 또한 개발 과정을 지원하기 위해 Learn 조직 서비스 모범 사례 문서, 릴리스 정보와 자주 묻는 질문을 확인하는 것이 좋습니다.
데이터 사전
테넌트 관련 데이터 세트
테넌트 관련 데이터는 성과 내역, 인증, 진행률, 사용자 데이터 세트에서 제공됩니다.
Important
테넌트별 데이터의 userId는 Learn 프로필 사용자 ID이며 Microsoft Entra ObjectId와 다릅니다.
테넌트에서 사용자에 대한 displayName을 사용하여 진행률 레코드를 얻으려면 다음을 수행합니다.
- 자체 Microsoft Entra 데이터
objectId를 테넌트별 사용자 데이터 세트AADObjectId와 조인합니다. - 테넌트별 사용자 데이터 세트
userId를 진행률userId에 조인합니다. - 고유의 Microsoft Entra 데이터
displayName및 해당 진행 데이터를 선택합니다.
Microsoft Entra 관리 센터에서 사용자 세부 정보를 다운로드하면 내보내기에 displayName 및 기타 속성이 CSV 형식으로 포함됩니다.
도전 과제
성과 내역 데이터 세트에는 이 테넌트의 사용자가 획득한 모든 보상(일반적으로 모듈 및 학습 경로 완료로 받음)에 대한 정보가 포함됩니다. 사용자는 모듈 완료 시 배지를 획득하고 학습 경로 완료 시 트로피를 획득하게 됩니다.
사용자의 프로필을 확인하여 라이브 사이트에서 사용자 성과 내역을 볼 수 있습니다. (예)
| tenantId | userId | awardReason | awardType | awardUid | SourceType | SourceUid | AwardedOn |
|---|---|---|---|---|---|---|---|
| {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} |
적용된 기술
Applied Skills 데이터 세트에는 일반적으로 랩 세션 완료의 결과로 이 테넌트의 사용자가 획득한 모든 Applied Skills에 대한 정보가 포함되어 있습니다. 랩 세션이 성공적으로 완료되면 사용자는 기술을 습득할 수 있습니다.
| tenantId | userId | 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} |
인증
인증 데이터 세트에는 하나 이상의 시험(인증에 필요한 경우)을 완료한 결과로 이 테넌트에서 사용자가 획득했거나 지난 2년 동안 만료된 모든 인증에 대한 정보가 포함되어 있습니다.
| tenantID | userId | AwardType | TranscriptName | SourceUid | AwardedOn | CertificationStartDate | CertificationEndDate | StayCurrentEligibilityStartDate |
|---|---|---|---|---|---|---|---|---|
| {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로 지정됩니다.
진행률
진행률 데이터 세트에는 이 테넌트의 사용자가 콘텐츠(예: 개별 단위, 전체 모듈, 학습 경로)를 완료하여 획득한 경험치에 대한 정보가 포함됩니다. 콘텐츠는 각기 다르므로 사용자는 대화형 작업이 포함됐거나 최초로 퀴즈를 100% 완료한 경우 경험치를 더 많이 획득할 수 있습니다.
| tenantId | userId | XPReason | SourceType | SourceUid | XP | AwardedOn |
|---|---|---|---|---|---|---|
| {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 프로필 사용자 ID이며, Microsoft Entra ObjectId(AADObjectId)와 다릅니다. 보고할 때 다른 데이터와 비교하여 보다 전체적인 사용자 정보 목록을 보려면 이 데이터를 Microsoft Entra 사용자 목록에 조인해야 합니다.
| tenantId | userId | AADObjectId | CreatedOn |
|---|---|---|---|
| {guid} | {guid} | {guid} | {datetime} |
Microsoft Learn 데이터 세트
Microsoft Learn 데이터(개별 테넌트에 국한되지 않음)는 HierarchyAppliedSkills, HierarchyCertification, HierarchyLearningPath, HierarchyLearningPathModule, HierarchyModule 및 HierarchyUnit 데이터 세트에서 제공됩니다.
HierarchyAppliedSkills
HierarchyAppliedSkills 데이터 세트에는 Microsoft Learn의 모든 적용 기술에 대한 카탈로그 정보가 포함되어 있습니다.
적용 기술 및 다른 콘텐츠 형식과의 관계에 대해 자세히 알아보려면 콘텐츠 형식 알아보기 문서의 적용 기술 섹션을 참조하세요.
| appliedSkillsUid | title | url | 수준 | products | 역할 | 제목 | 작업 |
|---|---|---|---|---|---|---|---|
| applied-skill.build-azure-ai-vision-solution | Azure AI Vision 솔루션 빌드 | /credentials/applied-skills/build-azure-ai-vision-solution/ | ["intermediate"] | ["azure-computer-vision"] | ["developer","ai-engineer","maker"] | ["artificial-intelligence"] | ["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/ | ["intermediate"] | ["office-teams","ms-graph","entra-id","ms-copilot"] | ["developer"] | ["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의 모든 인증에 대한 카탈로그 정보가 포함됩니다.
인증에 대한 자세한 내용과 다른 콘텐츠 형식과 관련된 방법을 자세히 알아보려면 Learn 콘텐츠 형식 문서에서 인증 섹션을 참조하세요.
| certificationUid | 형식 | title | 요약 | url | iconUrl | 수준 | products | 역할 | 시험 |
|---|---|---|---|---|---|---|---|---|---|
| certification.azure-administrator | 0 | Microsoft Certified: Azure Administrator Associate | Azure 관리자는 조직의 Microsoft Azure 환경을 구현, 관리, 모니터링합니다. | /certifications/azure-administrator/ | /media/learn/certification/badges/microsoft-certified-associate-badge.svg | ["intermediate"] | ["azure","azure-virtual-machines","azure-storage","azure-active-directory","azure-virtual-network","azure-resource-manager"] | ["administrator"] | ["exam.az-104"] |
HierarchyLearningPath
HierarchyLearningPath 데이터 세트에는 Microsoft Learn의 모든 학습 경로에 대한 카탈로그 정보가 포함됩니다.
학습 경로에 대한 자세한 내용과 다른 콘텐츠 형식과 관련된 방법을 자세히 알아보려면 Learn 콘텐츠 형식 문서에서 학습 경로 섹션을 참조하세요.
| LearningPathUid | title | url | durationInMinutes | 지점 | iconUrl | 수준 | products | 역할 | 언어 |
|---|---|---|---|---|---|---|---|---|---|
| learn.create-serverless-applications | 서버리스 애플리케이션 만들기 | /training/paths/create-serverless-applications/ | 517 | 1925 | /training/achievements/create-serverless-applications.svg | ["beginner","intermediate"] | ["azure","azure-functions","azure-portal","azure-cosmos-db","azure-storage","azure-cloud-shell"] | ["developer","student"] | ["powershell"] |
HierarchyLearningPathModule
HierarchyLearningPathModule 데이터 세트에는 모듈과 학습 경로의 매핑이 포함됩니다. (참고: 모듈은 여러 학습 경로에 속할 수 있습니다.)
모듈 및 학습 경로에 대한 자세한 내용과 다른 콘텐츠 형식과 관련된 방법에 대해 자세히 알아보려면 Learn 콘텐츠 형식 문서에서 모듈 섹션과 학습 경로 섹션을 참조하세요.
| LearningPathUid | ModuleUid |
|---|---|
| learn.security-ops-sentinel | azure.query-data-sentinel |
| learn.architect-data-platform | learn.access-data-with-cosmos-db-and-sql-api |
HierarchyModule
HierarchyModule 데이터 세트에는 모든 모듈(과정)에 대한 카탈로그 정보가 포함됩니다.
모듈에 대한 자세한 내용과 모듈이 다른 콘텐츠 형식과 어떻게 관련되어 있는지 자세히 알아보려면 Learn 콘텐츠 형식 문서의 모듈 섹션을 참조하세요.
| moduleUid | title | url | iconUrl | durationInMinutes | 지점 | 수준 | products | 역할 | 언어 |
|---|---|---|---|---|---|---|---|---|---|
| learn.languages.powershell-write-first | 첫 번째 PowerShell 코드 작성하기 | /training/modules/powershell-write-first/ | /training/achievements/powershell/powershell-write-first-code.svg | 17 | 200 | ["beginner"] | ["dotnet"] | ["developer","student"] | ["powershell"] |
HierarchyUnit
HierarchyUnit 데이터 세트에는 모든 단위(모듈의 일부)에 대한 카탈로그 정보가 포함됩니다.
단위에 대한 자세한 내용과 단위가 다른 콘텐츠 형식과 어떻게 관련되어 있는지 자세히 알아보려면 Learn 콘텐츠 형식 문서의 단위 섹션을 참조하세요.
| unitUid | title | url | durationInMinutes | 지점 | moduleUid |
|---|---|---|---|---|---|
| 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 |
다음 단계
개발 경험에 도움이 되도록 아래 리소스를 검토합니다.