Connecter Power BI au REST API

Mis à jour

Remarque : Cet article est technique ; nous vous recommandons de faire appel à une personne disposant des compétences techniques appropriées. Si vous avez des questions, contactez-nous à support@azumuta.com.

Power BI peut charger les données Azumuta via la REST API. Vous pouvez créer une requête vous-même, ou partir d’un modèle d’exemple qui inclut déjà plusieurs requêtes.

Si votre espace de travail utilise la base de données de reporting, Power BI peut également s’y connecter directement via le connecteur PostgreSQL. Voir Se connecter à la base de données de reporting.

Avant de commencer

  1. Créez un appareil API et copiez sa clé API. Voir Créer et gérer des clés API.
  2. Trouvez l’endpoint que vous souhaitez lire dans la documentation API intégrée. Dans l’application Azumuta, cliquez sur le point d’interrogation en haut à droite de votre écran, puis cliquez sur API docs.

Les clés API sont spécifiques à un environnement : utilisez donc l’URL du même environnement Azumuta pour lequel la clé a été générée.

Créer une requête dans Power BI

  1. Ouvrez un nouveau projet dans Power BI.
  2. Cliquez sur Get data → Blank query.
  3. Ouvrez l’Advanced editor et collez le code suivant :
let
  Source =
    Json.Document(
      Web.Contents(
        "https://YOUR_AZUMUTA_URL",
        [
          RelativePath = "api/YOUR_ENDPOINT",
          Headers = [
            #"x-api-key" = "YOUR_API_KEY",
            #"Accept" = "application/json"
          ]
        ]
      )
    )
in
  Source
  1. Remplacez les espaces réservés :
    • YOUR_AZUMUTA_URL : l’URL de votre environnement Azumuta.
    • YOUR_ENDPOINT : le chemin de l’endpoint, par exemple v2/products.
    • YOUR_API_KEY : la clé API que vous avez copiée.
  2. Lorsque Power BI demande des informations d’identification, choisissez Anonymous et définissez le niveau de confidentialité sur Organizational. Power BI n’a pas besoin de ses propres identifiants ici, car Azumuta lit la clé API depuis l’en-tête de la requête.
  3. Convertissez le résultat en table. Cliquez sur la valeur List, puis sur To Table.
  4. Cliquez sur l’icône d’expansion (⤢) et sélectionnez les colonnes nécessaires.
  5. Si vous avez besoin de données provenant de plusieurs endpoints, répétez ces étapes pour créer une requête par endpoint.
  6. Créez des tables et des visuels avec les données.

Important : La clé API est stockée dans la requête. Toute personne pouvant ouvrir le fichier Power BI, ou modifier le rapport publié, peut la lire. Traitez ce fichier comme des informations d’identification et ne le partagez pas en dehors de votre entreprise.

Démarrer depuis le modèle d’exemple

Azumuta propose un modèle Power BI d’exemple qui charge les données via la REST API et gère les résultats paginés. Pour l’obtenir, contactez support@azumuta.com.

  1. Créez un appareil API et copiez sa clé API. Voir Créer et gérer des clés API.
  2. Ouvrez le modèle dans Power BI.
  3. Ouvrez le Power Query Editor et sélectionnez chacun des deux paramètres. Mettez à jour la valeur actuelle du paramètre de clé API et réglez UrlEnvironment sur l’URL de votre propre environnement.
  4. Supprimez les requêtes dont vous n’avez pas besoin. Chaque requête augmente le temps de chargement ; ne conserver que ce que vous utilisez accélère le rafraîchissement.
  5. Cliquez sur Close & Apply pour charger vos données.
  6. Créez des relations entre les tables et construisez votre tableau de bord avec les visuels Power BI.

Articles liés

Sur cette page