ütemezett jelentések és adatexportok fájlba

Az Export script feladata, hogy a rendszerben tárolt adatokból rendszeres, fájlszintű jelentéseket készítsen automatikusan, a megadott időpontokban. Minden export a saját Ütemezése szerint fut, a futtatásról a BroAdminService gondoskodik — kézzel nem kell elindítani semmit.

Tipikus felhasználás:

• napi adáslisták automatikus publikálása böngészőben nézhető formában
• heti műsorarány-statisztika PDF jelentés a megfelelőség ellenőrzéséhez
• heti eseményjelentés a felügyelt rendszerek riasztásairól

• Export neve (Name): Tetszőleges, egyedi elnevezés.
• Leírás (Description): Tetszőleges leírás.
• Típus (Type): Milyen jellegű adatot exportáljon a rendszer. Elérhető típusok: HTML Adáslista, Esemény jelentés, Műsorarány statisztika — részletesen lásd lentebb.
• Cél mappa (Target path): A mappa, ahova az elkészült export fájl kerül. Dinamikus $( ) kifejezés is használható benne. Ha a mappa nem érhető el, a feladat kimarad és figyelmeztetés kerül a naplóba.
• Ütemezés (Schedule): Cron mintával meghatározható, mikor készüljön el az export. Kötelező megadni, enélkül a feladat sosem indul el; új exportnál 0 0 5 * * * (hajnali 5 óra) az előre kitöltött érték.
• Beállítások (Settings): Típusfüggő kiegészítő paraméterek. A jelenlegi típusok nem használják, későbbi export-típusok számára van fenntartva.
• Értesítés (Notify): Ha be van kapcsolva, a rendszer hiba esetén Telegram értesítést küld.
• Aktív (Enabled): A feladat engedélyezése.

Az HTML Adáslista típus a műsorautomatizálási rendszer lejátszási naplójából dolgozik, ezért működéséhez szükséges:

• a zettaapi-* beállítási kulcsok kitöltése,
• és hogy minden érintett állomásnál ki legyen töltve a Külső azonosító mező. Amelyik állomásnál nincs, azt az export kihagyja.

A script minden aktív állomásra lefut, és állomásonként külön fájlt készít a mai napra, valamint a beállított számú további napra. A fájl neve <HBR>_playlist_<év-hónap-nap>.html, a tartalma pedig egy önállóan is használható, interaktív adáslista: kereshető, típus szerint szűrhető (zene, szpot, bemondás…), órákra ugrik, világos/sötét témát vált és nyomtatható — elég böngészőben megnyitni, akár a stúdió gépén is.

Az előre exportált napok száma állomásonként állítható az állomás beállításai közt az export-playlist-days kulccsal; ha nincs megadva, az érték 3 — tehát alapesetben a mai és a következő három napra készül fájl. Amelyik napra még nincs feltöltve adáslista, arról nem készül fájl, ez nem hiba.

Az Esemény jelentés típus hetente egyszer, mindig az előző teljes naptári hétről (hétfő 0:00 – vasárnap 24:00) készít PDF összefoglalót a Track / Objektumok alatt felügyelt rendszerek riasztásairól: melyik objektum hányszor és összesen mennyi ideig jelzett, a hét hány százalékában — kiegészítve a riasztások időrendi listájával.

A jelentés nem állomásfüggő, egyetlen közös fájl készül <HBR>_event-report_<kezdet>-<vég>.pdf néven (a HBR az első aktív állomásé). Akkor is elkészül, ha a héten egyetlen riasztás sem volt — az üres jelentés is információ.

A Műsorarány statisztika típus hetente egyszer, az előző teljes naptári hétről készít állomásonként egy-egy PDF jelentést — lényegében a Report / Statisztika oldal tartalmát menti fájlba. A jelentés a lejátszási napló besorolt adataiból számol: műsortípus-arányok, Mttv-, közszolgálati-, hír-, magyar zenei, saját gyártású és ismétlési idők, óránkénti bontásban, az állomásnál beállított stat-* határértékekkel és a reklámidő-korláttal összevetve.

A számokat egy AI-alapú szöveges értékelés egészíti ki, amely emberi nyelven foglalja össze, hogy a hét megfelelt-e az elvárásoknak és hol vannak kockázatok. Az AI itt nem kiváltani hivatott a felelős szerkesztői és jogi ellenőrzést, hanem segíteni azt: gyorsabban észrevehetővé teszi, mire érdemes ránézni.

A fájl neve <HBR>_statistics_<kezdet>-<vég>.pdf. Amelyik állomásnak nincs lejátszási naplója a vizsgált hétre, azt az export kihagyja.

Mikor érdemes a heti jelentéseket ütemezni?

Mivel az Esemény jelentés és a Műsorarány statisztika mindig az előző teljes naptári hétről szól, a hét bármely napján futtatható — a bevett gyakorlat a hétfő hajnali időpont, így a jelentés már a hét első munkanapján a mappában van.

Miért hiányzik néhány nap adáslistája?

Az adáslista csak azokra a napokra készül el, amelyekre a műsorautomatizálási rendszerben már létezik lejátszási napló. Amint a hiányzó nap listája elkészül a Zettában, a következő futás pótolja a fájlt.

Honnan tudom, hogy lefutott-e az export?

A Track / Feladatok nézetben minden futás látszik az eredményével együtt; hiba esetén — bekapcsolt Értesítés mellett — Telegram üzenet is érkezik.

• Track → Feladatok — az exportfutások követése és kényszerített újraindítása
• Report → Statisztika — a műsorarány-statisztika interaktív, webes változata
• Track → Objektumok — az eseményjelentésben szereplő felügyelt objektumok
• Admin → Állomások — Külső azonosító és az export-playlist-days / stat-* kulcsok