From a9656842108b1cce75efdd1ee9fe85f7138f99bc Mon Sep 17 00:00:00 2001 From: Jonas Smedegaard Date: Mon, 9 Mar 2015 01:20:51 +0100 Subject: Rename (yet unused) topic address/addressbooks → contact. MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- doc/admin.md | 2 ++ doc/future.md | 26 +++++++++++++++++++++++ doc/setup.md | 67 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 95 insertions(+) create mode 100644 doc/admin.md create mode 100644 doc/future.md create mode 100644 doc/setup.md diff --git a/doc/admin.md b/doc/admin.md new file mode 100644 index 0000000..49eecca --- /dev/null +++ b/doc/admin.md @@ -0,0 +1,2 @@ +# Directory services maintainance commands + diff --git a/doc/future.md b/doc/future.md new file mode 100644 index 0000000..1c32879 --- /dev/null +++ b/doc/future.md @@ -0,0 +1,26 @@ +# Timeline of (planned and effectuated) events relate to central address handling + +## TODO + + * Public addressbook lookup through raw LDAP interface + * User-friendly access to public addressbook + * Integration with HORDE webmail framework + * Integration with Mozilla Thunderbird (documentation and possibly semi-automation) + * Web lookup page + * Wap lookup page + * SMS lookup routine + * Shared addressbooks for closed groups + * User-friendly access to shared addressbooks + * Integration with HORDE webmail framework + * Integration with Mozilla Thunderbird (documentation and possibly semi-automation) + * Web lookup page + * Wap lookup page + * SMS lookup routine + * Personal addressbooks (both discrete and public accessible) + * Semi-automated import (batch-adding) entries + * User-friendly access to adding and editing entries + * Integration with HORDE webmail framework + * Desktop apps (integration with system tools, use of generic tools, or design of custom tools) + * Web administration tool + * SMS add/overwrite routine + * Two-way syncronization with other personal (and shared?) directory databases diff --git a/doc/setup.md b/doc/setup.md new file mode 100644 index 0000000..86242a2 --- /dev/null +++ b/doc/setup.md @@ -0,0 +1,67 @@ +# Setting up and using central addresses + +## Looking up addresses + +### Web access + + * Public search page + + * Horde webmail + +### Desktop applications + + * Mozilla Thunderbird + +### Cell phone + + * SMS lookup + +## Adding and editing + +### Web access + + * Horde webmail + +### Desktop applications + + * Directory assistant (Linux, MacOS w/ X11) + +## Exchanging data + +### Importing addresses + +#### Well-structured address databases + +Some address book applications can export entries as an LDIF file. +This often means the data is well-structured and easy to feed into the central database. + +Import of LDIF files is supported from the following applications: + + * Mozilla Thunderbird + +If you use a different application and it can export LDIF files, then try if it works. +Tell us your experiences, so we can (maybe improve the import routines and) add it to this list. + +#### Other sources + +For applications that cannot export LDIF, first feed the data into an application that does, +and then import from there. + +Here's a possible recipe for a list of addresses stored in an Excel spreadsheet: + + 1. Remove noise (eg. non-tabular comments) + 2. Export as comma-separated file + * Use "Western european (ISO-8859-1)" as character codepage (not Unicode) + 3. Open Mozilla Thunderbird, and select "Import..." from the Tools menu + 4. Import addressbook, choose "Comma Separated" and open the exported data file + 5. Match Address Book fields with records to import + * Use "Display Name" as full name, if first and last name was not previously stored separately + * Use company fields for company info, if each previous record contained both company and contact person info + * Use custom fields for custom data (avoid reusing standard fields for new purposes!) + 6. Review the imported data now stored in a new Address Book + * Re-import if not satisfied: The field matching is remembered from last import + 7. Edit entries as needed + * Each personal entry *must* contain both first name and last name + * Each company-only entry must contain *no* personal data + +### Two-way syncronization -- cgit v1.2.3