Zautomatyzowana dokumentacja i
Raporty zgodności dla TIA Portal
Generuj pełne raporty projektowe, dokumenty akceptacyjne FAT/SAT i pakiety dokumentacji projektowej za pomocą jednego polecenia - bez ręcznego zbierania danych i formatowania.
Cztery typy raportów, jedno polecenie
Od szybkiego przeglądu technicznego po zatwierdzony pakiet zgodności
Raport projektu
Pełna dokumentacja techniczna projektu TIA Portal. Obejmuje konfigurację sprzętową, topologię sieci, listę I/O, bloki programowe, tagi, UDT, ekrany HMI, odsyłacze i status kompilacji. Podstawowy dokument przy przekazywaniu projektu.
Raport FAT
Raport Factory Acceptance Test łączący pełny raport projektu z automatycznymi wynikami testów, migawką VCS stanu projektu w momencie testu oraz stroną zatwierdzenia. Przygotowywany po zakończeniu testów fabrycznych przed wysyłką.
Raport SAT
Raport Site Acceptance Test o strukturze identycznej jak raport FAT, dostosowany do uruchomienia u klienta. Dokumentuje ostateczny stan zainstalowanego i uruchomionego systemu.
Dokumentacja projektowa (Deliverable)
Kompletne archiwum ZIP łączące raport PDF, eksport danych XLSX, archiwum TIA Portal .zap20 oraz migawkę VCS. Wszystko, czego potrzebuje klient lub system archiwizacji w jednym pliku.
Co zawiera raport projektu
Automatycznie wyodrębniane z aktywnego projektu TIA Portal - bez ręcznego wprowadzania danych
- Konfiguracja sprzętowa: szafy, moduły, wersje oprogramowania układowego, przypisania gniazd
- Topologia sieci: pierścienie PROFINET, podsieci, adresy IP, połączenia urządzeń
- Pełna lista I/O: adresy fizyczne, nazwy symboliczne, typy danych, opisy
- Inwentarz bloków programowych: OB, FB, FC, DB wraz z rozmiarami i datami modyfikacji
- Tabele tagów: wszystkie tagi PLC wraz z adresami, typami i komentarzami
- User-Defined Types (UDTs): definicje struktur i szczegóły elementów
- Ekrany HMI: lista ekranów, liczba elementów i przegląd powiązań tagów
- Analiza odsyłaczy: miejsca użycia każdego tagu i bloku w całym projekcie
- Status kompilacji: wynik ostatniego buildu, błędy, ostrzeżenia dla każdego urządzenia
Formaty wyjściowe
Każdy format służy innym odbiorcom i procesom
Raport PDF
Dokument czytelny dla człowieka dla klientów, audytorów i archiwów projektowych. Strukturalne sekcje, tabele i strona tytułowa. Gotowy do druku lub podpisu cyfrowego.
Eksport danych XLSX
Arkusz kalkulacyjny czytelny dla maszyn do dalszej analizy, importu do systemów ERP/MES lub niestandardowych procesów raportowania. Każda sekcja w osobnym arkuszu.
Pakiet ZIP
Kompletny pakiet projektu: raport PDF + dane XLSX + archiwum TIA Portal .zap20 + migawka VCS. Jeden plik do przekazania klientowi lub przechowywania w systemie zarządzania dokumentami.
Opcje raportu
Precyzyjne ustawienie zawartości każdego raportu
Filtr urządzenia
Ogranicz raport do konkretnego PLC lub urządzenia HMI za pomocą opcji deviceName. Przydatne w projektach wielourządzeniowych, gdzie każde urządzenie ma własny test akceptacyjny.
Dołączenie kodu źródłowego
Opcja includeSourceCode dołącza pełny kod źródłowy SCL dla wszystkich bloków programowych. Przydatne przy audytach, przeglądach kodu lub umownych wymogach dostarczenia źródeł.
Wyniki testów
includeTestResults dołącza wyniki automatycznych testów PLC T-IA Connect uruchomionych przed wygenerowaniem raportu. Potwierdza, że system przeszedł pomyślnie zestaw testów w momencie zatwierdzenia.
Migawka VCS
includeVcsSnapshot rejestruje hash commitu Git i gałąź w momencie generowania raportu. Zapewnia nienaruszalne powiązanie między raportem a dokładną przetestowaną wersją kodu.
Raporty jako część potoku DevOps
Automatyczne wyzwalanie generowania raportów na końcu etapów CI/CD
T-IA Connect udostępnia zarówno synchroniczne, jak i asynchroniczne punkty końcowe REST do generowania raportów. Potok CI może wyzwolić raport FAT po pomyślnym zakończeniu testów PLCSim, dołączyć PDF jako artefakt buildu i powiadomić odpowiedzialnego inżyniera - wszystko bez udziału człowieka.
Asynchroniczny punkt końcowy jest zalecany dla dużych projektów: zadanie trafia do kolejki, potok sprawdza stan ukończenia, a gotowy raport jest pobierany po zakończeniu. W przypadku mniejszych projektów punkt synchroniczny zwraca plik bezpośrednio.
W połączeniu z wersjonowaniem Git i automatycznymi testami PLC, automatyczne raportowanie domyka pętlę DevOps: każde scalenie do głównej gałęzi generuje raport z wersją, przetestowany stan systemu i kompletną dokumentację projektową.
Referencja narzędzi MCP
Sześć narzędzi obsługujących wszystkie typy raportów i formaty wyjściowe
generate_project_report
Generuje pełny techniczny raport projektu. Opcje: deviceName, includeSourceCode, outputPath. Zwraca plik raportu PDF.
generate_project_deliverable
Tworzy kompletny pakiet ZIP: PDF + XLSX + archiwum .zap20 + migawka VCS. Standardowy pakiet przekazania po zakończeniu projektu.
fat_generate_report
Generuje raport Factory Acceptance Test. Łączy raport projektu z wynikami testów, migawką VCS i stroną zatwierdzenia.
sat_generate_report
Generuje raport Site Acceptance Test. Taka sama struktura jak FAT, dostosowana do dokumentacji uruchomienia u klienta.
Asynchroniczny punkt końcowy REST
POST /api/reports/generate - kolejkuje zadanie generowania raportu i zwraca ID zadania. Sprawdzaj GET /api/reports/job/{id} pod kątem statusu, a następnie pobierz po zakończeniu.
Synchroniczny punkt końcowy REST
POST /api/reports/generate/sync - generuje raport synchronicznie i zwraca plik bezpośrednio. Odpowiednie dla mniejszych projektów lub użycia interaktywnego.