Introduction

Le composant WebPart Organizational Chart de Vitextra ne stocke aucune donnée d'employé qui lui soit propre. Tout ce qu'il affiche - noms, intitulés de poste, liens hiérarchiques, photos et présence - est lu lors de l’exécution dans Microsoft Entra ID via l'API Microsoft Graph. Pour que cela fonctionne, le composant WebPart a besoin d'un petit ensemble d'autorisations d'API qu'un administrateur du locataire approuve une seule fois.

Cet article énumère ces autorisations, explique à quoi sert chacune d'elles, montre comment les approuver et décrit l'aspect de l'organigramme lorsqu'une autorisation manque. Il s'adresse aux administrateurs SharePoint et Microsoft 365, ainsi qu'aux responsables de la sécurité qui doivent évaluer le produit avant son déploiement.

Les autorisations

Organizational Chart demande trois autorisations déléguées pour Microsoft Graph :

AutorisationUtilisationEn cas d'absence
Directory.Read.AllLecture de la liste des utilisateurs et de la relation de responsable (manager) de chaque compte - les données à partir desquelles la hiérarchie est construiteLe chargement de l’annuaire ou des profils peut échouer si aucune autre autorisation accordée ne couvre la requête
User.Read.AllLecture des attributs de profil affichés sur les cartes (intitulé de poste, service, localisation du bureau, numéros de téléphone, adresse, etc.) et des photos des employésLe chargement de l’annuaire ou des profils peut échouer si aucune autre autorisation accordée ne couvre la requête
Presence.Read.AllAffichage de l'indicateur de présence Microsoft Teams (Disponible, Occupé, Absent, Ne pas déranger, Hors ligne) sur chaque carteL'organigramme fonctionne, mais aucun indicateur de présence n'est affiché

Les trois sont des autorisations déléguées : le composant WebPart appelle toujours Microsoft Graph au nom de l'utilisateur connecté, jamais avec une identité d'application qui lui serait propre. L'organigramme ne montre donc à un visiteur rien que celui-ci ne pourrait voir en parcourant lui-même l'annuaire dans Microsoft 365 - il se contente de le présenter sous une forme plus pratique.

📝 Remarque
Les autorisations sont demandées au niveau du principal d'application SharePoint Online Client Extensibility, que partagent toutes les solutions SPFx du locataire. Si un autre produit Vitextra - par exemple Employee Directory - a déjà été approuvé pour la même étendue, la demande d'Organizational Chart est accordée automatiquement et n'apparaît pas comme en attente.

Approuver les autorisations

Les demandes d'autorisation sont enregistrées automatiquement lors du déploiement du package Organizational Chart dans le catalogue d'applications (App Catalog) du locataire. Pour les approuver :

  1. Connectez-vous au centre d'administration SharePoint avec un compte disposant du rôle Administrateur général.
  2. Dans la navigation de gauche, développez Avancé et sélectionnez Accès aux API.
  3. Sous Demandes en attente, repérez les demandes du package Organizational Chart pour la ressource Microsoft Graph - Directory.Read.All, User.Read.All et Presence.Read.All.
  4. Sélectionnez chaque demande et cliquez sur Approuver. Confirmez l'approbation dans le volet qui s'ouvre.

Demandes d’accès aux API

Demandes d’accès aux API

Les autorisations approuvées passent dans la liste Demandes approuvées, où elles peuvent être consultées ou révoquées à tout moment.

❗ Important
L'approbation prend effet immédiatement, mais les utilisateurs qui ont déjà la page ouverte doivent la recharger. Les navigateurs conservent en outre pendant un court instant le résultat de l'autorisation précédente : si l'organigramme affiche encore une erreur quelques minutes après l'approbation, patientez un peu et actualisez la page avant d'approfondir l'investigation.

💡 Astuce
La procédure de déploiement complète - chargement du package dans l'App Catalog, activation pour tous les sites et approbation des autorisations - est décrite dans KB10035. Comment installer un produit Vitextra dans SharePoint Online.

Que se passe-t-il lorsqu'une autorisation manque

Les trois autorisations ne provoquent pas les mêmes défaillances, ce qui aide à diagnostiquer le problème :

  • Autorisations d’annuaire insuffisantes. Si les étendues accordées ne couvrent pas la requête d’annuaire, l’organigramme ne peut pas charger les employés. À la place de l'arborescence, le composant WebPart affiche le message Désolé, nous avons rencontré un problème. Veuillez actualiser la page, puis réessayer. avec un bouton Configuration destiné aux éditeurs de la page. Approuvez les demandes en attente et rechargez la page.
  • Presence.Read.All non approuvée. L'organigramme se charge et toutes les cartes s'affichent, mais le point de présence sur les photos est absent pour tout le monde. C'est l'état partiel le plus courant : les deux autorisations d'annuaire ont été approuvées, tandis que la demande de présence a été oubliée.
  • Une autorisation a été révoquée après le déploiement. La fonctionnalité correspondante peut cesser de fonctionner. La demande est supprimée de la page d’accès aux API ; une nouvelle demande portant sur la même ressource et la même étendue doit être émise avant une nouvelle approbation.

L'erreur affichée lorsque l'annuaire ne peut pas être chargé

L'erreur affichée lorsque l'annuaire ne peut pas être chargé

📝 Remarque
La présence dépend aussi de la disponibilité de Teams pour la personne. Si Microsoft Graph ne renvoie aucun statut exploitable, la carte n’affiche pas d’indicateur de présence. Le statut est récupéré au chargement de la carte et n’est pas actualisé en continu.

Qui peut voir l'organigramme

Le composant WebPart utilisant des autorisations déléguées, l'accès à l'organigramme dépend de deux éléments :

  • L'accès à la page. Un visiteur doit pouvoir ouvrir la page SharePoint ou l'onglet Teams qui héberge le composant WebPart - les autorisations SharePoint et Teams habituelles s'appliquent.
  • L'accès à l'annuaire. Par défaut, tous les membres de l'organisation peuvent lire les informations de base de l'annuaire dans Microsoft 365 ; tout visiteur ayant accès à la page voit donc le même organigramme. Les utilisateurs invités, en revanche, ne sont pas chargés dans l'organigramme et ne peuvent généralement pas non plus lire l'intégralité de l'annuaire.

Organizational Chart n'ajoute aucune couche d'autorisation qui lui soit propre : il ne masque pas certains employés à certains visiteurs et ne donne à personne accès à des données qu'il ne pourrait pas lire ailleurs dans Microsoft 365. Pour exclure totalement certains comptes de l'organigramme - comptes de service, boîtes aux lettres partagées, utilisateurs de test -, utilisez les options de filtrage et d'exclusion du composant WebPart, décrites dans KB10233. Comment ajouter et configurer le composant WebPart Organizational Chart.

Traitement des données

Dans le cadre d'une revue de sécurité, les points suivants sont généralement pertinents :

  • Les données des employés sont lues dans Microsoft Graph directement par le navigateur de l'utilisateur et ne sont envoyées ni à Vitextra ni à un service tiers.
  • Un instantané de l'annuaire chargé est conservé dans le stockage local du navigateur pendant 12 heures maximum afin d'accélérer les visites répétées ; il est stocké par instance du composant WebPart et par navigateur et ne quitte jamais l'appareil.
  • Les photos et la présence ne sont demandées que pour les cartes visibles à l'écran et ne sont pas mises en cache au-delà de la session de la page.
  • Le composant WebPart ne contacte les serveurs de Vitextra que pour vérifier l'état de la licence du locataire, charger des ressources statiques telles que les icônes et collecter une télémétrie anonyme sur l'utilisation du produit. Aucune donnée d'annuaire n'est incluse dans ces requêtes.

💡 Astuce
Pour une présentation du produit, consultez KB10232. Organizational Chart : présentation de la solution. Si des employés sont absents de l'organigramme alors que toutes les autorisations sont approuvées, consultez KB10236. Pourquoi une personne est-elle absente de l'organigramme ?.

En savoir plus sur le produit : https://vitextra.com/fr/products/org-chart

Questions et réponses

Posez une question sur cet article et obtenez une réponse officielle de notre équipe.

Aucune question pour le moment. Posez la première !

Articles à la une

Comment ajouter et configurer le composant WebPart Questions and Answers

Guide pas à pas pour ajouter le composant WebPart Vitextra Questions and Answers à une page SharePoint Online, configurer sa source de données (liste SharePoint nouvelle ou existante) et ajuster son comportement, ses blocs visibles et son apparence dans le volet des propriétés.

1 5 min
My Tasks : pagination, limite de lignes, actualisation automatique et chargement instantané

Comment le composant WebPart Vitextra My Tasks gère les longues listes de tâches : curseur de taille de page (5 à 50), barre de pagination, commutateur Activer la Pagination, liste compacte, actualisation automatique toutes les minutes, cache de session de 15 minutes pour un chargement instantané et limite de 100 tâches pour les sources SharePoint et Projet.

101 6 min
Archiver une politique et la restaurer en tant que brouillon

Archivez les fiches de politique, comprenez ce qui reste accessible et restaurez une politique en brouillon sans supposer que les attributions ou preuves ont été supprimées.

14 4 min

Partager