Démarrer avec Analytique 2.0 (Bêta)

Table des matières

Aperçu

 En version bêta
Les clients existants d'Analytics ont la possibilité de participer à la version bêta ouverte d'Analytics 2.0. Veuillez contacter votre responsable du succès client pour en en savoir plus.

Analytics 2.0 fournit une solution puissante et conviviale pour exploiter les données de votre projet, prendre des décisions éclairées et obtenir des informations plus approfondies sur les performances et les résultats globaux de votre projet. 

Les principales fonctionnalités incluent:

  • Données actualisées toutes les heures que vous pouvez extraire à tout moment. De plus, les données sont surveillées pour en vérifier l'exactitude et l'exhaustivité.
  • Toutes les données de Procore peuvent être extraites, y compris les champs personnalisés, les flux de travail, l' historique des modifications et l'activité des utilisateurs.*
  • Nouvelle plate-forme de données avec une évolutivité et une disponibilité des données considérablement accrues.
  • Rapports de Power BI pré-construits.

* Tous les ensembles de données ne seront pas disponibles au début de la version bêta ouverte. Parité complète des fonctionnalités avec Analytics 1.0 à venir.

 

 

Considérations

  • Vous pouvez continuer à utiliser votre version actuelle de Procore Analytics, même si vous avez activé la version bêta ouverte d'Analytics 2.0.
     
  • Si vous ne voyez pas la légende pour rejoindre la version bêta ouverte, un autre administrateur de votre compagnie a peut-être déjà refusé l'accord bêta.
     
  • Pour réactiver l'invitation, contactez votre responsable du succès client pour la réactivation.
     
  • Si vous éprouvez des difficultés à vous connecter à Procore Analytics 2.0, communiquez avec votre gestionnaire de Succès client de Procore.

Questions courantes

Quelle est la fréquence d'actualisation des données?

Les données sont actualisées tout au long de la journée sur une base horaire. 

Comment puis-je me connecter à Procore Analytics 2.0?

Analytique 2.0 est accessible de plusieurs façons. Le moyen le plus courant consiste à se connecter dans Power BI. Voir Premiers pas avec Procore Analytics 2.0. 

Vais-je perdre l'accès aux rapports existants?

Procore Analytics 1.0 sera disponible jusqu'en 2025. Notre objectif est de donner aux utilisateurs suffisamment de temps pour passer à Analytique 2.0.

Les clients sur l’extraction de données devront-ils migrer vers Procore Analytique 2.0 ?

Oui, les clients de Data Extract devront passer à Procore Analytics 2.0, maintenant appelé Nuage Connector (alimenté par Delta Share).  Procore Analytics 2.0 comprendra également les rapports PowerBI en tant que fonctionnalité que les clients ne sont pas tenus d'utiliser, mais ils seront disponibles pour tous les clients avec Procore Analytics 2.0.

Ai-je toujours besoin de licences Power BI pour accéder à Procore Analytics2.0?

Les licences Power BI seront toujours nécessaires pour partager les rapports Power BI. 

Comment mettre à jour les rapports personnalisés développés en interne?

Procore Analytics 2.0 utilise désormais le partage Delta de Databricks. Toutes les connexions existantes à Analytics 1.0 (Azure SQL) doivent être modifiées. Plusieurs tableaux et colonnes de rapport ont été renommés. Les modifications de base que vous devrez effectuer incluent la mise à jour des rapports pour utiliser le nouveau connecteur Delta Sharing, la mise à jour des noms de table et de colonne et la mise à jour des visuels qui peuvent s'être rompus après les modifications mentionnées ci-dessus. En fonction de la manière dont votre rapport a été construit, il peut y avoir des considérations supplémentaires. Voir Premiers pas avec Procore Analytics 2.0. 

Comment le processus de copie des données vers mon entrepôt de données sera-t-il affecté par la version 2.0?

Procore Analytics 2.0 utilise désormais le partage Delta de Databricks pour l'accès aux données. Vous pouvez en savoir plus sur le partage delta ici.    

 

Pour toute autre question ou préoccupation concernant Procore Analytics 2.0, veuillez contacter le groupe de la communauté bêta d'Analytics 2.0 . 

Autorisations

Découvrez quelles permissions d'utilisateur sont requises pour effectuer les actions décrites dans cet outil.

 

Autorisations

 |  |  L'action est disponible sur l'application Web, iOS et/ou Android de Procore. Cliquez pour afficher l'article.

icon-mindtouch-table-check.png Les utilisateurs peuvent prendre l'action avec ce niveau de permissions.

icon-mindtouch-table-check.png Les utilisateurs peuvent effectuer cette action avec ce niveau de permission ET une ou plusieurs exigences supplémentaires, comme des permissions granulaires.

Mesure Aucune Lecture seule Standard Admin Remarques

Générer un jeton de données

 Web

       check-green2.png

Toute personne disposant d'un accès de niveau « Admin » à Analytique peut accorder à des utilisateurs supplémentaires l'accès à l'outil Analytique. 

 

Accédez à vos données Procore

Pour commencer à accéder à vos données Procore, vous devez générer un jeton d'accès. Le jeton d'accès est une chaîne de chiffres que vous saisirez dans votre système de BI pour accéder aux données. En règle générale, les utilisateurs qui ont besoin de jetons d'accès sont des ingénieurs de données ou des développeurs Power BI. 

 

Considérations

  • L'outil Procore Analytics doit être activé. 
  • Pour activer Analytics 2.0, un administrateur de la compagnie doit d'abord accepter l'accord bêta ouvert.
  • Par défaut, tous les administrateurs de la compagnie ont un accès de niveau « Admin » aux analyses dans le Répertoire. 
  • Toute personne disposant d'un accès de niveau « Admin » à Analytique peut accorder à des utilisateurs supplémentaires l'accès à l'outil Analytique. 
  • Les utilisateurs doivent avoir un accès de niveau « Admin » à l'outil Analytique pour générer un jeton de données. 

Étapes

Accepter l'accord bêta et activer

Une fois invités à la version bêta ouverte, les administrateurs de la compagnie verront une bannière contextuelle vous invitant à accepter l'accord bêta la prochaine fois que vous vous connecterez à Procore. Si vous ne voyez pas la fenêtre contextuelle, un autre administrateur de la compagnie a peut-être déjà refusé l'accord bêta. Veuillez contacter votre responsable du succès client pour être réactivé.

Accorder aux utilisateurs finaux des données un accès de niveau Admin à Analytique 2.0

Une fois qu'un administrateur de la compagnie accepte l'accord bêta, tous les administrateurs de la compagnie verront Procore Analytics dans le menu déroulant de l'outil dans Procore. Pour ajouter des administrateurs d'analyse (par exemple quelqu'un en informatique ou un analyste de données) pour vous aider dans vos prochaines étapes, accédez à la carte Répertoire au niveau de la compagnie de l'utilisateur et donnez-lui un accès de niveau Admin à l'outil Analytique.

Connectez-vous à vos données 

Toute personne disposant d'un accès de niveau Admin à l'outil Analytique pourra générer des jetons d'accès aux données via l'outil Analytique. Les utilisateurs finaux des données doivent générer des jetons de données et devront ensuite suivre les étapes supplémentaires de la section suivante de ce guide pour connecter les données à un entrepôt de données ou à une solution de BI. Pour commencer à connecter vos données, suivez les étapes ci-dessous :

  1. Connectez-vous à Procore. 
  2. Cliquez sur l'icône Compte et profil dans la barre de navigation.
  3. Cliquez sur Paramètres de mon profil. 
  4. Cliquez sur l'onglet Jetons Procore Analytics . 
  5. Vous choisirez ensuite votre connexion avec Procore Analytics.
  6. Si vous avez des Databricks, saisissez votre identifiant et cliquez sur Connecter.
  7. Choisissez le type de jeton que vous générerez.
  8. Cliquez sur Générer un jeton.
    Remarque : Le jeton disparaîtra après une heure ou si vous quittez la page. Pour générer un nouveau jeton, revenez à l'étape 1. 
  9. La section suivante de ce guide vous aidera à vous connecter à votre solution en aval.

Se connecter à Power BI

Se connecter avec des maquettes d'analyse

Télécharger le fichier d'identifiants

  1. Créez un fichier appelé « config.share.
  2. Ajoutez les champs ci-dessous :
    {
        « shareCredentialsTableaux » : 1,
        « bearerToken » : « ,
        « point de terminaison » : « »,
        « expirationTime » : «
    }
  3. Ajoutez les valeurs bearerToken, endpoint, shareCredentialsVersion et expirationTime reçues de Procore au fichier config.share.

Exécuter le script user_exp.py

Vous pouvez utiliser les scripts suivants pour créer un fichier config.yaml avec les configurations nécessaires. 

  • For Azure Storage:
    cron_job: #true/false
    run_as: #pyspark/python
    source_config:
      config_path: #path to the config.share file
      tables:
      - '' # table name if you want to download a specific table. Leave it empty if you want to download all tables
    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>
      tenant_id: #tenant_id
    target_type: azure_storage
  • Pour MSSQL DB:
    cron_job : #true/faux
    run_as : #pyspark/python
    source_config :
      config_path : #path au fichier config.share
      Tables:
        - Nom du tableau « » si vous souhaitez télécharger un tableau spécifique. Laissez-le vide si vous souhaitez télécharger tous les tableaux
    source_type : delta_share
    target_config :
      base de données : base de données #target
      hôte : #target hostname :port
      mot de passe : #password
      schéma : schéma #target (par défaut à Procore_analytique)
      nom d’utilisateur : #username
    target_type : sql_server

Exécuter en tant que PySpark

Si votre environnement est déjà configuré avec Spark, choisissez l'option « pyspark » lorsque vous y êtes invité ou une fois que le « config.yaml » est généré, vous pouvez exécuter les commandes suivantes pour télécharger les rapports dans le répertoire de données.

  • Pour écrire sur le stockage ADLS Gen2:
    spark-submit --packages io.delta:delta-share-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
  • Pour écrire dans la base de données MSSQL :
    spark-submit --paquets io.delta:delta-share-spark_2.12:3.1.0 --jars <Emplacement du bocal mssql-jdbc> delta_share_to_sql_spark.py

Exécuter en tant que Python

  1. À partir de la ligne de commande, accédez au dossier en saisissant la <path to the folder> commande « cd » .
  2. Installez les paquets requis à l’aide de « pip install -r exigences.txt » ou « python -m pip installez -r exigences.txt ».
  3. Ouvrez SSIS et créez un nouveau projet.
  4. Dans la boîte à outils SSIS , glisser-déposer Exécuter la tâche de processus.
  5. Double-cliquez sur Exécuter la tâche de processus.
  6. Accédez à l'onglet Processus.
  7. À côté de Exécutable, entrez le chemin de python.exe dans le dossier d'installation de Python.
  8. Dans Répertoire de travail, entrez le chemin du dossier contenant le script que vous souhaitez exécuter (sans le nom du fichier de script).
  9. Dans Arguments, entrez le nom du script delta_share_to_azure_panda.py que vous souhaitez exécuter avec la .py extension et cliquez sur Enregistrer.
  10. Cliquez sur Démarrer dans le menu du ruban supérieur.
  11. Pendant l'exécution de la tâche, la sortie de la console Python est affichée dans la fenêtre de la console externe.
  12. Une fois la tâche terminée, une coche s'affiche.

Choisissez votre propre méthode

Delta Sharing est un protocole ouvert de partage sécurisé de données. Vous pouvez trouver le référentiel public GitHub pour Delta Sharing à l' adresse https://github.com/delta-io/delta-share. Le référentiel comprend des exemples et de la documentation pour accéder aux données partagées à l'aide de divers langages tels que Python et Spark Connector (SQL, Python, Scala, Java, R).

Remarque
Assurez-vous de disposer des permissions et des droits d'accès appropriés pour télécharger les fichiers requis et exécuter les conteneurs Docker sur votre système. Suivez toujours les meilleures pratiques en matière de sécurité et les directives fournies par Procore lors du traitement des données sensibles et des informations d'identification.

Se connecter aux Databricks

  1. Connectez-vous à votre environnement Databricks.
  2. Cliquez sur Catalogue.
  3. Sous Partage delta, sélectionnez Partagé avec moi.
  4. Cliquez sur Partage de l'identifiant pour copier et partager avec l'équipe de support Procore .
    Remarque : Lorsque l'identifiant de partage sera reçu, Procore l'ajoutera au système. 
  5. Sous Fournisseurs, cliquez sur l'identifiant de Procore.
  6. Cliquez sur Créer un catalogue.
  7. Entrez votre nom préféré pour le catalogue partagé.
  8. Cliquez sur Créer.
    Votre catalogue et vos tableaux partagés s'afficheront désormais sous le nom fourni dans l'explorateur de catalogue. 

Migrer un rapport existant

  1. Ouvrez le rapport que vous souhaitez migrer.
  2. Ouvrez l'éditeur de requête.
  3. Cliquez sur Nouvelle source , puis sur Plus. 
    Remarque : Les valeurs qui vous sont données ne seront pas les mêmes que les valeurs des exemples ci-dessous.
  4. Dans la barre de recherche, tapez « Partage Delta ».
  5. Sélectionnez Partage delta, puis cliquez sur Se connecter.
  6. Tapez ou collez l' URL du serveur de partage Delta que vous avez reçu de Procore. 
  7. Sélectionnez le tableau que vous souhaitez migrer.
  8. Dans la nouvelle requête, cliquez sur Éditeur avancé.
  9. Copiez le contenu avant le mot « in ». Cela inclura les étapes « Source » et « Navigation » de la requête.
    Remarque : La capture d'écran ci-dessous n'est qu'un exemple. Vos valeurs seront différentes.  
    source-and-navigation-query.png
  10. Cliquez sur Terminé.
  11. Ouvrez la « Compagnie ».
  12. Remplacez les étapes « Source » et « Navigation » par celles copiées à partir de l'étape 9.
    Remarque : Assurez-vous de coller le texte avant le mot « dans ».
  13. Cliquez sur Terminé. 
  14. Ajoutez une virgule à la fin de votre texte s'il y a des étapes supplémentaires appliquées.
  15. Regardez la requête pour les erreurs qui peuvent se produire. Par exemple, certaines colonnes n’existent pas dans la dernière version de Procore Analytique afin que nous puissions les supprimer des étapes appliquées.
  16. Ensuite, vous remapperez le tableau du projet.
  17. Ouvrir la requête de projets.
  18. Cliquez sur Éditeur avancé.
  19. Collez le même code de connexion ci-dessus (copié à partir de la requête des compagnies) sur les deux premières lignes de la requête du projet (avant toute étape commençant par #).
  20. La nouvelle requête ressemble désormais à la capture d’écran ci-dessous.
    project-query.png
  21. Ajoutez une virgule et modifiez le code pour qu'il pointe vers un tableau différent, comme dans l'exemple ci-dessous :
    Exemple :

    Source = DeltaSharing.Contents("https://nvirginia.cloud nuage...d-4692f841b2ca ",
    [rowLimitHint=null]),pa_internal_test = Source{[Name="pa_internal_test"]}[Données],
    public_company_only = pa_internal_test{[Name="public_company_only"]}[Données],
    compagnies1 = public_company_only{[Name="companies"]}[Données],

    Modifier -> compagnies1 = public_company_only{[Name="companies"]}[Données],
    À -> Projets = public_company_only{[Name="projects"]}[Données],
     
  22. « [Name = »projects »] » est ce qui pointe vers le bon tableau dans Analytics 2.0.

Renommer les tableaux et les colonnes du rapport

  1. Ouvrez l'éditeur de requête pour le rapport que vous devez renommer.
  2. Recherchez la colonne qui n'est pas dans Procore Analytics 2.0.
  3. Dans la barre de formule, remplacez la colonne Analytics 1.0 par la nouvelle pour Analytics 2.0.
  4. Une autre méthode consisterait à ajouter une étape pour renommer les colonnes d'Analytics 2.0 avec les valeurs que vous aviez dans votre rapport précédent. 
  5. Par exemple, dans Analytics 1.0, project_stage_name est désormaisstage_name.
  6. Si vous accédez à l'étape de navigation, vous pouvez renommer la colonne ici et corriger les erreurs dans les étapes suivantes.
  7. Cliquez sur Insérer après avoir effectué toutes les mises à jour. 
  8. Répétez ce processus pour toutes les autres colonnes renommées.
  9. Lorsque vous revenez à l'erreur, vous verrez le problème résolu. 

Se connecter à Power BI Desktop

  1. Ouvrez votre bureau Power BI.
  2. Sur la page d'accueil , cliquez sur Nouveau pour développer la section.
  3. Cliquez sur Rapport.
  4. Cliquez sur Obtenir les données d'une autre source. 
  5. Dans la barre de recherche, tapez « Partage Delta ».
  6. Sélectionnez Partage delta, puis cliquez sur Se connecter. 
  7. Saisissez ou collez l' URL du serveur de partage Delta que vous avez reçu de Procore. 
  8. Si c'est la première fois que vous vous connectez à cette source, vous serez invité à fournir votre jeton de porteur de partage Delta.
  9. Après l'authentification, sélectionnez les tableaux Procore Analytics que vous souhaitez importer dans votre rapport Power BI. 
  10. Sélectionnez Charger pour afficher votre rapport ou sélectionnez Transformer les données pour effectuer plus de transformations dans Power Query. 

Configurer la sécurité au niveau de la ligne

  1. Configurer la relation Power BI « Project » et « ProjectUser »
  2. Créer un nouveau rôle RLS
  3. Ajouter des utilisateurs à un rôle RLS

Configurer la relation Power BI « projets » et « utilisateurs_projets »

La configuration d'une relation Power BI entre les projets et les tables project_users connecte les données de ces tables. Voir Microsoft Créer et gérer des relations dans Power BI Desktop icon-external-link.png. Deux options pour configurer cette relation sont décrites ci-dessous.

Option 1

  1. Ouvrez un rapport Procore Analytics dans Power BI Desktop.
  2. Dans l'onglet Accueil, cliquez sur Gérer les relations.
  3. Dans la fenêtre « Gérer les relations », faites défiler les options et sélectionnez project_users (project_id) et cliquez sur Modifier.
    manage-relationships-analytics.png
  4. Complétez ce qui suit dans la fenêtre « Modifier la relation » :
    • Sous « Cardinalité », sélectionnez Plusieurs à un (*:1) et cochez la case à cocher« Rendre cette relation active ». Ces options doivent être sélectionnées par défaut.
    • Sous « Sens du filtre croisé », sélectionnez Les deux et cochez la case à cocher« Appliquer le filtre de sécurité dans les deux sens ».
      edit-relationship-analytics.png
  5. Cliquez sur OK pour fermer la fenêtre « Modifier la relation ».
  6. Cliquez sur Fermer pour fermer la fenêtre « Gérer les relations ».
  7. Enregistrez le rapport.
  8. Continuez avec les étapes de Créer un nouveau rôle RLS.

Option 2

  1. Ouvrez un rapport Procore Analytics dans Power BI Desktop.
  2. Cliquez sur l'affichage Maquette .


     
  3. Vérifiez la relation entre les tableaux « projets » et « utilisateurs_projet ». La relation doit avoir un (1) à côté du tableau « projets » et un astérisque (*) à côté du tableau « project_users ».
     Conseil
    Pour afficher uniquement la relation entre les tableaux « projets » et « utilisateurs_projet » (comme indiqué ci-dessous), cliquez sur l'icône plus (+) à côté de l'onglet « Tous les tableaux » pour créer une nouvelle mise en page et ajouter le « Projet » et « Utilisateur du projet » 'tables à la mise en page en les faisant glisser-déposer depuis le menu Propriétés > Champs dans l'espace gris.
    relationship-models-analytics.png
  4. Sélectionnez la relation en double-cliquant sur la ligne de connexion entre eux.
  5. Complétez ce qui suit dans la fenêtre « Modifier la relation » :
    • Sous « Cardinalité », sélectionnez Plusieurs à un (*:1) et cochez la case à cocher« Rendre cette relation active ». Ces options doivent être sélectionnées par défaut.
    • Sous « Sens du filtre croisé », sélectionnez Les deux et cochez la case à cocher« Appliquer le filtre de sécurité dans les deux sens ».

      edit-relationship-analytics2.png
  6. Cliquez sur OK pour fermer la fenêtre « Modifier la relation ».
  7. Enregistrez le rapport.
  8. Continuez avec les étapes de Créer un nouveau rôle RLS.

Créer un nouveau rôle RLS

  1. Dans l’onglet « Modélisation », cliquez sur Gérer les rôles.
  2. Dans la fenêtre « Gérer les rôles », procédez comme suit dans chaque colonne :
    • Dans la colonne « Rôles », cliquez sur Créer et saisissez un nom pour le rôle dans le champ « Nouveau rôle ». Utilisateur du projet est le nom du rôle utilisé dans l'image ci-dessous.
    • Dans la colonne « Tableaux », sélectionnez project_users.
    • Sélectionnez Basculer vers l'éditeur DAX.
    • Dans la colonne « Expression DAX du filtre de tableau », saisissez [adresse_courriel] = nomprincipal de l'utilisateur().
      security-roles-analytics.png
  3. Cliquez sur Enregistrer dans la fenêtre « Gérer les rôles de sécurité ».
  4. Enregistrez et publiez le rapport.
  5. Continuez avec les étapes de Ajouter des utilisateurs à un rôle RLS.

Ajouter des utilisateurs à un rôle RLS

Une fois la relation entre les tables RLS configurée, les utilisateurs doivent être ajoutés aux rôles RLS dans le service Power BI afin d'afficher un rapport Procore Analytics . Pour plus d'informations, consultez Sécurité au niveau de la ligne (RLS) de Microsoft avec Power BI : Utilisation des membres icon-external-link.png.

  1. Ouvrez un rapport Procore Analytics dans le service Power BI.
  2. Sous « Ensembles de données », cliquez sur les points de suspension (...) à côté du rapport pour lequel vous souhaitez configurer RLS et cliquez sur Sécurité.
  3. Sélectionnez le rôle auquel vous souhaitez ajouter un ou plusieurs utilisateurs.
     Conseil
    L'utilisation des groupes de distribution Office 365 peut simplifier le processus d'ajout de plusieurs utilisateurs à un rôle RLS à la fois. Voir Prise en main de Microsoft avec les groupes Microsoft 365 dans Outlook icon-external-link.png.
  4. Saisissez leurs adresses courriel et cliquez sur Ajouter.
  5. Cliquez sur Enregistrer.