Pour commencer avec BIM Track et Power BI, consultez Connecter BIM Track avec Power BI Desktop.
Voir l'exemple du tableau de bord, des fonctions et de la vidéo rapide de powerBI :
PowerBI demo
Interactive key plans in powerBI
Getting started with powerBi & BIM Track video
PBI file with template functions to do pagination
Note : Par défaut, chaque fichier/image est protégé par un jeton d'accès généré sur demande. Le délai d'expiration de ces jetons est de 8 heures et les jetons sont réutilisés à condition qu'il reste une heure de validité. Si l'API est interrogée au cours de la dernière heure de validité, un nouveau jeton est généré, à nouveau valide pendant 8 heures.
Ce mécanisme peuiut causer des problèmes dans Power BI si l'ensemble de données est rafraîchi juste avant la dernière heure. Dans ce cas, l'API renverrait le jeton existant (q expirera dans l'heure qui suit), de sorte que l'URL pourrait ne pas être fiable avant le prochain rafraîchissement. Nous avons ajouté un moyen de forcer la régénération des jetons et de contrôler la durée de vie des jetons générés. Pour en profiter, il faut ajouter des headersaux requêtes :
x-externalLinksTokenPolicy-createNewTokens = true
Utilisez ce header pour forcer la génération de nouveaux jetons, ayant la durée de vie par défaut définie dans BIM Track (8 heures)
x-externalLinksTokenPolicy-expirationDelay = 480
Utilisez ce header pour contrôler la durée de vie, en minutes, des jetons générés
Exemple dans Postman :
Comment interroger l'API BIM Track
Afin d'interroger les données de l'API de BIMT Track, vous pouvez soit :
-
Créer une nouvelle requête web à partir de la documentation
https://api.bimtrackapp.co//swagger/ui/index
Notez que la création d'une simple requête de questions pour un projet de plus de 100 questions ne retournera que les 100 dernières questions, à moins que vous ne construisiez une fonction de pagination
-
Utilisez l'une des fonctions de ce fichier pour interroger les données.
PBI file with template functions to do pagination
En utilisant ces fonctions, vous pourrez récupérer toutes les données telles qu'elles sont construites pour faire la pagination.
- Dans l'éditeur, sélectionnez l'une des fonctions
- Remplissez les champs demandés et invoquez la fonction
- Vous avez maintenant les données demandées et vous devez les agrandir et les traiter dans Power BI
Les bases de PowerBI
Les données du projet de démonstration sont affichées telles quelles. Pour obtenir des données pertinentes à partir des requêtes, vous devez comprendre certains des principes qui sous-tendent la structure des données afin de vous assurer que vous obtenez les bons résultats :
- Lorsque vous ouvrez une liste, vous pouvez avoir plusieurs lignes pour le même ID de question par exemple. Cela a du sens une fois que vous avez compris que, par exemple, une question peut avoir plusieurs captures d'écran et donc plusieurs imageUrl. Selon les données que vous voulez analyser, vous voudrez régler le filtrage sur "unique data"
- [Modélisation] [Gérer les relations] ou l'onglet des relations dans le panneau de gauche vous permet de définir des relations entre les requêtes. À partir d'une requête contenant l'ID de la question, vous pourrez relier cet ID à celui d'une autre requête et utiliser correctement les données des deux requêtes dans une visualisation
- Afin de voir l'image d'un projet, vous devez définir les données de la colonne dans la catégorie ImageURL dans l'onglet [MODELAGE] [PROPRIETES] [CATEGORIE DE DONNEES].
AVIS DE NON-RESPONSABILITÉ
Les données du projet de démonstration ne sont pas pertinentes, elles ne sont là qu'à titre de démonstration des fonctions et le jeton d'accès peut être révoqué à tout moment. Vous devez comprendre que le jeton d'accès est privé et permet non seulement de lire les données de la base de données du hub de BIMTrack, mais aussi d'écrire des données, donc il ne doit pas être partagé à l'extérieur de votre organisation sans préavis.