Introducción a Analytics 2.0 (Beta)

Tabla de contenido

Descripción general

 En versión beta
Existente Los clientes de Análisis tienen la oportunidad de participar en la versión Beta abierta para Analytics 2.0. Comuníquese con su Gerente de Éxito del Cliente para más información.

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

Las funciones clave incluyen:

  • Los datos se actualizaron cada hora que puede extraer en cualquier momento. Además, los datos se monitorean para verificar su precisión e integridad.
  • Todos los datos de Procore se pueden extraer, incluidos los campos personalizados, los flujos de trabajo, el historial de cambios y la actividad del usuario.*
  • Nueva plataforma de datos con un aumento significativo de la escala y la disponibilidad de datos.
  • Reportes Power BI creados previamente.

*Todos los datasets no estarán disponibles al inicio de la versión beta abierta. Paridad completa de funciones con Analytics 1.0 próximamente.

 

 

Consideraciones

  • Puede continuar usando su versión actual de Procore Analytics, incluso si opta por la versión Beta abierta para Analytics 2.0.
     
  • Si no ve el rótulo para unirse a la versión beta abierta, es posible que otro administrador de la compañía en su compañía ya haya rechazado el acuerdo beta.
     
  • Para volver a activar la invitación, comuníquese con su Gerente de Éxito del Cliente para reactivación.
     
  • Si tiene problemas para conectarse a Procore Analytics 2.0, comuníquese con su Gerente de Éxito del cliente de Procore.

Preguntas frecuentes

¿Qué frecuencia es la actualización de datos?

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

¿Cómo se conecta a Procore Analytics 2.0?

Se puede acceder a Analytics 2.0 de varias formas. La forma más común sería conectarse en Power BI. Consulte Introducción a Procore Analytics 2.0. 

¿Perderé acceso a reportes existentes?

Procore Analytics 1.0 estará disponible hasta 2025. Buscamos dar a los usuarios mucho tiempo para cambiar a Analytics 2.0.

¿Los clientes de la extracción de datos tendrán que migrar a Procore Analytics 2.0?

Sí, los clientes de Data Extract necesitarán moverse a Procore Analytics 2.0, ahora llamado Conector Nube (alimentado por Delta Share).  Procore Analytics 2.0 también incluirá PowerBI reportes como una característica que no se requiere que los clientes utilicen, pero estarán disponibles para todos los clientes con Procore Analytics 2.0.

¿Aún necesito licencias de Power BI para acceder a Procore Analytics2.0?

Power BI licencias aún se requerirán para compartir reportes Power BI. 

¿Cómo actualizo los reportes personalizados que se desarrollaron en casa?

Procore Analytics 2.0 ahora utiliza Databricks Delta Sharing. Se deben cambiar las conexiones existentes a Analytics 1.0 (Azure SQL). Se han cambiado el nombre de varias tablas y columnas de reportes. Los cambios básicos que deberá realizar incluyen la actualización de los reportes para usar el nuevo conector Delta Sharing, actualizando las tablas y los nombres de las columnas, y actualizando las imágenes que pueden haber roto después de haber realizado los cambios mencionados anteriormente. Dependiendo de cómo se creó su reporte, puede haber consideraciones adicionales. Consulte Introducción a Procore Analytics 2.0. 

¿Cómo se procesará copiar datos a mi almacén de datos afectado por 2.0?

Procore Analytics 2.0 ahora utiliza Databricks Delta Sharing para obtener acceso a datos. Puedes obtener más información sobre cómo compartir delta aquí.    

 

Para obtener más preguntas o preocupaciones sobre Procore Analytics 2.0, comuníquese con el Grupo de 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 Análisis puede otorgar acceso de usuarios adicionales a la herramienta Análisis. 

 

Obtenga 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 ingresará en su sistema BI para acceder a los datos. Normalmente, 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 compañía primero debe aceptar el acuerdo Abierto Beta.
  • De forma predeterminada, todos los administradores de la compañía tienen acceso de nivel "Administrador" a Análisis en el Directorio. 
  • Cualquier persona con acceso de nivel "Administrador" a Análisis puede otorgar acceso de usuarios adicionales a la herramienta Análisis. 
  • Los usuarios deben tener acceso de nivel "Administrador" a la herramienta Análisis para generar un token de datos. 

Pasos

Aceptar acuerdo beta y activar

Una vez invitado a la versión beta abierta, los administradores de la compañía verán un banner emergente que le invita a aceptar el acuerdo beta la próxima vez que inicie sesión en Procore. Si no ve la ventana emergente, es posible que otro administrador de la compañía ya haya rechazado el acuerdo beta. Comuníquese con su Gerente de Éxito del Cliente para reactivarse.

Otorgar acceso a nivel administrador de datos a Los usuarios finales a Analytics 2.0

Una vez que el administrador de la compañía acepte el acuerdo beta, todos los administradores de la compañía verán Procore Analytics en el menú desplegable de la herramienta dentro de Procore. Agregar administradores de Análisis (por ejemplo, alguien en TI o un analista de datos) para ayudar con sus siguientes pasos, navegue hasta la tarjeta Directorio a nivel compañía del usuario y les brinde acceso a nivel administrador a la herramienta Análisis.

Conéctese a sus datos 

Cualquier persona con acceso de nivel administrador a la herramienta Análisis podrá generar tokens de acceso de datos a través de la herramienta Análisis. Los usuarios finales de datos deben generar tokens de datos y luego deberá tomar 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 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 Procore Analytics fichas . 
  5. A continuación elegirá su conexión con Procore Analytics.
  6. Si tiene Databricks, ingrese 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 navega fuera de la página. Para generar un nuevo token, regrese al Paso 1. 
  9. La siguiente sección de esta guía lo ayudará a conectarse a su solución posterior.

Conéctese a Power BI

Conectar con modelos de análisis

Descargar archivo de credenciales

  1. Cree un archivo llamado 'config.share.
  2. Agregue los campos a continuación:
    {
        "shareCredentialsVersion": 1,
        "portadorToken": "",
        "extremo": "",
        "expiraciónTime": ""
    }
  3. Agregue el portadorToken, el extremo, shareCredentialsVersion y los valores de expiración recibidos de Procore al archivo config.share.

Ejecutar user_exp.py script

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

  • Para Azure Storage:
    cron_job: #true/falso
    run_as: #pyspark/python
    source_config:
      config_path: #path al archivo config.share
      Mesas:
      - Nombre de la tabla "" si desea descargar una tabla específica. Déjalo vacío si quieres descargar todas las tablas
    source_type: delta_share
    target_config:
      auth_type: service_principal
      client_id:
      N° client_id secret_id: N° secret_id
      storage_cuenta: nombre #storage cuenta
      storage_path: #<container>@<storage-account>.dfs.core.windows.net/<directory>
      tenant_id: N° tenant_id
    target_type: azure_storage
  • Para MSSQL base de datos:
    cron_job: #true/falso
    run_as: #pyspark/python
    source_config:
      config_path: #path al archivo config.share
      Mesas:
        - Nombre de la tabla "" si desea descargar una tabla específica. Déjalo vacío si quieres descargar todas las tablas
    source_type: delta_share
    target_config:
      base de datos: base de datos #target
      host: #target nombre de host:port
      contraseña: #password
      esquema: #target esquema (predeterminado para procore_analytics)
      nombre de usuario: #username
    target_type: sql_server

Ejecutar como PySpark

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

  • Para escribir en almacenamiento de ADLS Gen2:
    spark-submit --packages io.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 --exclusion-paquetes com.sun.xml.jaxb-impl delta_share_to_sql_spark.py
  • Para escribir para 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, navegue hasta la carpeta ingresando el <path to the folder> comando "CD ".
  2. Instale paquetes requeridos usando "instalación de pip -r requirements.txt" o "python -m pip instala -r requirements.txt".
  3. Abra SSIS y cree un nuevo proyecto.
  4. Desde la caja de herramientas 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, ingrese la ruta a python.exe en la carpeta de instalación de Python.
  8. En WorkingDirectory, ingrese la ruta a la carpeta que contiene el script que desea ejecutar (sin el nombre del archivo de script).
  9. En argumentos, ingrese el nombre del script delta_share_to_azure_panda.py desea ejecutar con la .py extensión y haga clic en Guardar.
  10. Haga clic en Iniciar en el menú de cinta de opciones superior.
  11. Durante la ejecución de la tarea, la salida de la consola de Python se muestra en la ventana de consola externa.
  12. Una vez que se haga la tarea, se mostrará un marca de verificación.

Elija su propio método

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

 Nota:
Asegúrese de tener permisos y derechos de acceso adecuados para descargar los archivos requeridos y ejecutar contenedores Docker en su sistema. Siempre siga los mejores prácticas y las pautas de seguridad proporcionadas por Procore al manejar datos y credenciales confidenciales.

Conectar a Databricks

  1. Inicie sesión en su entorno databricks.
  2. Haga clic en Catálogo.
  3. En Compartir en Delta, seleccione Compartir conmigo.
  4. Haga clic en Compartirs para copiar y compartir con el equipo de soporte de procore.
    Nota: Cuando se reciba el identificador de intercambio, Procore lo agregará al sistema. 
  5. En Proveedores, haga clic en la identificador de Procore.
  6. Haga clic en Crear catálogo.
  7. Ingrese su nombre preferido para el catálogo compartido.
  8. Haga clic en Crear.
    Su catálogo y tablas compartidas ahora se mostrarán debajo del nombre proporcionado en el Explorador de catálogos. 

Migrar un reporte existente

  1. Abra el reporte que desea migrar.
  2. Abra el editor de consultas.
  3. Haga clic en Nueva fuente luego haga clic en Más. 
    Nota: Los valores que se le dan no serán los mismos que los valores en los ejemplos a continuación.
  4. En la barra de búsqueda, escriba "Compartir en Delta".
  5. Seleccione Compartir en Delta, luego haga clic en Conectar.
  6. Escriba o pegue el servidor compartido delta URL recibió de Procore. 
  7. Seleccione la tabla que desea migrar.
  8. En la nueva consulta, haga clic en Editor avanzado.
  9. Copie el contenido antes de la palabra "en". Esto incluirá los pasos "Origen" y "Navegación" de la consulta.
    Nota: La captura de pantalla a continuación es solo un ejemplo. Tus valores serán diferentes.  
    source-and-navigation-query.png
  10. Haga clic en Listo.
  11. Abra la "Compañía".
  12. Reemplace los pasos "Origen" y "Navegación" con los copiados del Paso 9.
    Nota: Asegúrese de pegar el texto antes de la palabra "en".
  13. Haga clic en Listo. 
  14. Agregue una coma al final de su texto si hay pasos aplicados adicionales.
  15. Busque la consulta de errores que pueden producirse. Por ejemplo, algunas columnas no existen en la última versión de Procore Analytics para que podamos eliminar estas de los pasos aplicados.
  16. A continuación, volverá a asignar 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 compañías) a las dos primeras líneas de la consulta del proyecto (antes de los pasos a partir del N°).
  20. La nueva consulta ahora se ve como la captura de pantalla a continuación.
    project-query.png
  21. Agregue una coma y cambie el código para apuntar a una tabla diferente, como el siguiente ejemplo:
    Ejemplo:

    Fuente = DeltaSharing.Content("[1]",
    [rowLimitHint= null]),pa_internal_test = Fuente{Nombre="pa_internal_test"}[Datos],
    public_company_only = pa_internal_test{[Nombre="public_company_only"]}[Datos],
    compañías1 = public_company_only{{[Nombre="compañías"]}[Datos],

    Cambio -> compañías1 = public_company_only{[Nombre="compañías"]}[Datos],
    Para -> Proyectos = public_company_only{[Nombre= "proyectos"]}[Datos],
     
  22. →Nombre = "proyectos"]" es lo que señala a la tabla correcta en Analytics 2.0.

Cambiar el nombre de tablas y columnas de reportes

  1. Abra el Editor de consultas para el reporte al que debe cambiarle el nombre.
  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 con la nueva para Analytics 2.0.
  4. Otro método sería agregar un paso para cambiar el nombre de las columnas de Analytics 2.0 a los valores que tenía en su reporte anterior. 
  5. Por ejemplo, en Analytics 1.0, project_stage_name ahora estátage_name.
  6. Si va al paso de navegación, puede cambiar el nombre de la columna aquí y corregir 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 regrese al error, verá el problema resuelto. 

Conéctese al escritorio de Power BI

  1. Abra su escritorio de Power BI.
  2. En la página de inicio , haga clic en Nuevo para expandir la sección.
  3. Haga clic en Reporte.
  4. Haga clic en Obtener datos de otra fuente. 
  5. En la barra de búsqueda, escriba "Compartir en Delta".
  6. Seleccione Compartir en Delta, luego haga clic en Conectar. 
  7. Escriba o pegue el servidor compartido delta URL recibió de Procore. 
  8. Si es la primera vez que se conecta a esta fuente, se le pedirá que proporcione su token de portador de uso compartido de Delta.
  9. Después de la autenticación, seleccione las tablas Procore Analytics que desea ingresar en su reporte Power BI. 
  10. Seleccione Cargar para ver su reporte o seleccione Transformar datos para hacer más revisiones en Power Query. 

Configurar seguridad a nivel de fila

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

Configurar "proyectos" y "project_users" Power BI relación

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

Opción 1

  1. Abra un reporte de Procore Analytics en Power BI escritorio.
  2. En la pestaña inicio, haga clic en Administrar 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 de verificación "Hacer que esta relación esté activa". Estas opciones deben ser seleccionadas por defecto.
    • En "Dirección transversal", seleccione Ambos y marque el "Aplicar filtro de seguridad en ambas direcciones" casilla de verificación.
      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 "Administrar relaciones".
  7. Guarde el reporte.
  8. Continúe con los pasos en Crear un nuevo rol de RLS.

Opción 2

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


     
  3. Verifique la relación entre las tablas "proyectos" y "project_users". La relación debe tener un (1) junto a la tabla "proyectos" y un asterisk configurable junto a la tabla "project_users".
     Recomendación
    Para ver la relación entre los "proyectos" y las tablas "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 agregar las tablas "Proyecto" y "Proyecto" al diseño arrastrándolos y soltándolos 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 ellas.
  5. Complete lo siguiente en la ventana "Editar relación":
    • En "Cardinalidad", seleccione Muchos a uno (*:1) y marque la casilla de verificación "Hacer que esta relación esté activa". Estas opciones deben ser seleccionadas por defecto.
    • En "Dirección transversal", seleccione Ambos y marque el "Aplicar filtro de seguridad en ambas direcciones" casilla de verificación.

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

Crear un nuevo rol de RLS

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

Agregar usuarios a un rol de RLS

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

  1. Abra un reporte de Procore Analytics en el servicio Power BI.
  2. En "Datasets", haga clic en los puntos suspensivos (...) junto al reporte para el que desea configurar RLS y haga clic en Seguridad.
  3. Seleccione el rol al que desea agregar uno o más usuarios.
     Recomendación
    El uso de Grupos de distribución de Office 365 puede simplificar el proceso de agregar varios usuarios a un rol de RLS a la vez. Consulte Microsoft Comience con Microsoft 365 grupos en Outlook icon-external-link.png.
  4. Ingrese sus direcciones de correo electrónico y haga clic en Agregar.
  5. Haga clic en Guardar.