Help Top

Using DArcMailLite to Convert an Account from mbox to XML

The "Convert mbox Files to XML" screen asks for the following information:

XML file names

If you convert an entire email account, then the name of the XML file will be the name of the email account with the ".xml" file extension. If the email account name contains characters that are not permitted in a file name, then each occurrance of an illegal character will be replaced with an underscore. Characters that are replaced with an underscore include any character with a numeric value less than decimal 32 (' ') or greater than decimal 127 ('~'), as well as these characters:

/ ? < > \ : * | " ^
The XML file for an account will be created in the
account directory.

If you export a single folder, then the path of the XML file will be the account directory joined to the folder name joined to the extension ".mbox". Since an email folder name is the same as the relative (to the account directory) path of an mbox file less the ".mbox" extension, all characters in an email folder name are legal in a file name.

If you choose to split an XML file into chunks, then each chunk will have a "." plus a "chunk id" before the ".xml" extension, like this:

johnsmith.aa.xml
johnsmith.ab.xml
...

CSV output

For each XML file that DArcMailXml produces, it also produces a file with the same path as the XML file but with the extension ".csv" in place of the extension ".xml". The CSV file contains one row of basic information for each message. The file is in "comma-separated values" so that is can be loaded into a spreadsheet program like Microsoft Excel or OpenOffice Calc. The CSV file has six columns:

  1. From
  2. To
  3. Date
  4. Subject
  5. Message ID
  6. SHA1 Hash
  7. Number of errors encountered in parsing the message
  8. The first error message encountered

If you choose to "chunk" XML ouptut files, then the CSV files will also be "chunked".

Log file output

Besides the XML output files and the CSV files, the xml conversion process produces a log file, dm_xml.log.txt, in the account directory. The contents of this file are also displayed in a pop-up window when the xml conversion process has completed.

Help Top