Progress Monitoring y Power BI

Este artículo describe cómo funciona la integración de Progress Monitoring con Microsoft Power BI, que permite visualizar los datos de progreso en forma de panel interactivo conectado a la Vista 3D, lo que posibilita la comunicación entre la aplicación web de Cintoo y el informe incrustado.

Consulte Power BI embedded analytics overview - Power BI | Microsoft Learn para obtener la documentación general sobre los informes de Power BI incrustados.

La integración se basa en la función Progress Monitoring de Cintoo, por lo que se requiere un permiso especial: Gestionar el informe de seguimiento del progreso.

TABLA DE CONTENIDOS

• Configuración previa necesaria de Entra ID
• Configuración previa necesaria de Power BI
• Incrustación del informe en Cintoo
• Ejemplo de uso del informe

Configuración previa necesaria de Entra ID

La integración requiere un registro de aplicación en el tenant de Microsoft Entra ID, tal como se describe aquí: Get started with Power BI Embedded - Power BI | Microsoft Learn.

Siga las instrucciones del escenario Embed for your organization.

Al final del proceso, debería aparecer un nuevo App Registration en el tenant de Entra.

En la sección Overview del App Registration, copie el Client ID y el Tenant ID, que se necesitarán más adelante en Cintoo.

En la sección Authentication, agregue una nueva configuración de plataforma de tipo Single-page application.

En Redirect URIs, ingrese https://eu.cintoo.cloud, https://us.cintoo.cloud, https://ca.cintoo.cloud o el nombre del dominio personalizado de Cintoo si la empresa tiene uno ( https://your-organization.cintoo.cloud ), según la ubicación de la cuenta de Cintoo.

Según la configuración de seguridad de Entra, es posible que el administrador de Entra deba conceder el consentimiento de administrador para la organización en la sección API permissions.

El permiso Power BI Service > Report.Real.All es obligatorio para la integración.

Configuración previa necesaria de Power BI

Cree un modelo de Power BI que contenga una tabla llamada CintooModelElements con una columna llamada ModelElementID, que corresponde a la primera columna del informe CIPM. Esto permite que el informe conecte las partes problemáticas del modelo, según el informe CIPM, con la información 3D de Cintoo.

¡Esta es una condición obligatoria para que el informe sea interactivo!

Cree un informe basado en este modelo y publíquelo en el servicio de Power BI.

Anote el Report ID, que se puede encontrar aquí, en la URL del informe.

Incrustación del informe en Cintoo

El icono de Power BI se encuentra en la esquina inferior derecha del visor; haga clic para abrir el cuadro de diálogo de configuración.

Ingrese el Tenant ID, el Client ID y el Report ID obtenidos en los pasos anteriores (configuraciones de Entra ID y de Power BI) y haga clic en Iniciar sesión.

Si el App Registration está configurado correctamente, aparecerá una ventana emergente de inicio de sesión y el informe debería mostrarse tras una autenticación correcta.

Salga del informe de Power BI actual haciendo clic en Cerrar sesión.

Ejemplo de uso del informe

En el informe presentado arriba, las 3 columnas siguientes provienen directamente del informe CIPM:

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

El resto se obtiene de fuentes externas:

• Category
• Level

Estas se utilizan como filtros para acotar la lista de elementos del modelo.

Se puede utilizar cualquier otro dato, como la parte responsable, la etapa del proyecto o cualquier otro, para enriquecer los datos.

Al resaltar un elemento de la lista del informe de la derecha (haciendo clic en él una vez), se activa la acción Foco en la Vista 3D y la cámara se desplaza hasta el elemento del modelo resaltado.

Si el modelo correspondiente está preseleccionado en el Modelo Explorer, el elemento del modelo correspondiente se resaltará en el Explorador de contenido modelo cada vez que se haga clic en él en el informe de Power BI.

También es posible buscar el elemento necesario en el Explorador de contenido modelo copiando su nombre desde el panel de Power BI, agregando el prefijo "label:" y colocando el nombre del archivo buscado entre comillas "example".

Utilice los resultados de Progress Monitoring junto con los informes de Power BI para visualizar los datos que deben revisarse dentro del proyecto de Cintoo. Agregue capas de información para filtrar los datos de una manera más cómoda e inteligente.