# Premiers pas

> Installer coOrgChart dans votre tenant Microsoft 365 et l’ajouter à une page en quelques minutes.

Web page: https://orgchart.compleo.ch/fr/docs/getting-started/

## Prérequis

- Microsoft 365 avec SharePoint Online et Microsoft Entra ID.
- Un administrateur pouvant ajouter des applications au catalogue SharePoint et approuver des accès API pour tout le
  tenant (par exemple un administrateur SharePoint avec un administrateur général).
- Des pages SharePoint modernes ou Microsoft Teams. SharePoint Server (on-premises) n’est pas pris en charge.

## 1. Ajouter le package au catalogue d’applications

1. [Téléchargez le package coOrgChart](https://orgchart.compleo.ch/download/coorgchart.sppkg) (`coorgchart.sppkg`).
2. Ouvrez le **centre d’administration SharePoint › Plus de fonctionnalités › Applications** et accédez au catalogue
   d’applications.
3. Téléversez le package. Lorsque la question est posée, choisissez de rendre l’application **disponible pour tous les
   sites**.
## 2. Approuver l’accès API

coOrgChart lit votre annuaire avec Microsoft Graph. Après le téléversement, SharePoint affiche trois demandes
d’autorisation. Approuvez-les dans le **centre d’administration SharePoint › Avancé › Accès à l’API** :

| Autorisation | Utilisée pour |
| --- | --- |
| `User.Read.All` | Personnes, responsables, fonctions et autres attributs. |
| `Presence.Read.All` | Présence Teams sur les cartes (facultatif). |
| `GroupMember.Read.All` | Filtres de groupe comme « afficher uniquement les membres du groupe » (facultatif). |

Les trois sont des autorisations déléguées en lecture seule : coOrgChart agit toujours avec les droits de la personne
connectée. Sans `GroupMember.Read.All`, tout fonctionne sauf les filtres de groupe. Plus de détails sous
[Autorisations et sécurité](https://orgchart.compleo.ch/fr/docs/permissions-security/).

## 3. Ajouter coOrgChart à une page

1. Modifiez une page SharePoint moderne et ajoutez une section, idéalement en **pleine largeur**.
2. Cliquez sur **+**, recherchez **coOrgChart** et ajoutez le composant WebPart.
3. Ouvrez les paramètres du composant (icône crayon) pour choisir les vues, filtres, couleurs et champs. Voir
   [Configuration](https://orgchart.compleo.ch/fr/docs/configuration/).
4. Publiez la page.

## Microsoft Teams

Dans le catalogue d’applications, sélectionnez coOrgChart et choisissez **Synchroniser avec Teams**. Vous pouvez
ensuite ajouter coOrgChart comme onglet dans n’importe quelle équipe. Dans un onglet, l’organigramme utilise toute la
hauteur.

## Essai et licence

Chaque tenant peut utiliser coOrgChart gratuitement pendant 30 jours, avec toutes les fonctionnalités et sans rien
saisir. Pour continuer ensuite, saisissez votre clé de licence dans les paramètres du composant. Voir
[Licences](https://orgchart.compleo.ch/fr/docs/licensing/).

## Mises à jour

Téléversez le nouveau package dans le catalogue d’applications et remplacez l’existant. Toutes les pages et tous les
paramètres sont conservés.