Mobilchange news Obsah dokumentace Uživatelská dokumentace Administrátorská dokumentace Rejstřík pojmů Technická podpora Hledání on-line
fxLdapSync - synchronizace FX/MX uživatelů proti LDAP

Účel a funkce aplikace

FXLDAPsync je aplikace synchronizující uživatelskou databázi FaxChange/MobilChange s LDAP serverem (tj. uživatelé musí být uloženi v databázi, ne v Active Directory; uživatelé MobilChange mohou být i v registry).

Do databáze serveru FaxChange (MobilChange) přistupuje přes existující rozhraní fxODBC (ADO), musí být tedy nainstalována na stejném serveru, kde je spuštěn FaxChange (MobilChange). Pro instalaci stačí zkopírovat obsah adresáře support\FaxChange\FxLDAPsync na UMS CD na disk serveru.
Aplikace zjišťuje dle zadaného filtru seznam uživatelů na straně LDAP a podle nich zakládá, konfiguruje nebo maže uživatele v databázi FaxChange (MobilChange). O své činnosti může zapisovat zprávy do umsMonitoru (je nutné vložit do registru soubor umsmonitor.reg z instalačního adresáře) a odesílá výsledky mailem na zvolenou adresu.

Aplikaci lze spouštět ručně nebo v pravidelných intervalech libovolným task schedulerem, např. jako úlohu umsTaskManageru.

zpět na začátek

Konfigurace aplikace

Konfigurace aplikace je uložena v registry v klíči [HKLM/Software/datasys/faxchange/fxldapsync].

Popis jednotlivých hodnot:

Příklad nastavení v registrech pro LDAP server typu MS Active directory je v souboru fxLdapSync.reg v instalačním adresáři.

Command line parametry: 

fxLdapSync [volby]
volby: /<appname>      typ aplikace (FX nebo MX). Pokud nezadáno, bere se FX
       /w              dotáže se na heslo root_DN
       /d<path>        cesta k log souboru. Platí jen pokud parametr "logpath" v registry již není
       /r<path>        název alternativní konfigurace. Ta musí být uložena jako subklíč pod HKLM/Software/datasys/faxchange/fxldapsync.
       /h              help
Alternativní konfigurace se hodí pro oddělené nastavení synchronizace pro FaxChange a MobilChange, případně při synchronizaci proti více LDAP serverům s různým nastavením.
Nástroj umí synchronizovat i distribuční skupiny a veřejné složky (pouze viditelné v adresáři) - nastavení ldap_filter ze souboru fxLdapSync.reg to umožňuje. Je ale nutno přidat kontejner "Microsoft Exchange System Objects" v Active Directory do prohledávaných větví.

zpět na začátek

Popis logiky synchronizace pro FaxChange

Společná část

  1. Aplikace načte do paměti všechny uživatele z FX databáze, kteří mají bit 2 v poli fControl = 0 (tj. ne FX skupiny).
  2. Aplikace načte do paměti všechny uživatele ze všech v konfiguraci odkazovaných LDAP stromů.
Může se stát, že některé položky (např. FAXFLG) v LDAPu nebudou. V takovém případě aplikace převezme z konfigurace defaultní hodnotu a použije ji, jako by byla v LDAPu.
V režimu "Český Telecom" je další zpracování specifické pro tuto firmu a není dále popsáno. Běžně se používá dále popsaný "normální" režim.

"Normální" režim

U každého uživatele v FX databázi načte jeho pole FreeText a rozparsuje ho. Zajímají nás položky: Pro všechny záznamy, které mají vyplněný fEmail a nemají NoSync=1: Následně projde všechny načtené LDAP záznamy, které nebyly označené jako zasynchronizované (nesmazané). To jsou záznamy, které jsou v LDAP ale nejsou v FX db. Pro každý z nich:

Mapování položek v LDAP na položky v FX db

Jména hledaných položek v LDAP se musí brát z konfigurace, tj. změní-li se jméno položky FAXNUM na FAX_NUMBER, stačí změnit tuto informaci v konfiguraci!
Jméno v LDAP Jméno v tUser Poznámka
FAXNUM
(string, <30 znaků)		 Nemá přímý ekvivalent, ale výše popsaným algoritmem se z něj generuje položka v PABX databázi a položka AutoPABX ve FreeText jedinečné faxové číslo, které slouží pro příjem faxů
FAXCSH
(string, <30 znaků)		 fCover jméno coversheet stránky pro daného uživatele
FAXGRP
(string, <30 znaků)		 fGroup definuje uživatelskou skupinu, ke které uživatel patří a jejíž standardní nastavení bude aplikováno pro tohoto uživatele u nastavení atributů pro FaxChange, které nejsou explicitně pro tohoto uživatele specifikovány
FAXFLG
(string, <30 znaků)		 fFlags, fControl, fLng – viz další tabulka obsahuje nastavení atributů: práva k faxování a jazyk; struktura popsána v další tabulce
INTERNET-ADDR fEmail SMTP adresa
COSTCODE fCostCode Kód nákladového střediska
COMMON-NAME fName Jméno uživatele

Struktura položky FAXFLG

Jedná se o textové pole, kde každý znak specifikuje nějakou část nastavení FX.
Znak Význam Hodnoty Mapování do FX
1 nastavení práv k posílání mezinárodních faxů y (ano), n (ne), d (standardní nastavení podle skupinových práv) fFlags znak 1, hodnoty Y/N/D
2 nastavení práv k posílání faxů mimo ÚTO y (ano), n (ne), d (standardní nastavení podle skupinových práv) fFlags znak 2, hodnoty Y/N/D
3 nastavení práv k posílání faxů mimo lokální ústřednu y (ano), n (ne), d (standardní nastavení podle skupinových práv) fFlags znak 3, hodnoty Y/N/D
4 nastavení práv k posílání faxů v rámci ústředny y (ano), n (ne), d (standardní nastavení podle skupinových práv) fFlags znak 4, hodnoty Y/N/D
5 nastavení práv k posílání faxů s nízkou prioritou y (ano), n (ne), d (standardní nastavení podle skupinových práv) fFlags znak 5, hodnoty Y/N/D
6 nastavení práv k posílání faxů s normální prioritou y (ano), n (ne), d (standardní nastavení podle skupinových práv) fFlags znak 6, hodnoty Y/N/D
7 nastavení práv k posílání faxů s vysokou prioritou y (ano), n (ne), d (standardní nastavení podle skupinových práv) fFlags znak 7, hodnoty Y/N/D
8 nastavení práv k plánování odeslaných faxů y (ano), n (ne), d (standardní nastavení podle skupinových práv) fFlags znak 8, hodnoty Y/N/D
9 nastavení práv k posílání faxů 0 (ano, standardní uživatel), 1 (ne, faxování zakázáno) fControl bit 0: 0 = povoleno, 1 = zakázáno
10 nastavení jazyka pro komunikaci 0 (CZ), 1 (UK), 2 (SK) fLng = "CZ", "UK" nebo "SK"

zpět na začátek

Popis logiky synchronizace pro MobilChange

Společná část

  1. Aplikace načte do paměti všechny mail uživatele z MX databáze (account_type=1), kteří mají user_source=2,3 nebo 4
  2. Aplikace načte do paměti všechny uživatele ze všech v konfiguraci odkazovaných LDAP stromů.
Může se stát, že některé položky v LDAPu nebudou. V takovém případě aplikace převezme z konfigurace defaultní hodnotu a použije ji, jako by byla v LDAPu.
V režimu "Český Telecom" je další zpracování specifické pro tuto firmu a není dále popsáno. Běžně se používá dále popsaný "normální" režim.

"Normální" režim

Pro všechny záznamy, které mají vyplněný i_user_id a mají x_email_rucne=0: Pokud i_user_id je prázdné (null), nastaví x_email_rucne=1.
Následně projde všechny načtené LDAP záznamy, které nebyly označené jako zasynchronizované (nesmazané). To jsou záznamy, které jsou v LDAP ale nejsou v MX db. Pro každý z nich:

zpět na začátek