Odeslání faxu z e-mailu
Přijmutí faxu
Hlavičky a patičky
Doplňování informací o odesílateli/příjemci do hlaviček odesílaných faxů
Doplňování informací o odesílateli/příjemci příchozích faxů
Substituční proměnné použitelné v templatech odchozích e-mailů
Směrování příchozích faxů podle CSID odesilatele
Odeslání faxu z e-mailu
1. | Uživatel odešle svým e-mailovým klientem e-mail na adresu <faxové číslo>@fax.fax (např. 225308110@fax.fax), případně na adresu [fax:225308110]. |
2. | Poštovní server je nakonfigurován tak, aby takto adresované e-maily směroval na SmtpReceiver, což je speciální SMTP server, který je součástí UMS (běží jako úloha Task Manageru). SmtpReceiver e-mail uloží do adresáře %Ums%/FaxChange/Mail/In ve tvaru CTL souboru, který obsahuje informace o zprávě a souboru s vlastním textem zprávy, na který se CTL soubor odkazuje. |
3. | CtlCheck do CTL souboru doplní informace o odesílateli a příjemci (zdrojem informací je ContactSearch) a soubor přejmenuje na CTL2. |
4. | FaxChange Server zprávu předá FX Convertoru (běží jako služba Windows). To provede přesunutím CTL souboru a souboru s textem zprávy z adresáře %Fx%\mail\IN do %Fx%\convert\IN. V rámci tohoto kroku FaxChange Server vyrenderuje do adresáře %Fx%\convert\OUT coversheety faxu do souborů X.tif (odpovídá hlavičce faxu X.cvs), X.tif.FF (odpovídá patce 1. coversheetu X.cvs.FirstFooter.cvs), X.tif.NH (odpovídá hlavičce zprávy X.cvs.NextHeader.cvs) a X.tif.NF (odpovídá patce zprávy X.cvs.NextFooter.cvs), kde X je jméno coversheetu. |
5. | FaxChange Master Convertor rozhodne o tom, který podřízený konvertor bude zprávu konvertovat. CTL soubor a soubor s textem zkopíruje z %Fx%\convert\IN do vstupního adresáře podřízeného konvertoru. Koncovku CTL souboru v %Fx%\convert\IN přejmenuje na "ctl_waiting". |
6. | Podřízený konvertor zkonvertuje text zprávy do TIFF souboru, který uloží do svého výstupního adresáře. |
7. | FaxChange Master Convertor přesune zkonvertovaný TIFF soubor do adresáře %Fx%\convert\OUT k již vyrenderovaným coversheetům. |
8. | FaxChange Server znovu vyrenderuje coversheety s již korektním počtem stránek. Do %Fx%\fax\OUT přesune zkonvertované TIFF soubory s přilinkovanými coversheet patičkami. Do %Fx%\fxsrvr\preview umístí CTL soubor a do %Fx%\mail\OUT CTL, TXT a TIFF soubor (už kompletně slinkovaný se všemi coversheet TIFFy) kvůli odeslání náhledu k potvrzení. |
9. | SmtpSender CTL, TXT a TIFF soubory vyjme z %Fx%\mail\OUT a odešle náhledy k potvrzení přes SMTP protokol poštovnímu serveru k odeslání původnímu autorovi faxu. Uživatel povolí nebo odmítne odeslání faxu jednou z následujících možností: |
• | Odpoví na přijatý e-mail (v Outlook 2007 je potřeba přidat v předmětu, bez mazání předešlého, CTL=YES z důvodů nefunkčních tlačítek, která však fungují s nahráním balíčku OutlookForms). |
1. | SmtpReceiver přijme odpověď a uloží ji do %Ums%/FaxChange/Mail/In. |
2. | FaxChange Server na základě předmětu zprávy, ve které je ID faxu rozpozná, že jde o potvrzení odeslání daného e-mailu. |
• | Stisknutím příslušného tlačítka v Outlook formuláři. |
1. | Formulář pošle HTTP požadavek na HTTP službu, která je implementována v SmtpSender. SmtpSender vytvoří v %Ums%/FaxChange/Mail/In CTL soubor s fiktivní odpovědí uživatele (stejná, jako v předchozím případě). |
10. | FaxChange Server přesune CTL soubor z %Fx%\fxsrvr\preview do %Fx%\fax\out. |
11. | Ovladače linky vybírají faxy z %Fx%\fax\out a snaží se je odeslat. O výsledku informují přejmenováním koncovky CTL souboru. |
12. | FaxChange Server sleduje faxy odložené na další pokus a pokud již nastane vhodný čas, přejmenuje soubor zpět na CTL. |
13. | FaxChange sleduje faxy s ukončeným zpracováním a ty úspěšně odeslané přesouvá je do archivu a neúspěšně odeslané posílá zpět autorovi s dotazem na opakování pokusů o odeslání. |
|
Uživatelský pohled na proces odeslání faxu z e-mail klienta |
Přijmutí faxu
1. | Ovladač linky přijme fax a předá ho FaxChange Serveru. |
2. | FaxChange Server rozhodne o adresátovi a pošle mu fax e-mailem. |
Hlavičky a patičky
Při odesílání faxu může FaxChange před obsah zprávy rozšířit o hlavičku a patičku.
1. | Jednotlivé konvertory zkonvertují dokumenty do FaxChange\convert\OUT\*.tiff. |
2. | V rámci dalšího zpracování je FaxChange Server před slinkováním s hlavičkou a patičkou ořeže (tím také nebude třeba upravovat všechny konvertory). |
3. | Vlastní slinkování provádí FaxChange Server zavoláním programu FaxChange\bin\tifflink.exe. Tento program se upraví přidáním nového parametru -trim, který způsobí, že do výsledného souboru se slinkují jednotlivé soubory s ořezanou poslední stránkou. |
4. | FaxChange se upraví, aby při slinkování zprávy s attachmenty (fce link_msg_with_attachs) volal tifflink.exe s parametrem -trim. |
Doplňování informací o odesílateli/příjemci do hlaviček odesílaných faxů
• | FaxChange Server musí mít konfigurační položku ctl2_extension nastavenou na hodnotu 1, aby odchozí faxy ke zpracování očekával v mail/in s příponou .ctl2. |
• | CtlCheck prohledává adresář mail/in a hledá soubory s příponou .ctl. Pokud takový soubor najde, zpracuje ho následujícím způsobem: |
o | Načte položku email sekce from obsahující e-mailovou adresu odesílatele odchozího faxu a dohledá pro ní kontakt přes UMS Contact Search - v případě úspěchu uloží informace z nalezeného kontaktu do položek v sekci user. |
o | Načte položku number sekce to obsahující faxové číslo příjemce faxu (případný prefix "i" odstraní) a dohledá pro něj kontakt přes UMS Contact Search - v případě úspěchu uloží informace z nalezeného kontaktu do položek se stejným názvem v sekci user jako v případě odesílatele faxu akorát s prefixem "RCV_". |
o | Pokud byl nalezen kontakt příjemce, doplní se informace také do sekce to (konkrétně položky name, title, company, dept, assist a assist_ph), čímž se informace o příjemci dostanou rovněž do doručenek (e-mailů o doručení/nedoručení faxu). |
o | Ukončí zpracování faxu - přejmenuje soubor na .ctl2. |
Doplňování informací o odesílateli/příjemci příchozích faxů
• | FaxChange Server musí mít konfigurační položku inbound_ctl2_extension nastavenou na hodnotu 1, aby příchozí faxy po zpracování uložil do mail/out s příponou .ctl2 (u všech zpráv s touto příponou odesílaných přes knihovnu fsApi. |
Poznámka: Od verze UMS 5.8 - jsou ukládány informace o substitucích do sekce subst řídícího souboru.
• | FaxChange Server dohledá faxovou adresu odesílatele příchozího faxu (položka email sekce from) takto: |
o | Najde-li CSID faxu v databázi CSID: jako faxovou adresu odesílatele faxu uloží položku tCSID.fNumber (= telefonní číslo odpovídající danému CSID, získané při odesílání faxu na dané CSID), v případě, kdy tato položka není vyplněna, se postupuje, jako když se CSID v databázi CSID nenajde. |
o | Nenajde-li CSID faxu v databázi CSID: je-li CSID neprázdný řetězec, uloží ho jako faxovou adresu odesílatele faxu, jinak uloží "FAX:-" . |
• | CtlCheck prohledává adresář mail/out a hledá soubory s příponou .ctl2, pokud takový soubor najde, zpracuje ho následujícím způsobem: |
o | Načte faxovou adresu odesílatele příchozího faxu (položku email sekce from), extrahuje z ní faxové číslo a dohledá pro něj kontakt přes UMS Contact Search - v případě úspěchu vytvoří seznam substitučních proměnných s prefixem "snd_" o odesílateli faxu a uloží jméno z kontaktu do položky username sekce from. |
o | Načte položku email sekce to obsahující e-mailovou adresu příjemce příchozího faxu a dohledá pro ní kontakt přes UMS Contact Search - v případě úspěchu vytvoří seznam substitučních proměnných s prefixem "rcv_" o příjemci faxu. |
o | Načte template pro předmět zprávy, provede substituci proměnných a výsledek uloží do položky subject sekce system. |
o | Načte template pro tělo zprávy, provede substituci proměnných a výsledek uloží do souboru zprávy, na nějž se odkazuje položka msg sekce system. |
o | Ukončí zpracování faxu - přejmenuje soubor na .ctl. |
Substituční proměnné použitelné v templatech odchozích e-mailů
Substituční proměnné mají prefix "snd_" u proměnných s informací o odesílateli e-mailu, "rcv_" u proměnných s informací o příjemci e-mailu a jsou v template ohraničeny znakem '%':
• | email = e-mail uživatele |
• | title, display_name, first_name, last_name = titul a jméno uživatele |
• | company, department = společnost a oddělení uživatele |
• | mobile, office, off_fax, off_ph_1, off_ph_2, home_ph_1, home_ph_2, pager = telefonní čísla uživatele |
• | assist_n, assist_p = jméno a tel. číslo asistenta |
• | street, postcode, city, country = adresa uživatele |
• | custom_1, custom_2, ... custom_10 = zákaznické vlastnosti |
• | usr1, usr2, usr3 = zákaznické vlastnosti |
V templates je navíc možné používat proměnné, které podporuje FaxCange Server (jejich hodnoty jsou uloženy v sekci subst, viz výše). Templates pro příslušný jazyk jsou uloženy v adresáři FaxChange\data\LANGUAGE\<language>.
Směrování příchozích faxů podle CSID odesílatele
Směrováním se myslí, že faxy přijaté z určitého CSID obdrží do emailu jeden daný uživatel.
1. | FaxChange driver uloží CSID, zjištěné při příjmu příchozího faxu, do CTL souboru příchozího faxu. |
2. | FaxChange Server při zpracování CTL souboru příchozího faxu zjistí, zda položka [from].CSID je neprázdná a zda je povoleno směrování podle CSID (použité metody směrování příchozího faxu a jejich pořadí je dáno konfigurační proměnnou HKLM\Software\Datasys\FaxChange\global\server\inbound). |
3. | V momentě, kdy na směrování podle CSID dojde řada, zjistí zda pro dané CSID existuje v tabulce tCSID záznam |
4. | Pokud záznam existuje, příchozí fax se odešle na uživatele s USERID ze záznamu. |