Geautomatiseerde Documentatie &
Compliance Rapporten voor TIA Portal
Genereer volledige projectrapporten, FAT/SAT acceptatiedocumenten en projectdeliverable-pakketten met één commando - geen handmatige gegevensverzameling, geen opmaakwerk.
Vier Rapporttypes, Eén Commando
Van een snel technisch overzicht tot een ondertekend compliance-pakket
Projectrapport
Volledige technische documentatie van het TIA Portal project. Omvat hardwareconfiguratie, netwerktopologie, I/O-lijst, programmablokken, tags, UDT's, HMI-schermen, kruisverwijzingen en compilatiestatus. Het basisdocument voor elke projectoverdracht.
FAT Rapport
Factory Acceptance Test rapport dat het volledige projectrapport combineert met geautomatiseerde testresultaten, een VCS snapshot van de projectstatus op het moment van testen, en een aftekenpagina. Geproduceerd aan het einde van de fabriekstests vóór verzending.
SAT Rapport
Site Acceptance Test rapport met dezelfde structuur als het FAT rapport, op maat gemaakt voor on-site inbedrijfstelling. Documenteert de definitieve geïnstalleerde en in bedrijf gestelde staat van het systeem.
Project Deliverable
Een compleet ZIP-archief met het PDF-rapport, de XLSX-gegevensexport, een TIA Portal .zap20 archief en een VCS snapshot. Alles wat de klant of het archiefsysteem nodig heeft in één bestand.
Wat een Projectrapport Bevat
Automatisch geëxtraheerd uit het live TIA Portal project - geen handmatige gegevensinvoer
- Hardwareconfiguratie: racks, modules, firmwareversies, slottoewijzingen
- Netwerktopologie: PROFINET-ringen, subnetten, IP-adressen, apparaatverbindingen
- Volledige I/O-lijst: fysieke adressen, symbolische namen, datatypes, beschrijvingen
- Programmablok-inventaris: OB's, FB's, FC's, DB's met groottes en wijzigingsdata
- Tag-tabellen: alle PLC-tags met adressen, types en commentaren
- User-Defined Types (UDT's): structuurdefinities en details van leden
- HMI-schermen: schermlijst, aantal elementen en overzicht van tag-bindingen
- Kruisverwijzingsanalyse: waar elke tag en elk blok in het project wordt gebruikt
- Compilatiestatus: laatste build-resultaat, fouten, waarschuwingen per apparaat
Output Formaten
Elk formaat dient een ander publiek en workflow
PDF Rapport
Menselijk leesbaar document voor klanten, auditors en projectarchieven. Gestructureerde secties, tabellen en een voorpagina. Klaar voor printen of digitale handtekening.
XLSX Gegevensexport
Machine-leesbaar spreadsheet voor verdere analyse, import in ERP/MES-systemen of aangepaste rapportage-pipelines. Elke sectie op een eigen blad.
ZIP Deliverable
Compleet projectpakket: PDF rapport + XLSX data + .zap20 TIA Portal archief + VCS snapshot. Eén bestand om aan de klant te overhandigen of op te slaan in het documentbeheersysteem.
Rapportopties
Verfijn wat elk rapport bevat
Apparaatfilter
Beperk het rapport tot een specifieke PLC of HMI via de optie deviceName. Handig voor projecten met meerdere apparaten waarbij elk apparaat een eigen acceptatietest heeft.
Broncode Inclusie
De optie includeSourceCode voegt de volledige SCL-broncode toe voor alle programmablokken. Nuttig voor audits, code-reviews of contractuele eisen voor broncodelevering.
Testresultaten
includeTestResults voegt de output van T-IA Connect geautomatiseerde PLC-tests toe die vóór de rapportgeneratie zijn uitgevoerd. Bewijst dat het systeem de testsuite heeft doorstaan op het moment van ondertekening.
VCS Snapshot
includeVcsSnapshot registreert de Git commit hash en branch op het moment van rapportgeneratie. Biedt een fraudebestendige link tussen het rapport en de exacte geteste codeversie.
Rapporten als Onderdeel van uw DevOps Pipeline
Trigger rapportgeneratie automatisch aan het einde van CI/CD fasen
T-IA Connect biedt zowel synchrone als asynchrone REST endpoints voor rapportgeneratie. Een CI-pipeline kan een FAT-rapport triggeren aan het einde van een succesvolle PLCSim-testrun, de PDF toevoegen als een build artifact en de verantwoordelijke engineer informeren - allemaal zonder menselijke tussenkomst.
Het asynchrone endpoint wordt aanbevolen voor grote projecten: de job wordt in de wachtrij geplaatst, de pipeline pollt voor voltooiing en het voltooide rapport wordt gedownload wanneer het klaar is. Voor kleinere projecten retourneert het synchrone endpoint het bestand direct.
Gecombineerd met Git-versiebeheer and geautomatiseerde PLC-tests, sluit geautomatiseerde rapportage de DevOps-loop: elke merge naar main produceert een versiebeheerd rapport, een geteste systeemstatus en een complete projectdeliverable.
MCP Tools Referentie
Zes tools die alle rapporttypes en outputformaten dekken
generate_project_report
Genereert het volledige technische projectrapport. Opties: deviceName, includeSourceCode, outputPath. Retourneert het PDF-rapportbestand.
generate_project_deliverable
Produceert het complete ZIP-pakket: PDF + XLSX + .zap20 archief + VCS snapshot. Het standaard overdrachtspakket bij projectvoltooiing.
fat_generate_report
Genereert het Factory Acceptance Test rapport. Combineert projectrapport met testresultaten, VCS snapshot en aftekenpagina.
sat_generate_report
Genereert het Site Acceptance Test rapport. Zelfde structuur als FAT, aangepast voor documentatie van inbedrijfstelling op locatie.
Asynchroon REST endpoint
POST /api/reports/generate - plaatst een rapportgeneratie-opdracht in de wachtrij en retourneert een job ID. Poll GET /api/reports/job/{id} voor status, download vervolgens indien voltooid.
Synchroon REST endpoint
POST /api/reports/generate/sync - genereert het rapport synchroon en retourneert het bestand direct. Geschikt voor kleinere projecten of interactief gebruik.