[cvs] [Wiki] changed: HermesAddressBook

[Michael Rubinsky]

mrubinsk  Sat, 29 Apr 2006 12:55:38 -0700

Modified page: https://dev.horde.org/horde/wicked/HermesAddressBook
New Revision:  1.4
Change log:  Update client address book howto with information about shared sources

@@ -40,5 +40,57 @@
 
 Permission your users to see/use this new database.
 
 Result? you should now have a nicely trimmed selection list.
+
++++ Alternatively, if you are using Turba 2.1 or higher and are using shared address books, you can do this:
+For this example, we are using shares on a source called localsql and want to create a shared, client address book called Our Clients.
+
++++ Step 1
+
+Create a new shared address book.  If you already have a shared address book created for you client list, skip to step 2.
+
+
+**1a.** Log in to Turba as the account that you want to be the owner of the shared address book.
+**1b.** Click on {{My Address Books}},  choose a name for the new address book (Our Clients in this example).
+**1c.** Choose the new address book (Our Clients) in the {{Edit Address Books}} section, and click on {{Edit Permissions}}.  Set permissions appropriate to your needs.
+
++++ Step 2
+
+While logged on as an administrator, go to {{Administration -> !DataTree}} and expand the {{horde.shares.turba}} branch.  Expand the branch for your shared source ( localsql in this example) and locate the entry for the address book we just created. 
+
+Now, the tricky part.  If you have a fairly large user base,  you will most likely have to browse through a good number of entries.  Most of the entries will be your user's default address books, these will be named after the user.  What you are looking for is an entry such as  {{82e8f032c1ab043b5efaa4fde50653d2}}.  These are user created address books.  In our example, the one we are looking for will have something like this when you expand it:
+<code>
+Array ( )
+ Array (
+    [0] => Array (
+        [name] => owner
+        [key] => 
+        [value] => mike
+     ) 
+    [1] => Array (
+        [name] => name
+        [key] =>
+        [value] => test
+     ) 
+    [2] => Array (
+        [name] => uid
+        [key] =>
+        [value] => 82e8f032c1ab043b5efaa4fde50653d2
+     ) 
+     .
+     .
+     .
+</code>
+
+Once you find the correct entry, copy down the uid (82e8f032c1ab043b5efaa4fde50653d2).
+
++++ Step 3
+
+Go to the {{Administration -> Setup -> Address Book (turba)}} and fill the following in to the Name of Client Addressbook field:
+
+{{localsql:82e8f032c1ab043b5efaa4fde50653d2}}
+
+That's the source name (localsql) followed by a colon, followed by the uid of the address book we want to use.
+
+Your shared client address book should now be visible in Hermes, without having to create an entirely seperate sql source.