Voir la source de Multi-LDAP Technical Documentation/fr

{{lang|Multi-LDAP Technical Documentation|Multi-LDAP Technical Documentation/fr}}
> [[Documentation/fr|Documentation]] > [[Multi-LDAP/fr|Module : Multi-LDAP]] > [[Multi-LDAP Technical Documentation/fr|Documentation technique]]


== Architecture ==

=== Présentation synthétique de l'architecture de l'extension ===
Cette fonctionnalité est développée sous la forme d'une extension Thunderbird.

* Auto-complétion des utilisateurs avec plusieurs serveurs LDAP
[[Image:multi_ldap_architecture_compose_autocomplete.jpg|Architecture]]

Cette fonctionnalité repose sur l'auto complétion standard de Thunderbird. 

Elle surcharge les fonctions '''setupLdapAutocompleteSession()''', '''AddDirectorySettingsObserver()''' et '''RemoveDirectorySettingsObserver()''' du fichier ''MsgComposeCommands.js''.

=== Les fichiers d'IHM ===

* Options globales

[[Image:multi_ldap_architecture_preferences_IHM_pg-fr.jpg|Liste des serveurs dans les préférences globales]]

* Préférences de comptes

[[Image:multi_ldap_architecture_preferences_IHM_pu-fr.jpg|Liste des serveurs dans les préférences de comptes]]

==== Configuration globale ====

* Le fichier ''preferencesOverlay.xul'' surcharge ''preferences.xul''. Il inclut le fichier ''composeLDAPOverlay.xul''. Il utilise la librairie ''composeLDAPOverlay.js''
* ''composeLDAPOverlay.js'' : récupère la liste des serveurs LDAP configurés. Il construit dynamiquement tous les items XML pour créer la liste des serveurs pour l'IHM. Cette liste est accessible dans les préférences globales, dans l’onglet composition.
* Propriété définissant l'activation de l'auto-complétion LDAP (booléen) : '''ldap_2.autoComplete.useDirectory'''
* Propriété définissant la liste des serveurs LDAP (chaîne de caractères) : '''ldap_2.autoComplete.directoryServers'''
[[Image:multi_ldap_architecture_preferences.jpg|Architecture de l'IHM]]

==== Préférences de compte ====

* L'architecture est la même que ci-dessus avec un niveau d'inclusion en moins (Pas de fichier ''preferencesOverlay.xul''). Le fichier ''am-addressingOverlay.xul'' surcharge ''am-addressingOverlay.xul''. Il utilise la librairie ''am-addressingOverlay.js''
* Propriété définissant la surcharge de l'activation de l'auto-complétion LDAP (booléen) : '''mail.identity.%IDENTITYKEY%.overrideGlobal_Pref.multi-ldap'''
* Propriété définissant la surcharge de la liste des serveurs LDAP (chaîne de caractères) : '''mail.identity.%IDENTITYKEY%.directoryServers'''

=== XPCOM ===
Cette extension s'appuie principalement sur des XPCOMs standards [http://www.xulplanet.com/references/xpcomref/ifaces/nsIAutoCompleteSession.html nsIAutoCompleteSession] et  [http://www.xulplanet.com/references/xpcomref/ifaces/nsILDAPAutoCompFormatter.html nsILDAPAutoCompFormatter] qui permettent de gérer l'auto-complétion depuis un serveur LDAP.