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

FaxChange API

V adresáři /faxchange/fxapi/ instalačního CD se nachází FaxChange API. FaxChange API Vám umožňuje:


Odesílání faxu z příkazové řádky

V adresáři "outmail/" je k dispozici program OutMail (v adresáři outmail/ je zdrojový kód, v outmail/bin/ pak zkompilovaný program).

Program OutMail Vám umožňuje odesílat z příkazové řádky fax (nebo libovolnou jinou e-mail zprávu). Umí odeslat fax obsahující pouze text nebo fax s přílohami.

Program OutMail se spouští s jedním parametrem -- jménem souboru typu INI, obsahujícího všechny potřebné informace (jméno profilu, adresáta faxu, subjekt, text a jména příloh). Ukázku INI souboru naleznete v adresáři outmail/bin/ .

Tip: pokud mají faxy opravdu odcházet, u uživatele, jehož profil je používán, je třeba vypnout posílání náhledu.

zpět na začátek


Odesílání faxů přímo z Vaší aplikace

Pro odeslání faxu z Vaší aplikace můžete zvolit několik cest. Spustit program OutMail (popsán v předchozím bodě), použít přímo služeb MAPI (popsáno v dokumentaci MAPI SDK (Platform SDK, MS Exchange SDK, BackOffice SDK)), nebo využít služeb knihovny BrMsg.

Knihovna BrMsg je uložena v adresáři brmsg/. Umožňuje jednoduchým způsobem odeslat e-mail zprávu -- například fax. Popis použití naleznete v souboru brmsg.h.

zpět na začátek


Rozšiřující DLL knihovny

Do Faxchange je možno přidat dva typy rozšiřujících knihoven:

Oba tyto typy knihoven se aktivují jejich nahrátím do adresáře FaxChange/Bin/fxSrvr-PlugIns/. Každá knihovna obsahuje funkci, pomocí které informuje faxserver, jakou z činností (archivace / log) vykonává.

Přesný popis rozhraní spolu s ukázkovými zdrojovými kódy je v odpovídajících adresářích server_custom_dll/.../.

zpět na začátek


Tip: jak generovat faxovou adresu

Pokud budete posílat fax ze své aplikace, možná Vám pomohou následujcí rady, jak vytvořit korektní faxovou adresu.

Pokud posíláte pomocí MAPI, pak vězte, že typ adresy musí být "FAX". Jako adresa pak stačí faxové číslo. Pokud k němu chcete dodat další informace tak, jak je možno je zadat v adresovém templatu FAX, výsledný formát adresy je:

<faxové číslo>#3A17 <titul>#3A16 <firma>#3A18 <oddělení>#39FF <jméno adresáta>
kde # je znak 0x05 .

Další možnost generování faxové adresy je v řádce "To:" Exchange klienta / Outlooku: je možno použít formát

<jméno>[fax:<číslo>]

zpět na začátek


Tip: jak odesílat faxy přímo z MS DOS aplikací

Častým problémem je nutnost odesílat faxy z MS DOS aplikací (např. databázové aplikace pod FoxPro) nebo z aplikací, ke kterým nelze z libovolného důvodu přilinkovat MAPI knihovny.

Nejjednodušším řešením této situace je následující:

Faxující aplikace neodesílá faxy do MS Exchange, nýbrž je ukládá jako soubory do nějakého adresáře.

Souběžně s hlavní aplikací se spustí aplikace odesílací která pouze v pravidelných intervalech prohledává sdílený adresář a nalezené faxy odešle (např. pomocí BrMsg knihovny).
Pro uvedený případ je k dispozici program "mailrobot", který můžete najít v adresáři /faxchange/fxapi/mailrobot instalačního CD.

zpět na začátek