Introduction 

La gestion de plusieurs projets de construction à des différents endroits représente un défi unique. Les chefs de projet utilisent généralement plusieurs applications pour suivre leurs projets, ce qui rend particulièrement difficile d'avoir une vue globale sur l'avancement des projets. En créant notre intégration Power BI, disponible en libre-service pour tous nos utilisateurs d’API sur Business et Business Plus, nous souhaitons offrir une solution efficace.

Voici quelques exemples de ce que vous pourrez faire :

• Suivre le planning d’une personne sur plusieurs projets dans Fieldwire
• Intégrez plusieurs applications de gestion de projet dans un tableau de bord unique
• Suivre l’exécution de la liste de contrôle des tâches dans Fieldwire

En bref, le programme Power BI Connector vous permet d’extraire facilement les données de Fieldwire dans votre application Power BI et de les combiner avec vos propres données personnalisées pour une analyse plus approfondie. 

Note : Les questions de base et le dépannage des bugues pour Power BI doivent être adressées à l’équipe Microsoft, car notre connecteur sera approuvé et partagé via Microsoft. L’équipe d’assistance de Fieldwire est disponible pour résoudre les problèmes d’installation du connecteur, mais cette fonctionnalité doit être considérée comme principalement en libre-service.

 

Table de Matières

• Les critères pour utiliser l’intégration Power BI
• Guide de démarrage
• Mise à jour des paramètres de sécurité
• Utilisation du Connector
• Utilisation du modèle par défaut
• Foire aux questions

 

Les critères pour utiliser l’intégration Power BI

Pour utiliser le connecteur Fieldwire Power BI, vous aurez besoin des éléments suivants :

• Accès administrateur à un compte Fieldwire (voir Introduction aux niveaux d’autorisation de compte : gestionnaires, utilisateurs de compte et utilisateurs de projet pour plus d’informations)
• Une clé API Fieldwire, ou la possibilité de générer une clé API (plus d’informations ici : Introduction à l’API Fieldwire)
• Power BI pour Windows

Note : nous recommandons fortement la version desktop de Power BI. Les applications du Microsoft Store ne sont pas officiellement prises en charge, mais peuvent toujours fonctionner en fonction de vos besoins.

 

Guide de démarrage

Dans votre compte Fieldwire, accédez à l’onglet Intégrations et cliquez sur Microsoft Power BI.





Si l’API Fieldwire est déjà activée pour votre compte, vous pouvez continuer à télécharger notre connecteur Power BI via ce package zip (notre modèle par défaut est également disponible). Le paquet zip contient :

• The Fieldwire custom connector
  • Fieldwire-connector.pqx
• A sample Power BI template
  • Fieldwire-Dashboard-Template.pbit
• A PowerShell script to register the connector (optional)

De là, décompressez le zip de fichiers et copiez le fichier Fieldwire-connector.pqx dans le dossier Custom Connectors.

Ce dossier se trouve ici :

C:\Users\<username>\Documents\Power BI Desktop\Custom Connectors

Si cette étape ne fonctionne pas, vous utilisez probablement l’application Microsoft Store, qui n’est pas entièrement prise en charge par Fieldwire (la version de bureau est fortement recommandée). Si vous utilisez l’application Store, vous devrez modifier le nom du dossier en conséquence :

C:\Users\<username>\Documents\Microsoft Power BI Desktop\Custom Connectors

 

Mise à jour des paramètres de sécurité

Étant donné que le connecteur est actuellement en version bêta, il n’a pas encore été certifié par Microsoft. Vous devrez autoriser l’installation dans vos paramètres Power BI.

Processus d'autorisation

Ouvrir le bureau Power BI et suivre les étapes ci-dessous :

1. Allez à Options de fichier et paramètres Options Sécurité

2. Dans la section Extensions de données, sélectionnez
"(Non recommandé) Autoriser le chargement de toute extension sans validation ni avertissement".

3. Sélectionnez OK

4. Fermer le Power BI et le rouvrir

 

Utilisez le Connector

Maintenant que la configuration initiale est terminée, vous pouvez commencer à utiliser le connecteur pour extraire des données de votre compte Fieldwire. Voici comment :

1. Sélectionnez Get Data -> More...



2. Tapez Fieldwire dans la barre de recherche. Sélectionnez Fieldwire -> Connect.

3. Accepter l’invite de Microsoft vous informant que ce plugin est encore en développement.
4. Une nouvelle invite vous demandera l’URL de Fieldwire et le numéro de projet. 



a. Pour l’URL de Fieldwire, choisissez Production.
b. Pour l’ID du projet, suivez les étapes suivantes :

• Connectez-vous à Fieldwire et ouvrez le projet correspondant
  Copiez l’ID de votre projet à partir de l’URL dans la barre de navigation : 

Dans l'exemple ci-dessus, l' ID du projet est "fccd93a5-ba9d-4cb5-91c3-7249994dbe1e".

5. Le connecteur vous demandera alors d’entrer votre clé API (voir cet article pour plus d’informations : Introduction à l'API Fieldwire).
6. Cliquez sur OK. Le connecteur devrait maintenant commencer à extraire des données de votre projet Fieldwire sélectionné.

 

Une fois les données récupérées, vous pouvez commencer votre analyse. Toutes vos données sont situées à droite de votre écran. Vous pouvez également cliquer sur « Actualiser » pour obtenir les renseignements les plus à jour. L’interface devrait ressembler à ceci :

 

Utilisation du modèle par défaut

Nous avons fourni un modèle prédéfini avec un ensemble initial de requêtes et de visualisation pour vous aider à démarrer. Pour l’utiliser, vous devrez suivre les étapes suivantes : 

1. Dans la barre supérieure de l’interface Power BI, sélectionnez File -> Import -> Import template.



2. Sélectionnez le modèle qui a été décompressé du paquet zip de Fieldwire. Le modèle porte le nom:  Fieldwire-Dashboard-Template.pbit.

3. Une fois le modèle chargé, suivez les étapes précédentes pour entrer votre ID de projet et la clé d’API. Si cela réussit, vous verrez le modèle commencer à charger avec vos données de projet, créant un tableau de bord.

Le tableau de bord contient 4 pages par défaut :

1. Tasks - Project overview : Tâches - Aperçu du projet.  Cette vue est axée sur les projets, ce qui vous permet d’identifier les projets et les tâches en retard.

2. Tasks - People overview : Tâches – Aperçu des personnes

Cette vision est centrée sur les personnes, avec l’intention de veiller à ce que le travail soit divisé également et que personne n’ait trop à faire le même jour. Il aide également les gestionnaires à voir clairement quand les gens travaillent sur plusieurs sites d’emploi.


3. Tasks - Checklist items : Tâches - Éléments de la liste de contrôle. Cette vue est dédiée aux éléments de la liste de contrôle des tâches. Elle est flexible pour s’adapter à divers cas d’utilisation.



4. Forms overview : Aperçu des formulaires.  Cette vue vous permet de suivre la réalisation du formulaire dans vos projets.

 

Voici une vidéo de présentation du tableau de bord de Power BI :

 

 

Félicitations, vous devriez maintenant avoir accès à vos données Fieldwire dans Power BI! Veuillez noter que tous les champs de données de Fieldwire ne sont pas actuellement disponibles via Power BI; pour nous aider à établir la priorité des champs de données qui doivent être transférés d’abord dans Power BI, Veuillez nous faire part de vos idées. Vous pouvez le faire en communiquant avec notre équipe de soutien : Contacter équipe Support.

Comment modifier les projets affichés dans votre tableau de bord

Dans la vidéo de cette section, nous montrons comment modifier facilement les projets inclus dans votre tableau de bord sans avoir à en créer un nouveau depuis zéro ! Cette mise à jour est automatique pour tous les clients utilisant Power BI, il n’est donc pas nécessaire de télécharger à nouveau nos connecteurs et modèles.

1. Accédez à votre tableau de bord Power BI.

2. Cliquez sur le bouton Transformer les données dans la barre d’outils.

3. Sélectionnez Modifier les paramètres.

4. Mettez à jour le champ projectsIDs avec les nouvelles informations.

5. Cliquez sur OK.

6. Sélectionnez Appliquer les modifications.

Note : Vous devrez peut-être attendre que tous les champs pertinents se chargent avant de voir les nouvelles informations de projet.

 

 

Guide complet : Configuration d’un rapport Power BI avec le connecteur Fieldwire et passerelle locale(On-premises Data Gateway)

Ce guide explique comment créer un rapport Power BI utilisant le connecteur personnalisé Fieldwire - v1.0.0, le publier, configurer la passerelle locale, associer le modèle sémantique et tester l’actualisation.

 

Prérequis

• Passerelle de données locale (Fieldwire-Gateway) installée en mode Standard et en cours d’exécution.

• Fichiers de connecteur personnalisé :

  • Fieldwire.pqx (Power BI Desktop)

  • Fieldwire.mez (passerelle)

• Modèle de rapport Fieldwire-Dashboard-Template.pbit (optionnel).

• Valeurs de paramètres pour la connexion dans Power BI Desktop :

  • Importer la liste complète des projets et des utilisateurs : true

  • Liste des ID projets (séparés par des virgules) : 3141de71-0cc4-47d0-9319-c6d40a4411a (à adapter selon vos projets).

• Clé API Fieldwire valide.

• Power BI Desktop installé.

Phase 1 : Power BI Desktop – Développement et publication du rapport

1. Installer Fieldwire.pqx

   • Copier le fichier dans le dossier des connecteurs personnalisés :

     [Vos Documents]\Power BI Desktop\Custom Connectors

   • Créer le dossier s’il n’existe pas.

2. Ajuster la sécurité de Power BI Desktop

   • Fichier > Options et paramètres > Options → Global > Sécurité → Autoriser toute extension à se charger sans validation ou avertissement.

   • Cliquer sur OK et fermer Power BI Desktop.

3. Créer ou ouvrir un rapport

   • Option A : ouvrir Fieldwire-Dashboard-Template.pbit.

   • Option B : créer un rapport vierge.

4. Se connecter à Fieldwire

   • Obtenir des données → sélectionner Fieldwire - v1.0.0.

   • Entrer les paramètres :

     • Importer la liste complète des projets et des utilisateurs : true

     • Liste des ID projets : vos ID projet(s)

   • Authentification : saisir la clé API Fieldwire.
     ⚠️ Les paramètres définissent le extensionDataSourcePath, qui devra être identique lors de la configuration de la passerelle.

5. Développer le rapport

   • Créer pages, visuels, mesures et relations.

6. Sauvegarder le rapport

   • Fichier > Enregistrer sous → .pbix.

7. Publier le rapport

   • Accueil > Publier → sélectionner l’espace de travail.

Phase 2 : Installation et vérification du connecteur sur la passerelle

1. Installer Fieldwire.mez

   • Copier le fichier dans :

     C:\Windows\ServiceProfiles\PBIEgwService\Documents\Power BI Desktop\Custom Connectors

   • Créer les dossiers si nécessaire.

2. Redémarrer le service de la passerelle

   • services.msc → clic droit sur On-premises data gateway service → Redémarrer.

3. Vérifier le connecteur

   • Ouvrir l’application On-premises data gateway → onglet Connecteurs → vérifier que Fieldwire - v1.0.0 apparaît.

Phase 3 : Créer/configurer la connexion de source de données sur la passerelle

1. Accéder à la gestion des passerelles

   • Power BI Service → ⚙️ → Gérer les connexions et les passerelles.

2. Créer une nouvelle connexion

   • Onglet Connexions → + Nouveau.

3. Configurer la connexion

   • Cluster : Fieldwire-Gateway.

   • Nom de connexion : descriptif.

   • Type : Fieldwire - v1.0.0.

   • Paramètres identiques à Power BI Desktop :

     • Importer la liste complète des projets et des utilisateurs : true

     • Liste des ID projets : vos ID projet(s)

   • Clé API Fieldwire.

   • Niveau de confidentialité : Organisationnel ou Privé.

4. Créer et tester la connexion

   • Cliquez sur Créer → statut En ligne.

   • En cas d’erreur, vérifier paramètres et clé API.

Phase 4 : Configurer le modèle sémantique dans Power BI Service

1. Accéder aux paramètres du modèle

   • Espace de travail → modèle sémantique → … > Paramètres.

2. Connexions passerelle et cloud

   • Section Passerelle et connexions cloud → bouton “Utiliser une passerelle” peut être désactivé (normal).

3. Associer la source de données à la passerelle

   • Dans Connexions passerelle, sélectionner la connexion créée en Phase 3.

   • Vérifier que extensionDataSourcePath correspond aux paramètres Power BI Desktop.

4. Appliquer les modifications

   • Cliquer sur Appliquer → statut mis à jour → icône d’erreur disparue.

Phase 5 : Tester l’actualisation

1. Lancer une actualisation manuelle

   • Paramètres du modèle → Actualiser maintenant

   • Ou depuis l’espace de travail → icône de rafraîchissement.

2. Vérifier l’historique des actualisations

   • Paramètres → Historique des actualisations → statut doit passer de En cours à Terminé.

   • En cas d’erreur, consulter le message pour dépannage.

En suivant ces étapes et en respectant strictement la correspondance des paramètres et de la clé API, votre rapport Power BI utilisant le connecteur Fieldwire sera correctement actualisable via la passerelle locale.

 

 

Foire aux questions

Quel type de données puis-je accéder avec le connecteur Fieldwire?

 

Voici une liste des champs de données actuels de votre projet Fieldwire avec lesquels vous pouvez travailler dans Power BI. (Veuillez noter que les messages de tâche, les pièces jointes aux tâches, les attributs personnalisés et le contenu du formulaire ne sont pas disponibles).



Si vous souhaitez accéder à d’autres champs, veuillez nous envoyer ces informations à l’adresse suivante support@fieldwire.com. 

Le connecteur Fieldwire Power BI fonctionne-t-il avec la version de base gratuite de Power BI ?
Oui ! Le connecteur fonctionne avec tous les niveaux de Power BI. Toutefois, pour publier des tableaux de bord en ligne à vos coéquipiers, vous aurez besoin d’une licence Pro. Voici la structure de tarification de Microsoft..

À quelle fréquence les données sont-elles mises à jour dans Power BI ?

Les données ne sont actualisées que lorsque vous cliquez directement sur le bouton "Actualiser" dans l’application Power BI.

Puis-je créer plus de tableaux de bord ?

 

Oui, via l’application de  Power BI. Ils peuvent être publiés en ligne avec une licence Power BI Pro pour permettre la visualisation des données de votre projet par les autres membres de l’équipe.

 Que faire si j’ai besoin de données spécifiques qui ne sont pas disponibles via le connecteur Power BI de Fieldwire ?

Nous vous recommandons d’utiliser notre API pour ajouter ces informations directement à Power BI (il vous faudra probablement un développeur/expert en Power BI dans votre équipe pour faciliter cela).

Veuillez également nous en informer à l’adresse support@fieldwire.com afin que vos retours puissent être enregistrés comme une nouvelle demande de fonctionnalité.

 

Comment puis-je aider à faire certifier le connecteur Power BI de Fieldwire ?

Faire certifier notre connecteur permettra une installation en environ 3 clics. Cela le rendra également compatible avec le Web et macOS, et activera l’actualisation automatique des données. Vous pouvez contribuer à la certification de notre connecteur Power BI de deux façons :

• Si vous êtes en contact avec un représentant de Microsoft, merci de l’en informer. C’est le principal levier utilisé par Microsoft pour prioriser la certification des connecteurs.

• Vous pouvez voter pour cette idée sur le forum Microsoft.

Combien de projets peuvent être inclus dans un seul tableau de bord Power BI ?
Vous pouvez inclure jusqu’à 100 projets par tableau de bord.

 

Plus d'informations

Onglet Intégrations : Configuration de SharePoint et Google Drive
Comment utiliser la vue d’analyse des tâches