# Konfiguration

> Ansichten, Filter, Assistenzen, Dotted-Line-Vorgesetzte, umbenannte Werte, Anzeige und Themes in coOrgChart.

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

Bearbeiten Sie die Seite und klicken Sie auf das Stiftsymbol des Webparts, um die Einstellungen zu öffnen. **Seite 1**
enthält Daten, Anzeige und Themes, **Seite 2** die Ansichten, die gemeinsamen Filter und die umbenannten Werte.
Die Einstellungen des Webparts sind derzeit auf Englisch; die Bezeichnungen stehen deshalb hier in Englisch.

## Daten («Data»)

| Einstellung | Hinweise |
| --- | --- |
| Assistant attribute | Das Entra-ID-Erweiterungsattribut (`extensionAttribute1`–`15`) mit den Assistenzen, siehe unten. |
| Dotted-line manager attribute | Das Erweiterungsattribut mit den Dotted-Line-Vorgesetzten, siehe unten. |
| Additional employees list | Eine SharePoint-Liste mit Personen ausserhalb von Entra ID. Siehe [Zusätzliche Mitarbeitende](https://orgchart.compleo.ch/de/docs/additional-employees/). |
| Hide people without manager and without reports | Standardmässig ein. Blendet Dienstkonten, Sitzungszimmer und Ähnliches aus. |
| Cache directory in the browser | 0 bis 72 Stunden (Standard 12). Bei 0 werden die Daten bei jedem Besuch neu geladen. |
| Reload data now | Umgeht den Cache, zum Beispiel nach Änderungen in Entra ID. |

## Assistenzen und Dotted-Line-Vorgesetzte

coOrgChart liest diese Beziehungen aus zwei Erweiterungsattributen Ihrer Wahl:

| Beziehung | Eingetragen bei | Wert |
| --- | --- | --- |
| Assistenz | der **Führungskraft** | UPN oder E-Mail der Assistenz. Mehrere mit `;` trennen. |
| Dotted-Line-Vorgesetzte | der **mitarbeitenden Person** | UPN oder E-Mail der Dotted-Line-Vorgesetzten. Mehrere mit `;` trennen. |

- Eine Assistenz, die der unterstützten Person unterstellt ist, erscheint im Assistenzbereich statt im Team. Leitet die
  Assistenz selbst ein Team, bleibt sie im normalen Baum, damit ihr Team erreichbar bleibt.
- Eine Assistenz mit einer anderen vorgesetzten Person erscheint an beiden Orten: im Team ihrer Vorgesetzten und neben
  der Person, die sie unterstützt.
- Dotted-Line-Mitarbeitende erscheinen mit gestricheltem Rahmen unter ihrer Dotted-Line-Vorgesetzten. Ein Klick springt
  zur eigentlichen Position der Person.
- **Hybride Identitäten:** Pflegen Sie die Attribute im lokalen Active Directory; Entra Connect synchronisiert sie.
- **Reine Cloud-Konten:** Setzen Sie die Attribute im Exchange Admin Center (Benutzer › Andere › Benutzerdefinierte
  Attribute) oder mit Microsoft Graph.

Wenn Sie solche Attribute bereits für ein anderes Organigramm-Tool pflegen, funktionieren sie meist unverändert.

## Ansichten («Views»)

Es gibt immer mindestens eine Ansicht. Ab zwei Ansichten erscheinen sie als Registerkarten über dem Organigramm. Jede
Ansicht ist entweder ein **Organigramm** oder ein **Mitarbeiterverzeichnis**.

**Organigramm-Ansichten**

| Einstellung | Hinweise |
| --- | --- |
| Tab name | In der Registerkartenleiste angezeigt. |
| Open the chart on | Die Spitze der Organisation, die angemeldete Person oder ein bis drei bestimmte Personen nebeneinander. |
| Chart type | **Classic** (von oben nach unten), **Compact** (Mitarbeitende ab einer bestimmten Anzahl untereinander), **Group leaves** (Personen ohne Mitarbeitende in zwei Spalten), **Left to right** (eingerückt wie ein Datei-Explorer), **Bottom to top**. |
| Group reports by | Gruppiert das Team jeder Führungskraft nach einem Attribut (z. B. Abteilung) mit Überschriften auf der Verbindungslinie. |
| Grouping levels | Wie viele Ebenen unter der Startperson gruppiert werden. |
| Levels expanded on load | 1 bis 6. |
| Show search box | Ein Suchfeld im Organigramm. |
| Label on the cards | Ein Attribut als farbiges Label auf jeder Karte, z. B. die Abteilung. |
| Filters for this view | Ergänzen die gemeinsamen Filter. |
| Theme | Farben, Kartenstil, Schriftgrösse und Felder dieser Ansicht, siehe [Themes](https://orgchart.compleo.ch/de/docs/configuration/#themes). Standard: das erste Theme. |

**Verzeichnis-Ansichten**

| Einstellung | Hinweise |
| --- | --- |
| Layout | **Cards** (Kacheln) oder **List** (Tabelle). |
| Sort by | Name oder ein Attribut, danach Name. |
| People per page | 12, 24, 48 oder 96. |
| Filter dropdowns | Attribute, nach denen gefiltert werden kann; jede Liste zeigt die verbleibenden Werte mit Anzahl. |
| Show search box | Suche über Name, Funktion, Abteilung, Firma, Standort und E-Mail. |
| Theme | Wie bei den Organigramm-Ansichten. |

Die erste Ansicht öffnet sich standardmässig. Für einen Link auf eine bestimmte Ansicht ergänzen Sie die Seiten-URL um
`?orgchartview=<Name der Registerkarte>`, für eine bestimmte Person um `?orgchart=<UPN>`.

## Filter

Die «Common filters (all views)» auf Seite 2 gelten für alle Ansichten; jede Ansicht kann eigene Regeln ergänzen.
Deaktivierte Konten und Gäste werden immer ausgeschlossen.

| Regel | Beispielwerte |
| --- | --- |
| Nur Personen anzeigen, deren *Attribut* einer der Werte ist | Firma: `Contoso AG; Contoso*` |
| Personen ausblenden, deren *Attribut* einer der Werte ist | Abteilung: `Extern; (empty)` |
| Konten ausblenden (UPN, E-Mail oder Anzeigename) | `svc-*; admin*; *@partner.com` |
| Nur Mitglieder der Gruppe anzeigen | `Alle Mitarbeitenden` (Name, E-Mail oder Objekt-ID; verschachtelte Gruppen zählen) |
| Mitglieder der Gruppe ausblenden | `Externe Auftragnehmer` |

- Attribute: Firma, Abteilung, Standort, Ort, Land/Region, Funktion, Mitarbeitertyp und `extensionAttribute1`–`15`.
- Vergleiche: **ist einer von** (mit `*` als Platzhalter), **beginnt mit** oder **enthält**. Gross-/Kleinschreibung
  spielt keine Rolle; `(empty)` passt auf einen leeren Wert.
- «Ausblenden»-Regeln blenden die Person **zusammen mit allen Personen darunter** aus. «Nur anzeigen»-Regeln
  überspringen Personen, die nicht passen; ihr Team rückt zur nächsten sichtbaren Führungskraft auf.
- Filter steuern die Anzeige. Sie sind keine Sicherheitsgrenze, denn das Verzeichnis ist in anderen Microsoft-365-Apps
  ohnehin sichtbar.

## Werte umbenennen («Rename values»)

Zeigt Attributwerte unter einem anderen Namen an, ohne Entra ID zu ändern – zum Beispiel zwei Gruppengesellschaften als
eine: Attribut **Company**, umzubenennende Werte `Contoso Holding AG`, anzeigen als `Contoso AG`.

- Gilt überall: Karten, Detailfenster, Verzeichnisfilter, Sortierung, Gruppierung, Labels, Suche und Export.
- Werte mit `;` trennen. Gross-/Kleinschreibung spielt keine Rolle, `*` ist ein Platzhalter, und `(empty)` gibt einem
  leeren Wert einen Namen.
- Das Umbenennen geschieht vor dem Filtern; Filterregeln verwenden also den neuen Namen.

## Anzeige («Display»)

| Einstellung | Standard | Hinweise |
| --- | --- | --- |
| Show dotted-line reports | ein | |
| Show Teams presence | ein | |
| Scale the chart to fit the web part | aus | Zoomt automatisch heraus, damit das ganze Organigramm sichtbar ist. |
| Show the export button (PNG / PDF / CSV) | ein | Aus blendet die Export-Schaltfläche für alle aus. |
| Height | 700 px | In einem Teams-Tab nutzt das Organigramm die volle Höhe. |

## Themes

Ein Theme ist eine benannte Sammlung von Formatierungseinstellungen. Legen Sie auf Seite 1 unter **Themes** so viele
an, wie Sie brauchen, und wählen Sie für jede Ansicht eines aus (**Theme** in den Einstellungen der Ansicht). Ansichten
ohne Auswahl verwenden das erste Theme – neue Ansichten sehen also aus wie der Rest des Webparts.

| Einstellung | Hinweise |
| --- | --- |
| Theme name | Erscheint in den Einstellungen der Ansichten. |
| Card style | **Modern** (Foto oben zentriert) oder **Classic** (Foto links vom Text). |
| Text size | Small (90%), Normal, Large (115%) oder Extra large (130%). Die Karten wachsen mit der Schrift; Fotos behalten ihre Grösse. |
| Card width | 120 bis 600 px (Standard 220). |
| Chart background | Seitendesign, Weiss oder eine eigene Farbe. Bei einer eigenen Farbe wechseln Schrift, Linien und Grautöne automatisch zwischen hell und dunkel. |
| Card colour | Kartenhintergrund; die Schrift wechselt für guten Kontrast zwischen Schwarz und Weiss. |
| Highlight, secondary and group header colour | Akzentbalken, Verbindungslinien, Labels und Gruppenüberschriften. Leer bedeutet SharePoint-Designfarbe. |
| Fields shown under the name | Bis zu fünf Attribute in der gewählten Reihenfolge. Leere Felder werden weggelassen. |
| Fields in the details window | Bis zu zwölf Attribute; E-Mail und Telefon sind anklickbar. |

**Export** und **Import** kopieren Themes als Text, zum Beispiel in das coOrgChart-Webpart auf einer anderen Seite.
Importierte Themes kommen zu den vorhandenen hinzu; ein bereits vorhandener Name erhält eine Nummer.