Importing EML Files

EML is a common file format that is often the result of exporting from an email client (such as Novell GroupWise, Microsoft Outlook Express, Lotus Notes) or from another archiving solution. Information is stored in plain text MIME format, containing the email header, body and attachments. IPRO supports importing EML files into the archive via a Swagger API accessible over HTTP. The API will accept EML files into an internal queue, after which they can be converted into XML and stored in the archives using a regular job. Pushing EMLs to the API is best accomplished with a script, which is left to the admin to elaborate.

Here is the workflow for importing EML files:

  • In the IPRO Admin UI, create a Storage Location for EML files.
  • Create a script to use Swagger API to push your EML files.
  • In the IPRO Admin UI, create an Import job to process the EMLs and add them to the archive.
  • Select Archiving > Connectors.
  • In the Storage Devices section, click Add.
  • In the window that opens, select the Message Import Queue option as your data format and click Next.
  • Enter a name, description, and path for the EML files and click Save.
  • Click Save at the bottom-left of the screen.
  • You can view the API using free, publicly available utilities such as petstore.swagger.io.
  • Open the site in a browser on the archive server.
  • Enter the address of your archive server:
  • http://localhost:8088/swagger.json
  • Navigate to ingestion-service-controller and importMessageDataWithFile.
  • Click Try it Out, then fill in the fields.
  • locationname corresponds exactly to the name entered during the Create Storage Location step.
  • account corresponds to the specific user you are importing EML files for, in the following format: User@domain.com
  • Select Archiving > Agents > Import.
  • Create a job.
  • Select Archiving > Agents > Import > your job.
  • On the Criteria tab, set the source location and archive location and click Save.