# Erste Schritte

> coOrgChart in wenigen Minuten in Ihrem Microsoft-365-Tenant installieren und auf einer Seite einfügen.

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

## Voraussetzungen

- Microsoft 365 mit SharePoint Online und Microsoft Entra ID.
- Eine Administratorin oder ein Administrator, die Apps in den SharePoint-App-Katalog laden und API-Zugriffe für den
  ganzen Tenant genehmigen können (zum Beispiel SharePoint-Administrator zusammen mit globalem Administrator).
- Moderne SharePoint-Seiten oder Microsoft Teams. SharePoint Server (on-premises) wird nicht unterstützt.

## 1. Paket in den App-Katalog laden

1. Laden Sie das [coOrgChart-Paket](https://orgchart.compleo.ch/download/coorgchart.sppkg) (`coorgchart.sppkg`) herunter.
2. Öffnen Sie im **SharePoint Admin Center › Weitere Features › Apps** den App-Katalog.
3. Laden Sie das Paket hoch. Wählen Sie auf Nachfrage, dass die App **für alle Websites verfügbar** sein soll.
## 2. API-Zugriff genehmigen

coOrgChart liest Ihr Verzeichnis mit Microsoft Graph. Nach dem Hochladen zeigt SharePoint drei Berechtigungsanfragen.
Genehmigen Sie sie im **SharePoint Admin Center › Erweitert › API-Zugriff**:

| Berechtigung | Verwendet für |
| --- | --- |
| `User.Read.All` | Personen, Vorgesetzte, Funktionen und weitere Attribute. |
| `Presence.Read.All` | Teams-Status auf den Karten (optional). |
| `GroupMember.Read.All` | Gruppenfilter wie «nur Mitglieder der Gruppe anzeigen» (optional). |

Alle drei sind delegierte, rein lesende Berechtigungen: coOrgChart handelt immer mit den Rechten der angemeldeten
Person. Ohne `GroupMember.Read.All` funktioniert alles ausser den Gruppenfiltern. Details finden Sie unter
[Berechtigungen und Sicherheit](https://orgchart.compleo.ch/de/docs/permissions-security/).

## 3. coOrgChart auf einer Seite einfügen

1. Bearbeiten Sie eine moderne SharePoint-Seite und fügen Sie einen Abschnitt hinzu, idealerweise in **voller Breite**.
2. Klicken Sie auf **+**, suchen Sie nach **coOrgChart** und fügen Sie das Webpart ein.
3. Öffnen Sie die Webpart-Einstellungen (Stiftsymbol), um Ansichten, Filter, Farben und Felder festzulegen. Siehe
   [Konfiguration](https://orgchart.compleo.ch/de/docs/configuration/).
4. Veröffentlichen Sie die Seite.

## Microsoft Teams

Wählen Sie coOrgChart im App-Katalog aus und klicken Sie auf **Mit Teams synchronisieren**. Danach können Sie
coOrgChart in jedem Team als Tab hinzufügen. Im Tab nutzt das Organigramm die volle Höhe.

## Testphase und Lizenz

Jeder Tenant kann coOrgChart 30 Tage lang kostenlos nutzen, mit allen Funktionen und ohne Eingaben. Danach geben Sie
Ihren Lizenzschlüssel in den Webpart-Einstellungen ein. Siehe [Lizenzierung](https://orgchart.compleo.ch/de/docs/licensing/).

## Updates

Laden Sie das neue Paket in den App-Katalog und ersetzen Sie das bestehende. Alle Seiten und Einstellungen bleiben
erhalten.