# Configuration

> Vues, filtres, assistants, responsables fonctionnels, valeurs renommées, affichage et thèmes dans coOrgChart.

Web page: https://orgchart.compleo.ch/fr/docs/configuration/

Modifiez la page et cliquez sur l’icône crayon du composant WebPart pour ouvrir ses paramètres. La **page 1** contient
les données, l’affichage et les thèmes ; la **page 2** les vues, les filtres communs et les valeurs renommées. Les
paramètres du composant sont actuellement en anglais ; les libellés sont donc indiqués en anglais ici.

## Données (« Data »)

| Paramètre | Remarques |
| --- | --- |
| Assistant attribute | L’attribut d’extension Entra ID (`extensionAttribute1`–`15`) contenant les assistants, voir ci-dessous. |
| Dotted-line manager attribute | L’attribut d’extension contenant les responsables fonctionnels, voir ci-dessous. |
| Additional employees list | Une liste SharePoint avec des personnes hors d’Entra ID. Voir [Collaborateurs supplémentaires](https://orgchart.compleo.ch/fr/docs/additional-employees/). |
| Hide people without manager and without reports | Activé par défaut. Masque les comptes de service, salles de réunion, etc. |
| Cache directory in the browser | 0 à 72 heures (12 par défaut). Avec 0, les données sont rechargées à chaque visite. |
| Reload data now | Ignore le cache, par exemple après des modifications dans Entra ID. |

## Assistants et responsables fonctionnels

coOrgChart lit ces relations dans deux attributs d’extension de votre choix :

| Relation | Saisie chez | Valeur |
| --- | --- | --- |
| Assistant | le **responsable** | UPN ou e-mail de l’assistant. Séparer plusieurs valeurs par `;`. |
| Responsable fonctionnel | le **collaborateur** | UPN ou e-mail du responsable fonctionnel. Séparer plusieurs valeurs par `;`. |

- Un assistant rattaché à la personne qu’il assiste apparaît dans la zone des assistants plutôt que dans l’équipe. S’il
  dirige lui-même une équipe, il reste dans l’arborescence normale pour que son équipe reste accessible.
- Un assistant dont le responsable est une autre personne apparaît aux deux endroits : dans l’équipe de son responsable
  et à côté de la personne qu’il assiste.
- Les liens fonctionnels apparaissent avec une bordure en pointillé sous le responsable fonctionnel. Un clic mène à la
  position réelle de la personne.
- **Identités hybrides :** gérez les attributs dans votre Active Directory local ; Entra Connect les synchronise.
- **Comptes cloud uniquement :** définissez les attributs dans le centre d’administration Exchange (utilisateur ›
  Autres › Attributs personnalisés) ou avec Microsoft Graph.

Si vous gérez déjà de tels attributs pour un autre outil d’organigramme, ils fonctionnent généralement tels quels.

## Vues (« Views »)

Il existe toujours au moins une vue. À partir de deux, elles apparaissent sous forme d’onglets au-dessus de
l’organigramme. Chaque vue est soit un **organigramme**, soit un **annuaire du personnel**.

**Vues organigramme**

| Paramètre | Remarques |
| --- | --- |
| Tab name | Affiché dans la barre d’onglets. |
| Open the chart on | Le sommet de l’organisation, la personne connectée ou une à trois personnes côte à côte. |
| Chart type | **Classic** (de haut en bas), **Compact** (collaborateurs empilés à partir d’un certain nombre), **Group leaves** (personnes sans collaborateurs sur deux colonnes), **Left to right** (en retrait, comme un explorateur de fichiers), **Bottom to top**. |
| Group reports by | Regroupe l’équipe de chaque responsable par attribut (p. ex. département) avec des en-têtes sur la ligne de liaison. |
| Grouping levels | Nombre de niveaux regroupés sous la ou les personnes de départ. |
| Levels expanded on load | 1 à 6. |
| Show search box | Un champ de recherche dans l’organigramme. |
| Label on the cards | Un attribut affiché comme étiquette colorée sur chaque carte, p. ex. le département. |
| Filters for this view | S’ajoutent aux filtres communs. |
| Theme | Couleurs, style de carte, taille du texte et champs de cette vue, voir [Thèmes](https://orgchart.compleo.ch/fr/docs/configuration/#th%C3%A8mes). Par défaut : le premier thème. |

**Vues annuaire**

| Paramètre | Remarques |
| --- | --- |
| Layout | **Cards** (vignettes) ou **List** (tableau). |
| Sort by | Nom, ou un attribut puis le nom. |
| People per page | 12, 24, 48 ou 96. |
| Filter dropdowns | Attributs utilisables comme filtres ; chaque liste affiche les valeurs restantes avec leur nombre. |
| Show search box | Recherche par nom, fonction, département, société, site et e-mail. |
| Theme | Comme pour les vues organigramme. |

La première vue s’ouvre par défaut. Pour créer un lien vers une vue précise, ajoutez `?orgchartview=<nom de l’onglet>`
à l’adresse de la page ; pour une personne, `?orgchart=<UPN>`.

## Filtres

Les « Common filters (all views) » de la page 2 s’appliquent à toutes les vues ; chaque vue peut ajouter ses propres
règles. Les comptes désactivés et les invités sont toujours exclus.

| Règle | Exemples de valeurs |
| --- | --- |
| Afficher uniquement les personnes dont l’*attribut* est l’une des valeurs | Société : `Contoso SA; Contoso*` |
| Masquer les personnes dont l’*attribut* est l’une des valeurs | Département : `Externe; (empty)` |
| Masquer des comptes (UPN, e-mail ou nom d’affichage) | `svc-*; admin*; *@partner.com` |
| Afficher uniquement les membres du groupe | `Tous les collaborateurs` (nom, e-mail ou ID d’objet ; les groupes imbriqués comptent) |
| Masquer les membres du groupe | `Prestataires externes` |

- Attributs : société, département, site, ville, pays/région, fonction, type d’employé et `extensionAttribute1`–`15`.
- Comparaisons : **est l’une des valeurs** (avec `*` comme joker), **commence par** ou **contient**. La casse est
  ignorée ; `(empty)` correspond à une valeur vide.
- Les règles « masquer » masquent la personne **avec toutes les personnes en dessous**. Les règles « afficher
  uniquement » ignorent les personnes qui ne correspondent pas ; leur équipe remonte au prochain responsable visible.
- Les filtres déterminent l’affichage. Ils ne constituent pas une barrière de sécurité, car l’annuaire est de toute
  façon visible dans d’autres applications Microsoft 365.

## Renommer des valeurs (« Rename values »)

Affiche des valeurs d’attribut sous un autre nom sans modifier Entra ID – par exemple deux sociétés du groupe comme une
seule : attribut **Company**, valeurs à renommer `Contoso Holding SA`, afficher comme `Contoso SA`.

- S’applique partout : cartes, fenêtre de détails, filtres de l’annuaire, tri, regroupement, étiquettes, recherche et
  export.
- Séparer les valeurs par `;`. La casse est ignorée, `*` sert de joker, et `(empty)` donne un nom à une valeur vide.
- Le renommage a lieu avant le filtrage ; les règles de filtre utilisent donc le nouveau nom.

## Affichage (« Display »)

| Paramètre | Par défaut | Remarques |
| --- | --- | --- |
| Show dotted-line reports | activé | |
| Show Teams presence | activé | |
| Scale the chart to fit the web part | désactivé | Fait un zoom arrière automatique pour que tout l’organigramme soit visible. |
| Show the export button (PNG / PDF / CSV) | activé | Désactivé, le bouton d’export est masqué pour tous. |
| Height | 700 px | Dans un onglet Teams, l’organigramme utilise toute la hauteur. |

## Thèmes

Un thème est un ensemble nommé de paramètres de mise en forme. Créez-en autant que nécessaire sous **Themes** à la
page 1 et choisissez-en un pour chaque vue (**Theme** dans les paramètres de la vue). Les vues sans choix utilisent le
premier thème : les nouvelles vues ressemblent donc au reste du composant.

| Paramètre | Remarques |
| --- | --- |
| Theme name | Affiché dans les paramètres des vues. |
| Card style | **Modern** (photo centrée en haut) ou **Classic** (photo à gauche du texte). |
| Text size | Small (90%), Normal, Large (115%) ou Extra large (130%). Les cartes s’agrandissent avec le texte ; les photos gardent leur taille. |
| Card width | 120 à 600 px (220 par défaut). |
| Chart background | Thème de la page, blanc ou une couleur personnalisée. Avec une couleur personnalisée, texte, lignes et gris passent automatiquement en clair ou en foncé. |
| Card colour | Fond des cartes ; le texte passe en noir ou en blanc pour un bon contraste. |
| Highlight, secondary and group header colour | Barre d’accent, lignes de liaison, étiquettes et en-têtes de groupe. Vide = couleur du thème SharePoint. |
| Fields shown under the name | Jusqu’à cinq attributs, dans l’ordre choisi. Les champs vides sont omis. |
| Fields in the details window | Jusqu’à douze attributs ; e-mail et téléphone sont cliquables. |

**Export** et **Import** copient les thèmes sous forme de texte, par exemple dans le composant coOrgChart d’une autre
page. Les thèmes importés s’ajoutent aux thèmes existants ; un nom déjà utilisé reçoit un numéro.