Progress Monitoring & Power BI

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 und die Kommunikation zwischen der Cintoo-Webanwendung und dem eingebetteten Bericht herstellt.

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 CintooModelElements und einer Spalte namens ModelElementID, die der ersten Spalte des CIPM-Berichts entspricht. Dadurch kann der Bericht problematische Teile des Modells gemäß dem CIPM-Bericht mit den 3D-Informationen 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 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 Anmelde-Popup 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 stammen die folgenden 3 Spalten direkt aus dem CIPM-Bericht:

• ModelElementID (obligatorisch)
• Model Element Name
• Coverage (%)

Der Rest stammt aus externen Quellen:

• Category
• Level

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

Alle weiteren Daten, etwa der Verantwortliche, die Projektphase oder Sonstiges, können zur Anreicherung der Daten verwendet werden.

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 Modellelement.

Ist das entsprechende Modell im Modell-Explorer vorab ausgewählt, wird das entsprechende Modellelement jedes Mal im Modellinhalts-Explorer hervorgehoben, wenn es im Power-BI-Bericht angeklickt wird.

Sie können das benötigte Element auch im Modellinhalts-Explorer suchen, indem Sie seinen Namen aus dem Power-BI-Dashboard kopieren, das Präfix „label:“ hinzufügen und den Namen der gesuchten Datei in Klammern "example" angeben.

Nutzen Sie die Ergebnisse von Progress Monitoring in Verbindung mit dem Power-BI-Reporting, um die Daten zu visualisieren, die innerhalb des Cintoo-Projekts überprüft werden müssen. Fügen Sie Informationsebenen hinzu, um die Daten bequemer und intelligenter zu filtern.