mxStatExport2 - export účtovacích dat
|
Tato aplikace provádí v pravidelných intervalech vyhodnocení nákladů jednotlivých uživatelů, skupin a
nákladových středisek. Aplikace je spouštěna "UMStaskManagerem" každý den v 00.00 hod (denní statistika)
a prvního dne každého měsíce v 00.00 hod (měsíční statistika). Do MX databáze přistupuje přes MX dbAPI.
Konfigurační údaje pro přístup k databázi načte z HKLM\software\datasys\mobilchange\database
.
Aplikace je tvořena 6 úlohami v umsTaskCfg - MxStatDen, MxStatDenC, MxStatDenG, MxStatMes, MxStatMesC, MxStatMesG. Pouze MxStatDen
a MxStatMes jsou povoleny, ostatní musí být zakázány - neměňte toto nastavení, jinak se export bude spouštět opakovaně každou minutu.
Aplikace provádí tři základní činnosti:
- souhrnný / detailní výpis skupin
- souhrnný / detailní výpis nákladových středisek
- souhrnný / detailní výpis jednotlivých uživatelů
Souhrné výpisy jsou ukládány do adresáře "/mobilchange/log" a mohou být odesílány na zadané adresy.
Detailní výpisy jsou v případě uživatelů odesílány na jejich email adresy, v případě skupin a nákladových skupin
na "vlastníka skupiny", jehož email adresa je zadána do pole Zobrazené jméno ve vlastnostech skupiny.
Pokud adresa není v SMTP formátu, výpis se neodešle.
Export probíhá v těchto krocích:
- Kontrola "timestamp" zda již dnes (tento měsíc) export neproběhl.
- export souhrnných / detailních nákladů na nákladová střediska a případné poslání informace e-mailem majiteli nákladového střediska
(costcode), se soupisem jednotlivých uživatelů jeho střediska.
- export souhrnných / detailních nákladů na skupiny a případné poslání informace e-mailem majiteli skupiny, se soupisem jednotlivých
členů skupiny.
- export souhrnných / detailních nákladů na jednotlivé uživatele
- vynulování patřičných údajů v databázi
- poslání informace e-mailem jednak uživateli a administrátorům
- Zapsání "timestamp" posledního běhu (ochrana proti dvojímu spuštění)
Parametry z příkazové řádky:
mxstatexport2 /R(M | D) [/Llevel] [/U] [/E{U | G | C | D}] [/T]
- /R{M | D} - určuje režim exportu, M mesíční, D denní
- /Lx - logovací úroveň dle MobilChange: je-li kód logovací hlášky nižší nebo roven x, je vypsán do log souboru.
- /U - nenuluj prosmskované hodnoty – v tomto případě nebudou po exportu nulovány stavy počitadel.
- /T - nesleduj timestamp – aplikaci bude možné spustit i v případě že tento den již běžela.
- /E{U | G | C| GD| CD } - exportuj uživatele (U), skupiny (G), nákladová střediska (C) - pokud není zadáno, exportuje vše.
Přidáním "D" je zapnuto odesílání podrobné statistiky za jednotlivé uživatele "vlastníkovi" skupiny (nákladového střediska).
Konfigurace:
Konfigurace je uložena v klíči: HKLM/Software/Datasy/MobilChange/Statexport2/ (pokud tento klíč chybí, naimportujte do registry soubor
MobilChange\extended\registry\cz\statexp2.reg
).
Hodnoty společné:
- "directory" - adresář, do kterého má ukládat vyexportované soubory
Následující vždy s předponou d_ nebo m_ pro denní nebo měsíční statistiky:
- "export_all" - exportovat všechny nebo jen ty s nenulovou prosmskovanou hodnotou? (1/0)
- "email2all" - posílat email s informací všem nebo jen těm, kteří prosmskovali více než email_limit? (1/0)
- "email_limit" - limitní hodnota (viz email2all), pokud končí znakem procento, pak procentuální k limitu day_(month_)limit
v tabulce mxUser
- "receivers_u" - seznam email adres oddělených mezerami, na které se posílají statistiky s volbou /EU* (sumární statistiky uživatelů)
- "receivers_g" - seznam email adres oddělených mezerami, na které se posílají statistiky s volbou /EG* (sumární statistiky skupin)
- "receivers_c" - seznam email adres oddělených mezerami, na které se posílají statistiky s volbou /EC* (sumární statistiky
nákladových středisek)
- "rec_export" - formát (text) řádku , může obsahovat jména sloupců obalená %, dále \t, (tabulátor) \n (CR), \r (LF), \\ (lomítko),
\% (znak procento)
- "rec_info" - formát textové zprávy (viz rec_export), použitý pokud neexistuje mail_info.txt v uživ. ani default jazyce
- "sender" - adresa odesilatele statistických zpráv (mobilchange@datasys.cz)
Soubory záznamů vytváří se jmenou konvencí:
- stat_day_<yyyymmdd>.txt pro denní statistiky
- stat_month_<yyyymm>.txt pro měsíční statistiky
- Šablona pro text zprávy pro uživatele je uložen v jednotlivých jazykových adresářích pod jménem d_mail_info.txt (denní), m_mail_info.txt
(měsíční). V textu je možné použít jména sloupců obalené znakem "%". Pokud šablona chybí, bere se text z registry, hodnota
"rec_export". Jmény sloupců se myslí sloupce z tabulky "mxUser" databáze Mobilchange - lze použít
libovolný z nich.
Příklad textu :
Vážený %I_SURNAME%,
Za dnešní den jste odeslal %THIS_DAY% z vašeho limitu %DAY_LIMIT%.
Tento měsíc jste již odeslal %THIS_MONTH% z vašeho limitu %MONTH_LIMIT%.
Celkem jste za dobu užívání MobilChange odeslal %SUM_SMS% zpráv za %SUMCOST%.
Pokud je neprázdný seznam e-mail adres pro posílání statistik, pak po uzavření souboru tento pošle na všechny
zadané adresy. U hromadných seznamů jako text zprávy i jako přílohu, u výpisu jednotlivým uživatelům vloží data do
šablony podle jazykové verze. Soupis nákladů jednotlivých uživatelů ve skupině (nákladové skupině) je odesílán na
adresu zadanou v poli "zobrazované jméno".
zpět na začátek