Mobilchange news Obsah dokumentace Uživatelská dokumentace Administrátorská dokumentace Rejstřík pojmů Technická podpora Hledání on-line
Konfigurace odesílání SMS zpráv, formát odesílaných zpráv

Jak probíhá odesílání SMS zprávy?

Tento dokument popisuje, jak probíhá odesílání SMS zprávy a jak jej může administrátor konfigurovat.

Odeslání zprávy probíhá v následujících krocích:

Po změně konfigurace je nutno zrestartovat servis MobilChange.Kernel.

Vyhledání vhodné odesílací linky

Tato část dokumentace je zde jen pro kompletnost informací. Pro editování směrovacích pravidel odchozích SMS používejte program mxRouteCfg.

MobilChange může obsluhovat více než jednu linku 1). Při odesílání SMS je tedy nutno určit, která odchozí linka zprávu odešle.

Směřovací tabulka pro odcházející zprávy je v registry v klíči:
HKEY_LOCAL_MACHINE\SOFTWARE\Datasys\MobilChange\sending\route\

V tomto klíči jsou podklíče obsahující jednotlivá směřovací pravidla. Jméno podklíče musí být číslem, toto číslo určuje prioritu daného pravidla. Směřovací pravidla se vyhodnocují abecedně, tj. pořadí je například "1", "10", "2", "20", "200", "201", "3"... To umožňuje vložit mezi libovolná dvě pravidla pravidlo další.

Každé směřovací pravidlo obsahuje následující položky:

recipient
Regulární výraz (nebo několik výrazů oddělených čárkou). Může zde být též alias. Pokud je výraz (některý z výrazů) vyhodnocen jako splněný, může být pravidlo použito. Příklady:
.*
všichni adresáti
^42060[34][0-9]+,^4616$
T-Mobile CZ, tj. čísla 420603xxxxxx, 420604xxxxxx a číslo SMS služeb 4616 (bez předvolby). Pozor! Číslo je zde vždy zpracováváno v mezinárodním formátu a bez plusu na začátku, tj. číslo 603899285 sítě T-Mobile CZ je zde zpracováváno jako 420603899285.
$tmobile
alias skupina Tmobile
priorities
Seznam priorit, pro které je toto pravidlo platné. Používají se písmena h, n a l. Pokud má tedy pravidlo platit pro všechny priority, napíšte sem hnl.
line
Jméno linky, přes kterou má být SMS odeslána, pokud jsou splněna pravidla recipient a priorities.
1) MobilChange Standard může obsluhovat pouze jeden hardware ovladač. MobilChange Enterprise může obsluhovat více hardware driverů.

zpět na začátek

Modifikace zprávy (dodání hlaviček)

Pokud uživatel nezvolí v send-options, že zpráva nemá být modifikována, je k odesílaným SMS přidána hlavička a patička.

Konfigurace této customizace je k nalezení v konfiguraci linky, tj. pro defaultní instalaci v klíči
HKEY_LOCAL_MACHINE\SOFTWARE\Datasys\MobilChange\line\line1

Vzhled výsledné zprávy je ovlivňován následujícími položkami:

customize_begin
Začátek první SMS vytvořené z jednoho e-mailu.
customize_end
Konec poslední SMS vytvořené z jednoho e-mailu.
customize_head
Začátek druhé a všech dalších SMS vytvořených z jednoho e-mailu. Pokud je e-mail rozložen jen na jednu SMS, nepoužije se.
customize_foot
Konec první až předposlední SMS vytvořených z jednoho e-mailu. Pokud je e-mail rozložen jen na jednu SMS, nepoužije se.

Každá tato položka může obsahovat text, který se připojí na začátek/konec SMS zprávy. Dále může obsahovat proměnné zapsané jako %jméno_proměnné%, které se nahradí svou hodnotou pro danou SMS.

Seznam proměnných, které jsou k dispozici:

sms_num
Číslo aktuální SMS
sms_max
Celkový počet SMS
from_email
SMTP adresa odesilatele
from_name
Jméno odesilatele
subject
Subjekt zprávy

Je též možno používat jednoduché logické výrazy, které umožňují například přidat do SMS jen ty položky, které jsou pro ní relevantní. Formát výrazu je následující:

["výraz 1"=="výraz 2";"výstup"]
["výraz 1"!="výraz 2";"výstup"]

Před středníkem je podmínka. Pokud je podmínka splněna (tj. u "==" jsou oba výrazy shodné, u "!=" naopak rozdílné), vloží se text "výstup". Pokud podmínka splněna není, nevloží se nic. Tj. u výrazu:
["%sms_max%"!="1";"1/%sms_max% "]
se do zprávy vloží text 1/N, pokud se jedná o první SMS z N, ale nevloží se žádný text, pokud byl e-mail zkonvertován jen do jedné SMS.

Součástí standardní instalace je tento formátovací řetězec:
["%sms_max%"!="1";"1/%sms_max% "]F:%from_email% ["%subject%"!="";"S:%subject%-"]
ze kterého tedy mohou vzejít následující hlavičky zprávy:

1/3 F:brouzda@datasys.cz S:pozvanka-text zpravy
pokud se e-mail rozdělil na tři SMS a měl uvedený subjekt
F:brouzda@datasys.cz S:pozvanka-text zpravy
pokud se e-mail vešel do jedné SMS a měl uvedený subjekt
1/3 F:brouzda@datasys.cz text zpravy
pokud se e-mail rozdělil na tři SMS a neměl uvedený subjekt
F:brouzda@datasys.cz text zpravy
pokud se e-mail vešel do jedné SMS a neměl uvedený subjekt

Použitím těchto výrazů je možno maximálně zkrátit text v hlavičce a ušetřit tím cenné místo v SMS.

zpět na začátek