DreamCom Server - odesílání pomocí databáze

Odesílání pomocí databáze

DreamCom Server je postaven na oblíbeném OpenSource SQL databázovém systému Firebird.

Některé programy umějí přistupovat k Firebirdu přímo (např. Borland Delphi, ci C++ Builder, i php má přímou podporu InterBase!) jindy je potřeba použít ODBC driver.
ODBC driver pro Firebird je k dispozici volně ke stažení například zde. Přes ODBC se tak snadno napojíte k tabulkám z libovolného databázového programu (Access, FoxPro, Oracle...)

SMS zprávu odešlete nejjednoduším způsobem pomocí SQL příkazu takto:
INSERT INTO QUEUE (PHONE, MSG) VALUES ('+420604106026', 'Text SMS zprávy')
Pozn. Jméno a heslo pro připojení k databázi je jmeno: sysdba a heslo:masterkey. Pokud vám toto jméno nevyhovujte vyplňte jiné v souboru db.ini

Struktura tabulky QUEUE (Fronta):

Název	Typ
ID	INTEGER Not Null
PHONE	VARCHAR (20)
NAME	VARCHAR (50)
EMAIL	VARCHAR (50)
SMSEMAIL	VARCHAR (50)
MODE	VARCHAR (20)
MSG	VARCHAR (10000) Not Null
CONFIRM	SMALLINT
FLASH	SMALLINT
IDENT	SMALLINT
SENDTIME	TIMESTAMP
SCRIPT	VARCHAR (200)
FROM_NAME	VARCHAR (50)
FROM_CELLPHONE	VARCHAR (20)
FROM_EMAIL	VARCHAR (50)
SUBJECT	VARCHAR (50)
REPEAT	INTEGER

ID, identifikátor záznamu, není potřeba vyplnit - je automaticky doplněn pri vkládání nového záznamu
PHONE, telefonní číslo v mezinárodním formátu (+420603123456), nebo národním formátu (603123456).
NAME označuje jméno adresáta (pokud je toto jméno v adresáři není nutné vyplňovat phone)
EMAIL je email adresáta
SMSEMAIL je smsemail adresáta, nepoužívá se
MODE, nepoužívá se
MSG, text zprávy libovolné délky, pokud je zpráva delší než dovoluje brána, je automaticky rozdělena a odeslána naněkolikrát
CONFIRM, 0 nebo 1, pokud nastavíte 1 přijde Vám doručenka na email From_Email (podporují jen některé skripty)
FLASH, 0 nebo 1, pokud nastavíte 1 SMS zpráva bude doručena jen na displej telefonu (podporují jen některé skripty)
IDENT, 0 nebo 1, pokud nastavíte 1, bude přidána do SMS zprávy vaše identifikace, (podporují jen některé skripty)
SENDTIME, čas odeslání zprávy, pokud nevyplníte zpráva bude odeslána ihned
SCRIPT, tedy brána přes kterou se SMS zpráva odesílá. Pokud ho nevyplníte, vybere se automaticky podle nastavení operátorů (v adminu ALT+O). Pokud chcete odesílat přes mobilní telefon nastavte GSM, pokud chcete poslat email nastavte SMTP.
FROM_NAME, určuje jméno odesílatele, pokud není vyplněno použije se z nastavení programu
FROM_CELLPHONE, určuje mobilní číslo odesílatele, pokud není vyplněno použije se z nastavení programu
FROM_EMAIL, určuje email odesílatele, pokud není vyplněno použije se z nastavení programu
SUBJECT, použijete jen v případe, že odesíláte email, jedná se o jeho předmět
REPEAT, určuje počet pokusů pro odeslání zprávy, pokud nevyplníte použije se hodnota z nastavení programu. Pokud se zprávu nepodaří odeslat ani na poslední pokus je přesunuta z fronty do historie a označena jako chybová.

Struktura tabulky History je obdobná jen jsou přidány sloupce:

SENTTIME	TIMESTAMP
ERROR	SMALLINT
ID_QUEUE	INTEGER
MR	SMALLINT
DELIVERED	TIMESTAMP

SENTTIME čas skutečného odeslání zprávy
ERROR, pokud je 1 došlo k nějaké chybě a zpráva nebyla odeslána
ID_QUEUE, je ID záznamu z tabulky Fronta
MR je identifikátor zprávy, pokud byla odesílána přes GSM
DELIVERED je datum doručení zprávy (pokud byla odesílána přes GSM)

Tabulka SCRIPT slouží na doplnění parametrů, lze nastavit přímo v programu Nastavení/Skripty.
Tabulky CONTACTS a GROUPS obsahují kontakty rotříděné do skupin. Naplnění provedete přes Admina (globální kontakty) nebo přes klienta SE (individuální kontakty)
Tabulka INBOX obsahuje přijaté zprávy (přes mobilní telefon)
Tabulky OPERATORS A PREFIXES jsou používány pro přiřazení skriptů jednotlivým prefixům čísla (Admin ALT+O)
Tabulka USERS obsahuje jména a hesla pro přihlášování uživatelů z klientů SE

Příklad na odeslání emailu:
INSERT INTO QUEUE (EMAIL, SUBJECT, MSG) VALUES('server@dreamcom.cz', 'status', 'šlape to výborně')

Na další příklady se podívejte na příklady do adresáře Demos, jak odesílat SMSky přidáním záznamu, příklady jsou pro php a delphi.

Pokud Vás zajímají podrobnější informace o InterBase/FireBird doporučujeme navštívit www.ibphoenix.com, zde najdete veškerou dokumentaci, poslední verzi ke stažení, různé užitečné nástroje, například na administraci databáze.