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?
- 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
- 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
- A Loader kiválasztja a Mintára illeszkedő fájlokat
- Kihagyja a más program által éppen használt (zárolt) fájlokat, és bekapcsolt Forrás megtartása mellett a már feldolgozottakat
- 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)
- Sikeres feldolgozás után:
- az eredeti fájl időbélyeges másolata az Archív mappába kerül (ha meg van adva)
- bekapcsolt Forrás megtartása mellett a fájl nyilvántartásba kerül, kikapcsolt mellett törlődik
- 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$— azRCS_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$1formában hivatkozhatunk,$0az 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.
