HowTo: Map Links


The shortcut links resolution is an important feature used to re-establish shortcut links of documents with new location of files in the target system while performing migration activity.

The shortcut link resolution feature works as follows:

  1. Shortcut Links resolution occurs only if the setting is enabled for respective migration task.
  2. Map custom content type for shortcut links.
  3. Perform Post Processing in order to create shortcut links on the target system.

Enable Shortcut Link Settings 

1.Firstly, select the Migration task and click on the Settings icon in the Migration Task Pane.

          Figure 1 - Migration Task Pane


2. Once user clicks on the Settings icon, the “Migration Task Settings “window is opened. Go to the “General Settings” tab and click on the "Resolve shortcut links" checkbox.

         Figure 2 - General Settings Tab

Create Shortcut Link Custom Content Type

  1. Go to the “Content Type Mapping Settings” tab which is under the “Migration Task Settings” Window and click on the “Add a new Source Classification” button in the upper-right corner of the ‘Unmapped Source Content Types’ panel, as shown in the image below.

         Figure 3 - Migration Task settings tab


  1. Create a Custom Content Type for Link with the following configuration:

    Content Type Name: e.g. Custom Link
    Base Content Type: e.g. Document
    Script Language: PowerShell
    Select variable: Optional
    Script of Custom Content Type:

         If($MigrationItem.SI.EntityType -eq "Link")

         {return $True




          return $False


  1. Verify that your entered data is analogous to the image below, then click the ‘Ok’ button to save your new Content Type. Once you click on the Ok button,  the Custom Content Type is created and we can do the metadata mapping.

         Figure 4 - Add Source Classification tab       

Content Type & Metadata Mapping

  1. Once we have created Custom Content Type, it will appear under the Unmapped Source Content Types Pane.  Select the ”Custom Link” source Content Type from the “Unmapped Source Content Types” pane and map it with “Link to a document” target Content Type from the “Available Target Content Type” pane.

         Figure 5 - Migration Task Settings

     2. Click on the “Map” button. On clicking the "Map" button, the Content Type Mapping Settings Screen is displayed.

    3. Map Name and Title metadata fields in the now visible “Content Type Mapping Settings” window.

       Figure 6 - Metadata Mapping

Figure 7 - Metadata Mapping

Figure 8 - Content type mappings settings


Provision Shortcut Link Content Type to Document Library(optional if mapped to Sharepoint Site Collection)

To associate the new Link Content Type to a Site Content Type on the target SharePoint Library:

  1. Navigate to the target Library
  2. Click on the Settings button in the top left of the page and select “Library settings” from the drop-down menu.

         Figure 9 - Migration QA Target Library


      3. Click on the “Add from existing site content types” link under the “Content Types” header.
          Figure 10 - Library Settings


       4. Select “Link to a Document Content Type” from the “Available Site Content Types” list.

       5. Click on the “Add” button.

           Figure 11 - add from existing site content type settings

         6. Click on the “Ok” button. After performing these steps the source and Target Content Types must be mapped.

Shortcut Link Processing

  1. Go to the Execution Tab and Click on discovery. Once Discovery is complete, need to click on pre-migration checks. Once the Pre-Migration check is completed, you need to Transform and then Process Load the items.
  2. You should have completed with processing up to load stage and there should be some pending items or actions for post processing. E.g. on the Items List tab, you can see the Status Message for the shortcut links as: “Link item skipped during load phase. These need to be processed using post load”.
  3. Now, click on the Post Process button to Post Process the shortcut links.
  4. The system will show confirmation to start the post processing. Click on the ‘Yes’ button. See the Screenshot below :

         Figure 12 - Post Processing Pop Up message


  1.  After clicking on the ‘Yes’ button, the Migration Accelerator will start performing post processing actions like processing the shortcut links. It will show the success and failure count of post processing items.

         Figure 13 - Processing window


Once the post process is completed, you can go to the Items List tab and check the status of the items being post processed. E.g. the shortcut links items will now show the status message as: “File checked in successfully.



Was this article helpful?
0 out of 0 found this helpful