Mobilchange news Obsah dokumentace Uživatelská dokumentace Administrátorská dokumentace Rejstřík pojmů Technická podpora Hledání on-line

mxRouteCfg - editor routingu

Úvod

Program mxRouteCfg je určen k nastavení a zkoušení směrovacích pravidel pro příchozí i odchozí SMS zprávy. Najdete jej v Start Menu -> Programs -> MobilChange -> mxRouteCfg

POZOR: Aby MobilChange načetla nová směrovací pravidla, je nutno zrestartovat servis MobilChange.Kernel.


Základní ovládání

V základním pohledu máme k dispozici následující tlačítka (platí pro příchozí i odchozí SMS):

Přidat... - přidá nové pravidlo

Upravit... - edituje označené pravidlo

Smazat - smaže označené pravidlo

Přejmenovat - umožní přejmenovat pravidlo (změnit číslo pravidla)

šipka nahoru / dolů - posunuje označené pravidlo nahoru/dolů a tím mění pořadí zpracování pravidel

Testovat doručení - pokud je zadáno telefonní číslo a text SMS, ukáže, která pravidla by ji zpracovaly.

Menu "Hlavní" - umožňuje změnit počítač, na kterém editujeme pravidla (tj. spravovat vzdálený počítač).
 

zpět na začátek


Přidání nového pravidla / editace existujícího (příchozí SMS)

Přepněte se na záložku "Příchozí". Nové pravidlo založíme stiskem tlačítka Přidat..., označené pravidlo editujeme stiskem tlačítka Upravit.... V obou případech se pak dostaneme do následujícího dialogu:

Popis - textový popis aplikace.

Od - regulární výraz filtrující odesilatele SMS. Místo regulárního výrazu je možno vložit přímo telefonní číslo, v tom případě bude pravidlo platit právě pro toto číslo. Místo regulárního výrazu pro telefonní číslo je též možno vložit alias ve formátu $<jméno_aliasu>, tj. např $users.
Dále je možno testovat, zda se číslo odesilatele nachází či nenachází v zadaném textovém souboru. Toto se nastavuje v poli Test přítomnosti (netestovat/obsaženo/neobsaženo) a jméno souboru se vyplní v poli Seznam čísel. Soubor je ve formátu "co řádek to telefonní číslo". Za běhu se testuje, zda nedošlo ke změně data zápisu do souboru. Při změněném datumu se načte nový obsah souboru. Test se provádí maximálně jednou za 15s.

Telefonní čísla se zpracovávají v mezinárodním formátu bez plusu na začátku, tj. např. +420603899285 se zapisuje jako 420603899285. Regexp je nutno konstruovat s ohledem na tento formát a takto se čísla zadávají i do souboru se seznamem čísel.
Regulární výrazy jsou popsány v tomto dokumentu.

Dále lze testovat, zda SMS došla linkou uvedenou v seznamu povolených linek (pole Příchozí linka). Prázdný seznam znamená, že se test na linku neprovádí. Linek lze uvést více, oddělují se čárkou (seznam dostupných linek je v rozbalovacím seznamu vpravo). Od verze Mobichange 4.6.16 lze psát linku ve tvaru "line1" i "line1_1234" (ve jméně linky může od linkového ovladače přijít číslo, na které byla SMS posílána) a lze zde používat regulární výrazy.


Text - regulární výraz filtrující text zprávy. Pokud zde uzavřete některé podvýrazy do kulatých závorek, můžete jejich hodnotu dále použít (v e-mail adrese nebo v parametrech aplikace).

Při příchodu nové zprávy se testují se všechny podmínky v logickém součinu. Tzn. aby pravidlo fungovalo, musí vyhovovat regexp na číslo odesilatele (vždy), jméno linky (jsou-li linky uvedeny) i test čísla na (ne)přítomnost v seznamu (je-li testování požadováno).


Příjemce - pokud chcete SMS předat aplikaci, zapište zde jméno aplikace ve tvaru $A<jméno aplikace> tj. např $Apizza pro aplikaci "pizza".

Pokud má být SMS předána uživateli, zapište sem jeho e-mail adresu. V adrese je možno používat podvýrazy z regexpu jako proměnné $1$9 (regulárního podvýraz zadaného čísla). Tj. pokud máte směrovací pravidlo #([^ ]+) (.*), můžete zde zadat $1@datasys.cz a SMS s textem "#zeleny ahoj" bude odeslána na adresu "zeleny@datasys.cz".

Text - jaký text se má poslat aplikaci. K dispozici máte proměnné $0 (která je nahrazena textem celé přišlé SMS) a $1$9 (které jsou nahrazeny obsahem regulárního podvýrazu zadaného čísla).

Příklad: Pokud bylo zadáno filtrovací pravidlo pro text zprávy jako
#pizza (.*)
pak pokud přišla SMS s textem "#pizza se slonama", bude naše aplikace dostávat v závislosti na tomto nastavení následující texty:
$0#pizza se slonama
$1se slonama
AHOJ $1 BLEBLEAHOJ se slonama BLEBLE

V jazyce - pokud má být SMS odeslána e-mailem, v jakém jazyku bude doprovodný text? (zz je jazyk pro SMS->email gateway, aa je jazyk pro aplikace).

Co dál - co má být se zprávou uděláno, pokud vyhovuje tomuto pravidlu:

zpět na začátek


Testování pravidla

Pravidlo bylo vytvořeno. Nyní je třeba otestovat, zda funguje tak, jak má, neboť špatně napsané nebo umístěné pravidlo může přijímat více SMS, než má (a nebo naopak méně).

V poli "Linka" vyberte příchozí linku. Do pole "Z čísla" napište telefonní číslo, do pole "Text" napište zkoušený text. Pak stiskněte "Testovat doručení".
 

Je to správně? Ano!
 

Nyní si zkusíme objednat pizzu.
 

A ejhle, místo předání aplikaci "pizza" by se SMS poslala e-mailem! Co s tím? Přesuneme pravidlo "pizza" na první místo.
 

A co teď?
 

Ano, takto je to správně!
 

V položce Historie najdete několik posledních testovaných SMS, abyste je nemuseli zadávat stále znovu.
 

zpět na začátek


Pravidla pro odchozí SMS

Přepněte se na záložku "Odchozí". Nové pravidlo založíme stiskem tlačítka Přidat..., označené pravidlo editujeme stiskem tlačítka Upravit.... V obou případech se pak dostaneme do následujícího dialogu:

Popis - textový popis pravidla.

Na číslo - regulární výraz filtrující číslo, kam je SMS odesílána. Místo regulárního výrazu je možno vložit přímo telefonní číslo, v tom případě bude pravidlo platit právě pro toto číslo. Místo regulárního výrazu pro telefonní číslo je též možno vložit alias ve formátu $<jméno_aliasu>, tj. např $users.

Telefonní čísla se zpracovávají v mezinárodním formátu bez plusu na začátku, tj. např. +420603899285 se zapisuje jako 420603899285. Regexp je nutno konstruovat s ohledem na tento formát.
Regulární výrazy jsou popsány v tomto dokumentu.

Priority - vyberte priority zpráv, které budou zpracovávány tímto pravidlem (vysoká, normální, nízká).

Směřuj na linku - vyberte odchozí linku ze seznamu vpravo, tím se přesune do seznamu. Lze zadat více linek (pokud jsou k dispozici) oddělených čárkou, v tomto případě se linka vybírá náhodně ze zadaných, není zde mechanismus beroucí ohled na propustnost, vytížení atd.

zpět na začátek