Documentation Automatisée &
Rapports de Conformité pour TIA Portal
Générez des rapports de projet complets, des documents de test d'acceptation FAT/SAT et des packages de livrables en une seule commande - pas de collecte manuelle de données, pas de mise en forme.
Quatre Types de Rapports, Une Commande
D'un aperçu technique rapide à un package de conformité signé
Rapport de Projet
Documentation technique complète du projet TIA Portal. Couvre la configuration matérielle, la topologie réseau, la liste des E/S, les blocs de programme, les variables, les UDT, les écrans HMI, les références croisées et le statut de compilation. Le document de base pour toute remise de projet.
Rapport FAT
Rapport Factory Acceptance Test combinant le rapport de projet complet avec les résultats de tests automatisés, un snapshot VCS de l'état du projet au moment du test, et une page de signature. Produit à la fin des tests en usine avant expédition.
Rapport SAT
Rapport Site Acceptance Test avec la même structure que le rapport FAT, adapté pour la mise en service sur site. Documente l'état final installé et mis en service du système.
Livrable de Projet
Une archive ZIP complète combinant le rapport PDF, l'export de données XLSX, une archive TIA Portal .zap20 et un snapshot VCS. Tout ce dont le client ou le système d'archivage a besoin dans un seul fichier.
Contenu d'un Rapport de Projet
Extrait automatiquement du projet TIA Portal en direct - aucune saisie manuelle
- Configuration matérielle : racks, modules, versions de firmware, affectation des emplacements
- Topologie réseau : anneaux PROFINET, sous-réseaux, adresses IP, connexions des appareils
- Liste complète des E/S : adresses physiques, noms symboliques, types de données, descriptions
- Inventaire des blocs programme : OB, FB, FC, DB avec tailles et dates de modification
- Tables de variables : toutes les variables PLC avec adresses, types et commentaires
- User-Defined Types (UDT) : définitions de structure et détails des membres
- Écrans HMI : liste des écrans, décompte des éléments et aperçu des liaisons de variables
- Analyse des références croisées : où chaque variable et bloc est utilisé dans le projet
- Statut de compilation : dernier résultat de build, erreurs, avertissements par appareil
Formats de Sortie
Chaque format sert un public et un workflow différents
Rapport PDF
Document lisible par l'homme pour les clients, les auditeurs et les archives de projet. Sections structurées, tableaux et page de garde. Prêt pour l'impression ou la signature numérique.
Export de Données XLSX
Feuille de calcul exploitable par machine pour analyse approfondie, import dans les systèmes ERP/MES ou pipelines de reporting personnalisés. Chaque section sur une feuille dédiée.
Livrable ZIP
Package projet complet : rapport PDF + données XLSX + archive TIA Portal .zap20 + snapshot VCS. Un seul fichier à remettre au client ou à stocker dans le système de gestion documentaire.
Options de Rapport
Affinez ce que chaque rapport inclut
Filtre d'Appareil
Limitez le rapport à un PLC ou un appareil HMI spécifique via l'option deviceName. Utile pour les projets multi-appareils où chaque unité a son propre test d'acceptation.
Inclusion du Code Source
L'option includeSourceCode ajoute le code source SCL complet de tous les blocs programme. Utile pour les audits, les revues de code ou les livraisons contractuelles.
Résultats de Test
includeTestResults joint la sortie des tests PLC automatisés T-IA Connect exécutés avant la génération du rapport. Prouve que le système a passé sa suite de tests au moment de la signature.
Snapshot VCS
includeVcsSnapshot enregistre le hash du commit Git et la branche au moment de la génération. Fournit un lien infalsifiable entre le rapport et la version exacte du code testé.
Les Rapports dans votre Pipeline DevOps
Déclenchez la génération de rapports automatiquement à la fin des étapes CI/CD
T-IA Connect expose des points de terminaison REST synchrones et asynchrones pour la génération de rapports. Un pipeline CI peut déclencher un rapport FAT à la fin d'un test PLCSim réussi, joindre le PDF en tant qu'artéfact de build et notifier l'ingénieur responsable - le tout sans intervention humaine.
Le point de terminaison asynchrone est recommandé pour les grands projets : le travail est mis en file d'attente, le pipeline vérifie la complétion, et le rapport final est téléchargé lorsqu'il est prêt. Pour les petits projets, le mode synchrone retourne le fichier directement.
Combiné avec le versioning Git et les tests PLC automatisés, le reporting automatisé boucle la boucle DevOps : chaque merge sur main produit un rapport versionné, un état système testé et un livrable projet complet.
Référence des Outils MCP
Six outils couvrant tous les types de rapports et formats de sortie
generate_project_report
Génère le rapport technique complet du projet. Options : deviceName, includeSourceCode, outputPath. Retourne le fichier rapport PDF.
generate_project_deliverable
Produit le package ZIP complet : PDF + XLSX + archive .zap20 + snapshot VCS. Le package standard pour la clôture de projet.
fat_generate_report
Génère le rapport Factory Acceptance Test. Combine le rapport de projet avec les résultats de tests, le snapshot VCS et la page de signature.
sat_generate_report
Génère le rapport Site Acceptance Test. Même structure que le FAT, adapté pour la documentation de mise en service sur site.
Point de terminaison REST Asynchrone
POST /api/reports/generate - met en file d'attente un job de génération et retourne un job ID. Vérifiez GET /api/reports/job/{id} pour le statut, puis téléchargez une fois terminé.
Point de terminaison REST Synchrone
POST /api/reports/generate/sync - génère le rapport de manière synchrone et retourne le fichier directement. Adapté aux petits projets ou à l'usage interactif.