EML files processor

High-level description

EML files processor is a part of the Intake framework that recursively extracts EML file content.

The typical Business Process with EML files processor looks as follows.

How to use

1. Provide the step that exports the _sys_transaction_id column or uploads data as a CSV file. The CSV file should include the single column: _sys_transaction_id.

note

You may use the TransactionCreateFakeConnector test connector. This connector is implemented for testing purposes only. It generates a test transaction with a single document. The document points to the example.eml file by the originalDocumentLink property: https://wfinst-307-92-db1.workfusion.com/doc-upload/example.eml.

2. Go to the side panel on the right > the Bot tab (Other) and drag-n-drop the EML files processor Bot Config from the Intake Bots BCB. Its name is Intake Bots \<VERSION> (EML files processor).

How it works

The EML files processor iterates over all the transaction documents.

• The originalDocumentLink document property is treated as S3 URL to the EML file. If the file extension is not .eml, a document will be not considered. In the resulting transaction, such document is preserved as it is.
• If the originalDocumentLink property points to the EML file, the EML file itself is saved into the resulting transaction as the origin document (see the Processing result code block below).
• The EML message body is saved as a separate document and stored on S3: originalDocumentLink="eml_flatMap/<Generated_document_UUID>.html, where <Generated_document_UUID> is the document UUID generated by the processor.
• Each MIME part extracted from the EML is also saved as a separate document and stored on S3: originalDocumentLink="eml_flatMap/<Generated_document_UUID>.<Extension>", where <Generated_document_UUID> is the document UUID generated by the processor, <Extension> is the MIME part file extension extracted from EML.

Inner EML MIME parts are also extracted recursively with no limitations.

See the transaction example code (example.eml) below.

Transaction before processing

{
  "meta": {
    "articlesReviewed": "1",
    "manualTaskLink": "https://demo-spa852.workfusion.com/workfusion/secure/business-process/edit/0a49ebc9-0a59-4567-bc2b-3f90fef5e2f6?actTab=WORKFLOW_DESIGNER",
    "dateOfInvestigation": "September 24, 2018",
    "entityName": "Arcandor",
    "suggestedKeywords": "[\"Arcandor AND FRAUD OR MONEY LAUNDERING OR LAUNDERING OR TRAFFICKING OR DRUGS OR ARREST OR SMUGGLING OR BRIBERY OR TERRORISM OR TERRORIST OR EMBEZZLEMENT\"]",
    "highRiskCountriesRelations": "[\"Costa Rica\",\"Macau\",\"Peru\"]",
    "workerName": "Kyle Hoback, kyle@workfusion.com",
    "overallRecommendation": "Suspicious - Investigate Further"
  },
  "docs": [
    {
      "id": "11111111-2222-3333-4444-555555555555",
      "name": "example.eml",
      "originalDocumentLink": "https://wfinst-307-92-db1.workfusion.com/doc-upload/example.eml",
    }
  ]
}

Transaction after processing

{
  "meta": {
    "articlesReviewed": "1",
    "manualTaskLink": "https://demo-spa852.workfusion.com/workfusion/secure/business-process/edit/0a49ebc9-0a59-4567-bc2b-3f90fef5e2f6?actTab=WORKFLOW_DESIGNER",
    "dateOfInvestigation": "September 24, 2018",
    "entityName": "Arcandor",
    "suggestedKeywords": "[\"Arcandor AND FRAUD OR MONEY LAUNDERING OR LAUNDERING OR TRAFFICKING OR DRUGS OR ARREST OR SMUGGLING OR BRIBERY OR TERRORISM OR TERRORIST OR EMBEZZLEMENT\"]",
    "highRiskCountriesRelations": "[\"Costa Rica\",\"Macau\",\"Peru\"]",
    "workerName": "Kyle Hoback, kyle@workfusion.com",
    "overallRecommendation": "Suspicious - Investigate Further"
  },
  "id": "a83cefa6-26c9-4c93-8fce-e546a385757c",
  "docs": [
    {
      "meta": {
      },
      "id": "9a9072ff-99b6-4882-a1a1-552711e00874",
      "name": "example.eml_=?UTF-8?Q?_EML Example File?=.html",
      "type": null,
      "textLink": null,
      "taggedTextLink": null,
      "originalDocumentLink": "https://wfinst-307-92-ct1-s3.workfusion.com:443/doc-upload/eml_flatMap/f3a39c69-9421-4f37-bde2-0a9a3ca8a33d.html",
      "extractedFields": {
      },
      "origin": {
        "meta": {
        },
        "id": "9a9072ff-99b6-4882-a1a1-552711e00874",
        "name": "example.eml",
        "type": null,
        "textLink": null,
        "taggedTextLink": null,
        "originalDocumentLink": "https://wfinst-307-92-db1.workfusion.com/doc-upload/example.eml",
        "extractedFields": {
        },
        "origin": null,
        "merged": false
      },
      "merged": false
    }
  ]
}