Nazaj na DevOps
DevOps / Poročanje

Avtomatizirana dokumentacija in
Poročila o skladnosti za TIA Portal

Z enim ukazom ustvarite celotna projektna poročila, dokumente o prevzemnih testih FAT/SAT in pakete projektne dokumentacije - brez ročnega zbiranja podatkov in oblikovanja.

Štiri vrste poročil, en ukaz

Od hitrega tehničnega pregleda do podpisanega paketa o skladnosti

Projektno poročilo

Celotna tehnična dokumentacija projekta TIA Portal. Zajema konfiguracijo strojne opreme, omrežno topologijo, seznam vhodov/izhodov (I/O), programske bloke, tage, UDT-je, HMI zaslone, navzkrižne reference in status prevajanja. Osnovni dokument za vsako primopredajo projekta.

Poročilo FAT

Poročilo o tovarniškem prevzemnem testu (Factory Acceptance Test), ki združuje celotno projektno poročilo z avtomatiziranimi rezultati testov, VCS posnetkom stanja projekta v času testa in stranjo za podpis. Izdelano ob koncu tovarniškega testiranja pred odpremo.

Poročilo SAT

Poročilo o prevzemnem testu na lokaciji (Site Acceptance Test) z isto strukturo kot poročilo FAT, prilagojeno za zagon na lokaciji. Dokumentira končno nameščeno in zagnano stanje sistema.

Projektna dokumentacija (Deliverable)

Popoln ZIP arhiv, ki združuje PDF poročilo, izvoz podatkov XLSX, TIA Portal .zap20 arhiv in VCS posnetek. Vse, kar stranka ali arhivski sistem potrebuje, v eni datoteki.

Kaj vsebuje projektno poročilo

Samodejno pridobljeno iz živega projekta TIA Portal - brez ročnega vnašanja podatkov

  • Konfiguracija strojne opreme: ohišja, moduli, različice vdelane programske opreme, dodelitve rež
  • Omrežna topologija: PROFINET obroči, podomrežja, IP naslovi, povezave naprav
  • Popoln seznam vhodov/izhodov (I/O): fizični naslovi, simbolna imena, tipi podatkov, opisi
  • Inventar programskih blokov: OB-ji, FB-ji, FC-ji, DB-ji z velikostmi in datumi sprememb
  • Tabele tagov: vsi PLC tagi z naslovi, tipi in komentarji
  • Uporabniško določeni tipi (UDT): definicije struktur in podrobnosti o članih
  • HMI zasloni: seznam zaslonov, število elementov in pregled povezav tagov
  • Analiza navzkrižnih referenc: kje se posamezen tag in blok uporablja v projektu
  • Status prevajanja: rezultat zadnje gradnje, napake, opozorila na napravo

Izhodni formati

Vsak format služi različnemu občinstvu in delovnemu toku

PDF poročilo

Človeku berljiv dokument za stranke, revizorje in projektne arhive. Strukturirani razdelki, tabele in naslovna stran. Pripravljeno za tiskanje ali digitalni podpis.

XLSX izvoz podatkov

Strojno berljiva preglednica za nadaljnjo analizo, uvoz v sisteme ERP/MES ali cevovode za poročanje po meri. Vsak razdelek na svojem listu.

ZIP paket

Popoln projektni paket: PDF poročilo + XLSX podatki + .zap20 TIA Portal arhiv + VCS posnetek. Ena datoteka za predajo stranki ali shranjevanje v sistemu za upravljanje dokumentov.

Možnosti poročila

Natančno določite, kaj vključuje posamezno poročilo

Filter naprav

Omejite poročilo na določen PLC ali HMI napravo z možnostjo deviceName. Uporabno za projekte z več napravami, kjer ima vsaka naprava svoj prevzemni test.

Vključitev izvorne kode

Možnost includeSourceCode doda celotno izvorno kodo SCL za vse programske bloke. Uporabno za revizije, preglede kode ali pogodbene zahteve po dostavi izvorne kode.

Rezultati testov

includeTestResults priloži izhod avtomatiziranih PLC testov T-IA Connect, izvedenih pred generiranjem poročila. Dokazuje, da je sistem v trenutku podpisa uspešno prestal nabor testov.

VCS posnetek

includeVcsSnapshot zabeleži hash Git commita in vejo v času generiranja poročila. Zagotavlja varno povezavo med poročilom in natančno različico testirane kode.

Poročila kot del vašega DevOps cevovoda

Samodejno sprožite generiranje poročil ob koncu stopenj CI/CD

T-IA Connect izpostavlja tako sinhrone kot asinhrone REST končne točke za generiranje poročil. CI cevovod lahko sproži poročilo FAT ob koncu uspešnega zagona testa PLCSim, priloži PDF kot artefakt gradnje in obvesti odgovornega inženirja - vse brez človeškega posredovanja.

Asinhrona končna točka je priporočljiva za velike projekte: opravilo se postavi v vrsto, cevovod preverja dokončanje, končano poročilo pa se prenese, ko je pripravljeno. Za manjše projekte sinhrona končna točka datoteko vrne neposredno.

V kombinaciji z verzijskim nadzorom Git in avtomatiziranim PLC testiranjem avtomatizirano poročanje sklene DevOps zanko: vsaka združitev v glavno vejo ustvari verzijsko poročilo, testirano stanje sistema in popolno projektno dokumentacijo.

Referenca orodij MCP

Šest orodij, ki pokrivajo vse vrste poročil in izhodne formate

generate_project_report

Ustvari celotno tehnično projektno poročilo. Možnosti: deviceName, includeSourceCode, outputPath. Vrne PDF datoteko poročila.

generate_project_deliverable

Izdelate celoten ZIP paket projektne dokumentacije: PDF + XLSX + .zap20 arhiv + VCS posnetek. Standardni paket za zaključek projekta.

fat_generate_report

Ustvari poročilo o tovarniškem prevzemnem testu. Združuje projektno poročilo z rezultati testov, VCS posnetkom in stranjo za podpis.

sat_generate_report

Ustvari poročilo o prevzemnem testu na lokaciji. Ista struktura kot FAT, prilagojeno za dokumentacijo o zagonu na lokaciji.

Asinhrona REST končna točka

POST /api/reports/generate - postavi opravilo generiranja poročila v vrsto in vrne ID opravila. Preverjajte GET /api/reports/job/{id} za status, nato prenesite, ko je končano.

Sinhrona REST končna točka

POST /api/reports/generate/sync - generira poročilo sinhrono in datoteko vrne neposredno. Primerno za manjše projekte ali interaktivno uporabo.

Avtomatizirajte svojo projektno dokumentacijo

Ne porabite več ur za ročno sestavljanje projektnih poročil. En sam ukaz ustvari vse - od seznama vhodov/izhodov do podpisanega dokumenta FAT.