Documentación del servicio Informes de la organización de Learn para desarrolladores

En este artículo se proporciona información para desarrolladores y solicitantes que implementan el servicio Informes de la organización de Microsoft Learn. También se recomienda consultar los artículos sobre los procedimientos recomendados, las notas de la versión y las preguntas más frecuentes del servicio Informes de la organización de Learn como ayuda en su recorrido de desarrollo.

Diccionario de datos

Conjuntos de datos específicos del inquilino

Los datos específicos del inquilino se proporcionan en los conjuntos de datos Achievements, Certifications, Progress y Users.

Importante

El userId en los datos específicos del inquilino es el identificador de usuario del perfil de Learn, que es diferente del ObjectId de Microsoft Entra.

Para obtener registros de progreso con displayName para los usuarios del inquilino:

• Combina tu propio objectId de datos de Microsoft Entra con el AADObjectId del conjunto de datos de Usuarios específico del inquilino
• Unión del conjunto de datos de usuarios específico del inquilino userId al progreso de userId
• Selecciona tu propio displayName de datos de Microsoft Entra y los datos aplicables de progreso.

Cuando descargue detalles de usuario del Centro de administración Microsoft Entra, la exportación incluirá el displayName y otras propiedades en formato CSV.

Logros

El conjunto de datos Achievements contiene información sobre todos los premios que han ganado los usuarios de este inquilino, normalmente, por completar módulos y rutas de aprendizaje. Al finalizar un módulo, los usuarios obtienen un distintivo y, cuando acaban la ruta de aprendizaje, obtienen un trofeo.

Los logros de un usuario se muestran en el sitio en vivo cuando se ve su perfil. (Ejemplo)

tenantId	userId	awardReason	awardType	awardUid	SourceType	SourceUid	AwardedOn
{guid}	{guid}	badge.module.basic.completed	Distintivo	learn.intro-to-compute.badge	Módulo	learn.intro-to-compute	{datetimeoffset}
{guid}	{guid}	trophy.path.basic.completed	Trofeo	learn.cloud-foundations.trophy	LearningPath	learn.cloud-foundations	{datetimeoffset}

Aptitudes aplicadas

El conjunto de datos Aptitudes aplicadas contiene información sobre todas las aptitudes aplicadas que los usuarios de este inquilino han obtenido, normalmente como resultado de completar sesiones de laboratorio. Tras completar correctamente la sesión de laboratorio, los usuarios pueden obtener una aptitud.

tenantId	userId	appliedSkillsUid	labProfileName	examScoredDate
{guid}	{guid}	applied-skill.build-azure-ai-vision-solution	APL-3004: Creación de una solución de Visión de Azure AI	{datetime}
{guid}	{guid}	applied-skill.build-collaborative-apps-microsoft-teams	APL-4001: Compilación de aplicaciones colaborativas para Microsoft Teams	{datetime}

Certificaciones

El conjunto de datos Certifications contiene información sobre todas las certificaciones que los usuarios de este inquilino han obtenido y que aún están activas o han expirado en los dos últimos años, como resultado de realizar uno o varios exámenes (según requiera la certificación).

tenantID	userId	AwardType	TranscriptName	SourceUid	AwardedOn	CertificationStartDate	CertificationEndDate	StayCurrentEligibilityStartDate
{guid}	{guid}	Certificación	Microsoft Certified: Azure AI Engineer Associate	certification.azure-ai-engineer	{int}	{int}	{int}	{int}
{guid}	{guid}	Certificación	Microsoft Certified: Power Platform Fundamentals	certification.power-platform-fundamentals	{int}	{int}	{int}	{int}

Los valores de fecha {int} tienen el formato YYYYMMDD.

Progreso

El conjunto de datos Progress contiene información sobre cuántos puntos de experiencia han obtenido los usuarios de este inquilino por completar fragmentos de contenido (como unidades individuales, módulos completos y rutas de aprendizaje). No todo el contenido es igual. Por eso, los usuarios pueden ganar más puntos si el contenido incluye interactividad o si completan una prueba de conocimientos al 100 % la primera vez.

tenantId	userId	XPReason	SourceType	SourceUid	XP	AwardedOn
{guid}	{guid}	points.unit.basic.completed	Unidad	learn.intro-to-compute.1-introduction	100	{datetimeoffset}
{guid}	{guid}	points.module.basic.completed	Módulo	learn.create-azure-account	200	{datetimeoffset}
{guid}	{guid}	points.path.basic.completed	LearningPath	learn.cloud-foundations	2100	{datetimeoffset}

Usuarios

El conjunto de datos Usuarios contiene información de todos los usuarios a los que se hace referencia en los demás conjuntos de datos específicos del inquilino. Tenga en cuenta que este conjunto de datos no contiene ninguna información de identificación personal. El userId es el identificador de usuario del perfil de Learn, que es diferente del ObjectId de Microsoft Entra (AADObjectId). Cuando genere informes, deberá combinar estos datos con la lista de usuarios de Microsoft Entra para ver una lista más completa de información de usuarios con respecto a los demás datos.

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

Conjuntos de datos de Microsoft Learn

Los datos de Microsoft Learn (no específicos de un inquilino individual) se proporcionan mediante los conjuntos de datos HierarchyAppliedSkills, HierarchyCertification, HierarchyLearningPath, HierarchyLearningPathModule, HierarchyModule y HierarchyUnit.

HierarchyAppliedSkills

El conjunto de datos HierarchyAppliedSkills contiene información de catálogo sobre todas las aptitudes aplicadas en Microsoft Learn.

Para obtener más información sobre las aptitudes aplicadas y cómo se relacionan con otros tipos de contenido, vea la sección Aptitudes aplicadas en el artículo Tipos de contenido de Learn.

appliedSkillsUid	title	dirección url	niveles	products	roles	temas	tareas
applied-skill.build-azure-ai-vision-solution	Creación de una solución de Visión de Azure AI	/credentials/applied-skills/build-azure-ai-vision-solution/	["intermediate"]	["azure-computer-vision"]	["developer","ai-engineer","maker"]	["artificial-intelligence"]	["Crear un recurso de Computer Vision","Analizar imágenes","Crear un modelo de análisis de imágenes personalizado","Entrenar y evaluar el modelo","Consumir un modelo personalizado"]
applied-skill.build-collaborative-apps-microsoft-teams	Compilación de aplicaciones colaborativas para 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"]	["Crear un bot","Crear una extensión de mensajería","Crear webhooks","Crear una pestaña de Teams","Integrar Microsoft Graph en una aplicación de Teams","Distribuir una aplicación de Teams"]

HierarchyCertification

El conjunto de datos HierarchyCertification contiene información del catálogo de todas las certificaciones de Microsoft Learn.

Para obtener más información sobre las certificaciones y cómo se relacionan con otros tipos de contenido, consulte la sección Certificación del artículo Tipos de contenido de Microsoft Learn.

certificationUid	type	title	Resumen	url	iconUrl	niveles	products	roles	exams
certification.azure-administrator	0	Microsoft Certified: Azure Administrator Associate	Los administradores de Azure implementan, administran y supervisan el entorno de Microsoft Azure de una organización.	/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

El conjunto de datos HierarchyLearningPath contiene información del catálogo sobre todas las rutas de aprendizaje de Microsoft Learn.

Para obtener más información sobre las rutas de aprendizaje y cómo se relacionan con otros tipos de contenido, consulte la sección Rutas de aprendizaje del artículo Tipos de contenido de Microsoft Learn.

LearningPathUid	title	url	durationInMinutes	puntos	iconUrl	niveles	products	roles	languages
learn.create-serverless-applications	Creación de aplicaciones sin servidor	/training/paths/create-serverless-applications/	517	1925	/training/achievements/create-serverless-applications.svg	["principiante","intermedio"]	["azure","azure-functions","azure-portal","azure-cosmos-db","azure-storage","azure-cloud-shell"]	["desarrollador","estudiante"]	["powershell"]

HierarchyLearningPathModule

El conjunto de datos HierarchyLearningPathModule contiene la correspondencia de los módulos con las rutas de aprendizaje. Nota: Un módulo puede formar parte de varias rutas de aprendizaje.

Para obtener más información sobre los módulos y las rutas de aprendizaje y cómo se relacionan con otros tipos de contenido, consulte las secciones Módulos y Rutas de aprendizaje del artículo Tipos de contenido de Microsoft 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

El conjunto de datos HierarchyModule contiene información del catálogo sobre todos los módulos (cursos).

Para obtener más información sobre los módulos y cómo se relacionan con otros tipos de contenido, consulte la sección Módulos del artículo Tipos de contenido de Microsoft Learn.

moduleUid	title	url	iconUrl	durationInMinutes	puntos	niveles	products	roles	languages
learn.languages.powershell-write-first	Escritura del primer código de PowerShell	/training/modules/powershell-write-first/	/training/achievements/powershell/powershell-write-first-code.svg	17	200	["beginner"]	["dotnet"]	["desarrollador","estudiante"]	["powershell"]

HierarchyUnit

El conjunto de datos HierarchyUnit contiene información del catálogo sobre todas las unidades (fragmentos de módulos).

Para obtener más información sobre las unidades y cómo se relacionan con otros tipos de contenido, consulte la sección Unidades del artículo Tipos de contenido de Microsoft Learn.

unitUid	title	url	durationInMinutes	puntos	moduleUid
learn.azure.query-data-sentinel.1-introduction	Introducción	/training/modules/query-data-sentinel/1-introduction/	5	100	azure.query-data-sentinel
learn.azure.query-data-sentinel.2-exercise-setup	Ejercicio: Consulta y visualización de datos con libros de Azure Sentinel	/training/modules/query-data-sentinel/2-exercise-setup/	10	100	azure.query-data-sentinel

Pasos siguientes

Consulte los siguientes recursos como ayuda para su recorrido de desarrollo:

• Procedimientos recomendados para usar el servicio Informes de la organización de Microsoft Learn
• Preguntas más frecuentes sobre el servicio Informes de la organización de Learn
• Notas de la versión del servicio Informes de la organización de Microsoft Learn