L'intégration entre Power BI et Huwise repose généralement sur deux scénarios :
- soit vous importez des données Huwise dans Power BI pour analyse,
- soit vous exposez vos rapports Power BI directement dans l'interface Huwise.
Voici les bonnes pratiques pour optimiser ces flux.
1. Importation de données (Huwise → Power BI)
Si vous utilisez Huwise comme source de données (via ses API) :
- Utilisez l'API V2 (ODSQL) : privilégiez les requêtes API filtrées plutôt que d'importer l'intégralité d'un jeu de données. Utilisez les paramètres
limitetwheredirectement dans votre URL de source Power Query pour ne charger que le nécessaire. - Privilégiez le mode "Import" : sauf besoin de temps réel absolu, le mode Import est plus performant pour les calculs DAX complexes et réduit la charge sur les serveurs API de Huwise.
- Gérez l'authentification par clé API : ne laissez pas vos accès en "Anonyme". Configurez l'authentification dans Power BI via l'en-tête HTTP
AuthorizationouApiKeypour garantir la sécurité et des quotas d'appels plus élevés. - Typage des données : Huwise renvoie souvent du JSON. Assurez-vous de typer vos colonnes (Dates, Décimaux) dès la première étape de Power Query pour éviter les erreurs de calcul ultérieures.
2. Exposition de rapports (Power BI → Huwise)
Si vous affichez vos rapports et tableaux de bord Power BI dans Huwise, l’objectif n’est pas seulement de les rendre visibles dans le portail. Il s’agit surtout de créer un flux fluide entre les deux plateformes : Power BI reste l’espace d’analyse et de visualisation, tandis que Huwise devient le point d’entrée pour découvrir, contextualiser et gouverner ces contenus.
Voici les bonnes pratiques à garder en tête pour optimiser cette intégration.
Clarifiez ce que vous voulez exposer dans Huwise
Avant de configurer le moissonneur Power BI, identifiez les rapports et tableaux de bord qui ont réellement vocation à être découverts dans le portail Huwise.
Évitez de collecter tous les contenus Power BI “par défaut”. Privilégiez les espaces de travail utiles aux utilisateurs finaux, par exemple :
- les rapports de pilotage métier ;
- les tableaux de bord de suivi opérationnel ;
- les visualisations réutilisées dans plusieurs équipes ;
- les contenus validés et prêts à être partagés.
Cela permet d’éviter de surcharger le catalogue avec des rapports de test, des brouillons ou des contenus trop techniques.
Conseil d’optimisation : traitez Huwise comme une vitrine de contenus Power BI qualifiés, pas comme une simple copie de tous les workspaces Power BI.
Utilisez un Service Principal pour fiabiliser le flux
Pour connecter Power BI à Huwise, privilégiez une application Azure dédiée, utilisée comme Service Principal, plutôt qu’un compte utilisateur personnel. Cette approche est plus robuste pour un flux automatisé : elle évite les dépendances à une personne, à un changement de mot de passe ou à un départ d’équipe.
Une fois l’application créée dans Azure, donnez-lui accès uniquement aux espaces de travail Power BI nécessaires. Vous gardez ainsi un périmètre clair, plus facile à maintenir dans le temps.
Conseil d’optimisation : créez un Service Principal dédié à Huwise, avec des droits limités aux workspaces réellement exposés dans le portail.
Choisissez le mode de collecte selon votre besoin de gouvernance
Le connecteur Power BI peut fonctionner en mode Admin ou mode Non-admin.
- En mode Admin, le Service Principal accède à l’API Admin Power BI et peut voir tous les espaces de travail du tenant.
- En mode Non-admin, l’application accède uniquement aux workspaces où elle a été explicitement ajoutée comme utilisateur.
Le mode Non-admin est souvent plus maîtrisé, mais il a toutefois une limite : l’API ne renvoie pas les dates de modification des rapports et tableaux de bord. Chaque collecte peut donc mettre à jour la date des actifs collectés dans Huwise, même si le contenu Power BI n’a pas réellement changé.
Conseil d’optimisation : si vous avez besoin d’un suivi fiable des dates de modification, vérifiez si le mode Admin est plus adapté à votre organisation. Si vous utilisez le mode Non-admin, tenez compte de cette limite dans vos règles de suivi et de fraîcheur des contenus.
Alignez la fréquence de moissonnage sur le rythme réel des rapports
Une fois le connecteur configuré, vous pouvez planifier un moissonnage récurrent. La bonne fréquence dépend du rythme de mise à jour de vos rapports et tableaux de bord Power BI.
Inutile de moissonner très fréquemment des rapports mis à jour une fois par mois. À l’inverse, des tableaux de bord critiques ou très consultés peuvent nécessiter une synchronisation plus régulière.
Conseil d’optimisation : adaptez la fréquence de moissonnage à la valeur métier du contenu et à son rythme réel de mise à jour. Cela évite de consommer des ressources inutilement tout en maintenant un catalogue à jour.
Soignez le mapping des catégories Huwise
Lors de la configuration, vous devez associer les types d’actifs Power BI à vos catégories Huwise. Par exemple, les rapports peuvent être rattachés à une catégorie “Rapports”, “Données” ou “Analyses”, tandis que les tableaux de bord peuvent être rattachés à une catégorie “Visualisations” ou “Tableaux de bord”.
Ce mapping est important : il influence la façon dont les utilisateurs retrouvent les contenus dans le portail.
Conseil d’optimisation : choisissez des catégories compréhensibles par les utilisateurs métier. Évitez de reproduire une organisation trop technique issue de Power BI si elle n’aide pas à la découverte dans Huwise.
Enrichissez les rapports avec du contexte Huwise
Le moissonneur récupère certaines métadonnées Power BI, comme le titre, la description, les dates, le lien vers le contenu et le créateur pour les rapports.
Mais l’intérêt de Huwise est aussi d’ajouter une couche de contexte métier : descriptions plus pédagogiques, tags, thèmes, informations de gouvernance ou indications d’usage.
Conseil d’optimisation : ne vous contentez pas des métadonnées Power BI. Utilisez Huwise pour expliquer à quoi sert le rapport, à qui il s’adresse, comment l’interpréter et dans quel contexte l’utiliser.
Préservez la gouvernance Power BI
L’intégration ne contourne pas les règles d’accès existantes dans Power BI. Si une personne a accès au rapport dans Power BI, elle pourra le consulter depuis Huwise. Si elle n’a pas les droits nécessaires, Huwise affichera un bouton Demander l’accès.
Cela permet de centraliser la découverte des contenus dans Huwise sans dupliquer la gestion des permissions.
Conseil d’optimisation : gardez Power BI comme source de vérité pour les autorisations, et utilisez Huwise pour faciliter la découverte, la compréhension et la demande d’accès.
Gardez en tête le périmètre du connecteur
Le connecteur Power BI collecte les rapports et les tableaux de bord, mais pas les objets de type jeux de données.
Il est donc préférable de présenter cette intégration comme un flux de valorisation des contenus analytiques, et non comme un mécanisme de documentation complète de toute la couche de données Power BI.
Conseil d’optimisation : si vous devez documenter les datasets, mesures ou modèles sémantiques, prévoyez un autre dispositif de documentation complémentaire dans Huwise.
Vous n’avez pas encore accès au connecteur sur votre portail ? Contactez votre CSM pour l’activer.
Vous l’avez déjà testé ? Partagez-nous votre retour d’expérience et vos cas d’usage en commentaire ! 👇