Exporter les données de test vers Power BI

Les tableaux de bord intégrés de TofuPilot couvrent la plupart des besoins en analytique de fabrication. Mais parfois, vous devez combiner les données de test avec les données ERP, MES ou chaîne d'approvisionnement dans un seul rapport pour la direction. C'est là que Power BI intervient.

Quand vous avez besoin d'un BI externe

TofuPilot gère nativement les tendances FPY, le Cpk, les cartes de contrôle, le Pareto des défaillances et le débit. Vous n'avez pas besoin de Power BI pour cela.

Les outils de BI externes sont pertinents quand vous devez corréler les résultats de test avec des données d'autres systèmes. Par exemple : mapper le rendement par lot fournisseur (données ERP), comparer les coûts de test aux réclamations de garantie (données financières), ou construire des synthèses pour la direction qui puisent dans cinq sources différentes.

Option 1 : Export CSV

Le moyen le plus rapide d'intégrer des données dans Power BI. TofuPilot vous permet d'exporter les exécutions de test et les mesures en fichiers CSV directement depuis le tableau de bord.

Dans Power BI Desktop, utilisez Obtenir des données > Texte/CSV pour importer le fichier. Cela fonctionne bien pour les rapports ponctuels ou les snapshots périodiques.

Pour les rapports récurrents, enregistrez le CSV dans un dossier partagé et configurez Power BI pour actualiser depuis cet emplacement selon un planning.

Option 2 : API REST

Pour des données automatisées et toujours à jour, connectez Power BI directement à l'API REST de TofuPilot. Cela récupère les dernières données de test à chaque actualisation du rapport.

Obtenir votre clé API

Générez une clé API sur https://tofupilot.app dans les paramètres de votre espace de travail. Conservez-la en lieu sûr. Vous la passerez en en-tête dans chaque requête.

Points de terminaison de l'API

L'API de TofuPilot fournit des points de terminaison pour les données dont vous aurez besoin dans Power BI :

GET /api/v1/runs retourne les exécutions de test avec le statut, les horodatages, l'ID du DUT et les informations de procédure
GET /api/v1/runs/{id} retourne une seule exécution avec les données de mesure complètes

L'API retourne du JSON. Paginez les résultats en utilisant les paramètres de requête offset et limit.

fetch_runs_example.py

import requests

API_KEY = "your-api-key"
BASE_URL = "https://tofupilot.app/api/v1"

response = requests.get(
    f"{BASE_URL}/runs",
    headers={"Authorization": f"Bearer {API_KEY}"},
    params={"limit": 100, "offset": 0},
)

runs = response.json()

Connecter Power BI à l'API

Dans Power BI Desktop, utilisez Obtenir des données > Web et configurez la requête :

Sélectionnez Avancé dans la boîte de dialogue Web
Définissez l'URL sur https://tofupilot.app/api/v1/runs?limit=100
Ajoutez l'en-tête Authorization avec la valeur Bearer your-api-key
Cliquez sur OK pour charger la réponse JSON

L'éditeur Power Query de Power BI affichera le JSON brut. Utilisez Vers une table > Développer les colonnes pour aplatir la structure imbriquée en lignes et colonnes.

Gestion de la pagination

L'API de TofuPilot pagine les résultats. Pour charger toutes les exécutions, créez une requête paramétrée dans Power Query qui itère sur les pages :

power_query_pagination.m

let
    BaseUrl = "https://tofupilot.app/api/v1/runs",
    PageSize = 100,
    GetPage = (offset) =>
        let
            Response = Web.Contents(
                BaseUrl,
                [
                    Query = [limit = Text.From(PageSize), offset = Text.From(offset)],
                    Headers = [Authorization = "Bearer your-api-key"]
                ]
            ),
            Json = Json.Document(Response)
        in
            Json,
    AllPages = List.Generate(
        () => [Page = GetPage(0), Offset = 0],
        each List.Count([Page]) > 0,
        each [Page = GetPage([Offset] + PageSize), Offset = [Offset] + PageSize],
        each [Page]
    ),
    Combined = List.Combine(AllPages),
    AsTable = Table.FromList(Combined, Splitter.SplitByNothing(), null, null, ExtraValues.Error)
in
    AsTable

Cette requête récupère les pages jusqu'à obtenir un résultat vide, puis combine le tout en une seule table.

Construire des rapports utiles

Une fois les données dans Power BI, concentrez les rapports sur ce que TofuPilot ne montre pas déjà.

Corrélation inter-systèmes. Joignez les exécutions de test avec les données de lot fournisseur de votre ERP. Construisez une matrice de rendement par fournisseur, par composant, par plage de dates. Cela répond à « quels composants du fournisseur causent le plus de défaillances ? » sans travail manuel de tableur.

Synthèses pour la direction. Combinez les métriques de rendement avec les données de volume de production et de coûts. Affichez les unités expédiées, le coût de test par unité et le taux de retours garantie sur une seule page.

Comparaison multi-sites. Si vous utilisez TofuPilot sur plusieurs usines, Power BI peut extraire de toutes les instances et normaliser les données dans une vue inter-sites unique.

Maintenir les données à jour

Configurez l'actualisation planifiée dans Power BI Service (cloud) pour extraire les nouvelles données quotidiennement ou toutes les heures. Pour la connexion API, stockez les identifiants dans les paramètres de source de données de Power BI afin que les actualisations s'exécutent sans intervention.

Pour les rapports basés sur des CSV, automatisez l'export avec un script planifié qui dépose le fichier là où Power BI l'attend.