Tags & Power BI

Die Cintoo-Power-BI-Integration ist eine Funktion, mit der Cintoo-Nutzer einen eingebetteten Power-BI-Bericht in der 3D-Ansicht von Cintoo anzeigen können und die die Kommunikation zwischen der Cintoo-Webanwendung und dem eingebetteten Bericht ermöglicht.

Dieser Artikel beschreibt, wie die Integration von Progress Monitoring und Microsoft Power BI funktioniert. Sie ermöglicht es, Fortschrittsdaten in Form eines interaktiven Dashboards zu visualisieren, das mit der 3D-Ansicht verbunden ist.

Allgemeine Dokumentation zu eingebetteten Power-BI-Berichten finden Sie unter Power BI embedded analytics overview - Power BI | Microsoft Learn.

Die Integration basiert auf der Funktion Progress Monitoring in Cintoo, daher ist die spezielle Berechtigung „Verwalten Sie den Fortschrittsüberwachungsbericht“ erforderlich.

INHALTSVERZEICHNIS

• Voraussetzung: Entra-ID-Konfiguration
• Voraussetzung: Power-BI-Konfiguration
• Einbetten des Berichts in Cintoo
• Beispiel für die Nutzung des Berichts

Voraussetzung: Entra-ID-Konfiguration

Die Integration erfordert eine App-Registrierung im Microsoft-Entra-ID-Tenant, wie hier beschrieben: Get started with Power BI Embedded - Power BI | Microsoft Learn.

Folgen Sie den Anweisungen für das Szenario Embed for your organization.

Am Ende des Vorgangs sollte im Entra-Tenant eine neue App Registration erscheinen.

Kopieren Sie im Abschnitt Overview der App Registration die Client ID und die Tenant ID, die später in Cintoo benötigt werden.

Fügen Sie im Abschnitt Authentication eine neue Plattformkonfiguration vom Typ Single-page application hinzu.

Tragen Sie unter Redirect URIs https://aec.cintoo.com, https://us.cintoo.cloud, https://ca.cintoo.cloud oder den Namen der benutzerdefinierten Cintoo-Domain ein, sofern das Unternehmen eine besitzt (https://your-organization.cintoo.cloud), je nach Standort des Cintoo-Kontos.

Abhängig von der Entra-Sicherheitskonfiguration muss der Entra-Administrator möglicherweise im Abschnitt „API permissions“ die Administratoreinwilligung für die Organisation erteilen.

Die Berechtigung Power BI Service > Report.Real.All ist für die Integration zwingend erforderlich.

Voraussetzung: Power-BI-Konfiguration

Erstellen Sie ein Power-BI-Modell mit einer Tabelle namens CintooTags und einer Spalte namens ID (in Großbuchstaben), die der Tag-ID in Cintoo entspricht. Dadurch kann der Bericht die Tags im Bericht mit den Tags in Cintoo verknüpfen.

Dies ist eine zwingende Voraussetzung dafür, dass der Bericht interaktiv ist!

Erstellen Sie auf Basis dieses Modells einen Bericht und veröffentlichen Sie ihn im Power-BI-Dienst.

Notieren Sie sich die Report ID, die Sie hier in der URL des Berichts finden können.

Einbetten des Berichts in Cintoo

Das Power BI-Symbol befindet sich in der unteren rechten Ecke des Viewers. Klicken Sie darauf, um den Einstellungsdialog zu öffnen.

Geben Sie die Tenant ID, die Client ID und die Report ID ein, die Sie in den vorherigen Schritten erfasst haben (Konfigurationen von Entra ID und Power BI), und klicken Sie auf Anmeldung.

Wenn die App Registration korrekt konfiguriert ist, wird ein Pop-up-Fenster zur Anmeldung angezeigt, und der Bericht sollte nach erfolgreicher Authentifizierung erscheinen.

Beenden Sie den aktuellen Power-BI-Bericht, indem Sie auf Abmeldung klicken.

Beispiel für die Nutzung des Berichts

Im oben dargestellten Bericht verknüpft die Spalte ID die Tags in der 3D-Ansicht mit denen im Bericht.

Die übrigen Felder stammen aus externen Quellen und dienen der Anreicherung der Daten:

• Location
• Material
• System
• IoT

Diese werden als Filter verwendet, um die Liste der Tags einzugrenzen.

Das Hervorheben eines Elements in der Berichtsliste auf der rechten Seite (durch einmaliges Anklicken) löst die Aktion Fokus in der 3D-Ansicht aus und bewegt die Kamera zum hervorgehobenen Tag.

Wählen Sie ein oder mehrere Tags im Tag-Explorer oder ein einzelnes Tag in der 3D-Ansicht aus, um sie mit dem Power-BI-Bericht zu synchronisieren.

Im Bericht wird dynamisch ein Seitenfilter mit der Liste der ausgewählten Tags erstellt.

Sie können das benötigte Tag auch im Tag-Explorer suchen, indem Sie seinen Namen aus dem Power-BI-Dashboard kopieren und in die Suchleiste einfügen.

Anwendungsfälle

Der obige Artikel zeigt einen Anwendungsfall für die Tag-Navigation innerhalb der Benutzeroberfläche von Cintoo Twin. Die Möglichkeiten des Power-BI-Dashboards sind jedoch umfangreich, und das volle Potenzial hängt vom Zugriff auf Data Lake und IoT ab. Einige Beispiele für die aktuelle Nutzung durch Kunden:

• Live-IoT-Daten („On / Off“) aus Azure IoT in die Tag-Umgebung von Cintoo streamen.
• Technische 2D-Daten im PDF-Format mithilfe eines PDF-Viewers in Power BI streamen.
• Verschiedene gespeicherte Progress-Monitoring-Berichte und gestaffelte Fortschrittsstände vergleichen.
• Entwurfssimulationen laden und visualisieren sowie die zugehörigen BIM-Modelle in 3D visualisieren

Das volle Potenzial der Integration ist noch nicht ausgeschöpft. Wenden Sie sich an unser Support-Team unter support@cintoo.com, um zu erfahren, wie Power BI Ihre Produktivität steigern kann.