Importing "config_CommonAddrBook.cgi" to Public Contact folders

If you used public contacts in a previous version of Ipswitch Web Messaging, the "config_CommonAddrBook.cgi" file is no longer functional with the new V12 and later web client. A command line utility has been created to allow the IMail Administrators to import and merge their "config_CommonAddrBook.cgi" files into Public Contacts folders using the IMail Collaboration database.

To successfully import and implement all your public contact "config_CommonAddrBook.cgi" files, the following steps are required:

Public Contact Folder Setup

  1. Public Contact folders must be created before running this import utility. Go to your Web Administration and select Collaboration > Public Folders. Click Add when the Public Folders dialog appears.
  2. Enter a unique name for each "config_CommonAddrBook.cgi" file. Keep in mind the name entered will be displayed within the Web Client under the user's Address Books as follows:

    Address Books

    Contacts

    Department Contacts [Public]

  3. Select "Contacts" from the Type drop down selection menu and click Save. This will bring up the Public Folder Properties dialog.
  4. At this point all users that are required to have access rights must be added at this point. Click Add.
  5. Be sure to leave the Access rights to "Read" only for your normal users. Be sure to click Save on every page.

    Note: The IMail Collaboration database does not currently recognize users on a per domain level, the IMail Administrator will need to manually select all users for each domain, separately for each Public Contacts folder.

  6. Next, add full permissions to Administrators to allow maintaining withing the Web Client. The new public contacts folder will now display for all user's with access rights in their Web Client Address Books navigation folder.

Running "PublicContactsCGI Importer.exe"

  1. The "PublicContactsCGI Importer.exe" is located under your "../IMail" directory. Double click to initiate the import process.
  2. The main dialog displays all available Public Folders (Calendars, Contacts, Notes and Tasks).
  3. Select (highlight) the Public Contact folder and use the "Browse" button to locate the matching "config_CommonAddrBook.cgi".
  4. Click "Import", upon completion a dialog "Import Complete" will return.

    Warning: There is no mechanism to avoid duplicate contact entries. Clicking "Import" again, will duplicate all entries.