Tìm hiểu tài liệu tham khảo dành cho nhà phát triển dịch vụ Báo cáo Tổ chức

Bài viết này cung cấp thông tin cho các nhà phát triển và người yêu cầu triển khai dịch vụ Báo cáo tổ chức của Microsoft Learn. Chúng tôi cũng khuyên bạn nên xem bài viết Các biện pháp tốt nhất về dịch vụ tổ chức của Learn, Ghi chú phát hành và Câu hỏi thường gặp để hỗ trợ hành trình phát triển của bạn.

Từ điển dữ liệu

Tập dữ liệu dành riêng cho đối tượng thuê

Dữ liệu dành riêng cho đối tượng thuê được cung cấp bởi tập dữ liệu Thành tích, AppliedSkills, Chứng chỉ, Tiếnđộ và Người dùng.

Quan trọng

Trong userId dữ liệu dành riêng cho đối tượng thuê là mã định danh người dùng hồ sơ Learn khác với Id Đối tượng Microsoft Entra.

Để tải bản ghi Tiến độ với displayName cho người dùng trong đối tượng thuê của bạn:

  • Tham gia dữ liệu Microsoft Entra của riêng bạn với objectId tập dữ liệu Người dùng dành riêng cho đối tượng thuê AADObjectId
  • Nối tập dữ liệu Người dùng dành riêng cho đối tượng thuê với userId Tiến độuserId
  • Chọn dữ liệu Microsoft Entra của riêng bạn và displayName dữ liệu tiến độ hiện hành.

Khi bạn Tải xuống chi tiết người dùng trong trung tâm quản trị Microsoft Entra, quá trình xuất sẽ bao gồm displayName và các thuộc tính khác ở định dạng CSV.

Thành tích

Tập dữ liệu Thành tích chứa thông tin về tất cả các giải thưởng mà người dùng trong đối tượng thuê này đã kiếm được, thường là kết quả của việc hoàn thành các mô-đun và đường dẫn học tập. Sau khi hoàn thành mô-đun, người dùng sẽ nhận được huy hiệu và sau khi hoàn thành lộ trình học tập, họ sẽ giành được cúp.

Thành tích người dùng được hiển thị trên trang web trực tiếp bằng cách xem hồ sơ của người dùng. (Ví dụ)

tenantId userId awardReason awardType awardUid Loại Nguồn SourceUid AwardedOn
{guid} {guid} badge.module.basic.completed Huy hiệu learn.intro-to-compute.badge Mô-đun learn.intro-to-compute {datetimeoffset}
{guid} {guid} trophy.path.basic.completed Cúp learn.cloud-foundations.trophy LearningPath learn.cloud-foundations {datetimeoffset}

AppliedSkills

Tập dữ liệu AppliedSkills chứa thông tin về tất cả các Kỹ năng Áp dụng mà người dùng trong đối tượng thuê này đã kiếm được, thường là kết quả của việc hoàn thành các phiên trong phòng thí nghiệm. Sau khi hoàn thành phiên phòng thí nghiệm thành công, người dùng có thể kiếm được kỹ năng.

tenantId userId appliedSkillsUid labProfileName examScoredDate
{guid} {guid} applied-skill.build-azure-ai-vision-solution APL-3004: Xây dựng giải pháp Azure AI Vision {datetime}
{guid} {guid} applied-skill.build-collaborative-apps-microsoft-teams APL-4001: Xây dựng các ứng dụng cộng tác cho Microsoft Teams {datetime}

Chứng chỉ

Tập dữ liệu Chứng chỉ chứa thông tin về tất cả các chứng chỉ mà người dùng trong đối tượng thuê này đã đạt được mà vẫn đang hoạt động hoặc đã hết hạn trong hai năm qua, do hoàn thành một hoặc nhiều kỳ thi (theo yêu cầu đối với chứng chỉ).

id_đối_tượng_thuê userId Loại Giải thưởng Tên Bản ghi SourceUid AwardedOn CertificationStartDate Ngày_Chứng chỉ StayCurrentEligibilityStartDate
{guid} {guid} Chứng nhận Được Microsoft chứng nhận: Azure AI Engineer Associate certification.azure-ai-engineer {int} {int} {int} {int}
{guid} {guid} Chứng nhận Chứng nhận của Microsoft: Nguyên tắc cơ bản về Nền tảng Nguồn certification.power-platform-fundamentals {int} {int} {int} {int}

Giá trị ngày {int} được định dạng là YYYYMMDD.

Tiến độ

Tập dữ liệu Tiến độ chứa thông tin về số điểm XP mà người dùng trong đối tượng thuê này đã kiếm được từ việc hoàn thành các phần nội dung (chẳng hạn như đơn vị riêng lẻ, mô-đun đầy đủ và đường dẫn học tập). Không phải tất cả nội dung đều bằng nhau, vì vậy người dùng có thể kiếm được nhiều điểm hơn nếu nội dung có tính tương tác hoặc nếu họ hoàn thành bài kiểm tra kiến thức 100% lần đầu tiên.

tenantId userId XPReason Loại Nguồn SourceUid XP AwardedOn
{guid} {guid} points.unit.basic.completed Đơn vị learn.intro-to-compute.1-introduction 100 {datetimeoffset}
{guid} {guid} points.module.basic.completed Mô-đun learn.create-azure-account 200 {datetimeoffset}
{guid} {guid} points.path.basic.completed LearningPath learn.cloud-foundations 2100 {datetimeoffset}

Người dùng

Tập dữ liệu Người dùng chứa thông tin của tất cả người dùng được tham chiếu trong các tập dữ liệu dành riêng cho đối tượng thuê khác. Lưu ý rằng tập dữ liệu này không chứa bất kỳ thông tin PII nào. userId mã định danh người dùng hồ sơ Learn khác với Id Đối tượng Microsoft Entra (AADObjectId). Khi báo cáo, bạn sẽ cần kết hợp dữ liệu này vào danh sách người dùng Microsoft Entra của mình để xem danh sách thông tin người dùng tổng thể hơn so với dữ liệu khác.

tenantId userId AADObjectId CreatedOn
{guid} {guid} {guid} {datetime}

Tập dữ liệu Microsoft Learn

Dữ liệu Microsoft Learn (không dành riêng cho một đối tượng thuê riêng lẻ) được cung cấp bởi HierarchyAppliedSkills, HierarchyCertification, HierarchyLearningPath, HierarchyLearningPathModule, HierarchyModule và Tập dữ liệu HierarchyUnit .

Cấu trúc phân cấpAppliedSkills

Tập dữ liệu HierarchyAppliedSkills chứa thông tin danh mục về tất cả các Kỹ năng Đã áp dụng trong Microsoft Learn.

Để tìm hiểu thêm về Kỹ năng Áp dụng và cách chúng liên quan đến các loại nội dung khác, hãy xem phần Kỹ năng Áp dụng trong bài viết Kiểu nội dung của Learn.

appliedSkillsUid tiêu đề url Cấp Sản phẩm vai trò Đối tượng Nhiệm vụ
applied-skill.build-azure-ai-vision-solution Xây dựng giải pháp Azure AI Vision /credentials/applied-skills/build-azure-ai-vision-solution/ ["trung gian"] ["azure-computer-vision"] ["developer","ai-engineer","maker"] ["trí tuệ nhân tạo"] ["Tạo tài nguyên tầm nhìn máy tính","Phân tích hình ảnh","Tạo mô hình phân tích hình ảnh tùy chỉnh","Đào tạo và đánh giá mô hình","Sử dụng mô hình tùy chỉnh"]
applied-skill.build-collaborative-apps-microsoft-teams Xây dựng các ứng dụng cộng tác cho Microsoft Teams /credentials/applied-skills/build-collaborative-apps-microsoft-teams/ ["trung gian"] ["office-teams","ms-graph","entra-id","ms-copilot"] ["nhà phát triển"] ["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"]

Cấu trúc phân cấpCấu trúc phân cấp

Tập dữ liệu HierarchyCertification chứa thông tin danh mục về tất cả các Chứng chỉ trong Microsoft Learn.

Để tìm hiểu thêm về các chứng chỉ và cách chúng liên quan đến các loại nội dung khác, hãy xem mục Chứng chỉ trong bài viết Các loại nội dung của Learn.

certificationUid loại tiêu đề tóm tắt url biểu tượngUrl Cấp Sản phẩm vai trò Thi
certification.azure-administrator 0 Được Microsoft chứng nhận: Azure Administrator Associate Người quản trị Azure triển khai, quản lý và giám sát môi trường Microsoft Azure của tổ chức. /certifications/azure-administrator/ /media/learn/certification/badges/microsoft-certified-associate-badge.svg ["trung gian"] ["azure","azure-virtual-machines","azure-storage","azure-active-directory","azure-virtual-network","azure-resource-manager"] ["người quản trị"] ["exam.az-104"]

HierarchyLearningPath

Tập dữ liệu HierarchyLearningPath chứa thông tin ca-ta-lô về tất cả các đường dẫn học tập trên Microsoft Learn.

Để tìm hiểu thêm về các lộ trình học tập và cách chúng liên quan đến các loại nội dung khác, hãy xem phần Đường dẫn học tập trong bài viết Loại nội dung tìm hiểu.

LearningPathUid tiêu đề url durationInMinutes Điểm biểu tượngUrl Cấp Sản phẩm vai trò Ngôn ngữ
learn.create-serverless-applications Tạo ứng dụng không dùng máy chủ /training/paths/create-serverless-applications/ 517 1925 /đào tạo/thành tích/create-serverless-applications.svg ["người mới bắt đầu","trung gian"] ["azure","azure-functions","azure-portal","azure-cosmos-db","azure-storage","azure-cloud-shell"] ["developer","student"] ["powershell"]

Cấu trúc phân cấpTìm hiểuPathModule

Tập dữ liệu HierarchyLearningPathModule chứa ánh xạ các mô-đun đến đường dẫn tìm hiểu. (Lưu ý: Mô-đun có thể là một phần của nhiều lộ trình học tập.)

Để tìm hiểu thêm về các mô-đun và đường dẫn học tập cũng như cách chúng liên quan đến các loại nội dung khác, hãy xem phần Mô-đun và đường dẫn Tìm hiểu trong bài viết Loại nội dung Tìm hiểu.

LearningPathUid ModuleUid
learn.security-ops-sentinel azure.query-data-sentinel
learn.architect-data-platform learn.access-data-with-cosmos-db-and-sql-api

Cấu trúc phân cấpModule

Tập dữ liệu HierarchyModule chứa thông tin ca-ta-lô về tất cả các mô-đun (khóa học).

Để tìm hiểu thêm về các mô-đun và cách chúng liên quan đến các loại nội dung khác, hãy xem phần Mô-đun trong bài viết Kiểu nội dung tìm hiểu.

moduleUid tiêu đề url biểu tượngUrl durationInMinutes Điểm Cấp Sản phẩm vai trò Ngôn ngữ
learn.languages.powershell-write-first Viết mã PowerShell đầu tiên của bạn /training/modules/powershell-write-first/ /training/achievements/powershell/powershell-write-first-code.svg 17 200 ["người mới bắt đầu"] ["dotnet"] ["developer","student"] ["powershell"]

Đơn vị phân cấp

Tập dữ liệu HierarchyUnit chứa thông tin ca-ta-lô về tất cả các Đơn vị (các phần của mô-đun).

Để tìm hiểu thêm về các đơn vị và cách chúng liên quan đến các loại nội dung khác, hãy xem phần Đơn vị trong bài viết Tìm hiểu loại nội dung.

unitUid tiêu đề url durationInMinutes Điểm moduleUid
learn.azure.query-data-sentinel.1-introduction Giới thiệu /training/modules/query-data-sentinel/1-introduction/ 5 100 azure.query-data-sentinel
learn.azure.query-data-sentinel.2-exercise-setup Bài tập - Truy vấn và trực quan hóa dữ liệu với Sổ làm việc Azure Sentinel /training/modules/query-data-sentinel/2-exercise-setup/ 10 100 azure.query-data-sentinel

Các bước tiếp theo

Xem lại các tài nguyên bên dưới để giúp bạn trong hành trình phát triển của mình: