Employee Directory Vue d’ensemble
Un annuaire à l’échelle de l’entreprise répond à la question « qui travaille ici ? ». Le site d’un service ou d’un bureau a besoin d’une réponse plus précise : « qui fait partie du service commercial ? », « qui travaille au bureau de Riga ? », « qui est employé par notre filiale allemande ? ». Avec Vitextra Employee Directory, vous pouvez créer une telle page à partir des mêmes composants WebPart que ceux de l’annuaire principal : il suffit de limiter les personnes affichées par le composant WebPart et d’adapter la mise en page.
Cet article est un scénario complet. Il explique comment :
- limiter l’annuaire à un service, un bureau, un pays ou une société ;
- choisir les colonnes, les affinements, le regroupement et la présentation des fiches adaptés à une telle page ;
- décider quels filtres rapides conserver ;
- créer la même page pour plusieurs bureaux ;
- proposer l’annuaire du service dans Microsoft Teams.
Chaque paramètre est décrit en détail dans d’autres articles ; celui-ci y renvoie plutôt que de répéter chaque option.
Choisir l’approche
La façon de limiter l’annuaire dépend du composant WebPart et de sa source de données :
| Approche | Composant WebPart et source | Comment l’étendue est définie | Adaptée à une page de service |
|---|---|---|---|
| Méthode A (recommandée) | Employee Directory (Entra ID) | Un filtre créé dans l’éditeur de filtres visuel, sur n’importe quelle colonne ou colonne personnalisée | Oui |
| Méthode B | Employee Directory avec la source Profils utilisateur | Une condition KQL dans Requête enregistrée | Oui |
| Méthode C | Employee Directory avec la source Entra ID (Azure AD) | Uniquement Afficher uniquement les utilisateurs avec un service non vide | Non |
Utilisez la méthode A lorsque les données de vos collaborateurs sont gérées dans Microsoft Entra ID : elle ne nécessite aucun langage de requête et fonctionne avec n’importe quel attribut, y compris les attributs personnalisés. Utilisez la méthode B lorsque votre annuaire s’appuie déjà sur les profils utilisateur SharePoint et la recherche, par exemple sur des propriétés de profil personnalisées.
💡 Astuce
Pour une comparaison complète des deux composants WebPart d’annuaire, consultez KB10310. Employee Directory ou Employee Directory (Entra ID) : quel composant WebPart choisir.
Avant de commencer
- La solution Employee Directory est installée (voir KB10035. Comment installer un produit Vitextra dans SharePoint Online) et ses autorisations Microsoft Graph sont approuvées (voir KB10360. Comment approuver les autorisations d'API Microsoft Graph pour les solutions Vitextra dans le Centre d'administration SharePoint).
- Vous pouvez modifier la page du site du service ou du bureau.
- Vérifiez les données. Le filtre comme la requête comparent les valeurs enregistrées pour chaque personne. Vérifiez comment sont écrits exactement le service, le bureau, le pays ou la société - par exemple
SalesouSales Department,RigaouRiga HQ,LVouLatvia- et si la valeur est renseignée pour toutes les personnes qui doivent figurer sur la page. Une personne dont la valeur est absente ou écrite autrement n’est pas affichée.
Méthode A : Employee Directory (Entra ID) avec un filtre
Le composant WebPart Employee Directory (Entra ID) lit tous les utilisateurs de Microsoft Entra ID et applique son filtre dans le navigateur. Le filtre définit qui appartient à la page ; les visiteurs ne peuvent pas le supprimer.
Créer le filtre
- Ouvrez la page, sélectionnez Modifier et ajoutez le composant WebPart Employee Directory (Entra ID).
- Ouvrez le volet des propriétés (l’icône en forme de crayon Modifier le composant WebPart) et développez le groupe Source de données.
- Sous Filtrer, sélectionnez Modifier le filtre. Le volet Filtrage avancé s’ouvre.
- Sélectionnez Ajouter › Critère.
- Dans le critère, sélectionnez le champ Service, l’opérateur Égal à et saisissez la valeur
Sales. - Sélectionnez Enregistrer. Le composant WebPart n’affiche plus que le service commercial, et l’aperçu du filtre dans le volet des propriétés indique [Service] Égal à Sales.
- Sélectionnez Republier.
La liste des champs d’un critère contient toutes les colonnes configurées sous Colonnes et Colonnes personnalisées, que la colonne soit affichée dans la liste ou non. Vous pouvez donc masquer la colonne Service sur une page de service tout en filtrant sur celle-ci.
📝 Remarque
Toutes les comparaisons de texte du filtre ignorent la casse. Égal à exige que la valeur entière corresponde ; Commence par et Contient en vérifient une partie, ce qui est utile lorsque les valeurs diffèrent légèrement, par exemple Riga, Riga HQ et Riga, Floor 3.
Combiner des critères
Chaque niveau du filtre possède un sélecteur ET / OU. ET exige tous les critères de ce niveau ; OU en exige au moins un.
- Alternatives. Pour afficher le service commercial et toutes les personnes du bureau de Riga, ajoutez deux critères au niveau supérieur et basculez le sélecteur sur OU : Service Égal à
Saleset Bureau Commence parRiga. - Une étendue et des alternatives. Pour afficher les services commercial et marketing en Allemagne, laissez le niveau supérieur sur ET avec Pays/Région Égal à
Germany, puis sélectionnez Ajouter › Groupe, réglez le groupe sur OU et ajoutez-y Service Égal àSaleset Service Égal àMarketing. Le résultat est Germany et (Sales ou Marketing).
❗ Important
Les groupes sont toujours combinés au reste du filtre avec ET, même lorsque le niveau supérieur est réglé sur OU. Les groupes ne peuvent être ajoutés qu’au niveau supérieur. Si vous avez besoin d’alternatives en plus d’autres critères, placez les alternatives dans un même groupe réglé sur OU, comme dans l’exemple ci-dessus.
Pour tous les champs, opérateurs et d’autres exemples, consultez KB10312. Employee Directory (Entra ID) : référence de l’éditeur de filtres.
Combiner le filtre et les exclusions
Le groupe Exclure les employés supprime les comptes qui ne correspondent pas à de vrais employés avant l’application du filtre : le filtre ne fait que restreindre davantage le résultat. Sur une page à étendue limitée, la combinaison utile est généralement la suivante :
- laissez Exclure les utilisateurs bloqués activé (par défaut), afin que les anciens employés du service n’apparaissent pas ;
- activez Exclure les employés sans licence si des boîtes aux lettres partagées ou des comptes de salles portent la valeur du service ou du bureau ;
- activez Exclure les employés avec un service vide lorsque vous utilisez un critère négatif tel que Service Est différent de
Sales: Est différent de et Ne contient pas retiennent aussi les personnes dont le champ est vide.
Les exclusions sont décrites dans KB10311. Comment configurer le composant WebPart Employee Directory (Entra ID) : filtres, exclusions et navigation A–Z.
Méthode B : Employee Directory avec les profils utilisateur et une requête enregistrée
Avec la source Profils utilisateur, le composant WebPart Employee Directory trouve les personnes via la recherche SharePoint. L’étendue de la page est une condition KQL (Keyword Query Language) dans Requête enregistrée.
- Ajoutez le composant WebPart Employee Directory et ouvrez son volet des propriétés.
- Dans le groupe Source de données, réglez Source de données sur Profils utilisateur.
- Dans Requête enregistrée, remplacez la valeur par défaut
*par votre condition, par exempleDepartment:"Sales". - Laissez Afficher les utilisateurs masqués désactivé pour exclure les profils SharePoint marqués par
SPS-HideFromAddressLists. - Vérifiez le résultat sur la page et sélectionnez Republier.
Points à garder à l’esprit lors de la rédaction de la requête :
- Elle est ajoutée à chaque recherche. Le composant WebPart ajoute la requête au texte que le visiteur saisit dans la zone de recherche ; la recherche reste donc limitée au service. Le filtre rapide Mon service y ajoute le service du visiteur.
- Utilisez les propriétés standard des personnes.
Department,JobTitleetBaseOfficeLocation(le bureau) sont des propriétés gérées standard de la recherche de personnes SharePoint, par exempleJobTitle:"Engineer"ouBaseOfficeLocation:Riga*(le*final trouve les valeurs qui commencent par Riga). - Combinez avec OR en majuscules et des parenthèses, par exemple
(Department:"Sales" OR Department:"Marketing"). Utilisez explicitementANDlorsque toutes les conditions doivent être remplies. - Une restriction de propriété recherche des mots dans la valeur.
Department:"Sales"peut aussi renvoyer des personnes des services Inside Sales ou Sales Operations. Vérifiez le résultat et précisez la valeur si nécessaire. - Une requête contenant une erreur de syntaxe ne renvoie aucun résultat, et les modifications de profil n’apparaissent qu’après une nouvelle analyse des profils utilisateur par la recherche SharePoint.
📝 Remarque
Pour filtrer sur une propriété qui n’est pas une propriété gérée standard - par exemple un pays, une société ou une propriété de profil personnalisée -, celle-ci doit être mappée à une propriété gérée dans le schéma de recherche SharePoint. La procédure de mappage est décrite dans KB10313. Comment configurer le volet d’affinement dans Employee Directory. Si vos données se trouvent dans Microsoft Entra ID, la méthode A est généralement plus simple.
Méthode C : pourquoi la source Entra ID d’Employee Directory ne convient pas
Le composant WebPart Employee Directory peut aussi lire les personnes dans Microsoft Entra ID (Source de données › Entra ID (Azure AD)). Avec cette source, la zone Requête enregistrée n’est pas disponible : la seule restriction est le bouton Afficher uniquement les utilisateurs avec un service non vide, qui masque les comptes sans service mais ne permet pas d’en sélectionner un en particulier. Le groupe Panneau d'affinement n’est pas non plus disponible avec cette source, et le composant WebPart Employee Directory ne propose pas de navigation A–Z.
Cette source ne convient donc pas à une page de service ou de bureau. Si les données de vos collaborateurs se trouvent dans Microsoft Entra ID, utilisez le composant WebPart Employee Directory (Entra ID) (méthode A).
Exemples de filtres
Le tableau présente des pages courantes à étendue limitée et la manière de les définir avec chaque méthode. Remplacez les valeurs d’exemple par celles de votre annuaire.
| Page | Méthode A : éditeur de filtres | Méthode B : requête enregistrée |
|---|---|---|
| Un service | Service Égal à Sales | Department:"Sales" |
| Deux services | Groupe (OU) : Service Égal à Sales ; Service Égal à Marketing | (Department:"Sales" OR Department:"Marketing") |
| Un bureau | Bureau Commence par Riga | BaseOfficeLocation:Riga* |
| Une ville | Ville Égal à Riga | Nécessite une propriété gérée mappée |
| Un pays | Pays/Région Égal à Latvia | Nécessite une propriété gérée mappée |
| Plusieurs graphies d’un pays | Groupe (OU) : Pays/Région Égal à Latvia ; Pays/Région Égal à LV | Nécessite une propriété gérée mappée |
| Une société dans un locataire multi-sociétés | Nom de la société Égal à Contoso Baltics | Nécessite une propriété gérée mappée |
| Un service dans un pays | Niveau supérieur (ET) : Service Égal à Sales ; Pays/Région Égal à Germany | Nécessite une propriété gérée mappée pour le pays |
| Une famille de métiers | Fonction Contient engineer | JobTitle:"Engineer" |
| Un centre de coûts ou un autre attribut personnalisé | Ajoutez l’attribut sous Colonnes personnalisées, puis Centre de coûts Égal à 4100 | Nécessite une propriété gérée mappée |
💡 Astuce
Pour filtrer sur un attribut absent de la liste des colonnes intégrées, comme un attribut d’extension local, ajoutez-le d’abord sous Colonnes personnalisées - voir KB10060. Comment afficher les attributs personnalisés Entra ID dans le composant WebPart Employee Directory.
Affiner la page
Une fois l’étendue définie, ajustez la mise en page pour que la page présente ce qui est utile à ce public précis.
Colonnes
Sur une page de service, tout le monde appartient au même service : la colonne Service n’apporte donc rien. Dans Source de données, sélectionnez Configuration sous Colonnes, désactivez Afficher dans la liste et Afficher sur la carte pour Service, et affichez plutôt les colonnes qui varient d’une personne à l’autre - Fonction, Bureau ou un numéro de téléphone. Sur une page de bureau, faites l’inverse : conservez Service et masquez Bureau.
Affinements pour un filtrage complémentaire
Le volet d’affinement permet aux visiteurs de restreindre encore la page - par exemple par fonction sur une page de service ou par service sur une page de bureau. Activez l’option Activé dans le groupe Panneau d'affinement, sélectionnez Configuration sous Affinements et ajoutez les affinements :
- dans Employee Directory (Entra ID), sélectionnez une colonne, comme Fonction, dans Affiner par. Les valeurs sont calculées à partir des personnes qui satisfont au filtre : une page du service commercial ne propose donc que les fonctions présentes dans ce service ;
- dans Employee Directory avec Profils utilisateur, saisissez le nom d’une propriété gérée affinable, comme
JobTitle, après avoir vérifié dans le schéma de recherche qu’elle est affinable.
Pour plus de détails, consultez KB10313. Comment configurer le volet d’affinement dans Employee Directory.
Regroupement et présentation des fiches
Dans le groupe Apparence, Grouper par divise la page en sections : par Fonction ou Bureau sur une page de service, par Service sur une page de bureau, ou par Nom (première lettre) pour une présentation de type carnet d’adresses. Une colonne n’a pas besoin d’être affichée dans la liste pour être proposée dans Grouper par.
Pour une page que l’on parcourt plutôt qu’on ne l’interroge, l’affichage en fiches est généralement le plus adapté : réglez Affichage sur Fiche contact, choisissez la Taille des fiches et les lignes dans Champs de contenu (En-tête, Secondaire, etc.) - par exemple le nom, la fonction et le bureau sur une page de service.
❗ Important
Le regroupement s’applique aux personnes chargées sur la page. Avec la pagination, un groupe ne contient que les personnes chargées jusqu’ici. Sur une petite page de service, réglez Afficher les éléments par pages de : sur une valeur suffisante pour afficher tout le monde ; dans Employee Directory (Entra ID), vous pouvez indiquer 0 pour afficher toutes les personnes en une fois. Voir KB10314. Affichages d’Employee Directory : liste et fiches, taille des fiches, champs des fiches et regroupement.
Filtres rapides
Le groupe Filtres rapides comporte un bouton pour chaque filtre rapide. Passez-les en revue pour une page à étendue limitée :
- Mon service est redondant sur une page de service : pour les membres du service, il répète la page, et pour les visiteurs d’autres services, il n’affiche personne, car il restreint la liste déjà filtrée au service du visiteur. Désactivez-le sur une telle page. Sur une page de bureau ou de pays, il est utile : il affiche le service du visiteur dans ce bureau.
- Mon équipe, Personnes avec qui je travaille et Favoris sont des listes personnelles. Dans Employee Directory (Entra ID), elles respectent le filtre administrateur et les exclusions. Dans Employee Directory, elles utilisent des listes distinctes et contournent Requête enregistrée : elles peuvent donc inclure d’autres services. Désactivez-les dans la méthode B si la page doit rester limitée à un service.
Pour savoir ce qu’affiche chaque filtre rapide, consultez KB10214. Filtres rapides d'Employee Directory : Mon service, Mon équipe, Personnes avec qui je travaille, Favoris.
Navigation A–Z, zone de recherche et totaux
- Afficher la navigation alphabétique (dans le groupe Apparence d’Employee Directory (Entra ID)) ajoute une ligne avec les initiales des noms de famille. Les lettres proviennent des personnes qui satisfont au filtre et correspondent donc à la page. Sur une petite page de service, vous pouvez la laisser désactivée.
- Afficher la zone de recherche : la recherche filtre la liste actuelle, y compris lorsqu’un filtre rapide personnel est sélectionné. Désactivez la zone de recherche pour une liste courte et fixe, comme une équipe de dix personnes.
- Afficher les totaux indique combien de personnes la page contient - pratique comme effectif d’un service ou d’un bureau.
Créer des pages pour plusieurs bureaux
Pour que chaque bureau, pays ou société dispose de sa propre page, configurez entièrement une page, puis copiez-la :
- Sur la page terminée, sélectionnez + Nouveau › Copie de cette page dans la barre de commandes de la page.
- Dans la copie, modifiez le composant WebPart et changez uniquement la valeur du filtre (par exemple
RigaenTallinn) ou de Requête enregistrée. - Modifiez le titre de la page et sélectionnez Republier.
Chaque composant WebPart conserve ses propres propriétés : modifier le filtre sur une page n’affecte pas les autres, ni l’application personnelle Teams.
📝 Remarque
Les composants WebPart d’une même origine SharePoint partagent un cache navigateur de la liste des utilisateurs. Si la liste a plus de 24 heures, le chargement du composant déclenche une actualisation en arrière-plan ; une actualisation manuelle peut la recharger plus tôt. Conservez les mêmes colonnes, colonnes personnalisées et paramètres d’exclusion des utilisateurs bloqués sur les pages copiées. Après avoir modifié les attributs chargés, actualisez les données pour obtenir les nouvelles valeurs.
💡 Astuce
Pour donner à l’annuaire une page pleine largeur dédiée, sans autres composants WebPart, consultez KB10040. Comment créer une page d'application unique avec Vitextra Employee Directory.
Annuaires de service dans Microsoft Teams
L’application personnelle Employee Directory dans Microsoft Teams utilise une seule configuration pour tout le locataire. Un administrateur l’enregistre avec Enregistrer les paramètres dans le groupe Application personnelle (Microsoft Teams) du volet des propriétés : « Vous pouvez enregistrer la configuration actuelle comme configuration par défaut de votre locataire. L’application personnelle hébergée dans Microsoft Teams utilise cette configuration. » Chaque utilisateur qui ouvre l’application personnelle voit cette configuration.
❗ Important
Ne sélectionnez pas Enregistrer les paramètres sur une page de service ou de bureau. La configuration enregistrée inclut le filtre, la requête enregistrée et les filtres rapides : l’application personnelle n’afficherait alors que ce service à tous les membres de l’organisation. Enregistrez la configuration de l’application personnelle depuis une page contenant l’annuaire de toute l’entreprise.
Les annuaires à étendue limitée ont leur place là où se trouve leur public :
- Sur le site SharePoint du service : les pages décrites dans cet article.
- Dans l’équipe du service : ajoutez la page SharePoint du service à un canal sous forme d’onglet SharePoint ; cela fonctionne avec chaque méthode. L’application Employees peut aussi être ajoutée comme onglet de canal, mais elle ouvre le composant WebPart Employee Directory : seules la méthode B et la méthode C s’y appliquent. Un onglet de canal possède ses propres paramètres, que vous configurez lors de l’ajout de l’onglet, et la configuration de l’application personnelle à l’échelle du locataire ne s’y applique pas.
Résolution des problèmes
| Symptôme | Ce qu’il faut vérifier |
|---|---|
| La page n’affiche personne | La valeur du filtre ne correspond pas à l’annuaire (orthographe, espaces superflus, abréviations) ; un critère Égal à au niveau supérieur avec ET que personne ne remplit ; une erreur de syntaxe dans Requête enregistrée |
| Certaines personnes manquent | Leur service, bureau ou pays est vide ou écrit autrement ; elles sont exclues par Exclure les employés sans licence ou Exclure les employés dont le titre de poste est vide ; avec Profils utilisateur, le profil n’a pas encore été analysé ou est masqué dans les listes d’adresses |
| Des personnes d’autres services apparaissent | Dans Employee Directory (méthode B), un filtre personnel contourne la requête de la page ; un critère Contient ou KQL peut retenir trop de valeurs. |
| Mon service n’affiche personne | Le visiteur appartient à un autre service que celui de la page - désactivez ce filtre rapide sur les pages de service |
| L’application personnelle Teams n’affiche qu’un service | Enregistrer les paramètres a été sélectionné sur une page à étendue limitée - enregistrez de nouveau la configuration depuis l’annuaire de toute l’entreprise |
Articles connexes
- KB10311. Comment configurer le composant WebPart Employee Directory (Entra ID) : filtres, exclusions et navigation A–Z
- KB10312. Employee Directory (Entra ID) : référence de l’éditeur de filtres
- KB10309. Comment ajouter et configurer le composant WebPart Employee Directory
- KB10313. Comment configurer le volet d’affinement dans Employee Directory
- KB10314. Affichages d’Employee Directory : liste et fiches, taille des fiches, champs des fiches et regroupement
- KB10214. Filtres rapides d'Employee Directory : Mon service, Mon équipe, Personnes avec qui je travaille, Favoris
