MobilChange™ - Dokumentace > Administrace a funkčnost MobilChange™ > Administrátorské nástroje > Popis MobilChange > Serverové části > SMS aplikace > Konkrétní aplikace > MobilChange Database Connector > MobilChange Databázový konektor > Instalace a konfigurace

Nasazení probíhá konfigurací DB Connectoru pomocí UMSConfigurationTool v části MobilChange > Databázový konektor > Přidat.

Název konektoru musí být 1-30 znaků bez mezer.

dbconnector

Po nasazení se v UMS Task Configurationu automaticky založí dvě úlohy (do verze 5.16 jedna společná) zajišťující předávání zpráv mezi zákaznickou tabulkou a MobilChange.

Služba "DatabaseConnector_<jmeno>_in" obsluhuje tabulku SMSIN do které jsou vkládány SMS které byly přijaty do MobilChnage

Služba "DatabaseConnector_<jmeno>_out" obsluhuje tabulku SMSOUT která je vstupní frontou do MobilChange a jsou do ní vkládány zprávy k odeslání.

Dále je potřeba v zákaznické databázi vytvořit tabulky dle StrukturaDB_send.xls (dokument se nachází instalačním adresáři \\MobilChange\etc\DatabaseConnector\SQL).

ve stejném adresáři se nacházejí i SQL scripty pro tvorbu struktury tabulek, je třeba vždy použít napřed původní
MobilChange\etc\DatabaseConnector\SQL\mssql.sql

a následně všechny změnové:

MobilChange\etc\DatabaseConnector\SQL\mssql_delta_000x.sql

SMSIN
	TYPE	POPIS	POZNÁMKA
ID	automatické číslo	ID řádku, primary key
SENDER	varchar [20]	Telefonní číslo odesilatele
RECEIVED	datetime	Čas přijetí zprávy
MESSAGE	varchar [1600]	Text zprávy
LINE	varchar [50]	Linka ze které zpráva došla
OPERATOR	varchar [50]	Jméno operátora
BINAR	varchar [1]	Příznak binární zprávy	1=ano, 0=ne
PDU	varchar [4000]	PDU formát zprávy, pokud je dostupný
SMS_ID	bigint	MX identifikátor zprávy
FROM_USERNAME	nvarchar [100]	Jméno odesilatele
TO_NUMBER	varchar [17]	Na jakém čísle byla zpráva přijata
TO_USERNAME	nvarchar [100]	Jméno příjemce
REF_SMS_ID	bigint	SMS ID zprávy, na kterou je tato příchozí zpráva odpovědí
TIME_RECEIVED_MX	datetime	Čas přijetí SMS nebo události dle MX. Zdrojem času je MX.
TIME_RECEIVED_SMSC	datetime	Čas odeslání SMS z mobilu do SMSC dle SMSC.

SMSOUT
	TYPE	POPIS	POZNÁMKA
ID	automatické číslo	ID řádku, primary key
RECIPIENT	varchar [20]	[U]Telefonní číslo příjemce (POVINNÝ ÚDAJ)
MESSAGE	varchar [760]	[U]Text zprávy (POVINNÝ ÚDAJ)
Subject	varchar [25]	[U]Subject zprávy
Line	varchar [15]	[U]Určuje konkrétní linku přes kterou má být zpráva odeslána	Linka musí být odesilateli povolena.
nomodify	varchar [1]	[U]Nemodifikovat zprávu	1=nemodifikovat, 0=možno upravit
replyrequired	varchar [1]	[U]Vyžadovat pro tuto zprávu DR	1=ano, 0=ne
schedule	datetime	[U]požadovaný čas odeslání zprávy
Priority	varchar [1]	[U]Priorita předávané zprávy	l=nízká, n=normální, h=vysoká
User_ID	varchar [25]	[U]ID pro spárování v libovolném systému, index
DELIVERED	datetime	[MX]čas doručení poslední infozprávy
LAST_NOTIFICATION	varchar [20]	[MX]poslední info zpráva	Typ zprávy, např.: ""sent_ok"", ""sent_ok_dr"" ... Kompletní seznam viz sloupec ''Šablona'' v popisu tabulky MX_SMS_SEND_STATUS
Line_send	varchanr [15]	[MX]Linka přes kterou byla sms reálně odeslána	Vyplní MX po odeslání.
PUT_MX	datetime	[MX]čas doručení do MX	Vyplní MX po odeslání.
Cost	numeric(16,2)	[MX]cena za odeslání sms	Vyplní MX po odeslání.
operator	varchar [20]	[MX]Jmeno GSM operátora	Vyplní MX po odeslání.
num	smallint	[MX]počet sms na které byla zpráva rozdělena	Vyplní MX po odeslání.
Send	datetime	[MX]čas odeslání zprávy	čas v unix formátu ( počet sekund od 1.1.1970 )
SENTFLAG	varchar [1]	[MX][U] předávací informace, index	N = zpráva ještě nebyla odeslána. Po nalezení změní MX na Y = zprávu již zpracovávám.
FROM_SMTP	varchar [255]	[U]email od koho je zpráva - toto je identifikátor uživatele (sloupec EMAIL v pohledu MXUSER)
LANG	varchar [2]	[U]v současnosti nemá využití
FROM_NUMBER	varchar [15]	[U]položka v MX označovaná jako system from number. Umožňuje nastavit co uvidí příjemce sms v parametru "od"
FROM_EMAIL	varchar [255]	[U]v současnosti nemá využití
FROM_NAME	varchar [50]	[U]tuto položku použije MX při zakládání uživatele pro sloupec I_DISPLAY_NAME v pohledu MXUSER
SEND_NOTIFY	varchar [1]	[U]povoluje, zda má být aplkaci doručena zpráva o odeslání sms, ve výchozím nastavení je "ANO"
PRIORITYNUM	Integer	[MX]Priorita předávané zprávy konvertovaná ze sloupce PRIORITY na číselné vyjádření	Vyplní se samo triggerem po vložení záznamu do tabulky, nabývá hodnoty 1..Low, 4..Normal, 16..High
SMS_ID	bigint	[MX]MX ID DR/NDR	Vyplní MX po odeslání.
MAIL_IN_SMS_ID	bigint	[MX]MX ID odchozí zprávy	Vyplní MX po odeslání.
SMS_SEND_ATTEMPT_ID	bigint	[MX]MX ID pokusu o odeslání	Vyplní MX po odeslání.

LEGENDA
	[U]Vyplní odesílající strana
TEXT	[U]Vyplní odesílající strana ( povinné údaje )
	[MX]Vyplní MX průběžně

Tyto tabuky lze založit pomocí připravených scriptů, které se nacházejí v témže umístění.

Skripty pro databáze Oracle (oracle.sql) a Microsoft SQL Server (mssql.sql), nebo lze využít přímo Microsoft Access databáze (dbconnector.mdb).

Poznámka: Velikost polí SUBJECT a MESSAGE v tabulce SMSOUT lze podle vašich potřeb změnit.

Po dosažení koncového stavu v poli "Last_Notification" dle koncových stavů "SMS_SEND_STATUS" musí být řádek v tabulce odstraněn odesilatelem.

Po přečtení příchozí zprávy musí být tato odstraněna aplikací která tuto došlou zprávu vyčítá.

V případě instalace na MS SQL nebo ORACLE databázi je třeba po instalaci výše uvedených skriptů spustit i delta scripty (mssql_delta_nnnn.sql, oracle_delta_nnnn.sql), které obsahují aktualizace databázových tabulek. A to v pořadí, které určuje číslo "nnnn".

Význam jednotlivých polí je rovněž uveden v dokumentu StrukturaDB_send.xls.

•Pole označená [U] vyplňuje uživatel (většina z nich není povinná, slouží pro upřesnění způsobu odeslání).

•Pole označená [MX] vyplňuje MobilChange v průběhu odesílání.

Odesílání SMS se provádí přidáním řádku do tabulky SMSOUT, přičemž je nutné vyplnit položky RECIPIENT a MESSAGE. Položka SENTFLAG musí byt nastavena na hodnotu "N".

Text samotné SMS vzniká složením položek SUBJECT a MESSAGE.

Popis nasazení