User Tools

Site Tools


script:loader

small-banner_script.jpg

Loader

fájlok automatikus feldolgozása és konvertálása

A Loader a forrásmappába érkező, a megadott mintára illeszkedő fájlokat automatikusan feldolgozza: a célmappába teszi őket a megadott néven, közben szükség szerint át is konvertálja (pl. formátum vagy mintavételi frekvencia). Az eredetit igény szerint archiválja, és nyilvántartja a már feldolgozott fájlokat, hogy ne dolgozza fel őket újra.

Tipikus felhasználás:

  • a szerkesztőség által elmentett hírek, időjárás, műsorelemek betöltése az adáslebonyolító fix fájljaiba
  • hangfájlok automatikus konvertálása (pl. mp3 → wav)
  • külső eszközről vagy partnertől érkező felvételek átnevezése és célmappába rendezése

Hogyan működik a Loader?

  1. A BroAdminService figyeli a Forrás mappát (bekapcsolt Almappák mellett az almappáit is); amint illeszkedő fájl érkezik vagy változik, elindítja a feladatot
  2. Ha az időpont az Ütemezés ablakán kívül esik, a feldolgozás a következő engedélyezett időpontra halasztódik
  3. A Loader kiválasztja a Mintára illeszkedő fájlokat
  4. Kihagyja a más program által éppen használt (zárolt) fájlokat, és bekapcsolt Forrás megtartása mellett a már feldolgozottakat
  5. A Minta és a Fájlnév alapján előállítja a célfájl nevét, és az FFmpeg a Paraméterek szerint elkészíti a célfájlt; üres Paraméterek mellett a fájlt változtatás nélkül másolja (a meglévőt mindkét esetben felülírja)
  6. Sikeres feldolgozás után:
    1. az eredeti fájl időbélyeges másolata az Archív mappába kerül (ha meg van adva)
    2. bekapcsolt Forrás megtartása mellett a fájl nyilvántartásba kerül, kikapcsolt mellett törlődik
  7. Sikertelen feldolgozásnál a félkész célfájl törlődik, a hiba naplózódik, bekapcsolt Értesítés mellett Telegram-üzenet is megy

Loader beállításai

  • Név (Name): kötelező, egyedi, legfeljebb 128 karakter.
  • Leírás (Description): tetszőleges leírás.
  • Forrás mappa (Source path): kötelező; a mappa, ahová a fájlok érkeznek.
  • Cél mappa (Target path): kötelező; ide kerülnek a feldolgozott fájlok. Ha nem létezik, a rendszer létrehozza.
  • Archív mappa (Archive path): ha meg van adva, az eredeti fájl időbélyeges másolata ide is bekerül (pl. felvetel_20260714-143022.wav). Üresen hagyható.
  • Minta (Pattern): kötelező regex; meghatározza, mely fájlneveket dolgozza fel a rendszer (kis- és nagybetűtől függetlenül). Például ^.*\.wav$ — minden WAV fájl, ^RCS_.*\.wav$ — az RCS_ kezdetű WAV fájlok.
  • Fájlnév (Filename): kötelező; a célfájl nevének sablonja regex-cserével: a Minta csoportjaira ${név} vagy $1 formában hivatkozhatunk, $0 az egész illeszkedő név.
  • Paraméterek (Parameters): az átalakítás FFmpeg-argumentumai (pl. -ar 48000 -ac 2). Üresen hagyva a fájl változtatás nélkül, bitre pontosan kerül a célmappába, átalakítás nélkül.
  • Ütemezés (Schedule): nem kötelező Cron minta, amely megadja, mikor dolgozhat a Loader. Üresen a feladat bármikor futhat.
  • Forrás megtartása (Keep source): bekapcsolva az eredeti fájl megmarad, és a rendszer nyilvántartja, hogy ne dolgozza fel újra; kikapcsolva sikeres feldolgozás után törlődik.
  • Almappák (Subfolders): bekapcsolva a forrásmappa almappáit is figyeli és feldolgozza.
  • Értesítés (Notify): bekapcsolva a hibákról Telegram-üzenet megy.
  • Aktív (Enabled): csak az aktív feladatokat figyeli és futtatja a rendszer.

Bekapcsolt Forrás megtartása mellett a nyilvántartás az elérési út, a fájlméret és a módosítási idő alapján azonosítja a fájlt: ha ugyanazon a néven új tartalom érkezik, azt a rendszer újra feldolgozza.

A Minta és a Fájlnév szorosan összefügg: a Minta azonosítja a forrásfájlt, a Fájlnév pedig a Minta csoportjaiból építi a célfájl nevét. Hibás beállításnál a fájl nem kerül feldolgozásra, vagy hibás nevet kap.

Az Ütemezés időablakként működik, ezért a másodperc és a perc mezőbe * kerüljön: a * * 6-22 * * * reggel 6-tól este 23 óráig folyamatosan engedélyezi a feldolgozást. Részletek a Cron segédletben.

Tipikus statikus minták

Másolás változatlan néven:

  • Minta: ^(?<filename>.+)\.(?<extension>.+)$
  • Fájlnév: ${filename}.${extension}

Dátum átrendezése: 20251231-barmi.wav → barmi_2025-12-31.wav

  • Minta: ^(?<year>\d{4})(?<month>\d{2})(?<day>\d{2})[-_](?<info>.*)\.(?<ext>.+)$
  • Fájlnév: ${info}_${year}-${month}-${day}.${ext}

Fix célnév, konverzióval: 0800_bkkinfo_2025-12-31.wav → bkkinfo.mp3

  • Minta: ^(?<time>\d{4})[_-](bkkinfo)[_-](.*)\.(mp3|wav)$
  • Fájlnév: bkkinfo.mp3

A fájlnévnek egy négyjegyű számmal, majd a bkkinfo szóval kell kezdődnie, a további része nem számít. Csak mp3 és wav fájlokat dolgoz fel, és mindegyikből bkkinfo.mp3 lesz: a wav fájlt a Loader a célkiterjesztés miatt automatikusan mp3-ra konvertálja.

Tipikus dinamikus minták

A Mintában a $( ) közé írt PowerShell-kifejezést a rendszer minden futáskor kiértékeli, így a minta az idővel együtt változik. A figyelt mintákat és a mappák tartalmát a rendszer rendszeres időközönként (alapértelmezésben 5 percenként) újraértékeli, így az előre bemásolt fájl is sorra kerül, amint a minta illeszkedni kezd rá.

Félórás hírek: az óra 30. percében elhangzó hír minden óra elejétől cserélhető. A fájlnevek formátuma 20251231-08-feles.mp3, a cél a HIREK-FELES.wav.

  • Minta: ^$( (Get-Date).ToString('yyyyMMdd') )[_-]$( (Get-Date).ToString('HH') )[_-]feles\..+$
  • Fájlnév: HIREK-FELES.wav

8 óra után a kiértékelt minta: ^20251231[_-]08[_-]feles\..+$ — a 08-as fájl ettől kezdve illeszkedik, és a célmappában HIREK-FELES.wav néven, konvertálva jelenik meg. A [_-] kötőjelet és aláhúzást is elfogad, így egy elgépelés nem akasztja meg a betöltést.


Egészórás hírek: az óra elején elhangzó hír cseréje az előző óra 15. percétől. 7:15-kor a 7 órás hír már biztosan lement, így a HIREK.wav cserélhető a 8 órásra. A fájlnevek formátuma 20251231-08-hirek.mp3.

  • Minta: ^$( (Get-Date).AddMinutes(45).ToString('yyyyMMdd[_-]HH') )[_-]hirek\..+$
  • Fájlnév: HIREK.wav

7:15-től a kiértékelt minta: ^20251231[_-]08[_-]hirek\..+$. Az AddMinutes(45) miatt a rendszer 45 perccel előre gondolkodik.


Óra vége előtt elhangzó hírek: ha az óra hírei :55 körül hangzanak el, és a fájlnevek formátuma 20251231-0855-hirek.mp3, negatív eltolás kell:

  • Minta: ^$( (Get-Date).AddMinutes(-15).ToString('yyyyMMdd[_-]HH') )\d{2}[_-]hirek\..+$
  • Fájlnév: HIREK.wav

8:15 és 9:14 között a kiértékelt minta ^20251231[_-]08\d{2}[_-]hirek\..+$, vagyis a 8 órás fájlt keresi. Így óraváltáskor, amíg az előző hírek még szólhatnak, a rendszer nem cseréli le a fájlt; csak negyed után vált a következő hírekre.


Naponta egyszer jelentkező, többrészes műsor: a reggel 6-os, hatrészes magazint a kollégák előző este elkészítik; reggel 8-tól, amikor a mai adás már biztosan lement, a holnapi részek cserélhetők. A fájlnevek formátuma 20251231-reggeli-magazin-1.wav, ahol a -1 a rész sorszáma.

  • Minta: ^$( (Get-Date).AddHours(16).ToString('yyyyMMdd') )[_-]reggeli[_-]magazin[_-](?<part>\d{1})\.wav$
  • Fájlnév: REGGELI-MAGAZIN-${part}.wav

A 16 órás eltolás miatt reggel 8-tól másnap reggel 8-ig a holnapi dátum kerül a mintába: 2025. 12. 31-én 8 órától ^20260101[_-]reggeli[_-]magazin[_-](?<part>\d{1})\.wav$. A részekből REGGELI-MAGAZIN-1.wav … REGGELI-MAGAZIN-6.wav lesz.


Több adóra szétosztott hírek: a fájlnevek formátuma 20251231-0800-budapest-headline.mp3, ahol a város és a rész változik.

  • Minta: ^$( (Get-Date).AddMinutes(45).ToString('yyyyMMdd[_-]HH') )\d{2}[_-](?<city>.+)[_-](?<part>headline|hirek|idojaras|sport)\..+$
  • Fájlnév: hirek-${city}_${part}.wav

7:15-től a kiértékelt minta ^20251231[_-]08\d{2}[_-](?<city>.+)[_-](?<part>headline|hirek|idojaras|sport)\..+$. A part csak a headline, hirek, idojaras vagy sport szó lehet. A példafájlból hirek-budapest_headline.wav lesz.

GYIK

Beérkezett a fájl, de nem történt semmi — mi lehet az oka?

Ok Megoldás
A fájlnév nem illeszkedik a Mintára Ellenőrizzük a mintát egy regex-tesztelőben (lásd Regex)
A fájlt egy másik program még írja vagy zárolja A rendszer a következő futáskor feldolgozza
Bekapcsolt Forrás megtartása mellett a fájl már szerepel a nyilvántartásban Csak a megváltozott fájlt dolgozza fel újra
Az Ütemezés időablakán kívül érkezett A következő engedélyezett időpontban kerül sorra
A feladat nem Aktív Kapcsoljuk be

Ugyanazt a fájlt frissítve újra elmentették — feldolgozza a rendszer?

Igen: a nyilvántartás a fájlméretet és a módosítási időt is nézi, így a megváltozott fájl újra feldolgozásra kerül.

Kell értenünk az FFmpeg-hez?

A leggyakoribb esetekhez nem: üres Paraméterek mellett a fájl változtatás nélkül kerül át. Speciális konverziós beállításokban a Broadmax Support segít.

Kapcsolódó

  • Syncer — ha konverzió nélkül, a mappaszerkezetet megőrizve kell mappákat szinkronban tartani
  • Remote — ha a forrás vagy a cél FTP-szerver
  • Purger — az Archív mappa rendszeres takarítása
  • Regex és Cron — a Minta és az Ütemezés mező szintaxisa
script/loader.txt · Last modified: (external edit)