Documentazione Automatizzata e
Report di Conformità per TIA Portal
Genera report di progetto completi, documenti di test di accettazione FAT/SAT e pacchetti di deliverable di progetto in un solo comando - nessuna raccolta dati manuale, nessun lavoro di formattazione.
Quattro tipi di report, un solo comando
Da una rapida panoramica tecnica a un pacchetto di conformità firmato
Report di Progetto
Documentazione tecnica completa del progetto TIA Portal. Copre configurazione hardware, topologia di rete, lista I/O, blocchi di programma, tag, UDT, schermate HMI, riferimenti incrociati e stato della compilazione. Il documento di base per qualsiasi consegna di progetto.
Report FAT
Report Factory Acceptance Test che combina il report completo del progetto con i risultati dei test automatizzati, uno snapshot VCS dello stato del progetto al momento del test e una pagina di firma. Prodotto al termine dei test in fabbrica prima della spedizione.
Report SAT
Report Site Acceptance Test con la stessa struttura del report FAT, personalizzato per la messa in servizio in loco. Documenta lo stato finale installato e collaudato del sistema.
Deliverable di Progetto
Un archivio ZIP completo che combina il report PDF, l'esportazione dei dati XLSX, un archivio TIA Portal .zap20 e uno snapshot VCS. Tutto ciò di cui il cliente o il sistema di archiviazione hanno bisogno in un unico file.
Cosa contiene un Report di Progetto
Estratto automaticamente dal progetto TIA Portal live - nessun inserimento manuale dei dati
- Configurazione hardware: rack, moduli, versioni firmware, assegnazione slot
- Topologia di rete: anelli PROFINET, sottoreti, indirizzi IP, connessioni dispositivi
- Lista I/O completa: indirizzi fisici, nomi simbolici, tipi di dati, descrizioni
- Inventario blocchi programma: OB, FB, FC, DB con dimensioni e date di modifica
- Tabelle tag: tutti i tag PLC con indirizzi, tipi e commenti
- User-Defined Types (UDT): definizioni delle strutture e dettagli dei membri
- Schermate HMI: elenco schermate, conteggio elementi e panoramica dei collegamenti tag
- Analisi dei riferimenti incrociati: dove ogni tag e blocco viene utilizzato nel progetto
- Stato della compilazione: ultimo risultato della build, errori, avvisi per dispositivo
Formati di Output
Ogni formato serve un pubblico e un workflow diversi
Report PDF
Documento leggibile dall'uomo per clienti, auditor e archivi di progetto. Sezioni strutturate, tabelle e un frontespizio. Pronto per la stampa o la firma digitale.
Esportazione Dati XLSX
Foglio di calcolo leggibile dalla macchina per ulteriori analisi, importazione in sistemi ERP/MES o pipeline di reporting personalizzate. Ogni sezione su un foglio dedicato.
Deliverable ZIP
Pacchetto di progetto completo: report PDF + dati XLSX + archivio TIA Portal .zap20 + snapshot VCS. Un unico file da consegnare al cliente o conservare nel sistema di gestione documentale.
Opzioni del Report
Affina i contenuti di ogni report
Filtro Dispositivo
Limita il report a un PLC o dispositivo HMI specifico utilizzando l'opzione deviceName. Utile per progetti multi-dispositivo in cui ogni dispositivo ha il proprio test di accettazione.
Inclusione Codice Sorgente
L'opzione includeSourceCode aggiunge il codice sorgente SCL completo per tutti i blocchi di programma. Utile per audit, revisioni del codice o requisiti contrattuali di consegna dei sorgenti.
Risultati dei Test
includeTestResults allega l'output dei test PLC automatizzati di T-IA Connect eseguiti prima della generazione del report. Dimostra che il sistema ha superato la suite di test al momento della firma.
Snapshot VCS
includeVcsSnapshot registra l'hash del commit Git e il branch al momento della generazione del report. Fornisce un collegamento a prova di manomissione tra il report e l'esatta versione del codice testata.
Report come parte della tua Pipeline DevOps
Attiva la generazione dei report automaticamente al termine delle fasi CI/CD
T-IA Connect espone endpoint REST sia sincroni che asincroni per la generazione dei report. Una pipeline CI può attivare un report FAT al termine di un test PLCSim riuscito, allegare il PDF come artefatto di build e notificare l'ingegnere responsabile - tutto senza intervento umano.
L'endpoint asincrono è consigliato per i grandi progetti: il lavoro viene messo in coda, la pipeline interroga per il completamento e il report finale viene scaricato quando pronto. Per i progetti più piccoli, l'endpoint sincrono restituisce direttamente il file.
Combinato con il versionamento Git e i test PLC automatizzati, il reporting automatizzato chiude il ciclo DevOps: ogni merge su main produce un report versionato, uno stato del sistema testato e un deliverable di progetto completo.
Riferimento Strumenti MCP
Sei strumenti che coprono tutti i tipi di report e formati di output
generate_project_report
Genera il report tecnico completo del progetto. Opzioni: deviceName, includeSourceCode, outputPath. Restituisce il file del report PDF.
generate_project_deliverable
Produce il pacchetto deliverable ZIP completo: PDF + XLSX + archivio .zap20 + snapshot VCS. Il pacchetto standard di consegna per il completamento del progetto.
fat_generate_report
Genera il report Factory Acceptance Test. Combina il report di progetto con i risultati dei test, lo snapshot VCS e la pagina di firma.
sat_generate_report
Genera il report Site Acceptance Test. Stessa struttura del FAT, adattata per la documentazione della messa in servizio in loco.
Endpoint REST Asincrono
POST /api/reports/generate - mette in coda un lavoro di generazione del report e restituisce un ID lavoro. Interroga GET /api/reports/job/{id} per lo stato, quindi scarica al completamento.
Endpoint REST Sincrono
POST /api/reports/generate/sync - genera il report in modo sincrono e restituisce direttamente il file. Adatto per progetti più piccoli o uso interattivo.