Extract Emails within Queues in Dynamics 365

Per default, AttachmentExtractor (AE) does not extract emails within queues. By adding some SettingsKeys to your system, this can be enabled.

However, extracting an email with a queue item association will break either the “QueueEntered” date or the queue relation. Since this cannot be avoided, the user must decide which option to take. Depending on your situation, the SettingsKey configuration will be slightly different:

Scenario 1: Choosing to break the queue association

1. Enable extraction of emails associated with queues: Create a new SettingsKey with the following information
   • Name: IgnoreQueuedItems
   • Value: false
     
2. Add emails back to the queue after extraction: Create a new SettingsKey with the following information.
   • Name: PersistsQueueRelation
   • Value: false
     

Scenario 2: Choosing to break the queue entered date

1. Enable extraction of emails associated with queues: Create a new SettingsKey with the following information
   • Name: IgnoreQueuedItems
   • Value: false
     
2. Add emails back to the queue after extraction: Create a new SettingsKey with the following information.
   • Name: PersistsQueueRelation
   • Value: true
     

Attention: When emails are re-added during the extraction process, all Plugins/Workflows that trigger when an email is added to a queue will still trigger again in this case.

Adding a delay

A general delay can be applied to both of the above scenarios by creating another SettingsKey with the following information (This will tell the ExtractionService to ignore queued Items until the reference date (ModifiedOn per default) has passed the delay):

• Name: DelayQueueItemsHours
• Value: numeric

Common scenarios:

• Ignore queued items for a week, then extract the email and do not re-add the item to the queue:
  • IgnoreQueuedItems : false
  • PersistsQueueRelation : false
  • DelayQueueItemsHours : 168
• Ignore queued items for a month, then extract the email and readd the item to the queue it was in at that time (This would break order of items in the queue!):
  • IgnoreQueuedItems : false
  • PersistsQueueRelation : true
  • DelayQueueItemsHours : 720

That’s it! We appreciate your feedback! Please share your thoughts by sending an email to support@mscrm-addons.com.