Skip Ribbon Commands
Skip to main content

How do I add Recipient Mappings to a project?

Last Update: 1/26/2017 11:22 AM

​How do I add Recipient Mappings to a project?

Answer:

Recipient Mappings are a useful way to ensure:

  • That all email remains replyable to, post-migration, even after a Full (Delta) Migration has occurred when performing a tenant to tenant migration, while keeping the same domain name; or when changing domain names from Source to Destination.
  • That calendar ownership and display name match on destination when performing a tenant to tenant migration, while keeping the same domain name; or when changing domain names from Source to Destination.

Use cases:

 

The following explains how to add a Recipient Mapping to your project's Advanced Options, using the example above:

  • Under Support/Support Options, add the following:
    • RecipientMapping="@Sourcedomain.onmicrosoft.com->@Destinationdomain.com"
      • Notes:
        • Make sure to click on the "+" sign after entering your Recipient Mapping. If you do not do this, it will not be added.
        • The Recipient Mapping above is only an example: do not copy this verbatim. Change it to reflect your tenant .onmicrosoft.com account name and your customer domain name.
        • Left part is a RegEx applied to the recipient email address. You can use more than one remapping expression. This is a very important step for Office 365 to Office 365 migrations. It ensures that emails are replyable to, even after the Full (Delta) Migration has occurred.

Refer to KB005100 for instructions on how to add this support option, under Advanced Options, at either the project or individual item level.

 

 

This Advanced Option has the following limitation:

  • We do not support Recipient Mapping for the actual Mime content, so email mime content based migrations, such as Zimbra, won't have remapping for email.
    • Further explanation: the MIME content is the information that is listed under Show Details, for a message, for most email systems.

 

Here is a breakdown of migration scenarios, to show which scenarios support this Advanced Option:

  • Exchange 2003+, or Office 365 as a Source - supported
    • Note: Exchange 2003 will migrate using WebDAV. Exchange 2007 can migrate using WebDAV or EWS, Exchange 2010+ will migrate using EWS
  • GoogleApps as a Source - Calendar entries do support this option. Email entries will not support this option because migrations are based on MIME content.
  • Zimbra as a Source - Calendar entries do support this option. Email entries will not support this option because migrations are based on MIME content.
  • GroupWise as a Source - not supported
  • Lotus Notes as a Source - supported
    • Notes:
      • Lotus' recipients are extracted inside the local Lotus Extractor as an Attribute of LotusWebServiceItem instead of MIME content.
      • The customer's email addresses on Domino/Lotus server are in X400 format instead of SMTP, so inside Lotus Extractor we have a translator used to translate & map these email addresses.
  • POP as a Source - not supported
  • IMAP as a Source - not supported