Meilleures pratiques d’utilisation du service Rapports organisationnels Microsoft Learn
Cet article décrit les meilleures pratiques d’utilisation du service Rapports organisationnels Learn.
Présentation du contrat Microsoft Learn Data Access and Sharing Agreement
En utilisant ce service de partage de données, vous reconnaissez avoir pris connaissance et accepté les termes du contrat Microsoft Learn Data Access and Sharing Agreement qui permet à Microsoft de partager avec votre organisation des données de Learn relatives aux utilisateurs du service qui se connectent avec l’ID de locataire de votre organisation. Lisez ce contrat et comprenez son contenu avant d’utiliser le service Rapports organisationnels Microsoft Learn et d’inclure la sortie dans un environnement de production.
Planifier la solution de création de rapports que vous utiliserez pour visualiser les données offertes dans ce service
Le service Rapports organisationnels Microsoft Learn fournit des données d’achèvement brutes aux organisations et ne propose pas de tableaux de bord par défaut. Vous pouvez prendre les données et les exporter vers un fichier CSV pour afficher rapidement les données, mais elles doivent être jointes pour avoir un impact.
Nous avons fourni un modèle Power BI Rapports organisationnels Learn pour le stockage SQL DB qui contient de nombreuses visualisations de données standard, mais vous pouvez également utiliser la solution de création de rapports de votre choix. Planifiez à l’avance les éléments que vous souhaitez utiliser, afin de pouvoir les connecter au stockage de données dans le cadre du processus d’installation.
Comprendre le modèle de contenu Learn
Pour utiliser efficacement la réponse du service Rapports organisationnels Microsoft Learn, il est important de comprendre les types de contenu disponibles dans Microsoft Learn et leurs relations les uns avec les autres. Pour plus d’informations, consultez l’article Types de contenu Learn.
Notamment :
- UID signifie « ID unique » et est unique pour chaque objet de contenu. Si un UID change, même si le titre ou d’autres métadonnées restent identiques, le contenu est considéré comme un nouvel objet.
- Les modules sont l’objet principal du catalogue de formations Learn. Ils sont tous autonomes, dans le sens où ils enseignent un scénario ou un concept de bout en bout et ne nécessitent pas de suivre des modules prérequis. Certaines se suffisent à elles-mêmes et elles ne font pas partie d’un parcours d’apprentissage. D’autres sont regroupées dans un ou plusieurs parcours d’apprentissage qui présentent à l’utilisateur des concepts plus avancés. Un module ne doit pas nécessairement faire partie d’un parcours d’apprentissage, ou il peut faire partie d’un ou de plusieurs parcours d’apprentissage.
- Les unités ne sont pas écrites en tant que contenu autonome. Elles sont destinées à être utilisées dans un ordre spécifique pour le module. Pour cette raison, nous incluons le lien vers la page de détails du module et la première unité afin que les utilisateurs puissent démarrer à cet endroit-là et poursuivre la lecture du contenu.
Comprendre le fonctionnement de la localisation dans Learn et comment le contenu localisé est reflété dans la sortie Rapports organisationnels
Microsoft Learn prend en charge plus de 65 paramètres régionaux sur le site et une grande partie du contenu a été traduit dans les langues correspondant à ces paramètres régionaux. Notre objectif est de faire en sorte que le contenu soit disponible dans tous les paramètres régionaux dans lesquels les produits enseignés dans le contenu sont disponibles, mais du contenu traduit n’est pas disponible pour toutes les expériences de paramètres régionaux.
Quand aucune traduction associée n’est disponible pour un enregistrement de paramètres régionaux, le contenu sur le site et la réponse de l’API reviennent à l’anglais par défaut. Dans le cas de la sortie de l’API, vous verrez des métadonnées en anglais dans les réponses d’autres paramètres régionaux lorsque la réinitialisation vers l’anglais se produit. Toutefois, l’URL du contenu pointera toujours vers les paramètres régionaux, même si le contenu principal peut être réinitialisé vers l’anglais. L’objectif est de permettre à l’utilisateur de continuer à naviguer sur le site dans ces paramètres régionaux (qui afficheront l’en-tête/le pied de page traduits et tout autre lien pour lequel une traduction est disponible).
Lorsque des mises à jour sont publiées dans le contenu en anglais, nos pipelines de localisation font en sorte que les versions localisées soient mises à jour dès que possible, généralement dans les quelques jours suivant la modification d’origine. Vous pouvez voir la liste complète des paramètres régionaux pris en charge via le pied de page du site (sélectionnez le lien vers la langue dans laquelle vous affichez le site).
Nos enregistrements relatifs à l’achèvement du contenu des formations sont indépendants des paramètres régionaux. En d’autres termes, nous ne différencions pas les versions localisées du contenu en tant qu’objets distincts dans nos enregistrements d’achèvement de formation des utilisateurs. Quelle que soit la langue dans laquelle un utilisateur suit une formation, il reçoit un crédit pour l’objet global, et nous ne stockons pas de référence à la langue dans laquelle la formation a été suivie. Cela signifie que si vous implémentez les données du service Rapports organisationnels Learn dans votre expérience d’apprentissage, vous devez en tenir compte. En outre, si vous chargez les objets de contenu en tant qu’objets distincts, implémentez une équivalence entre eux afin que, quelle que soit la langue dans laquelle l’utilisateur effectue la formation, il obtienne un crédit pour celle-ci dans les autres langues et n’ait pas à la suivre à nouveau.
Comprendre le fonctionnement du contrôle de version de contenu dans Learn et comment il est reflété dans la sortie des rapports organisationnels
Notamment, le contenu est mis à jour en permanence. Nous publions généralement des mises à jour deux fois par jour. Elles peuvent être mineures (p. ex. des modifications de texte mineures) ou majeures (p. ex. des révisions, des ajouts ou des suppressions majeurs). En général, le portefeuille de contenu est géré comme un projet open source massif et hautement régi ayant des milliers de contributeurs, et par conséquent, des changements se produisent tout le temps. Si vous utilisez les données du service Rapports organisationnels Learn dans votre système de production, vous devez en être conscient et faire en sorte que votre système soit en mesure de gérer ces changements.
Lorsque de nouveaux objets de contenu sont ajoutés, ils apparaissent sous la forme d’un nouvel objet (identifié par un UID) dans la réponse. Lorsque du contenu est modifié, vous pouvez le déterminer en vous référant à sa valeur last_modified. Lorsque du contenu est supprimé, il est supprimé de la réponse. Bien qu’il y ait parfois un léger retard sur la mise à jour du contenu dans la réponse de l’API, lorsqu’un utilisateur suit l’URL pointant vers le contenu, il voit toujours les informations les plus actualisées. Dans le cas de suppressions, l’ancienne URL redirige vers le nouveau contenu ou la nouvelle expérience.
Il n’existe aucune référence aux versions de contenu pour l’instant au-delà de la date last_modified.
Comprendre les limitations du service Rapports organisationnels
Consultez la section Limitations de l’article de présentation des fonctionnalités du service Rapports organisationnels Learn.
Actualiser les données régulièrement
Si vous utilisez les informations du catalogue provenant des données du service Rapports organisationnels pour prendre en charge vos processus métier, ou si vous les affichez pour les clients dans le cadre de votre expérience de site, veillez à actualiser le contenu au moins une fois par jour.
Notamment, le contenu est mis à jour en permanence. Nous publions généralement des mises à jour deux fois par jour. Elles peuvent être mineures (p. ex. des modifications de texte mineures) ou majeures (p. ex. des révisions, des ajouts ou des suppressions majeurs). En général, le portefeuille de contenu est géré comme un projet open source massif et hautement régi ayant des milliers de contributeurs, et par conséquent, des changements se produisent tout le temps. Si vous utilisez les données du service Rapports organisationnels Learn dans votre système de production, vous devez en être conscient et faire en sorte que votre système soit en mesure de gérer ces changements.
Vérifiez que vos informations Microsoft Entra jointes sont actualisées régulièrement
Si vous souhaitez savoir à qui chaque enregistrement de saisie semi-automatique se réfère, vous devez joindre les données du jeu de données Rapport organisationnel à vos informations Microsoft Entra pour que les noms apparaissent à côté des enregistrements de saisie semi-automatique. Si vous n’actualisez pas vos données jointes Microsoft Entra, il est possible que vous ayez des enregistrements de saisie semi-automatique avec des données personnelles obsolètes ou qu’il y ait des données d’informations d’identification personnelle qui y sont associées.
Référencer la documentation pour les développeurs
La documentation sur le service Rapports organisationnels Learn destinée aux développeurs contient une liste complète des données fournies dans le cadre de la réponse, ainsi que des recommandations sur la façon dont chaque champ doit être utilisé pour prendre en charge des expériences d’apprentissage exceptionnelles.
Étapes suivantes
Pour plus d’informations sur le service Rapports organisationnels Learn, consultez les articles suivants :