Microsoft 365

Diese App ermöglicht den direkten Zugriff auf die Microsoft-365-Plattform in BuildingPro Suites über die Microsoft Graph API.

Name des delegierten Benutzers (bei delegierten Rechten)

Diese App verbindet Räume und andere Ressourcen mit BuildingPro Suites und liefert Informationen zu deren Buchungsstatus. Die wichtigste Funktion der App ist jedoch die Möglichkeit, die gesamte Graph API direkt in BuildingPro Suites zu verwenden, indem die Authentifizierungs-Proxy-Funktionalität genutzt wird.

Installation

Die Microsoft 365 App wird über den BuildingPro Suites App Store installiert.

Assets

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

• Raum: Ein Raum in Azure AD.

• Ausstattung: Ein beliebiges buchbares Ausstattungsobjekt. Wie ein Raum, aber verallgemeinert.

Die folgenden Attribute sind definiert:

Attribut	Beschreibung	Raum	Equipment	Filterbar
Adresse	Physische Adresse	x		x
Spitzname	Spitzname	x		x
Bezeichnung	Bezeichnung	x		x
geo_coordinates	Geo-Koordinaten	x		x
phone	Telefonnummer	x		x
email_address	E-Mail-Adresse	x	x	x
booking_type	Buchungstyp	x		x
building	Gebäude	x		x
capacity	Kapazität	x		x
floor_label	Etagenbezeichnung	x		x
floor_number	Etagennummer	x		x
is_wheel_chair_accessible	Rollstuhlzugänglichkeit	x		x
tags	Schlagwörter	x		x
display_device_name	Name des Anzeigegeräts	x		x
audio_device_name	Name des Audiogeräts	x		x
video_device_name	Name des Videogeräts	x		x
on_schedule	Planmäßig	x	x

Konfiguration

Weitere Informationen zur App-Konfiguration finden Sie ↗ hier.

Die Microsoft 365 App wird durch die Definition einer oder mehrerer Anmeldeinformationen konfiguriert. Die folgenden Daten sind für jede Konfiguration erforderlich:

Attribut	Beschreibung
tenantId	ID oder Domäne des Unternehmens
clientId	Client-ID / Azure AD-Anwendungs-ID
clientSecret	Ein „Client Secret“ (für App-Berechtigungen)
username	Name des delegierten Benutzers (für delegierte Rechte)
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	Schalter zum Aktivieren oder Deaktivieren des Abrufs von dieser API
refreshInterval	Intervall in Sekunden zum Sammeln von Daten von der API
requestTimeout	Zeitüberschreitung für die API-Abfrage in Sekunden
assetFilter	Filter für die Asset-Erstellung, weitere Details finden Sie in der README-Datei der App
tenantIDs	Liste der BuildingPro-Suites-Tenant-IDs, für die dieses Gerät Daten erfassen soll. Alle Assets werden für jede Tenant-ID automatisch in BuildingPro Suites erstellt. Die Zuordnung zu den BuildingPro-Suites-Assets wird in der App als Asset-Mapping gespeichert.

Die Konfiguration muss entweder das Client Secret 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:

[Code hier]

Endpunkte können mit dieser Struktur in BuildingPro Suites unter Apps > Kontakt.io > Einstellungen. Wählen Sie den /configs-Endpunkt mit der POST-Methode aus.

Erforderliche Berechtigungen

Für den grundlegenden Anwendungsfall des Auslesens von Räumen und Geräten sowie deren Verfügbarkeit benötigt die Anwendung die folgenden Anwendungsberechtigungen:

• Place.Read.All

• User.Read.All

• Calendars.Read