Aller au contenu principal

Connecter Power BI à l'API REST

Remarque : Cet article est technique, nous vous recommandons donc de faire intervenir quelqu'un possédant l'expertise technique appropriée. Si vous avez des questions, contactez-nous à support@azumuta.com.

Power BI peut charger les données d'Azumuta via l'API REST. Vous pouvez créer une requête vous-même, ou commencer à 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 rapport, Power BI peut également s'y connecter directement avec le connecteur PostgreSQL. Voir Connecter à la base de données de rapport.

Avant de commencer

  1. Créer un Appareil API et copier sa Clé API. Voir Créer et gérer les Clés API.
  2. Trouvez le Point de terminaison que vous souhaitez lire dans les Docs API intégrées. Dans l'application Azumuta, cliquez sur le point d'interrogation en haut à droite de votre Écran, puis cliquez sur Docs API.

Les Clés API sont limitées à l'environnement, utilisez donc l'URL du même environnement Azumuta auquel la Clé appartient.

Créer une Requête dans Power BI

  1. Ouvrir un nouveau projet dans Power BI.
  2. Cliquez sur Obtenir les données → Requête vierge.
  3. Ouvrir l'Éditeur avancé et Coller 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 du Point de terminaison, par exemple v2/products.
    • YOUR_API_KEY : la Clé API que vous avez copiée.
  2. Quand Power BI demande les identifiants, choisissez Anonyme et définissez le niveau de confidentialité sur Organisationnel. Power BI n'a pas besoin de ses propres identifiants ici, car Azumuta lit la Clé API à partir de l'En-tête de la Demande.
  3. Convertir le résultat en Tableau. Cliquez sur la valeur Liste, puis cliquez sur Vers le Tableau.
  4. Cliquez sur l'icône de développement (⤢) et Sélectionnez les Colonnes dont vous avez besoin.
  5. Si vous avez besoin de données provenant de plusieurs Points de terminaison, répétez ces étapes pour créer une Requête pour chacun.
  6. Créer des Tableaux et des Visuels avec les Données.

Important : La Clé API est stockée dans la Requête. Toute personne qui peut ouvrir le fichier Power BI, ou modifier le rapport Publié, peut la lire. Traitez le Fichier comme une information d'identification, et ne le Partagez pas en dehors de votre entreprise.

Démarrer à partir du modèle d'exemple

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

  1. Créer un Appareil API et copier sa Clé API. Voir Créer et gérer les Clés API.
  2. Ouvrir le modèle dans Power BI.
  3. Ouvrir l'Éditeur Power Query et Sélectionnez chacun des deux Paramètres. Mettre à jour la Valeur actuelle du paramètre de Clé API, et définir UrlEnvironment sur l'URL de votre propre environnement.
  4. Supprimer les Requêtes dont vous n'avez pas besoin. Chaque Requête augmente le Temps de chargement, donc garder seulement ce que vous utilisez rend l'Actualisation plus rapide.
  5. Cliquez sur Fermer et Appliquer pour charger vos Données.
  6. Créer des relations Entre les Tableaux et construire votre Tableau de bord avec les Visuels Power BI.

Articles connexes