Saltar al contenido principal
Procore

Introducción a Analytics 2.0 (Beta)

  1. Última actualización
  2. Guardar como PDF

Tabla de contenido

Resumen

 En versión beta
Los clientesexistentes de Analytics tienen la oportunidad de participar en la Beta Abierta para Analytics 2.0.  Póngase en contacto con su gestor de éxito del cliente para más información.

Analytics 2.0 proporciona una solución potente y fácil de usar para aprovechar los datos de su proyecto, tomar decisiones informadas y obtener información más detallada sobre el rendimiento y los resultados generales de su proyecto.  

Las características principales incluyen:

  • Datos actualizados cada hora que puede extraer en cualquier momento. Además, los datos se supervisan para verificar su precisión e integridad.
  • Se pueden extraer todos los datos de Procore, incluidos los campos personalizados, los flujos de trabajo, el historial de cambios actividad del usuario.*
  • Nueva plataforma de datos con una escalabilidad y disponibilidad de datos significativamente mayores.
  • Informes preconstruidos de Power BI.

*Todos los conjuntos de datos no estarán disponibles al inicio de la beta abierta. La paridad completa de funciones con Analytics 1.0 estará disponible próximamente.

 

 

Consideraciones

  • Puede seguir utilizando la versión actual de Procore Analytics, incluso si opta por la versión beta abierta para Analytics 2.0.
        
  • Si no ves la llamada para unirte a la versión beta abierta, es posible que otro Administrador de la empresa ya haya rechazado el acuerdo de la versión beta.
        
  • Para reactivar la invitación, póngase en contacto con su Gerente de Éxito del Cliente para la reactivación.
        
  • Si tiene problemas para conectarse a Procore Analytics 2.0, póngase en contacto con su gestor de éxito del cliente de Procore.

Preguntas habituales

¿Con qué frecuencia se actualizan los datos?

Los datos se actualizan a lo largo del día por horas.  

¿Cómo me conecto a Procore Analytics 2.0?

Se puede acceder a Analytics 2.0 de varias maneras. La forma más común sería conectarse en Power BI. Consulte Primeros pasos con Procore Analytics 2.0.  

¿Perderé el acceso a los informes existentes?

Procore Analytics 1.0 estará disponible hasta 2025. Nuestro objetivo es dar a los usuarios tiempo suficiente para cambiar a Analytics 2.0.

¿Los clientes de Data Extract tendrán que migrar a Procore Analytics 2.0?

Sí, los clientes de Data Extract deberán pasar a Procore Analytics 2.0, ahora llamado Cloud Connector (impulsado por Delta Share).    Procore Analytics 2.0 también incluirá informes de PowerBI como una función que los clientes no están obligados a usar, pero estarán disponibles para todos los clientes con Procore Analytics 2.0.

¿Todavía necesito licencias de Power BI para acceder a Procore Analytics2.0?

Se seguirán necesitando licencias de Power BI para compartir informes de Power BI.  

¿Cómo actualizo los informes personalizados desarrollados internamente?

Procore Analytics 2.0 ahora utiliza Databricks Delta Sharing. Se debe cambiar cualquier conexión existente con Analytics 1.0 (Azure SQL). Se ha cambiado el nombre de varias tablas y columnas de informes. Los cambios básicos que deberá realizar incluyen la actualización de los informes para usar el nuevo conector Delta Sharing, la actualización de los nombres de tablas y columnas, y la actualización de las imágenes que pueden haberse roto después de realizar los cambios mencionados anteriormente.  Dependiendo de cómo se haya creado su informe, puede haber consideraciones adicionales. Consulte Introducción a Procore Analytics 2.0.  

¿Cómo se verá afectado el proceso de copia de datos en mi almacén de datos por 2.0?

Procore Analytics 2.0 ahora utiliza Databricks Delta Sharing para el acceso a los datos. Puede obtener más información sobre el intercambio de deltas aquí.        

 

Si tiene más preguntas o inquietudes sobre Procore Analytics 2.0, póngase en contacto con el Grupo de la comunidad beta de Analytics 2.0.  

Permisos

 

Permisos

Acción Ninguno Solo lectura Estándar Administrador Notas

Generar un token de datos

  Web

       check-green2.png

Cualquier persona con acceso de nivel 'Administrador' a Analytics puede conceder acceso a usuarios adicionales a la herramienta Analytics.  

 

Obtener acceso a sus datos de Procore

Para comenzar a acceder a sus datos de Procore, debe generar un token de acceso. El token de acceso es una cadena de dígitos que introducirá en su sistema de BI para acceder a los datos.  Por lo general, los usuarios que necesitan tokens de acceso son ingenieros de datos o desarrolladores de Power BI.  

 

Consideraciones

  • Debe tener habilitada la herramienta Procore Analytics.  
  • Para habilitar Analytics 2.0, un Administrador de la empresa primero debe aceptar el acuerdo Open Beta.
  • De forma predeterminada, todos los administradores de la empresa tienen acceso a nivel de 'Administrador' a Analytics en el directorio.  
  • Cualquier persona con acceso de nivel 'Administrador' a Analytics puede conceder acceso a usuarios adicionales a la herramienta Analytics.  
  • Los usuarios deben tener acceso 'Administrador' a la herramienta Analytics para generar un token de datos.  

Pasos

Aceptar el acuerdo beta y activarlo

Una vez invitado a la versión beta abierta, los administradores de la empresa verán un banner emergente que lo invitará a aceptar el acuerdo de la versión beta la próxima vez que inicie sesión en Procore. Si no ve la ventana emergente, es posible que otro Administrador la empresa ya haya rechazado el acuerdo beta. Póngase en contacto con su gestor de éxito del cliente para que lo reactiven.

Otorgar a los usuarios finales Administrador a Analytics 2.0

Una vez que cualquier Administrador la empresa acepte el acuerdo beta, todos los administradores de la empresa verán Procore Analytics en el menú desplegable de la herramienta dentro de Procore. Para añadir administradores de Analytics (por ejemplo, alguien en TI, o un analista de datos) para ayudarlo con sus próximos pasos, vaya a la tarjeta de directorio de nivel de empresa del usuario y dele acceso de nivel de administrador a la herramienta de análisis.

Conectar a sus datos  

Cualquier persona con acceso a nivel de administrador a la herramienta Analytics podrá generar tokens de acceso a datos a través de la herramienta Analytics. Los usuarios finales de datos deben generar tokens de datos y luego deberán seguir los pasos adicionales en la siguiente sección de esta guía para conectar los datos a un almacén de datos o solución de BI. Para comenzar a conectar sus datos, siga los pasos a continuación:

  1. Inicie sesión en Procore.  
  2. Haga clic en el icono Cuenta y perfil  en la barra de navegación.
  3. Haga clic en Configuración de mi perfil.  
  4. Haga clic en la pestaña Tokens de Procore Analytics .   
  5. A continuación, elegirá su conexión con Procore Analytics.
  6. Si tiene Databricks, introduzca su identificador y haga clic en Conectar.
  7. Elija qué tipo de token generará.
  8. Haga clic en Generar token.
    Nota: El token desaparecerá después de una hora o si se navega fuera de la página. Para generar un nuevo token, vuelva al Paso 1.  
  9. La siguiente sección de esta guía lo ayudará a conectarse a su solución descendente.

Conectar a Power BI

Conectar con modelos analíticos

Descargar archivo de credenciales

  1. Cree un archivo llamado 'config.share.
  2. Añade los siguientes campos:
    {
    "shareCredentialsVersion": 1,
            "bearerToken": "",
            "endpoint": "",
            "expirationTime": ""
    }
  3. Añada los valores bearerToken, endpoint, shareCredentialsVersion y expirationTime recibidos de Procore al archivo config.share.

Ejecutar script user_exp.py

Puede utilizar los siguientes scripts para crear un archivo config.yaml con las configuraciones necesarias.  

  • Para Azure Storage:
    cron_job: #true/false
    run_as: #pyspark/python
    source_config:
        config_path: #path to the config.share file
        tables:
        - '' # nombre de tabla si desea descargar una tabla específica. Déjelo vacío si desea descargar todas las tablas
    source_type: delta_share
    target_config:
        auth_type: service_principal
        client_id: #client_id
        secret_id: #secret_id
        storage_account: # storage-account name
        storage_path: #<container>@<storage-account>.dfs.core.windows.net/<directory>
          id_inquilino: # id_inquilino
    tipo_objetivo: almacenamiento_azul
  • Para MSSQL DB:
    cron_job: #true/false
    run_as: #pyspark/python
    source_config:
        config_path: #path to the config.share file
        tables:
            - '' # nombre de tabla si desea descargar una tabla específica. Déjelo vacío si desea descargar todas las tablas
    source_type: delta_share
    target_config:   database:
        #target database
        host: #target hostname:port
        password: #password
        schema: #target schema (default to procore_analytics)
        username: #username
    target_type: sql_server

Ejecutar como PySpark

Si su entorno ya está configurado con Spark, elija la opción 'pyspark' cuando se solicite o una vez que se genere el 'config.yaml', puede ejecutar los siguientes comandos para descargar los informes al directorio de datos.

  • Para escribir en ADLS Gen2 Storage:
    spark-submit --packages io.delta:delta-sharing-spark_2.12:3.1.0,org.apache.hadoop:hadoop-azure:3.4.0,com.microsoft.azure:azure-storage:8.6.6,org.apache.hadoop:hadoop-common:3.4.0 --exclude-packages com.sun.xml.bind:jaxb-impl delta_share_to_sql_spark.py
  • Para escribir en MSSQL DB:
    spark-submit --packages io.delta:delta-sharing-spark_2.12:3.1.0 --jars <Ubicación de mssql-jdbc jar> delta_share_to_sql_spark.py

Ejecutar como Python

  1. Desde la línea de comandos, vaya a la carpeta introduciendo el comando "cd <path to the folder>".
  2. Instale los paquetes requeridos utilizando "pip install -r requirements.txt" o “python -m pip install -r requirements.txt”.
  3. Abra SSIS y cree un nuevo proyecto.
  4. Desde la caja de herramientas de SSIS arrastrar y soltar Ejecutar tarea de proceso.
  5. Haga doble clic en Ejecutar tarea de proceso.
  6. Vaya a la pestaña Proceso.
  7. Junto a Ejecutable, introduzca la ruta a python.exe en la carpeta de instalación de Python.
  8. En WorkingDirectory, introduzca la ruta a la carpeta que contiene el script que desea ejecutar (sin el nombre del archivo de script).
  9. En Arguments, escriba el nombre del script delta_share_to_azure_panda.py que desea ejecutar con .py y haga clic en Guardar.
  10. Haga clic en Iniciar en el menú superior de la cinta.
  11. Durante la ejecución de la tarea, la salida de la consola de Python se muestra en la ventana de la consola externa.
  12. Una vez realizada la tarea, se mostrará una marca de verificación.

Elija su propio método

Delta Sharing es un protocolo abierto para compartir datos de forma segura. Puede encontrar el repositorio público de GitHub para Delta Sharing en https://github.com/delta-io/delta-sharing. El repositorio incluye ejemplos y documentación para acceder a datos compartidos utilizando varios lenguajes como Python y Spark Connector (SQL, Python, Scala, Java, R).

 Nota
Asegúrese de tener los permisos y derechos de acceso adecuados para descargar los archivos necesarios y ejecutar los contenedores de Docker en su sistema. Siga siempre buenas prácticas y pautas de seguridad proporcionadas por Procore cuando maneje datos y credenciales confidenciales.

Conectar a Databricks

  1. Inicie sesión en el entorno de Databricks.
  2. Haga clic en Catálogo.
  3. En Compartir en Delta, selecciona Compartido conmigo.
  4. Haga clic en Compartir identificador  para copiar y compartir con el equipo de soporte técnico de Procore.
    Nota:  Cuando se reciba el identificador de uso compartido, Procore lo añadirá al sistema.  
  5. En Proveedores, haga clic en el identificador de Procore.
  6. Haga clic en Crear catálogo.
  7. Introduzca su nombre preferido para el catálogo compartido.
  8. Haga clic en Crear.
    Su catálogo y tablas compartidas ahora se mostrarán con el nombre proporcionado en el Explorador de catálogos.  

Migrar un informe existente

  1. Abra el informe que desee migrar.
  2. Abra el Editor de consultas.
  3. Haga clic en Nueva fuente y, a continuación, en Más.  
    Nota: Los valores que se le proporcionarán no serán los mismos que los valores de los ejemplos a continuación.
  4. En la barra de búsqueda, escriba 'Delta Sharing'.
  5. Seleccione Delta Sharing y, a continuación, haga clic en Conectar.
  6. Escriba o pegue la URL del servidor Delta Sharing que haya recibido de Procore.  
  7. Seleccione la tabla que desee migrar.
  8. En la nueva consulta, haga clic en Editor avanzado.
  9. Copie el contenido antes de la palabra "en".  Esto incluirá los pasos "Fuente" y "Navegación" de la consulta.
    Nota: La siguiente captura de pantalla es solo un ejemplo. Tus valores serán diferentes.    
    source-and-navigation-query.png
  10. Haga clic en Hecho.
  11. Abra la "Empresa".
  12. Reemplace los pasos "Fuente" y "Navegación" por los copiados del paso 9.
    Nota: Asegúrese de pegar el texto antes de la palabra 'in'.
  13. Haga clic en Hecho.  
  14. Añada una coma al final de su texto si hay pasos adicionales aplicados.
  15. Revise la consulta en busca de errores que puedan ocurrir. Por ejemplo, algunas columnas no existen en la última versión de Procore Analytics, por lo que podemos eliminarlas de Pasos aplicados.
  16. A continuación, reasignará la tabla del proyecto.
  17. Abrir consulta de proyectos.
  18. Haga clic en Editor avanzado.
  19. Pegue el mismo código de conexión de arriba (copiado de la consulta de empresas) en las dos primeras líneas de la consulta del proyecto (antes de cualquier paso que comience con #).
  20. La nueva consulta ahora se parece a la captura de pantalla siguiente.
    project-query.png
  21. Agregue una coma y cambie el código para apuntar a una tabla diferente, como en el siguiente ejemplo:
    Ejemplo:

    Source = DeltaSharing.Contents("https://nvirginia.nube.databricks.c...d-4692f841b2ca",
    [rowLimitHint=null]),pa_internal_test = Fuente{[Name="pa_internal_test"]}[Datos],
    public_company_only = pa_internal_test{[Name="public_company_only"]}[Datos],
    companies1 = public_company_only{[Name="companies"]}[Datos],

    Cambiar -> companies1 = public_company_only{[Name="companies"]}[Datos],
    A ->   Projects = public_company_only{[Name="projects"]}[Datos],
        
  22. “[Name=”projects”]” es lo que apunta a la tabla correcta en Analytics 2.0.

Cambiar nombre de tablas y columnas de informes

  1. Abra el Editor de consultas del informe cuyo nombre desee cambiar.
  2. Busque la columna que no está en Procore Analytics 2.0.
  3. En la barra de fórmulas, reemplace la columna Analytics 1.0 por la nueva para Analytics 2.0.
  4. Otro método sería añadir un paso para cambiar el nombre de las columnas de Analytics 2.0 a los valores que tenía en el informe anterior.  
  5. Por ejemplo, en Analytics 1.0, project_stage_name es ahora stage_name.
  6. Si va al paso de navegación, puede cambiar el nombre de la columna aquí y corregir los errores en los pasos posteriores.
  7. Haga clic en Insertar después de realizar todas las actualizaciones.  
  8. Repita este proceso para cualquier otra columna renombrada.
  9. Cuando vuelva al error, verá el problema resuelto.  

Conéctese a Power BI Desktop

  1. Abra el escritorio de Power BI.
  2. Desde la página de inicio, haga clic en Nuevo para expandir la sección.
  3. Haga clic en Informe.
  4. Haga clic en Obtener datos de otra fuente.  
  5. En la barra de búsqueda, escriba 'Delta Sharing'.
  6. Seleccione Delta Sharing y, a continuación, haga clic en Conectar.  
  7. Escriba o pegue la URL del servidor Delta Sharing que recibió de Procore.  
  8. Si es la primera vez que se conecta a esta fuente, se le pedirá que proporcione su token Delta Sharing Bearer.
  9. Después de la autenticación, seleccione las tablas de Procore Analytics que desee incluir en su informe de Power BI.  
  10. Seleccione Cargar para ver su informe o seleccione Transformar datos para realizar más transformaciones en Power Query.  

Configurar seguridad a nivel de fila

  1. Configurar la relación de Power BI entre "Proyecto" y "ProjectUser"
  2. Crear un nuevo rol RLS
  3. Adición de usuarios a un rol RLS

Configurar la relación Power BI de 'proyectos' y 'project_users'

La configuración de una relación de Power BI entre las tablas projects y project_users conecta los datos de estas tablas. Consulte Crear y gestionar relaciones de Microsoft en Power BI Desktop icon-external-link.png.  A continuación se describen dos opciones para configurar esta relación.

Opción 1

  1. Abra un informe de Procore Analytics en Power BI Desktop.
  2. En la pestaña Inicio, haga clic en Gestionar relaciones.
  3. En la ventana 'Administrar relaciones', desplácese por las opciones y seleccione project_users (project_id)  y haga clic en Editar.
    manage-relationships-analytics.png
  4. Complete lo siguiente en la ventana "Editar relación":
    • En "Cardinalidad", seleccione Muchos a uno (*:1)  y marque la casilla "Activar esta relación". Estas opciones deben seleccionarse de forma predeterminada.
    • En "Dirección del filtro cruzado", seleccione Ambos  y marque la casilla "Aplicar filtro de seguridad en ambas direcciones".
      edit-relationship-analytics.png
  5. Haga clic en Aceptar  para cerrar la ventana "Editar relación".
  6. Haga clic en Cerrar  para cerrar la ventana "Gestionar relaciones".
  7. Guarde el informe.
  8. Continúe con los pasos descritos en Crear un nuevo rol RLS.

Opción 2

  1. Abra un informe de Procore Analytics en Power BI Desktop.
  2. Haga clic en la vista Modelo .  


     
  3. Compruebe la relación entre las tablas "proyectos" y "project_users". La relación debe tener un (1) junto a la tabla "proyectos" y un asterisco (*) junto a la tabla "project_users".
     Sugerencia
    Para ver solo la relación entre las tablas 'proyectos' y 'project_users' (como se muestra a continuación), haga clic en el icono más (+) junto a la pestaña 'Todas las tablas' para crear un nuevo diseño y agregue las tablas 'Proyecto' y 'ProjectUser' al diseño arrastrándolas y soltándolas desde el menú Propiedades > Campos en el espacio gris.
    relationship-models-analytics.png
  4. Seleccione la relación haciendo doble clic en la línea de conexión entre ellos.
  5. Complete lo siguiente en la ventana "Editar relación":
    • En "Cardinalidad", seleccione Muchos a uno (*:1)  y marque la casilla "Activar esta relación". Estas opciones deben seleccionarse de forma predeterminada.
    • En "Dirección del filtro cruzado", seleccione Ambos  y marque la casilla "Aplicar filtro de seguridad en ambas direcciones". 

      edit-relationship-analytics2.png
  6. Haga clic en Aceptar  para cerrar la ventana "Editar relación".
  7. Guarde el informe.
  8. Continúe con los pasos descritos en Crear un nuevo rol RLS.

Crear un nuevo rol RLS

  1. En la pestaña "Modelado", haga clic en Gestionar roles.
  2. En la ventana "Gestionar roles", complete lo siguiente en cada columna:
    • En la columna "Roles", haga clic en Crear e introduzca un nombre para el rol en el campo "Nuevo rol". Usuario del proyecto es el nombre del rol utilizado en la siguiente imagen.
    • En la columna "Tablas", seleccione project_users.
    • Seleccione Cambiar al editor Dax.
    • En la columna "Expresión Dax del filtro de tabla", introduzca [email_address] = userprincipalname().
      security-roles-analytics.png
  3. Haga clic en Guardar en la ventana "Gestionar roles de seguridad".
  4. Guardar y publicar el informe.
  5. Continúe con los pasos de Adición de usuarios a un rol RLS.

Adición de usuarios a un rol RLS

Una vez configurada la relación de tabla RLS, los usuarios deben añadirse a los roles RLS en el servicio Power BI para ver un informe de Procore Analytics.  Para obtener más información, consulte Seguridad a nivel de fila (RLS) de Microsoft con Power BI: Trabajar con miembros icon-external-link.png.

  1. Abra un informe de Procore Analytics en el servicio Power BI.
  2. En "Conjuntos de datos", haga clic en los puntos suspensivos (...) junto al informe para el que desea configurar RLS y haga clic en Seguridad.
  3. Seleccione el rol al que desee añadir uno o más usuarios.
     Sugerencia
    El uso de Grupos de distribución de Office 365 puede simplificar el proceso de adición de varios usuarios a un rol RLS a la vez. Consulte Introducción a Microsoft 365 Groups en Outlook icon-external-link.png.
  4. Introduzca sus direcciones de correo electrónico y haga clic en Añadir.
  5. Haga clic en Guardar.