Chat now with support
Chat with Support

Metalogix Content Matrix 8.9 - Public Folder Edition User Guide

Introduction Entering the License Key Content Matrix Console End User Interface Connecting to Public Folders Connecting to SharePoint Preparing for Your Migration Configuring Copying Options Saving or Running a Migration Action Log Files Using PowerShell with Content Matrix Modifying Content Matrix Configuration and Settings Configuring Content Matrix for Distributed Migration Frequently Asked Questions About Us

Users and Permissions Options

Users And Permissions Options enable you  to map Exchange user accounts and permissions (such as Author, Reviewing Author, etc.) to SharePoint user accounts and permissions (such as Full Control, Contribute, Read, etc.).. This means that an Exchange user account can be mapped into a SharePoint user account.

IMPORTANT: Users from the source can only be mapped to the SharePoint target if there is some kind of shared authentication method (such as Active Directory) between them.

If no mappings are specified for any user based metadata that is migrated, Metalogix Content Matrix will use the migrating user account for this metadata instead.

To configure User and Permissions Options:

PF Users and Permissions

1.Click [Set user mappings...] to display the User Mapping dialog, and follow the procedure for Mapping Users and Permissions.

2.If you want to copy user permissions:

a)Check the Copy permissions box.

b)If you want to explicitly map permissions between source and target, click [Set permissions mapping] and follow the procedure for Mapping Users and Permissions.

NOTE:  If you choose not to map permissions, Metalogix Content Matrix will be use Automatic Permissions Mapping.

c)If you want any permissions that are not explicitly mapped to be skipped, check the Skip non-mapped permissions box.

NOTE:  If this box is not checked, Metalogix Content Matrix will be use Automatic Permissions Mapping for permissions that are not explicitly mapped.

Mapping Users and Permissions

You can explicity map users and permissions when you click the [Edit Users] or [Edit Permissions] button from the Users and Permissions tab.

NOTE:  If the source environment has a large number of users, it is recommended that the XML user mapping method be used instead, to help improve performance, and for better control over user mapping.

To map user and permissions:

PF Permission Mapping

1.Use the information in the following table to determine the appropriate action to take.

NOTE:  You can Filter items in each window to narrow displayed lists.

If ...


you want to load mappings from a previously-saved xml file

click the Load icon.

you want to  manually map individual users or permissions on the source to a target SharePoint user or permission

·From the source list, select the Item that you want to map.

·From the target list, select a target Item.

·Click the Map icon.

you are mapping users and want to have Metalogix Content Matrix automatically map source users to target SharePoint users (based on email address)

·From the User Mappings dialog - source list, select the Item(s) that you want to map.

·Click the Auto icon.


·The Exchange From field will be mapped to the SharePoint Created by field.

·The Exchange Last modified by user field will be mapped to the SharePoint Modified by field.

·If a user has already been mapped during a migration, the SharePoint Created and Last Modified fields are maintained on the target.

save mappings in the dialog as an xml file

click the Save icon.

The mappings you create will display in the bottom window.  (Note that you can also Unmap individually-selected mappings in the bottom window or or Clear all mappings from the bottom window.

2.Click [OK] to return to the Copy Options dialog.

Importing Mappings from an xml File

Metalogix Content Matrix can import any desired user or permissions mappings from an XML file. Importing user or permissions mappings from an XML file involves creating an XML file with the desired mappings, then importing that file. This option is generally used if migrating from an  environment that has a large number of users and/or permissions

Example Permission mapping XML

<?xml version="1.0" encoding="utf-8"?>
<Map ExPermission="Owner" SpPermission="Full Control" />
<Map ExPermission="NoneditingAuthor" SpPermission="Read" />

There could be more Mapped sections within the root StaticMaps section of the XML file. Each Map section defines mapping for Exchange permission into SharePoint permission.

ExPermission - Exchange permission (mandatory)

SpPermission - SharePoint permission (mandatory)

Example User mapping XML

<?xml version="1.0" encoding="utf-8"?>
<Map ExUser="adm@tests.local" SpUserDisplayName="adm" SpUserEmail="adm@tests.local" SpUserIsGroup="False" SpUserLoginName="TESTS\adm" />
<Map ExUser="test02@tests.local" SpUserDisplayName="test02" SpUserEmail="test02@tests.local" SpUserIsGroup="False" SpUserLoginName="TESTS\test02" />
<Map ExUser="test03@tests.local" SpUserDisplayName="test03" SpUserEmail="test03@tests.local" SpUserIsGroup="False" SpUserLoginName="TESTS\test03" />
<Map ExUser="test05@tests.local" SpUserDisplayName="test05" SpUserEmail="test05@tests.local" SpUserIsGroup="False" SpUserLoginName="TESTS\test05" />

There could be more Map sections within the root StaticMaps section of this XML. Each Map section defines mapping of Exchange user (or distribution list) into SharePoint user (or group).

·ExUser - Exchange user or distribution list email address (mandatory).

·SpUserDisplayName - SharePoint user display name (optional).

·SpUserEmail - SharePoint user email address (optional).

·SpUserIsGroup - group flag whether SharePoint user is a group (optional, default value set to "False").

·SpUserLoginName - SharePoint user login name or the group name in case of group (mandatory).


Automatic Permissions Mapping

When you Configure Users and Permissions Options, you can either map user permissions explicitly, or have Metalogix Content Matrix map permissions automatically, as specified in the following table.

NOTE:  Custom permission groups will be created in SharePoint.

PF Automatic Permissions Mapping

Related Documents