perl-Convert-Addressbook-Mozilla2Blackberry

Perl extension for converting a CSV comma delimited addressbook from Moz[cut]

This is a module that builds on the Mozilla::Mork module to translate the Mozilla address book to a CSV format suitable for importing into a Blackberry via the Desktop Manager (i.e. even the CSv fields are in the correct order). Assumptions 1. the calling routine knows the correct format to send it in. 2. the 'right format' is a hash containing a set of records to convert as produced by Mozilla::Mork 3. this is not a full file conversion - some fields are missing, if there is no corresponding field, also, some fields are created from, or imported from others 4. You want to print the results so you can capture the output to a file of of your choice. Caveats It turns out that the import engine that comes with the Blackberry Desktop (I tested with version 4.0) will happily import duplicates, even if you tell it not to; so I suggest this for a bulk load only, rather than multiple import runs. For a ongoing conversion I suggest using the Sync with Outlool/Outlook Express and using Dawn (See Also, below) to manage the combining and conversion. I might write a conversion routine, but so far I've shaved my particular yak. Also, the correct place for this code, if I am being honest is an addtion to the Mail::Addressbook::Convert suite. However, my time to work on this is limited and by releasing in this way I can get it 'out there' for others to use. If someone wants to incorporate it in athe abobe namespace, good for them. I plan to, but no idea when I'll actually get round to it.. Routines *new()* create the new() OO Object. Don't mind the man behind the curtain.. *PrintBlackberryHeaders()* print the blackberry field headers - iterate over ever instance and print it, basically. *ReturnBlackberryHeaders()* return a list of the Header fields that Blackberry uses in its .CSV import file *StreamConvert()* Convert each record passed, from each line in an array expects a hash reference which contains a set of data to convert This only converts one set of records at a time, to convert the entire file, you must call it repeatedly. Returns a single scalar containing the CSV record set of the converted record, along with printing the record to STDOUT. #TODO seperate the printing and returning routines Formats not that its needed here, but the Mozilla 'export' file format is: First,Last,Display,Nickname,email,screen name,Work Phone,home phone,fax pager,mobile Blackberry import format is reachable with ReturnBlackberryHeaders(), above.