Automatiserad dokumentation &
Efterlevnadsrapporter för TIA Portal
Generera fullständiga projektrapporter, FAT/SAT-godkännandedokument och projektleveranspaket med ett enda kommando - ingen manuell datainsamling, inget formateringsarbete.
Fyra rapporttyper, ett kommando
Från en snabb teknisk översikt till ett signerat efterlevnadspaket
Projektrapport
Fullständig teknisk dokumentation av TIA Portal-projektet. Omfattar hårdvarukonfiguration, nätverkstopologi, I/O-lista, programblock, taggar, UDT:er, HMI-bilder, korsreferenser och kompileringsstatus. Basdokumentet för varje projektöverlämning.
FAT-rapport
Factory Acceptance Test-rapport som kombinerar den fullständiga projektrapporten med automatiserade testresultat, en VCS-ögonblicksbild av projekttillståndet vid testtillfället och en godkännandesida. Skapas vid slutet av fabrikstestningen före leverans.
SAT-rapport
Site Acceptance Test-rapport med samma struktur som FAT-rapporten, anpassad för driftsättning på plats. Dokumenterar systemets slutliga installerade och driftsatta tillstånd.
Projektleverans
Ett komplett ZIP-arkiv som kombinerar PDF-rapporten, XLSX-dataexport, ett TIA Portal .zap20-arkiv och en VCS-ögonblicksbild. Allt kunden eller arkivsystemet behöver i en enda fil.
Vad en projektrapport innehåller
Extraheras automatiskt från det live TIA Portal-projektet - ingen manuell datainmatning
- Hårdvarukonfiguration: rack, moduler, firmwareversioner, platsallokeringar
- Nätverkstopologi: PROFINET-ringar, subnät, IP-adresser, enhetsanslutningar
- Komplett I/O-lista: fysiska adresser, symboliska namn, datatyper, beskrivningar
- Programblocksinventering: OB, FB, FC, DB med storlekar och ändringsdatum
- Taggtabeller: alla PLC-taggar med adresser, typer och kommentarer
- User-Defined Types (UDT:er): strukturdefinitioner och medlemsdetaljer
- HMI-bilder: bildlista, antal element och översikt över taggbindningar
- Korsreferensanalys: var varje tagg och block används i hela projektet
- Kompileringsstatus: senaste byggresultat, fel, varningar per enhet
Utdataformat
Varje format tjänar en annan målgrupp och ett annat arbetsflöde
PDF-rapport
Människoläsbart dokument för kunder, revisorer och projektarkiv. Strukturerade avsnitt, tabeller och en försättssida. Klar för utskrift eller digital signatur.
XLSX-dataexport
Maskinläsbart kalkylblad för vidare analys, import till ERP/MES-system eller anpassade rapporteringspipelines. Varje avsnitt på ett dedikerat ark.
ZIP-leverans
Komplett projektpaket: PDF-rapport + XLSX-data + .zap20 TIA Portal-arkiv + VCS-ögonblicksbild. En fil att lämna över till kunden eller lagra i dokumenthanteringssystemet.
Rapportalternativ
Finjustera vad varje rapport innehåller
Enhetsfilter
Begränsa rapporten till en specifik PLC- eller HMI-enhet med alternativet deviceName. Användbart för projekt med flera enheter där varje enhet har sitt eget godkännandetest.
Källkodsinkludering
Alternativet includeSourceCode bifogar fullständig SCL-källkod för alla programblock. Användbart för revisioner, kodgranskningar eller avtalsenliga krav på källkodsleverans.
Testresultat
includeTestResults bifogar utdata från T-IA Connect automatiserade PLC-tester som körts före rapportgenerering. Bevisar att systemet klarade sin testsvit vid tidpunkten för godkännande.
VCS-ögonblicksbild
includeVcsSnapshot registrerar Git-commithashen och grenen vid tidpunkten för rapportgenerering. Ger en manipuleringssäker länk mellan rapporten och den exakta kodversion som testats.
Rapporter som en del av din DevOps-pipeline
Trigger rapportgenerering automatiskt vid slutet av CI/CD-steg
T-IA Connect exponerar både synkrona och asynkrona REST-slutpunkter för rapportgenerering. En CI-pipeline kan utlösa en FAT-rapport vid slutet av en lyckad PLCSim-testkörning, bifoga PDF:en som en byggartefakt och meddela ansvarig ingenjör - allt utan mänsklig intervention.
Den asynkrona slutpunkten rekommenderas för stora projekt: jobbet köas, pipelinen pollar efter färdigställande och den färdiga rapporten laddas ner när den är klar. För mindre projekt returnerar den synkrona slutpunkten filen direkt.
Kombinerat med Git-versionering och automatiserad PLC-testning stänger automatiserad rapportering DevOps-loopen: varje merge till main producerar en versionerad rapport, ett testat systemtillstånd och en komplett projektleverans.
Referens för MCP-verktyg
Sex verktyg som täcker alla rapporttyper och utdataformat
generate_project_report
Genererar den fullständiga tekniska projektrapporten. Alternativ: deviceName, includeSourceCode, outputPath. Returnerar PDF-rapportfilen.
generate_project_deliverable
Producerar det kompletta ZIP-leveranspaketet: PDF + XLSX + .zap20-arkiv + VCS-ögonblicksbild. Standardpaketet för överlämning vid projektavslut.
fat_generate_report
Genererar Factory Acceptance Test-rapporten. Kombinerar projektrapport med testresultat, VCS-ögonblicksbild och godkännandesida.
sat_generate_report
Genererar Site Acceptance Test-rapporten. Samma struktur som FAT, anpassad för driftsättningsdokumentation på plats.
Asynkron REST-slutpunkt
POST /api/reports/generate - köar ett rapportgenereringsjobb och returnerar ett jobb-ID. Polla GET /api/reports/job/{id} för status, ladda sedan ner när det är klart.
Synkron REST-slutpunkt
POST /api/reports/generate/sync - genererar rapporten synkront och returnerar filen direkt. Lämplig för mindre projekt eller interaktiv användning.