> For the complete documentation index, see [llms.txt](https://help.aphex.co/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.aphex.co/docs/aphex-help-fr/integrations-et-api/power-bi/getting-started-with-power-bi-reporting.md). # Connecter Aphex à Power BI {% hint style="info" %} **À savoir avant de commencer :** * Vous aurez besoin de l’ [application Power BI Desktop téléchargée](https://powerbi.microsoft.com/en-au/) sur votre appareil. * Vous devez être administrateur du projet pour configurer l’intégration. {% endhint %} En plus de notre application de reporting intégrée, Aphex Insight, nous proposons également une intégration avec Power BI afin que les équipes puissent personnaliser leurs rapports et rechercher des informations. Dans ce guide, nous passerons en revue les étapes clés pour commencer à analyser vos données dans Power BI. Si nécessaire, nous inclurons tout au long du guide des liens vers des fonctionnalités plus avancées. ## Activer l’intégration *** L’intégration Power BI est activée au niveau du projet afin que chaque équipe puisse contrôler qui a accès à ses données. Pour commencer, rendez-vous sur votre projet dans Aphex Planner et ouvrez la page Intégrations.
#### Pour activer la source de données : * Ouvrez votre projet * Cliquez sur le titre de votre projet en haut à gauche et sélectionnez `Intégrations` dans le menu * Repérez la section Power BI et activez `Activer la source` ## Générer un jeton *** Une fois la source Power BI activée, vous pourrez copier l’URL unique du point de terminaison de votre projet. Pour sécuriser vos données, le point de terminaison ne renverra aucune donnée tant que la requête n’inclura pas un jeton valide. Le jeton n’est affiché qu’une seule fois, alors assurez-vous de le copier avant de fermer la fenêtre. S’il expire ou si vous oubliez de l’enregistrer, vous pouvez en générer un nouveau à tout moment.
#### Pour générer un jeton : * Sur la page Intégrations, cliquez sur `+ Générer un nouveau jeton` * Donnez un nom à votre jeton afin que les utilisateurs sachent à quoi il sert * Cliquez sur `Générer le jeton` * Sélectionnez `Copier le jeton` * Cliquez sur `Terminé` pour fermer la fenêtre
Comment fonctionnent les jetons **Authentification**\ Power BI se connecte à l’aide de deux éléments : une **URL spécifique au projet** et un **jeton porteur**.\ Le jeton agit comme une clé sécurisée — il prouve que la requête est autorisée à accéder aux données derrière l’URL. **Expiration**\ Les jetons expirent automatiquement après **90 jours**, ou peuvent être révoqués manuellement à tout moment depuis les paramètres d’intégration du projet. **Plusieurs jetons pris en charge**\ Vous pouvez créer autant de jetons que nécessaire — utile si vous connectez différents outils ou modèles. **Nommer les jetons**\ Chaque jeton doit recevoir un nom lors de sa création. Cela vous aide à suivre où il est utilisé (par ex. « Tableau de bord PPC » ou « Suite de reporting client »). **Suivi de l’utilisation**\ Vous pourrez voir le **horodatage de la dernière utilisation** et le **créateur du jeton** pour chaque jeton, afin de savoir ce qui est actif et ce qui peut être nettoyé.
## Télécharger un modèle *** Étape suivante : choisissez un modèle.\ Nous avons créé un ensemble de tableaux de bord Power BI prêts à l’emploi afin que vous n’ayez pas à les créer vous-même de zéro. Choisissez celui qui correspond à vos besoins de reporting, puis vous serez prêt à connecter les données de votre projet.
#### Pour télécharger un modèle : * Visitez [le centre de ressources d’Aphex](https://www.aphex.co/resources) * Choisissez un modèle * Saisissez vos informations et votre e-mail * Ouvrez l’e-mail et cliquez sur le lien de téléchargement * Un fichier PBIT sera téléchargé sur votre appareil Télécharger un modèle ou créez le vôtre à l’aide de la documentation de référence de l’API ## Charger les données dans Power BI *** Étape suivante : ouvrez votre modèle\ Avant que le modèle n’affiche quoi que ce soit, il doit se connecter à votre projet. C’est ici que vous renseignez les valeurs enregistrées précédemment et que vous laissez Power BI charger les données de votre projet dans le rapport.
#### Pour connecter le modèle à votre projet Aphex : * Ouvrez le fichier PBIT dans Power BI Desktop * Il vous sera demandé de saisir trois valeurs : * `URL de l’API du projet` * `Jeton` * `Nom du projet` (cela sert uniquement à l’affichage dans le rapport) * Cliquez sur `Charger` * Power BI demandera en toute sécurité les données de votre projet et les chargera dans le rapport Une fois vos données chargées, le tableau de bord est prêt à être utilisé. Si vous connaissez Power BI, vous pouvez ajuster les visuels, ajouter des filtres ou étendre les rapports pour les adapter au flux de travail de votre projet.
Erreurs courantes * Si vous recevez un avertissement vous demandant d’installer la dernière version de Power BI Desktop, vous pouvez très probablement continuer sans problème (même si mettre votre logiciel à jour est généralement une bonne idée !) * Assurez-vous que votre jeton est valide et que vous avez copié correctement l’URL de l’API du projet **Invite d’accès au contenu web**\ Lorsque Power BI affiche la fenêtre Accès au contenu web, il vous demande comment authentifier votre connexion à l’API. Comme l’authentification est gérée via le jeton porteur que vous avez déjà saisi, aucun identifiant supplémentaire n’est requis ici : * Sélectionnez «`Anonyme`» comme méthode d’authentification, puis cliquez sur `Connecter`. Cela indique à Power BI de n’appliquer aucune autre méthode de connexion. L’utilisation d’autres options comme « Windows » ou « Compte organisationnel » peut bloquer la requête ou provoquer des erreurs.
{% hint style="info" %} Vous avez un excellent modèle de rapport ? Pourquoi ne pas contribuer à la communauté Aphex et le partager avec nous {% endhint %} ## Problèmes de connexion courants *** La plupart des problèmes de connexion se résument à l’une de quelques causes prévisibles. Cette section passe en revue celles que nous voyons le plus souvent et explique comment les résoudre. ### Accès au contenu web : utiliser l’authentification anonyme Lorsque Power BI affiche la fenêtre Accès au contenu web, assurez-vous que `Anonyme` est sélectionné.\ C’est important car l’API utilise votre jeton pour l’authentification — sélectionner une autre méthode (comme Windows ou Compte organisationnel) bloquera la connexion.
#### Pour utiliser l’authentification anonyme : * Dans la fenêtre Accès au contenu web, sélectionnez `Anonyme` * Assurez-vous qu’aucune autre méthode n’est sélectionnée et qu’aucune autre information n’a été saisie dans la fenêtre (comme Clé API Web ou Compte organisationnel) * Vous devrez peut-être aussi vous assurer que le `niveau de confidentialité` est défini sur `Aucun` ou `Public` pour éviter les erreurs lors de l’actualisation #### Pour afficher la fenêtre Accès au contenu web : * Ouvrez le modèle * Cliquez sur `Transformer les données` * Sélectionnez `Paramètres de la source de données` * Cliquez sur `Modifier les autorisations` en bas de la fenêtre * Assurez-vous que les informations d’identification correspondent à : * Type : `Anonyme` * Niveau de confidentialité : `Aucun` * Si nécessaire, sélectionnez `Modifier` pour ouvrir la fenêtre Accès au contenu web
Exemples d’erreurs **`« L’en-tête "Authorization" n’est pris en charge que lors d’une connexion anonyme. »`**\ *`Ces en-têtes peuvent être utilisés avec tous les types d’authentification : Accept, Accept-Charset, Accept-Encoding, etc.`* * Cela signifie que Power BI a tenté de se connecter à l’aide d’une méthode d’authentification qui ne prend pas en charge votre jeton porteur (comme Windows ou Compte organisationnel). *`« Nous n’avons pas pu nous authentifier avec les informations d’identification fournies. »`* * Cela suggère que Power BI utilise peut-être la mauvaise méthode (par ex. « Compte organisationnel ») au lieu d’Anonyme. *`« Le serveur distant a renvoyé une erreur : (401) Non autorisé. »`* * Cela signifie que l’API a bloqué la requête — souvent parce que Power BI a essayé d’utiliser les informations d’identification Windows ou organisationnelles au lieu du jeton.
### Limite de taille de réponse (32 Mo) Par défaut, votre requête renverra les données des 5 versions publiées les plus récentes. Si l’ensemble de données de votre projet est trop volumineux, le chargement de la connexion peut échouer. Sauf si vous êtes sur un forfait Enterprise, la réponse de l’API doit être inférieure à 32 Mo. \ Vous pouvez réduire la quantité de données renvoyées en utilisant des paramètres de requête pour limiter la taille de la réponse. En savoir plus sur les paramètres de requête dans nos documentation de référence de l’API
Exemples de messages d’erreur *`« La taille de la charge utile de la réponse dépasse la limite. »`* * Un signe clair que l’API a renvoyé plus que ce que Power BI est autorisé à traiter. *`« DataFormat.Error : Nous avons atteint la fin du tampon. »`* * Cela signifie généralement que l’ensemble de données était trop volumineux pour être traité par Power BI en une seule réponse. *`« Impossible de se connecter à la source de données. La connexion a été fermée avant que les données puissent être récupérées. »`* * Cela peut parfois se produire lorsque la réponse est trop volumineuse et expire pendant le transfert.
Moyens de réduire la taille des données Vous pouvez utiliser les paramètres suivants individuellement ou en combinaison : * **Limiter le nombre de versions**\ Ajoutez `?limit=3` ou `?limit=2` à l’URL de votre API\ → Exemple : `https://app.aphex.co/au/power-bi...?limit=3` * **Exclure les données de ressources**\ Ajoutez `?resource=false` à l’URL de votre API\ → Utile si vous n’avez pas besoin de rapports sur la main-d’œuvre, le matériel ou les matériaux. * **Exclure les données de statut de retard**\ Ajoutez `?status=false` à l’URL de votre API\ → Utile si vous n’avez pas besoin de faire des rapports sur les raisons des retards. * **Exclure les données de blocage**\ Ajoutez `?blockers=false` à l’URL de votre API\ → Utile si vous n’avez pas besoin de faire des rapports sur les blocages. Vous pouvez combiner des paramètres comme :\ `?limit=3&resource=false&status=false`
### Remplacer des identifiants expirés Les jetons porteurs utilisés pour l’intégration Power BI sont valides pendant 90 jours. Passé ce délai, la connexion cessera de fonctionner jusqu’à ce que vous génériez un nouveau jeton. Si votre jeton a expiré, retournez simplement à la page Intégrations du projet, révoquez l’ancien jeton et générez-en un nouveau. Vous devrez ressaisir le nouveau jeton dans votre rapport pour rétablir la connexion. #### Pour remplacer un jeton expiré : * Générez un nouveau jeton depuis votre projet Aphex * Ouvrez votre modèle dans Power BI * Cliquez sur `Transformer les données` puis `Modifier les paramètres` * Sélectionnez `Modifier le jeton` * Supprimez votre ancien jeton et ajoutez le nouveau, puis sélectionnez `Enregistrer` * Vous devrez peut-être `Recharger les données`
Exemples d’erreurs *`« Le serveur distant a renvoyé une erreur : (401) Non autorisé. »`* * Cela signifie généralement que le jeton est manquant, expiré ou n’est plus valide.
## Configurer l’actualisation automatique *** Une fois votre rapport connecté, vous pouvez configurer une actualisation planifiée dans Power BI pour maintenir automatiquement vos données à jour. Nous vous suggérons de planifier l’actualisation quelques heures après, ou le lendemain du moment où votre équipe crée généralement la version publiée hebdomadaire dans Aphex. Ainsi, votre tableau de bord reflétera toujours le dernier plan, sans aucune mise à jour manuelle. #### Pour configurer l’actualisation planifiée dans Power BI : * **Publiez votre rapport dans Power BI Service** * Dans Power BI Desktop, allez dans `Fichier` → `Publier` → `Mon espace de travail` (ou l’espace de travail partagé de votre équipe). * **Ouvrir les paramètres du jeu de données** * Dans Power BI Service, allez dans votre `espace de travail` → `jeux de données` onglet. * Trouvez le jeu de données lié à votre rapport Aphex et cliquez sur le `Plus d’options (⋯)` → `Paramètres` * **Définir la méthode d’authentification sur Anonyme** * Sous `Informations d’identification de la source de données`, confirmez que la méthode est définie sur `Anonyme`. * Vérifiez également que `niveau de confidentialité` est défini sur `Aucun` ou `Public`, si vous y êtes invité. * **Activer « Ignorer le test de connexion »** * Pour éviter de fausses erreurs lors de la configuration de l’actualisation, veillez à activer «`Ignorer le test de connexion`». * Ce paramètre indique à Power BI de ne pas valider la connexion à l’avance, ce qui est acceptable, car le jeton porteur est déjà intégré dans la requête. * **Configurer l’actualisation planifiée** * Développez la section `Actualisation planifiée` et activez-la : * Choisissez `quotidienne` ou `hebdomadaire` actualisation * **Enregistrez vos modifications** * Votre tableau de bord restera désormais synchronisé avec le dernier plan publié — aucune exportation ni mise à jour manuelle nécessaire. Consultez la documentation Microsoft pour en savoir plus sur [l’actualisation planifiée dans Power BI](https://learn.microsoft.com/en-us/power-bi/connect-data/refresh-scheduled-refresh) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://help.aphex.co/docs/aphex-help-fr/integrations-et-api/power-bi/getting-started-with-power-bi-reporting.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.