Procedimientos recomendados para usar el servicio Informes de la organización de Microsoft Learn
En este artículo se describen los procedimientos recomendados para usar el servicio Informes de la organización de Learn.
Contrato de acceso y uso compartido de datos de Microsoft Learn
Al utilizar este servicio de uso compartido de datos, reconoce y acepta el Contrato de acceso y uso compartido de datos de Microsoft Learn para permitir que Microsoft comparta con su organización los datos de los usuarios de Learn que inicien sesión con el id. de inquilino de su organización. Debe leer y comprender este contrato antes de usar el servicio Informes de la organización de Microsoft Learn e incluir la salida en cualquier entorno de producción.
Planeamiento de la solución de elaboración de informes que usará para visualizar los datos que ofrece este servicio
El servicio Informes de la organización de Microsoft Learn proporciona a las organizaciones datos sin procesar sobre la finalización de actividades y no tiene ningún panel de forma predeterminada. Puede tomar los datos y exportarlos a un archivo CSV para verlos rápidamente, pero debe combinarlos para que sean significativos.
Hemos proporcionado una plantilla de Power BI de Informes de la organización de Learn para almacenar los datos en una base de datos SQL, que ofrece muchas visualizaciones de datos estándar, pero también puede usar cualquier solución de elaboración de informes que prefiera. Planee con antelación lo que desea usar, para que pueda conectarlo al almacenamiento de datos durante el proceso de configuración.
Descripción del modelo de contenido de Learn
Para hacer un uso eficaz de la respuesta del servicio Informes de la organización de Microsoft Learn, es importante comprender los tipos de contenido disponibles en Microsoft Learn y de qué forma están relacionados. Consulte el artículo Tipos de contenido de Microsoft Learn para obtener más información.
En particular:
- UID significa "id. único" y es único para cada objeto de contenido. Si cambia un UID, aunque el título u otros metadatos permanezcan iguales, el contenido se considera un nuevo objeto.
- Los módulos son el objeto principal del catálogo de aprendizaje de Learn. Todos se pueden realizar de forma independiente, porque enseñan un escenario o concepto íntegramente, sin necesidad de realizar otros módulos previamente. En algunos casos, eso es todo y no forman parte de ninguna ruta de aprendizaje. En otros casos, se agrupan en una o varias rutas de aprendizaje que guían al usuario en el desarrollo de conceptos más avanzados. Un módulo no tiene por qué formar parte de una ruta de aprendizaje, o bien puede formar parte de una o varias rutas de aprendizaje.
- Las unidades no están escritas como contenido independiente. Están pensadas para estudiarlas en un orden específico para el módulo. Por este motivo, se incluye el vínculo a la página de detalles del módulo y la primera unidad para que los usuarios puedan empezar ahí y continuar con el contenido.
Cómo funciona la localización en Learn y cómo se refleja el contenido localizado en la salida de Informes de la organización
Microsoft Learn ofrece más de 65 configuraciones regionales en el sitio y gran parte del contenido se ha traducido a esas configuraciones regionales. El objetivo es hacer que el contenido esté disponible en todos los idiomas en los que están disponibles los productos que se enseñan en el contenido, pero no todas las configuraciones regionales tienen contenido traducido disponible.
Cuando un registro de configuración regional no tiene disponible la traducción asociada, el contenido del sitio y la respuesta de la API se muestran en inglés de forma predeterminada. En el caso de la salida de la API, verá metadatos en inglés en las respuestas de otras configuraciones regionales cuando esto ocurra. Sin embargo, la dirección URL del contenido seguirá apuntando a la configuración regional, aunque el contenido principal se muestre en inglés. El motivo es permitir que el usuario siga navegando por el sitio con esa configuración regional, que mostrará el encabezado y el pie de página traducidos, y cualquier otro vínculo que tenga la traducción disponible.
Cuando se publican actualizaciones del contenido en inglés, nuestras canalizaciones de localización funcionan para actualizar las versiones localizadas lo antes posible, normalmente en unos pocos días después del cambio en el original. Puede ver una lista completa de las configuraciones regionales disponibles en el pie de página del sitio (seleccione el vínculo al idioma en el que está viendo el sitio).
Nuestros registros de finalización de contenido de aprendizaje son independientes de la configuración regional, es decir, no diferenciamos las versiones localizadas del contenido como objetos independientes en los registros de finalización de actividades de aprendizaje del usuario. Independientemente del idioma en el que un usuario complete una actividad de aprendizaje, recibirá crédito por el objeto global, y no almacenamos una referencia al idioma en el que la completó. Esto significa que, si implementa los datos del servicio Informes de la organización de Learn en su experiencia de aprendizaje, deberá tener esto en cuenta y, si carga los objetos de contenido como objetos independientes, implemente una equivalencia entre ellos para que, al margen del idioma en el que un usuario complete una actividad de aprendizaje, obtenga crédito por ella en los otros idiomas y no tenga que repetirla.
Cómo funciona el control de versiones del contenido de Learn y cómo se refleja en la salida de Informes de la organización
El contenido se actualiza todo el tiempo. Normalmente, publicamos actualizaciones dos veces al día. Pueden ser menores, como pequeños cambios en el texto, o mayores, como revisiones, adiciones o eliminaciones importantes. En general, la cartera de contenido se administra como un proyecto masivo de código abierto muy controlado con miles de colaboradores y, como tal, se están produciendo cambios todo el tiempo. Si usa los datos del servicio Informes de la organización de Learn en su sistema de producción, debe tener esto en cuenta y hacer que el sistema pueda controlarlo.
Cuando se agregan nuevos objetos de contenido, aparecen como un nuevo objeto (identificado por un UID) en la respuesta. Cuando se modifica el contenido, se puede ver en el valor de last_modified. Cuando se elimina contenido, se quita de la respuesta. Aunque a veces hay un ligero retraso en el contenido que se está actualizando en la respuesta de la API, cuando un usuario sigue la dirección URL del contenido, siempre ve la información más actual. En el caso de eliminaciones, la dirección URL anterior redirigirá al nuevo contenido o la nueva experiencia.
Actualmente, no hay referencias a las versiones del contenido más allá de la fecha de last_modified.
Limitaciones del servicio Informes de la organización
Consulte las limitaciones en el artículo Introducción al servicio Informes de la organización de Microsoft Learn.
Actualización periódica de los datos
Si usa la información del catálogo procedente de los datos del servicio Informes de la organización de Learn para sustentar sus procesos empresariales o para mostrárselos a los clientes como parte de la experiencia en el sitio, asegúrese de actualizar el contenido al menos una vez al día.
El contenido se actualiza todo el tiempo. Normalmente, publicamos actualizaciones dos veces al día. Pueden ser menores, como pequeños cambios en el texto, o mayores, como revisiones, adiciones o eliminaciones importantes. En general, la cartera de contenido se administra como un proyecto masivo de código abierto muy controlado con miles de colaboradores y, como tal, se están produciendo cambios todo el tiempo. Si usa los datos del servicio Informes de la organización en su sistema de producción, debe tener esto en cuenta y hacer que el sistema pueda controlarlo.
Asegúrese de que la información unida de Microsoft Entra se actualiza periódicamente
Para saber a quién hace referencia cada registro de finalización, tendrá que unir los datos del conjunto de datos de Informes de organización a su información de Microsoft Entra, de modo que los nombres aparezcan junto a los registros de finalización. Si no actualiza sus datos unidos a Microsoft Entra, puede tener registros de finalización con datos de personal obsoletos, o a los que les falten datos de información de identificación personal asociados a ellos.
Consulta de la documentación para desarrolladores
La documentación del servicio Informes de la organización de Learn para desarrolladores incluye una lista completa de los datos proporcionados en la respuesta y recomendaciones de uso de cada campo para ofrecer experiencias de aprendizaje excelentes.
Pasos siguientes
Si desea obtener más información que le ayude a usar el servicio Informes de la organización de Learn, consulte los siguientes artículos: