IPTA - Uživatelská příručka

Program IPTA (IP Telephony Accounting) slouží k statistickému sledování telefonních hovorů uskutečněných prostřednictvím sítě IP telefonie sítě CESNET2. Program umí zobrazit jak podrobný výpis jednotlivých telefonních hovorů, které proběhly v určitém období, tak i souhrnné výpisy statistik jednotlivých připojených institucí.

Přístup k programu, uživatelské rozhraní

Program je přístupný přes webovské uživatelské rozhraní na adrese https://ipta.cesnet.cz. Po napojení se na tuto adresu se program zeptá na uživatelské jméno a heslo, které je ověřeno vůči CAAS (stejné jméno a heslo jako například pro přístup do řešitelské části www.cesnet.cz). Je proto potřeba mít konto v CAAS, které může zřídit Milan Sova. Aplikace ale neumožňuje přístup úplně všem majitelům konta v CAAS, nýbrž jen některým. Je proto potřeba ještě požádat o vložení do seznamu oprávněných uživatelů, to může udělat Sven Ubik.

Práce s programem

Všechny parametry se zadávají na hlavní webovské stránce programu. Po zadání parametrů se klikne na tlačítko "Refresh" a program zobrazí výpis dle zadaných parametrů.

Accounting period

Účtovací období. Defaultní hodnota je aktuální den (od půlnoci do aktuálního času). V položce "New" lze vybrat z řady předdefinovaných období nebo lze vybrat poslední hodnotu "Other". V tom případě se musí do položek "From date" a "To date" napsat datum začátku, resp. konce účtovacího období ve formátu, který je uveden jako nápověda přímo ve formuláři. Nepovinně je možné do položek "From time" a "To time" napsat čas začátku, resp. konce účtovacího období. Čas zadaný v položce "From time" platí pro první den účtovacího období a obdobně čas zadaný v položce "To time" platí pro poslední den účtovacího období. Dny uprostřed účtovacího období se počítají vždy celé. Pokud se časy nezadají, platí celý první den, resp. celý poslední den zadaného účtovacího období. Je-li první den účtovacího období zároveň posledním dnem, lze takto omezit účtovací období třeba jen na jednu hodinu.

Caller

Volající účastník. Defaultní hodnota je "All", tedy všichni možní volající účastníci. Chceme-li výpis omezit jen na určitou množinu volajících účastníků, můžeme v položce "New" vybrat z řady předdefinovaných volajících účastníků nebo vybereme poslední hodnotu "Other". V tom případě se musí do položky "Other" zadat prefix (začátek tekefonního čísla), který identifikuje volajícího účastníka. Všimněte si, že v nabídce předdefinovaných volajících účastníků jsou jednotlivé volby seřazeny systematicky: nejprve jednotlivé připojené organizace, potom celá města a na konec ostatní případy, jako mobily, mezinárodní čísla, atd. U každé volby je uvedeno její jméno a v závorce prefix, který jí identifikuje. Za prefixem mohou být písmena "xxx" (počet písmen se může lišit) nebo tři tečky "...". Počet písmen "x" značí počet cifer linky, které mohou následovat za prefixem. Pokud vybereme takovou volbu, po jejím odeslání kliknutím na tlačítko "Refresh" v seznamu voleb volajícího účastníka přibydou volby pro jednotlivé skupiny linek dané organizace. Například, vybereme-li volbu "CVUT Praha (022435xxxx)", potom přibydou volby "CVUT Praha (0224351xxx)", "CVUT Praha (0224352xxx)" až "CVUT Praha (0224350xxx)". Tímto způsobem je možné ve skupinách linek listovat až na úroveň jednotlivých linek. Je ovšem také možné určitou skupinu linek nebo jednotlivou linku zadat přímo do položky "Other", například můžeme zadat "0224345235". Jsou-li za prefixem v nabídce uvedeny tři tečky, jde o celé město nebo jiný celek a listování ve skupinách není možné. Je ale opět možné zadat určitý prefix do položky "Other", například "02311".

Callee

Volaný účastník. Defaultní hodnota je "All", tedy všichni možní volaní účastníci. Chceme-li výpis omezit jen na určitou množinu volaných účastníků, postupujeme stejně jako při zadávání volajícího účastníka v oddílu "Callee".

Format

Výstup programu zahrnuje vždy všechny hovory provedené v účtovacím období zadaném v položce "Accounting period" od všech volajících účastníků vymezených položkou "Caller" všem volaným účastníkům vymezeným položkou "Callee". Výstup může mít jeden z několika formátů určených položkou "Format". Možné volby jsou následující:

Upozornění: volba "All" v položkách "Accounting period", "Caller" a "Callee" a současně volba "List of calls" v položce "Format" znamená detailní výpis úplně všech hovorů mezi všemi účastníky za celou dobu provozu systému, což pravděpodobně není příliš rozumná volba. Výsledná tabulka může být tak dlouhá, že může způsobit havárii některých WWW prohlížečů.

Accounting plan

Účtovací plán. V této položce je možné vybrat, podle kterého z účtovacích plánů, které jsou právě k dispozici v databázi má proběhnout výpočet cen hovorů. Je možné zvolit více účtovacích plánů současně, potom bude ve výsledné tabulce více sloupců s cenami dle jednotlivých účtovacích plánů.

Upozornění: tato položka zatím není implementována. Výsledná tabulka vždy zobrazí pevnou množinu sloupců s cenami. Význam těchto sloupců je uveden před výpisem tabulky.

Print debugging messages

Tato položka slouží jen pro ladící účely. Doporučuji položku nezapínat, neboť zobrazí opravdu mnoho pro uživatele málo užitečných ladících informací.

Tlačítko Refresh

Po změně hodnoty kterékoliv z výše popsaných položek je třeba kliknout na tlačítko "Refresh" pro zobrazení nových údajů.

Výsledná tabulka

Výsledná tabulka je standardně seřazena podle sloupce volajícího účastníka, t.j. podle sloupce "Caller". Tabulku lze nechat seřadit podle jiného sloupce kliknutím na tlačítko nad příslušným sloupcem. Význam sloupců je zřejmý podle jejich jmen v záhlaví.

Je-li číslo volajícího nebo volaného účastníka zobrazeno červeně, znamená to, že program nerozpoznal dané číslo jako korektní číslo podle tabulek povolených volajících a volaných účastníků. Pokud daná řádka obsahuje souhrn určité množiny hovorů, nikoliv jen jeden hovor, potom se toto upozornění může vztahovat jen na určitou podmnožinu dané množiny hovorů nebo třeba jen na jediný hovor uvnitř množiny hovorů. Změnou volby položky "Caller" nebo "Calle" je možné nechat si zobrazit podrobnější výpis, ze kterého bude zřejmé, na které hovory se upozornění vztahuje. Obecně by se neměla žádná čísla zobrazovat červeně. Je-li tomu tak, často jde o případy různých experimentů prováděných účastníky projektu "Hlasové služby v síti CESNET2". Přesto je dobré upozornit někoho z projektu, že se taková čísla objevují. Vedoucím projektu je Michal Neuman.

Kdy se zobrazí nový hovor?

Obvykle asi za 5 sekund po ukončení hovoru (položení sluchátka volajícím účastníkem) je hovor již v databázi. Pro jeho zobrazení je potřeba zadat správně všechny položky formuláře a kliknout na tlačítko "Refresh".

Když program nefunguje

Když program evidentně zkolabuje nebo když jste si jisti, že jste zadali správně všechny položky formuláře a stejně se nezobrazí určitý hovor, který by se měl zobrazit, kontaktujte autora aplikace, kterým je Sven Ubik.

další weby:fond rozvojemetacentrumCzechLightpřenosyvideoservereduroameduID.cz