Funkce SendSMS.Init() inicializuje SendSMS objekt. Není možno odesílat SMS zprávy před zavoláním této funkce. Tato funkce by měla být zavolána jen jednou na začátku práce.
Syntaxe:
SendSMS.Init( appname, [server] )
•appname (textový řetězec) - Jméno odesílající aplikace. Nesmí obsahovat nic jiného, než malá písmena anglické abecedy a číslice.
•server (textový řetězec) - Jméno MobilChange serveru. Pokud je předán prázdný řetězec, přistupuje se na lokální počítač.
•(návratová hodnota) - Textový řetězec "OK" = úspěšná inicializace, "ERROR" = problém při inicializaci.
Objekt vytváří CTL soubory ve sdíleném adresáři MxInQueue na počítači [server], resp. na lokálním počítači. Pokud tento sdílený adresář neexistuje, vrátí funkce Init chybu.
Příklad použití:
Dim rc |
Funkce SendSMS.SendSMS() odesílá SMS zprávu.
Syntaxe:
SendSMS(To, Text, [NoModify=False], [FromName], [FromEmail], [FromSmtp], [Language], [DR=False])
•To (textový řetězec) - Telefonní číslo adresáta.
•Text (textový řetězec) - Text zprávy.
•NoModify (True/False) - Nepovinný parametr s výchozí hodnotou False. Pokud je True, text zprávy je odeslán přesně tak, jak byl zadán aplikací. Pokud je False, text je zpracován pomocí MobilChange stejným zprůsobem, jako odesílané e-maily, tj. jsou vynechány mezery, překódovaná čeština atd.
•FromName (textový řetězec) - Nepovinný parametr s výchozí hodnotou prázdný řetězec. Jméno uživatele, za kterého aplikace SMS odesílá. Případné potvrzení o doručení bude posláno na toto jméno.
•FromEmail (textový řetězec) - Nepovinný parametr s výchozí hodnotou prázdný řetězec. E-mail adresa uživatele, za kterého aplikace SMS odesílá, v rámci lokálního e-mail systému (tj. např EX: adresa u Exchange serveru). Případné potvrzení o doručení bude posláno na tuto adresu.
•FromSMTP (textový řetězec) - Nepovinný parametr s výchozí hodnotou prázdný řetězec. SMTP adresa uživatele, za kterého aplikace SMS odesílá. Případné potvrzení o doručení bude posláno na tuto adresu.
•Language (textový řetězec) - Nepovinný parametr s výchozí hodnotou prázdný řetězec. Kód jazyka uživatele, za kterého aplikace SMS odesílá. Případné potvrzení o doručení bude posláno v tomto jazyce. Povolené kódy odpovídají názvům podadresářů v adressáři MobilChange/data/, tj. CZ, UK, ... Podle zdrojáku se tato hodnota nepoužívá, takže je lepší předávat vždy prázdný řetězec. Pro odesílatele typu aplikace bude použit jazyk AA, pro ostatní jazyk dle nastavení uživatele v pohledu MXUSER.
•DR (True/False) - Nepovinný parametr s výchozí hodnotou False. Pokud je True, je vyžadováno potvrzení o doručení. Pokud je False, nechce aplikace potvrzení o doručení. Nastavením této proměnné se řídí i nastavení žádosti o infomail, chci DR = chci i infomail a opačně.
•(návratová hodnota) Textový řetězec "OK", pokud je vše v pořádku, řetězec "ERROR" v případě, že došlo k chybě.
Pokud není některý z parametrů FromName, FromEmail a FromSMTP vyplněn, použije se hodnota "appname" předaná funkci Init (doplněná o $A na začátku - $Aappname).
Příklad použití:
Dim rc |
Metoda SendSMS.UnInit() odinicializuje SendSMS objekt. Po zavolání metody není možno dále odesílat SMS zprávy. Tato metoda by měla být zavolána jen jednou na konci práce.
Syntaxe:
SendSMS.UnInit()
Příklad použití:
Call SendSMS.UnInit() |
Property SendSMS.LastError obsahuje textový popis poslední chyby vzniklé v objektu SendSMS.
Seznam chyb:
•Chyba: Nebyla nalezena složka pro odchozí SMS
•Chyba: Objekt není inicializován
•Chyba: Vytvoření výstupního SMS souboru selhalo