Systém Calom slouží pro tarifikaci telefonních hovorů. Skládá se z Calom serveru a Calom klienta. K systému Calom se standardně dodává textový klient calom, se kterým je možné pracovat po přihlášení na počítač, na kterém je tento klient nainstalován, např. pomocí služeb SSH nebo Telnet. Dále existuje klient creport, který slouží pro vygenerování reportu přes příkazovou řádku.

Tento dokument popisuje www prostředí WebCalom, pomocí kterého je možné k systému Calom přistupovat přes webový prohlížeč. Na úvod stručně popíšeme Calom server.

1Calom server

Calom server je základní částí systému Calom. Sbírá data, spravuje telefonní seznam, uživatele a poskytuje služby pro zpracování reportů.

• Může běžet na jiném počítači než WebCalom (pouze nebude možné prohlížet log Calom serveru).

• Může spravovat libovolné množství ústředen několika typů.

• Má několik možností propojení s telefonními ústřednami (sériová linka nebo internet, příp. spojení s dalším Calom serverem).

• Kompletně podporuje češtinu včetně třídění.

• Calom servery se mohou navzájem doplňovat a synchronizovat.

• Umožňuje současnou práci mnoha připojených uživatelů.

• Podporuje několik druhů klientů.

• Umožňuje definování přístupových práv. Je možné uživatelům povolit přístup jen do určitých organizačních jednotek nebo mu třeba úplně zakázat zápis do telefonního seznamu.

• Není náročný na hardware počítače a umožňuje práci i s velmi velkým objemem dat.

• Poskytuje možnost vzdálené správy

Poznámky

• Nastavení a práce s Calom serverem jsou popsány ve zvláštní dokumentaci.

2WebCalom - www klient

1Úvod

Vlastní práce se systémem (zadávání údajů a prezentace dat) probíhá prostřednictvím webového prohlížeče. Práce se systémem vyžaduje povolené cookies a některé stránky vyžadují přítomnost Java pluginu (Java 2 SE 5.0 nebo vyšší). Pro přihlášení k systému napište do adresy:

http://jméno_počítače/calom/login.html

resp.:

http://jméno_počítače/cgi-bin/calom/calom_www/login.html

Poznámka: "jméno_počítače" je jméno počítače, na kterém je nainstalován WWW klient. Na podrobnosti se zeptejte správce systému Calom.

Tím se dostanete do úvodní obrazovky. Tam zadáte svoje přihlašovací jméno a heslo, které vám přidělil administrátor systému. Administrátorský účet má název 'admin', 'administrator' nebo 'root'. Všechny účty˙s těmito jmény mají práva administrátora (smějí měnit veškeré nastavení).˙

Pokud nastane při přihlašování nějaký problém, zobrazí se popis nad tabulkou s přihlašovacími údaji. Po úspěšném přihlášení se zobrazí hlavní stránka systému.

2Hlavní stránka

Hlavní stránka (main.html) je rozcestník k dalším funkcím WebCalomu. V závislosti na tom, zda jste přihlášeni pod administrátorským účtem nebo jako běžní uživatelé, se bude obsah stránky lišit.

Běžní uživatelé vidí místo položky konfigurace přímo nabídku stránek s konfigurací, ke kterým mají přístup:

3Spouštění reportů

Na stránce spouštění reportů (report_params.html) se nastavují parametry reportu. Nejdřív se vybere formát (HTML, PDF, CSV, XML, neformátovaný) a typ reportu, který určuje jaké informace budou na výstupu reportu a jak budou strukturované. Podporované typy reportu jsou:

• HTML je vhodný pro zobrazování na obrazovce, příp. pro tisk

• CSV je formát určený pro import dat do tabulkového procesoru (např. Excel)

• XML je vhodný pro výměnu dat s jinými aplikacemi

• PDF je určený především pro tisk

• Neformátovaný se hodí pro případy, kdy chcete zobrazit report bez formátování (není určeno pro koncové uživatele).

Pro každý formát může být nadefinováno libovolné množství typů reportu. Klasicky se dodávají tyto předdefinované reporty (nemusí být dostupné pro všechny formáty), ale je možné si vytvořit vlastní typy:

Další volby lze rozdělit do dvou kategorií. Většina z nich omezuje výběr hovorů, které se dostanou do reportu, další vybírají způsob prezentace nebo uložení výsledku. Poslední volba umožňuje uložit všechno nastavení ve formě tzv. "rychlého reportu" (což je report, který se dá vyvolat z hlavní stránky).

Jednotlivé volby je možné skrývat kliknutím na název v prvním sloupci. Znovu ukázat všechny volby je možné klepnutím na "Zobraz všechna pole".

Do reportu jsou zahrnuty všechny hovory, které splňují zadaná kritéria a uživatel, který je spouští, má právo na jejich prohlížení. Právo na prohlížení se nastaví pouze na ty hovory, kde volající, volaný i ten, co hovor platil, mají v telefonním seznamu záznam umístěný v rámci organizačních jednotek, na které má daný uživatel právo na čtení nebo pokud ten, co hovor platí, má v telefonním seznamu záznam umístěný v rámci organizačních jednotek, na které má daný uživatel právo na rozšířené čtení.

Poznámka: Vždy, když se u reportu mluví o tom, že obsahuje tabulku pro všechny oddělení, autorizační kód, atd., rozumí se, že pokud do dané kategorie nespadl žádný záznam, tabulka je vynechána.

4Editace reportů

Editor reportů je Java aplikace pro editaci definice reportu. Definici reportu je možné upravovat i v textovém editoru, ale editor reportů nabízí grafické prostředí pro návrh. Je možné jej spouštět jako Java applet v rámci aplikace nebo jako samostatnou aplikaci. Bližší informace je možné najít v nápovědě pro aplikaci.

5Plánování reportů – nastavení pozdějšího a pravidelného spouštění

Na stránce “Správa plánovače” se provádí správa naplánovaných úloh.

Uvedete zde čas prvního spuštění a případně také frekvenci opakovaného spouštění. Pokud chcete report spustit pouze jednou, vyberte Pouze jednou. Parametry reportu už zde nemůžete měnit, můžete se ale podívat na nastavení reportu stisknutím Zobraz detaily o reportu. Toto je však určeno pro zkušené uživatele. Stisknutím OK bude report nastaven pro plánování.

Na stránce “Správa naplánovaných reportů” je pak s danými reporty možné dále pracovat. Tyto reporty se vytvoří na stránce spouštění reportů zaškrtnutím políčka Pouze uložit definici, naplánovat spuštění později. Při vytvoření takového reportu se nespouští generování reportu, pouze se uloží nastavení. Na této stránce pak naplánujete, kdy se report spustí.

Report může být spuštěn jednou v zadaný čas a potom zůstane neaktivní nebo můžete nastavit periodické spouštění. Pokud má report pevně určený rozsah data, nemá periodické spouštění smysl. V reportu ale můžete zadat rozdahy jako Dnes, Tento týden nebo Minulý měsíc. V takovém případě např. spouštění každý měsíc vygeneruje bez dalších zásahů každý měsíc aktuální report. Pokud to ještě zkombinujete se zasíláním reportu e-mailem, budete výsledky reportu automaticky dostávat. Pokud ne, můžete si hotové reporty vyzvednout na stránce uložených reportů.

Neaktivní reporty (ty, které se nebudou samy spouštět) jsou vybarveny šedou barvou, aktivní jsou černé. Kliknutím na Zapnout/Vypnout report aktivujete/deaktivujete. U každého reportu je vyznačeno datum a čas spuštění i frekvence spouštění.

Naplánovaný report můžete také smazat. Report se pak předstane spouštět, pokud však již spuštěn byl, výsledky nebudou smazány.

6Spouštění externích aplikací – SQLSync a LDAPSync

Z této nabídky můžete spouštět synchronizaci telefonního seznamu (dirdb adresáře) z jednoho ze dvou zdrojů:

1. SQLSync - synchronizace s DNA databází

2. LDAPSync - synchronizace s LDAP databází

Pro synchronizaci SQLSync jsou k dispozici následující parametry:

• Simulace - synchronizace proběhne bez zápisu do seznamu Calomu. Pouze se označí duplicitní záznamy a jiné chyby.

• Množství výstupu určuje kolik pomocných informací se má vypisovat.

• Úroveň výpisu ladicích informací určuje kolik se má vypisovat informací, které mohou sloužit ke zjišťování problémů.

• Verze DNA volí verzi DNA. DNA verze 5 je kompatibilní s verzí 4. Rozdíl ve verzi 3 a 4 je v existenci propojovací tabulky ext_sub a možností mít u jednoho záznamu víc telefonních čísel. Takovéto záznamy se pak v seznamu Calom serveru objeví jako několik položek se stejnými jmény ale různými čísly.

• Pokračuj i když najdeš duplicitní záznamy ovlivňuje chování SQLSyncu při nalezení duplicitních záznamů (což je chyba v při zadávání údajů do DNA). Implicitně se při nalezení duplicitních informací synchronizace ukončí a žádné změny se neprovedou. Tato volba umožní pokračovat i v tomto případě.

• Nepoužívej tabulku sub_ext je volba, která by se neměla používat pokud k tomu nejsou vážné důvody. Vynechá tabulku sub_ext, která se u DNA verze 4 a výš používá pro převod mezi jmény účastníků a telefonními čísly.

• Prohoď jména slouží ke zvolení příjmení jako prvního slova u záznamu. Calom má pro záznam v telefonním seznamu pouze jednu kolonku na jméno, a tam se zadává jméno i příjmení. Implicitně se nejdřív uvádí jméno, ale touto volbou je možné to změnit.

• Vyber Calom server slouží pro nastavení jiného Calom serveru než je uveden v konfiguračním souboru sql.conf.
  
  Poznámka: nastavení implicitního konfiguračního souboru se dá provést změnou volby
  
  sqlsync-config v souboru config/server_params)

• Vyber SQL server souží k nastavení jiného SQL serveru než je uvedeno v konfiguračním souboru sql.conf.

• Podstrom pro synchronizaci umožňuje vybrat pro synchronizaci pouze podstrom v telefonním seznamu. Ostatní záznamy budou ponechány beze změny.

• Kategorie pro nové záznamy vybírá číslo kategorie pro záznamy, které před tím v telefonním seznamu na Calom serveru nebyly. DNA totiž neobsahuje informaci o kategoriích.

• Databázové políčko pro komentář umožňuje vybrat databázový sloupec, ze kterého se má vzít komentář pro záznam.

• Databázové políčko pro CIL-kód umožňuje vybrat databázový sloupec, ze kterého se má vzít CIL-kód pro záznam.

• Třídění podle políčka vybírá databázový sloupec, podle kterého se záznamy před synchronizací setřídí. Má význam při použití pokročilých filtrů, které počítají s pořadím, v jakém přichází záznamy pro jednoho účastníka.

• Tabulka pro node prefixy umožní vybrat tabulku s node-prefixy.

• Filtry umožní vybrat podmínky pro záznamy. Záznamy, které neprojdou filtrem, budou ignorovány.
  
  Můžete si napsat vlastní podmínku pro filtr nebo použít některou z přednastavených. Podmínka Zařaď pouze účastníky s A v poli slouží k vyřazení záznamů, které nemají v daném databázovém sloupci uvedeno 'A'.

• Další parametry slouží k zadání jiných parametrů pro SQLSync. Nastavení konzultujte s manuálem k programu SQLSync.

• Uložení/Obnovení nastavení formuláře – nastavení v tomto formuláři můžete uložit pomocí tlačítka Ulož formulář a při dalším přístupu na tuto stránku (i když jste se mezi tím odhlásili a znova přihlásili) nazpět nahrát pomocí tlačítka Obnov formulář.
  
  Pro funkčnost těchto tlačítek musíte mít v prohlížeči povolené cookies. Standardní doba platnosti těchto údajů je jeden rok od posledního uložení..

Poznámky k výběru databázových sloupců (políček):

• Můžete přímo specifikovat jméno databázového sloupce (políčka). Implicitně se bude hledat v tabulce subscriber. Můžete však před název sloupce zadat jméno tabulky a údaje oddělit tečkou. Za tabulku subscriber se používá s, za tabulku extension se používá e.
  
  Např. sloupec directory_number z tabulky extension vyberete zápisem e.directory_number.

• Můžete hodnotu specifikovat pomocí UDF, pokud před ní napíšete '#'.

7Správa tarifikačních skriptů

Na stránce “Správa tarifů” se provádí úprava tarifikačních skriptů (tarifů). Tarify jsou programy ve speciálním skriptovacím jazyce, které slouží pro určení ceny hovoru.

Tyto tarify mohou být složeny z několika skriptů. Jednotlivé skripty jsou vidět v levé části v tabulce Dostupné skripty. Skriptovací jazyk je syntaxí podobný jazykům JavaScript nebo C. Skripty obsahují definice funkcí, proměnných a mohou obsahovat také kód mimo funkce. Skripty, které mají kód mimo funkce mohou sloužit jako tzv. hlavní tarifikační skripty. Tyto skripty si můžete vybrat při generování reportu a ceny hovorů budou počítány právě tímto kódem za definicemi funkcí.

Filosofie je taková, že tento kód obsahuje jenom kostru a většinu činností zajišťují funkce, které volá. Tyto funkce mohou být ze stejného skriptu nebo i z jiných skriptů.

Tímto vznikají závislosti mezi jednotlivými skripty. Pokud skript A využívá skript B, není možné skript B odstranit dokud existuje skript A. Podobně není možné odstranit skript pokud je používán jako implicitní tarif pro reporty. Tyto závislosti si systém sám kontroluje a nepovolí odstranit skript pokud by došlo k porušení pravidel.

Ve standardní distribuci např. existuje skript global, ve kterém jsou pomocné funkce použitelné prakticky pro všechny tarifikace. Například je tam funkce pro zjištění zda je daný den svátek nebo obecné jedno-pásmové, dvou-pásmové a tří-pásmové tarify.

Na tento skript pak navazuje skript telecom nebo aliatel, kde jsou funkce pro konkrétní způsoby tarifikace - např. místní hovor Telecomu. To je o víkendu a svátcích jednopásmový hovor, jindy dvoupásmový se jedním pásmem od 7:00 do 19:00 a s nejmenším tarifikovaným časem 2 minuty a následnou tarifikací po jedné minutě. Konkrétní ceny zde nejsou, jsou až v konkrétnějším tarifu např. telecom_standard nebo telecom_business. Tyto skripty volají služeb ze skriptu telecom.

Nakonec je tu hlavní tarifikovací skript main, kde se určí, jaké trunky budou tarifikovány jakými operátory, tedy jaké funkce se pro tarifikaci budou volat, případně se zde provedou výjimky. Třeba hovory z organizační domény soukromé hovory mohou být tarifikovány dvakrát větší cenou. Toto kaskádovité uspořádání má výhody v univerzálnosti, je však možné zvolit i libovolné jiné řešení.

Na levé straně v tabulce Dostupné skripty vyberte skript/tarif se kterým budete pracovat. Všechny další informace na stránce se budou vztahovat k tomuto skriptu.

V části Dostupné tarify můžete také vytvářet nové skripty, přejmenovávat nebo mazat existující (pro pravidla pro mazání viz výše).

V pravé části v sekci detaily můžete upravovat kód tarifu. Pro uložení změn stiskněte tlačítko Ulož. Pokud při kontrole nastaly ve skriptu chyby, uvidíte popis v horní části stránky. Aby nedošlo k poškození existujícího tarifu, bude nefunkční tarif dočasně přejmenován a po odstranění chyb se vrátí původní jméno.

Více informací o syntaxi tarifikačních skriptů najdete v dokumentaci popisující tarifikační jazyk.

Při generování reportu si můžete vybrat jakým tarifem budete chtít cenu počítat. Aby byl daný tarif při generování reportu nabídnut, musíte mu přiřadit jméno pro tarifikaci. Toto jméno od té doby budete moci používat. Administrátor může pojmenovat tarif globálně, tj. pro všechny uživatele zaškrtnutím políčka Ulož globálně pro všechny uživatele. Pojmenování můžete zrušit uvedením prázdného políčka. Pro potvrzení stiskněte tlačítko Ulož.

Poznámky:

• Editace tarifikačních skriptů je určena pro zkušené uživatele. Systém je dodáván se standardní sadou tarifů, které by měly pokrýt většinu požadavků. Pokud je nutné udělat úpravy, je možné se domluvit s distributorem.

• Každý skript je uložen na serveru v samostatném souboru. Tyto soubory můžete editovat přímo nebo můžete tarify spravovat i pomocí konzole nebo jiného klienta systému Calom. Soubory můžete editovat i přímo, pak je ale nutný restart serveru, aby se změny projevily.

• Více informací o syntaxi tarifikačních skriptů najdete v dokumentaci k tarifikačnímu jazyku

8Správa uživatelů

Na stránce “Správa uživatelů” můžete přidávat, mazat uživatelské účty WWW klienta a měnit jejich nastavení.

Klepnutím na uživatelské jméno se dostanete na stránku “Nastavení uživatelského účtu” pro daného uživatele. Když klepnete na Přidat nového uživatele, dostanete se na týž stránku, ale bez předvyplněných údajů. Klepnutím na Vymaž vymažete daného uživatele.

Uživatelské účty WWW klienta mají svůj protějšek v účtech na Calom serveru.˙Každý uživatelský účet má svůj Calom protějšek stejného jména. Protože se ale˙uživatelské účty na Calom serveru mohou dynamicky měnit i jinak než pomocí˙WWW klienta, synchronizuje se při každém požadavku na připojení ke Calom˙serveru údaj o aktuálním uživateli a jeho protějšek na Calom serveru. Účty na˙serveru se také, pokud se neuloží, při ukončení serveru vymažou.

Klepnutím na Uložit na serveru se uloží nastavení účtů permanentně˙na serveru. Pak nebude třeba tak často účty synchronizovat. Neuloží se ale˙pouze účty modifikované pomocí WWW klienta, ale všechny účty, které jsou˙v paměti serveru.

Je vhodné po nadefinování uživatelských účtů provést uložení na serveru.

Pomocí licence je možné omezit počet uživatelů, kteří smějí být na WWW klientu definováni. Pokud narazíte na omezení počtu uživatelů, bude nutné některé uživatele smazat.

9Nastavení uživatelského účtu

Na stránce “Nastavení uživatelského účtu” nastavujete vlastnosti uživatelských účtů. Můžete měnit nastavení nějakého konkrétního účtu, jehož hodnoty byly do políček předvyplněné, nebo přidávat nový účet.

Jednotlivá políčka jsou:

• Uživatelské jméno je jméno pod kterým se uživatel bude přihlašovat do WWW klienta.

• Uživatelské heslo je heslo, které musí při příhlášení zadat. Pokud není zaškrtnuto políčko Změnit bude ponecháno původní heslo, pro nového uživatele se vygeneruje prázdné heslo.

• Plné jméno je celé jméno uživatele. Aby se při přihlašování nemuselo psát celé dlouhé jméno, používá se uživatelské jméno, které by mělo být kratší a snadno zapamatovatelné.

• Číslo z adresáře označuje telefonní číslo daného účastníka.
  
  Je možné tento údaj využít např. v rychlém reportu, kde se výběr hovorů zúží např. jen na hovory, kde volající volal z daného čísla. Viz stránka “Editace rychlého reportu”.

• Implicitní jazyk je jazyk stránek, které se uživateli budou zobrazovat. Můžete vybrat z nabizených jazyků. ˙¯¯Výběr jazyků se konstruuje ze seznamu adresářů HTML_jazyk.˙¯¯Pokud v nějakém z těchto adresářů není kompletní jazyková verze,˙¯¯stránky mohou být nefunkční.

• Přístup povolen z IP adres umožňuje povolit uživateli přístup k systému pouze z určitého okruhu počítačů. Můžete zadat '0' pro neomezený přístup nebo IP adresu (čtyři čísla v rozmezí 0 až 255 oddělená tečkou) volitelně se síťovou maskou (buď ve formátu aaa.bbb.ccc.ddd nebo jen počet bitů (0 až 24)).
  
  Pokud síťovou masku neuvedete, bude se implicitně uvažovat '255.255.255.255' (nebo ekvivalentní zápis '24').

• Domovská organizační doména se podobně jako Číslo z adresáře může využívat v rychlých reportech. Navíc je uživateli automaticky povoleno čtení z této domény (viz. stránka o spouštění reportu).

• Organizační domény s právem na čtení je seznam organizačních domén, ze kterých se uživateli budou zobrazovat hovory v reportech. Hovory, kde volající, volaný nebo platící není v telefonním seznamu v některé z těchto domén (nebo jejich poddomén), nebudou při reportu brány v potaz. Více viz. stránka o spouštění reportu.
  
  Chcete-li přidat novou doménu, vyplňte její jméno do prázdného políčka a vlevo od zašktněte okénko. Pokud chcete odebrat doménu, zrušte zaškrtnutí vlevo od jejího jména.

• Organizační domény s rozšířeným právem na čtení je seznam organizačních domén, ze kterých se uživateli budou zobrazovat hovory v reportech. Hovory, kde je platící v telefonním seznamu v některé z těchto domén (nebo jejich poddomén), bude zahrnut do reportu. Více viz. stránka o spouštění reportu.
  
  Chcete-li přidat novou doménu, vyplňte její jméno do prázdného políčka a vlevo od zašktněte okénko. Pokud chcete odebrat doménu, zrušte zaškrtnutí vlevo od jejího jména.

• Organizační domény s právem na zápis je seznam organizačních domén, ve kterých může uživatel editovat telefonní seznam. Postup přidávání a ubírání domén je stejný jeko u seznamu domén pro čtení.

10Prohlížení záznamů systému – log Calom serveru a WebCalomu

Do logu systému WebCalom se zapisují chybové události nebo varování, které nastanou ve WebCalom klientu nebo při komunikaci s Calom serverem.

Na každém řádku je na začátku uvedeno datum a čas, potom následuje popis události. Určité druhy událostí jsou vyznačeny zvláštními barvami.

Prohlížení WebCalom logu je určeno pouze pro správu WebCalomu, většina záznamů nemá při běžném používání smysl, neboť obsahuje pouze informace použitelné při ladění systému a hledání chyb.

Aby log příliš nenarůstal, můžete starší údaje vymazat. Do kolonky Smazat záznamy před vyplňte datum (den-měsíc-rok), před kterým chcete záznamy smazat a stiskněte tlačítko Smazat.

Do logu systému Calom se zapisují události, které při provozu generuje Calom server. Na každé řádce je uvedeno datum a čas a v dalším sloupci popis události. a jedna událost. Každá obrazovka ukazuje vždy záznamy pro jeden den.

Pokud při práci s WWW klientem nastane nějaká chyba, sem se o ní zapíše podrobnější informace.

Ke každému záznamu je přiřazen typ (závažnost), která je rozlišena barvou. Kliknutím na položky z horní tabulky se seznamem typů se zobrazí nebo skryjí záznamy s daným typem.

Kliknutím na odkazy Předchozí a Následující se přesunete na předchozí resp. následující dny, kdy byly vygenerovány nějaké záznamy. Také můžete napsat datum ve formátu rok-měsíc-den a zobrazí se záznam pro daný den nebo nejbližší neprázdný záznam před tímto datem.

11Konzole Calom serveru

Tato konzole slouží pro přímou komunikaci s Calom serverem. Pro bližší popis funkcí Calom serveru nahlédněte do manuálu k Calom serveru.

Konsole běží v prostředí Java. Pro její funkčnost musíte mít v prohlížeči nainstalovanou a povolenou podporu jazyka Java alespoň verze 1.2. Pokud tomu tak není, můžete si stáhnout Java plugin pro váš prohlížeč z http://java.sun.com/.

12Editace telefonního seznamu

V systému Calom jsou v telefonním seznamu uloženy všechny důležité informace o účastnících (pobočkách) v telefonní síti. Používá se pro převod telefonního čísla na jméno účastníka (pobočky) a další záznamy.

V telefonním seznamu by měly být uloženy všechny vnitřní linky a do co největších detailů také vnější směry.

Pokud budou v seznamu chybět některé položky, nezobrazí se v reportech na místě pro jméno účastníka nic. Pokud bude vynechán nějaký údaj s CIL-kódem, nebudou se správně zobrazovat ani reporty, které jej využívají.

Telefonní seznam je hierarchický podobně jako struktura adresářů (složek) a souborů na počítači. Roli adresářů (složek) zde hrají organizační domény.

V každém místě telefonního seznamu je možné umístit libovolné množství organizačních domén i záznamů o účastnících (pobočkách).

Organizační doména sama o sobě nenese žádnou informaci, pouze může obsahovat další domény a záznamy o účastnících.

Typické nastavení pro firmu s odděleními 'Vývoj' a 'Prodej' se dá znázornit např.:

ext
    Evropa
       <x> Albánie           000355
       …
       Česká republika
           <x> Brno          05
           <x> Plzeň         019
           <x> Praha         02
           <x> ostatní       01
           <x> ostatní       03
           <x> ostatní       04
           <x> ostatní       06
           <x> ostatní       07
           <x> ostatní       08
           <x> ostatní       09
        …
        <x> Německo          00049
    Asie
        <x> Čína             00086
      …
   …
Vývoj
    skupina 1
        <x> Josef Novák      2456
        <x> Miroslav Pokorný 2457
    skupina 2
        <x> Pavel Prokeš     2510
        <x> Miroslav Pokorný 2522
Prodej
    <x> Antonín Svoboda      2568
    <x> Hana Svobodová       2571

Kde řádky označené <x> představují účastníky, ostatní jsou organizační domény.

Z daného příkladu je vidět, že když je nějaký útvar pro hovory důležitý, nemusí se mu přiřadit účastník, ale přiřadí se mu organizační doména a účastnící se vytvoří až v ní. Tímto se informace "zjemňuje" (viz např. rozdíl u České republiky a Albánie).

Když se v reportu někde vyskytne telefonní číslo, hledá se pro něj v telefonním seznamu záznam, který je nejdelším prefixem daného čísla (pokud je u něj poznačeno, že se nejedná o prefix, musí se shodovat přesně). Z tohoto záznamu se pak vezme jméno, CIL-kód a další informace a zobrazí se v reportu.

K organizačním doménám se vztahují uživatelská práva. Pokud by se měl v reportu zpracovávat hovor, kde volající, volaný nebo ten, co hovor platí, jsou z domény, kam daný uživatel nemá právo na čtení, hovor se ignoruje. Proto je dobré dát každému právo na čtení domény ext (pro telefonování ven).

Na stránce editace adresáře je možné provádět následující úkony:

• Pohyb v organizačních doménách – Pokud chcete prohlížet nebo upravovat domény nebo záznamy v nějaké doméně, klikněte na její název. Na prvním řádku se ukazuje jméno aktuální domény (kořenová doména se nazývá '.').
  
  Pokud se chcete dostat do nadřazené domény, klepněte na '..' (pokud jste v kořenové doméně '.', tento odkaz se nezobrazí).
  
  Na počátku se ukáže kořenová doména, pokud do ní máte přístup (pro čtení). Pokud nemáte, zobrazí se seznam domén, do kterých máte přístup.

• Editace záznamu – U záznamu, který chcete editovat, klepněte na odkaz Edituj v posledním sloupci. Dostanete se na stránku “Editace záznamu telefonního seznamu”.

• Přidání nového záznamu – Klepněte na Přidej záznam. Dostanete se na stránku “Editace záznamu telefonního seznamu”.

• Přidání organizační domény – Jméno organizační domény napište do políčka vedle tlačítka Přidej doménu a toto tlačítko stiskněte.

• Vymazání organizačních domén nebo záznamů – Zaškrtněte políčka vlevo od záznamú nebo domén, které chcete smazat, a stiskněte tlačítko Vymaž označené.

• Přesun organizačních domén nebo záznamů – Zaškrtněte políčka vlevo od záznamú nebo domén, které chcete přesunout, vyberte z nabídky u Přesuň označené do cílovou doménu a stiskněte tlačítko Přesuň.

• Třídění záznamů – Pokud je záznamů v dané organizační doméně velké množství, může být poměrně složité najít určitý záznam. Proto můžete klepnutím na jméno sloupce v záhlaví tabulky setřídit záznamy podle daného sloupce.

• Zapsat na serveru – Adresář se po každé akci ukládá na Calom server. Ten si ho však drží pouze v paměti a v případě výpadku se změny ztratí. Proto je dobré čas od času změny ukládat na serveru. K tomu slouží tlačítko Uložit u popisku Zapsat na serveru.

13Editace záznamu telefonního seznamu

Záznamy v telefonním seznamu slouží pro převod telefonního čísla na jméno, navíc slouží pro tarifikaci.

V horním řádku se za textem Org. vypíše v které organizační doméně se daný záznam nachází. Je to ta doména telefonního seznamu, ze které jste klepli na Přidej záznam nebo Edituj.

• Jméno účastníka je text, který se objeví v reportech vedle telefonního čísla.

• Číslo účastníka je telefonní číslo daného účastníka. V telefonním seznamu nemohou být dvě stejná čísla, může se zde ale vyskytovat u více čísel stejné jméno (pro případ, že účastník má víc telefonních linek). Mohou se zde také vyskytovat dvě čísla, kde jedno je prefixem druhého.

• Prefix označuje, zda je dané číslo prefixem, tj. jestli tomuto záznamu bude odpovídat telefonní číslo, které začíná tímto číslem, ale pak pokračuje dalšími číslicemi.

• CIL-kód je autorizační kód, který umožní, aby volání z libovolného telefonního přístroje bylo účtováno účastníkovi, jehož autorizační kód byl při volání použit. Proto musí být daný CIL-kód unikátní - žádný další účastník nesmí mít stejný CIL-kód.
  
  Aby se tento způsob tarifikace dal použít, musí být v ústředně nadefinován tzv. PIN kód.

• Kategorie je číslo udávající tarifikační kategorii záznamu. Podle této kategorie u volaného čísla se hovory většinou tarifikují. Např. záznamy pro Evropské země, do kterých je cena za volání stejná, mohou mít stejnou kategorii. Naopak třeba mobilní síť Eurotel bude mít jinou kategorii než Německo, protože mezinárodní hovory se tarifikují jiným způsobem než volání do sítí mobilních operátorů.
  
  Volba kategorie se musí zvolit v souladu s tarifikačními pravidly pro danou kategorii uvedenými v tarifních skriptech na Calom serveru (viz. dokumentace k tarifům Calom serveru).

• Komentář je libovolný text, který se v adresáři objeví vedle jména. Lze jej použít na doplňující informace o účastníkovi.

Stiskem Ulož uložíte daný záznam na Calom serveru (pozor, ještě není permanentně uložen, viz poznámka na stránce “Editace adresáře”. Stisknutím odkazu Zpět se vrátíte na stránku “Editace adresáře”.

14Správa uložených reportů

Na stránce “uložené reporty” je možné stahovat nebo mazat výsledky reportů, které byly vygenerovány plánovačem nebo byla v tabulce parametrů reportu zaškrtnuta volba Pouze uložit definici, naplánovat spuštění později.

Poznámka: Tyto uložené reporty by se měly čas od času promazat, protože zabírají místo na disku serveru.

Poznámka: Pro více informací viz. správa plánovače.

15Konfigurace rychlých reportů

Na stránce “Konfigurace rychlých reportů” se provádí úprava rychlých reportů. Vidíte seznam vlastních (administrátor i globálních) tzv. rychlých reportů. Klepnutím na Smazat daný rychlý report smažete, klepnutím na Editovat se dostanete na stránku “Editace rychlého reportu”, kde můžete daný rychlý report upravit.

16Nastavení licence

Na stránce “Nastavení licence” můžete nastavit vlastnosti licence. Tato stránka je určena pouze pro osoby, které mohou měnit licenci a znají autorizační kód. Nastavují se zde různé limity a povolují resp. zakazují se určité vlastnosti. Tato nastavení se týkají pouze WebCalomu, ne Calom serveru.

Počtem uživatelů se myslí počet uživatelských účtů na WebCalomu, ne počet současně pracujících uživatelů.

Poznámka: Pokud do políčka Omezit počet uživatelů napíšete -1, nebude počet uživatelů omezen.

3Dodatek A: popis tarifikačního jazyka

Tarifikace probíhá při generování reportu po tom, co informace o hovoru projde autorizací a lokálními filtry.

Je zajišťována skripty (také označovaných jako tarify), jejichž formát zde bude popsán.

3.1Hlavní skripty

To, jaký skript se pustí pro tarifikování hovoru se určí podle nastavení implicitního "hlavního" skriptu.

Nastavení tohoto skriptu se provede příkazem 'TARIF DEFAULT_MAIN jmeno_skriptu' buď v konfiguračním souboru nebo z příkazové řádky klienta.

Vymazat implicitní hlavní skript lze pomocí 'TARIF NO_DEFAULT_MAIN' (skript se nesmaže, pouze se u něj poznačí, že není hlavní).

Kromě implicitního hlavního skriptu se dá pro každou seanci zvlášť nastavit lokální "hlavní" skript příkazem 'TARIF LOCAL_MAIN jmeno_skriptu'. Pokud je nastaven, použije se při tarifikování místo implicitního.

3.2Správa skriptů

Skripty je možné přidávat pomocí 'TARIF ADD', mazat pomocí 'TARIF DEL', zjišťovat o nich informace 'TARIF DUMP' nebo si nechat vypsat všechny natažené skripty přes 'TARIF LIST'.

Každý skript má tzv. reference count, což je počet objektů, které ho potřebují. Pokud tento čítač klesne na nulu a skript není uložen, smaže se. Za každou funkci daného skriptu, kterou používá nějaký jiný skript se mu o 1 zvýší reference count.

Když z určité cli seance natáhnu nový skript, dostane reference count 1. Když daná seance skončí, čítač se zase sníží. Když je skript "hlavní" (ať už lokálně nebo globálně), má reference count zvýšený o 1 (pokud je jak lokálně tak globálně, tak o 2). To zabraňuje tomu, aby byl smazán.

Pozor na to, že pokud natáhnu nějaký skript pomocí 'TARIF ADD' a skončím seanci, skript se smaže. To platí i pro seanci, ve které se načítá konfigurační soubor. Takže pokud chci skript zachovat, musím buď nahrát jiný skript, který bude využívat jeho funkcí, nebo ho označit jako hlavní.

Tímto vznikají jakésy stromy využívání skriptů, kde v kořeni jsou "hlavní" skripty (globální nebo lokální pro nějakou probíhající seanci) a na ně se napojují skripty, které jsou jimi využívány. Pokud potom smažu kořen, smaže se celý strom (v případě, že jsem skripty načítal ve stejné seanci, ve které toto provádím, smažou se až po jejím skončení).

Pokud ale nějaký skript uložím příkazem 'TARIF STORE', nesmaže se ani když jeho reference count dosáhne 0 (pod 0 klesnout nemůže).

Když chci provést upgrade skriptů, stačí smazat hlavní skript a potom nahrát nové verze skriptů a jednomu z nich přiřadit funkci "hlavního skriptu". Tento reference counting je udělán z důvodu, aby se nemohly mazat skripty, které jsou používány, a aby v systému nezůstávaly nepoužívané skripty.

Skript mohu smazat příkazem 'TARIF DEL'. Pokud měl reference count větší než 0, akce se neprovede. To se může stát, pokud je daný skript lokální (využívá ho aktuální seance, takže mu o 1 zvyšuje reference count), pokud je nastaven jako hlavní skript nebo pokud jeho funkcí využívá nějaký jiný skript. Reference county skriptů a další informace se mi zobrazídané příkazem 'TARIF LIST'.

Příkazy 'TARIF REPARSE', 'TARIF STRIP', 'TARIF STORE', 'TARIF DEL', 'TARIF SET_MAIN', 'TARIF NO_DEFAULT_MAIN', 'TARIF INFO', 'TARIF DUMP' a 'TARIF DUMP_CODE' jsou povolené pouze účtům s administrátorskými právy.

Standardní postup je načíst skripty v konfiguračním souboru serveru v takovém pořadí, aby skript, který načítám se odkazoval pouze na skripty už načtené a na závěr načtu hlavní skript a označím ho jako hlavní. Příklad konfiguračního souboru:

; Ruzne servisni funkce
TARIF ADD global tarifs/global.trf

; Telecom
TARIF ADD telecom tarifs/telecom_fcn.trf
TARIF ADD tabulky tarifs/telecom_standard.trf

; Aliatel
TARIF ADD aliatel tarifs/aliatel.trf

; Main
TARIF ADD main tarifs/main.trf

TARIF STORE main
TARIF SET_MAIN main

Seznam nových příkazů serveru (dají se použít z klienta z příkazové řádky nebo v konfiguračním souboru serveru):

3.3Syntaxe tarifikačních skriptů

Jazyk pro skripty je syntaxí podobný jazyku C. Zdrojový kód se skládá ze dvou částí: deklarační a příkazové.

V deklarační části jsou deklarace proměnných (jsou lokální pro daný skript) a funkcí (ty jsou globální, tj. přístupné z jiných skriptů).

V příkazové části jsou příkazy, které se budou spouštět při tarifikaci pokud je daný skript hlavní (pokud není, daná část nemá smysl).

Deklarace globálních proměnných vypadá takto (hranaté závorky udávají nepovinnou část):

TYP jméno1 [, jméno2 [, …]] [= iniciální hodnota];

3.3.1Typy

TYP může být:

Mezi mnoha typy jsou prováděny implicitní konverze.

Pokud je v deklaraci proměnné uvedena iniciální hodnota, je daná proměnná na tuto hodnotu inicializována při každém spuštění reportu.

3.3.2Předdefinované proměnné

Poznámka: obsahují aktuální informace o hovoru a mají stejný význam jako proměnné stejného jména v reportech nebo filtrech

• string ANUM, BNUM, CNUM, DNUM - telefonní čísla

• string ACOM, BCOM, CCOM, DCOM - komentáře

• string ADOM, BDOM, CDOM, DDOM - domény

• byte ACAT, BCAT, CCAT, DCAT - kategorie

• string ANAME, BNAME, CNAME, DNAME - jména účastníků

• byte SRC

• ulong FLAGS

• string TRUNK

• string AUTH

• string ACCT

• string AUX

• ulong PULSES - počet tarifních impulzů

• ulong LEN - délka hovoru

• timestamp END - čas konce hovoru

• ulong OPQUEUE

• ulong QUEUE

• ulong PULSECOST

3.3.3Deklarace funkcí

TYP jméno_funkce ([TYP [&] parametr1 [, TYP [&] parametr2 [,…]]])
{
    [lokální deklarace proměnných (stejné jako globální)]
    [seznam příkazů]
}

TYP je stejný jako u proměnné, ale navíc může být 'void', který označuje, že funkce nic nevrací.

Pokud je v lokální deklaraci uvedena iniciální hodnota, dosadí se do dané proměnné při každém volání funkce (než se začnou vykonávat příkazy). Parametry, u kterých je uvedeno '&' se předávají odkazem, tj. funkce může měnit hodnotu proměnné uvedené jako skutečný parametr (ten, který se píše do volání funkce).

Ve volání funkce musí být parametry předávané odkazem uvedeny také s '&'.

3.3.4Předdefinované funkce

Poznámka: není problém na požádání přidat další. Zatím jsou tam ty, které byly potřeba při tarifikování

int split_timestamp(
    timestamp end,
    int &year, int &month,
    int &month_day,
    int &week_day,
    int &day_seconds
);

int day_intersect(
    time end0, time length0,
    time begin1, time end1
);

int strlen(string s);

string substr(
    string s,
    int start,
    int length);

int parse_trunk(
    string trunk,
    int &t1, int &t2, int &t3
);

3.3.5Příkazy

{ příkaz1; [příkaz2; [příkaz3; […]]]}

if (podmínka) příkaz
if (podmínka) příkaz1 else príkaz2

while (podmínka) příkaz

for (příkaz1; podmínka; příkaz3;) příkaz4

switch (výraz) {
    case a: příkazy_a; [break;]
    case b: příkazy_b; [break;]
    […]
    [default: příkazy_default;]
}

break;
break n;

return výraz;

print string [, string2 [, …]];
println string [, string2 [, …]];

stop;

fail;
fail "Chybová hláška";

funkce(parametr [, parametr]);

3.3.6Výrazy

Klasické výrazy v infixové notaci se závorkami.

Používají se operátory (seřazeno podle priorit, první řádek má nejvyšší):

'-' (unární), '++', '--', '(typ)', '(+typ)', '(-typ) (přetypování)
'*', '/', '%'
'+', '-'
'<', '>', '<=', '>='
'==', '!='
'&'
'|'
'&&'
'||'
'=' a všechny varianty jako '+=', '*=', …
','

Poznámky:

• priority jsou stejné jako v jazyce C.

• Oproti jazyku C je zde navíc přetypování na typ 'typ' se zaokrouhlením dolů: (-typ) a nahoru: (+typ).

• Nejsou zde bitové posuny.

3.3.7Překlad

Překlad probíhá těsně po příkazu serveru 'TARIF ADD', 'TARIF PARSE' nebo 'TARIF REPARSE'. Výskyt chyby je hlášen serverem klientovi a detailní popis důvodu je zapsán do logu.

3.4Standardní tarifikační skripty

3.4.1main.trf:

Hlavní skript; v něm se tarifikace rozskakuje podle trunku do tarifikačních funkcí jednotlivých operátorů. Tento soubor je potřeba upravit podle přiřazení trunků jednotlivým operátorům.

3.4.2global.trf:

Zde jsou uloženy obecné servisní funkce, které je možné použít pro libovolného operátora.

int is_easter(int year, int month, int day)

int is_holiday(int year, int month, int day)

void get_day_before(
    int year, int month, int day,
    int &year1, int &month1, int &day1
)

money do_tarif_1pasmo(
    time mintime,
    money mincost,
    time timeslice,
    money slicecost,
    time &begin, time &length,
    int is_continuation
)

money do_tarif_2pasma(
    time T1, time T2,
    time mintime1, time mintime2,
    money mincost1, money mincost2,
    time timeslice1, time timeslice2,
    money slicecost1, money slicecost2,
    time &begin, time &length,
    int is_continuation
)

money do_tarif_3pasma(
    time T1, time T2, time T3, time T4,
    time mintime1,
    time mintime2,
    time mintime3,
    money mincost1,
    money mincost2,
    money mincost3,
    time timeslice1,
    time timeslice2,
    time timeslice3,
    money slicecost1,
    money slicecost2,
    money slicecost3,
    time &begin, time &length,
    int is_continuation
)

money do_tarif_internet2002(
    time T1, time T2,
    money low_cost1, money high_cost1,
    money low_cost2, money high_cost2,
    time &begin,
    time &length1, time &length2
)

3.4.3telecom_fcn.trf:

Zde jsou funkce uzpůsobené konkrétně pro Telecom, používají ale funkce z global.trf.

money tarif_telecom_mistni02(
    money cost_low, money cost_high,
    timestamp end, time length
)

money tarif_telecom_mezimesto02(
    money cost_night,
    money cost_low,
    money cost_high,
    timestamp end, time length
)

money tarif_telecom_mobil02(
    money cost,
    timestamp end, time length
)

money tarif_telecom_mezinarodni02(
    money cost_low, money cost_high,
    timestamp end, time length
)

money tarif_telecom_2pasma_02(
    time min_time, time interval,
    money cost_low, money cost_high,
    timestamp end, time length
)

money tarif_telecom_1pasmo_02(
    time min_time,
    time interval,
    money cost_per_minute,
    timestamp end, time length
)

money tarif_telecom_internet2002(
    money cost1_low,
    money cost1_high,
    money cost2_low,
    money cost2_high,
    timestamp end, time length
)

3.4.4telecom_standard.trf:

Je zde hlavní tarifikovací funkce tarif_telecom(), která na základě BCATu určí, jaké tarifikovací funkce a s jakými cenami zavolá. Tento soubor je potřeba upravit podle konkrétní konfigurace BCATů a podle konkrétního cenového programu.