Re: address book format

On Fri, 13 May 2005 14:17:21 -0400 (Eastern Daylight Time) Alan G Isaac <[email protected]> wrote:

AGI> I'm sure I'm overlooking it somehow but I did not
AGI> find simple documentation of the address book (.adr)
AGI> format.  I.e., what does each field represent,
AGI> and what strings are permissible.
AGI> 
AGI> Can you please point me to a doc?

 Unfortunately there is no real doc for it, the best I can propose is this
extract from src/adb/ProvFC.cpp:

/*
  This module works with files in wxFileConfig format. The file structure is
  as following:

  [ADB_Header]
  # it's the name which is shown in the tree
  Name = Psion Address Book
  Description = The ADB imported from Psion

  # groups are supported as in wxFileconfig
  [ADB_Entries/Friends/Old]
  # format is 'alias = colon delimited list of fields'
  # colon itself should be escaped with backslash ('\') if it appears inside
  # a field. Trailing colons can be omitted if all the trailing fields are
  # empty. Multiple e-mail addresses are comma-delimited, if a comma appears
  # inside an address, it should be also escaped with a backslash. Of course,
  # backslash itself should be escaped as well (in fact, it escapes any
  # character, not just ',' and ':')
  Mike = Full Name:First Name:Family Name:Prefix:Title:Organization:...
*/

 The fields are defined in include/adb/AdbEntry.h:

enum AdbField
{
  AdbField_NamePageFirst,                     // NB: must be 0!
  AdbField_NickName = AdbField_NamePageFirst, // NB: and this one also
  AdbField_FullName,                          //
  AdbField_FirstName,                         //
  AdbField_FamilyName,                        //
  AdbField_Prefix,                            // M., Mme, ...
  AdbField_Title,                             //
  AdbField_Organization,                      //
  AdbField_Birthday,                          // date
  AdbField_Comments,                          // arbitrary (multi line) text
  AdbField_NamePageLast,                      //

  AdbField_EMailPageFirst = AdbField_NamePageLast,
  AdbField_EMail = AdbField_EMailPageFirst,   // main e-mail address
  AdbField_HomePage,                          // WWW
  AdbField_ICQ,                               // ICQ number
  AdbField_PrefersHTML,                       // if not, send text only
  AdbField_OtherEMails,                       // additional e-mail addresses
  AdbField_EMailPageLast,

  // 2 copies of address fields: for home (_H_) and for the office (_O_)
  AdbField_H_AddrPageFirst = AdbField_EMailPageLast,
  AdbField_H_StreetNo = AdbField_H_AddrPageFirst,
  AdbField_H_Street,
  AdbField_H_Locality,
  AdbField_H_City,
  AdbField_H_Postcode,
  AdbField_H_Country,
  AdbField_H_POBox,
  AdbField_H_Phone,
  AdbField_H_Fax,
  AdbField_H_AddrPageLast,

  AdbField_O_AddrPageFirst = AdbField_H_AddrPageLast,
  AdbField_O_StreetNo = AdbField_O_AddrPageFirst,
  AdbField_O_Street,
  AdbField_O_Locality,
  AdbField_O_City,
  AdbField_O_Postcode,
  AdbField_O_Country,
  AdbField_O_POBox,
  AdbField_O_Phone,
  AdbField_O_Fax,
  AdbField_O_AddrPageLast,

  // priority for expansion
  AdbField_ExpandPriority,

  AdbField_Max
};

 Regards,
VZ



-------------------------------------------------------
This SF.Net email is sponsored by Oracle Space Sweepstakes
Want to be the first software developer in space?
Enter now for the Oracle Space Sweepstakes!
http://ads.osdn.com/?ad_id=7393&alloc_id=16281&op=click