Microsoft 365

Diese App ermöglicht den Zugriff auf die Microsoft 365 Plattform direkt in Eliona unter Verwendung der Microsoft Graph API.

Name des delegierten Benutzers (bei delegierten Rechten)

Diese App verbindet Zimmer und andere Ressourcen mit Eliona und liefert Informationen über deren Buchungsstatus. Die wichtigste Fähigkeit der App ist jedoch die Möglichkeit, die gesamte Graph-API direkt in Eliona zu nutzen, indem die Authentifizierungs-Proxy-Funktionalität verwendet wird.

Installation

Die Microsoft 365 App wird über den App Store in Eliona installiert.

Assets

Die Microsoft 365 App erstellt automatisch alle notwendigen Asset-Typen und Assets, die über die konfigurierten Endpunkte zugänglich sind. Die folgenden Asset-Typen werden erstellt:

• Raum: Ein Raum in Azure AD.

• Ausrüstung: Jedes Stück Ausrüstung, das gebucht werden kann. Wie ein Raum, aber verallgemeinert.

Die folgenden Attribute sind definiert:

Attribute	Beschreibung	Raum	Ausrüstung	Filterbar
address	Physische Adresse	x		x
nickname	Spitzname	x		x
label	Label	x		x
geo_coordinates	Geokoordinaten	x		x
phone	Rufnummer	x		x
email_address	Email Addresse	x	x	x
booking_type	Buchungsart	x		x
building	Gebäude	x		x
capacity	Kapazität	x		x
floor_label	Boden-Etikett	x		x
floor_number	Stockwerk Nummer	x		x
is_wheel_chair_accessible	Zugänglichkeit für Rollstühle	x		x
tags	Tags	x		x
display_device_name	Gerätename anzeigen	x		x
audio_device_name	Name des Audiogeräts	x		x
video_device_name	Name des Videogeräts	x		x
on_schedule	Im Zeitplan	x	x

Konfiguration

Mehr Informationen zur Konfiguration von Apps finden Sie ↗ hier.

Die Microsoft 365 App wird durch die Definition eines oder mehrerer Authentifizierungsnachweise konfiguriert. Für jede Konfiguration sind die folgenden Daten erforderlich:

Attribute	Beschreibung
tenantId	ID oder Domain des Unternehmens
clientId	ClientID / Azure AD-Anwendungs-ID
clientSecret	Ein "App-Passwort" (für App-Berechtigungen)
username	Name des delegierten Benutzers (bei delegierten Rechten)
password	Passwort des delegierten Benutzers (für delegierte Berechtigungen)
forEliona	Gibt an, ob die Konfiguration für die Asset-Erstellung verwendet werden soll
forProxy	Gibt an, ob die Konfiguration für das App-Frontend und die Proxy-API verwendet werden soll
enable	Flagge zum Aktivieren oder Deaktivieren des Abrufs von dieser API
refreshInterval	Intervall in Sekunden für das Sammeln von Daten von der API
requestTimeout	API-Abfrage-Timeout in Sekunden
assetFilter	Filter für die Asset-Erstellung, weitere Details finden Sie in der README der App
projectIDs	Liste der Eliona-Projekt-IDs, für die dieses Gerät Daten sammeln soll. Für jede Projekt-ID werden automatisch alle Assets in Eliona erstellt. Die Zuordnung zu Eliona-Assets wird als Asset-Zuordnung in der App gespeichert.

Die Konfiguration muss entweder das Client-Geheimnis für App-Berechtigungen oder die Benutzeranmeldedaten für delegierte Berechtigungen enthalten. Die Konfiguration erfolgt über eine entsprechende JSON-Struktur. Als Beispiel kann die folgende JSON-Struktur verwendet werden, um einen Endpunkt für App-Berechtigungen zu definieren:

{
  "clientId": "adasf8676a-example-client-id-asfd2867130",
  "clientSecret": "8nx-8Kelionathebestwfmbsdiurnc987vcu",
  "tenantId": "tenant-id",
  "username": "",
  "password": "",
  "enable": true,
  "refreshInterval": 60,
  "requestTimeout": 120,
  "assetFilter": [],
  "projectIDs": [
    "10"
  ]
}

Endpunkte können mit dieser Struktur in Eliona unter Apps > Kontakt.io > Settings angelegt werden. Wählen Sie dazu den Endpunkt /configs mit der Methode POST.

Erforderliche Privilegien

Für den grundlegenden Anwendungsfall der Lesesäle und -geräte und deren Verfügbarkeit benötigt die Anwendung folgende Anwendungsberechtigungen:

• Place.Read.All

• User.Read.All

• Calendars.Read