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 target system while performing migration activity.
The shortcut link resolution feature works as follows:
- Shortcut Links resolution occurs only if the setting is enabled for respective migration task.
- Map custom content type for shortcut links.
- Perform Post Processing in order to create shortcut links on target system.
Enable Shortcut Link Settings
1.Firstly, select the Migration task and click on settings icon in the Migration Task Pane.
Figure 1 - Migration Task Pane
2. Once user clicks on Settings icon, “Migration Task Settings “window is opened. Go to“General Settings” tab and click on Resolve shortcut links checkbox.
Figure 2 - General Settings Tab
Create Shortcut Link Custom Content Type
- Go to “Content Type Mapping Settings” tab which is under “Migration Task Settings” Window & 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
- 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")
- 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 OK button, Custom Content Type is created and we can do the metadata mapping.
Figure 4 - Add Source Classification tab
Content Type & Metadata Mapping
- Once we have created Custom Content type, it will appear under 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, 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:
- Navigate to the target Library
- Click on the settings button in the top left of the page and select “Library settings” from the dropdown.
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
- Go to Execution Tab and Click on discovery. Once Discovery is complete, need to click on pre-migration checks. Once Pre-Migration check is completed, User needs to Transform and then Process Load the items.
- User should have completed with processing up to load stage and there should be some pending items or actions for post processing. E.g. on Items List tab user can see Status Message for the shortcut links as: “Link item skipped during load phase. These need to be processed using post load”.
- Now, User needs to click on the Post Process button to Post Process the shortcut links.
- The system will show confirmation to start the post processing. Click on ‘Yes’ button. See the Screenshot below :-
Figure 12 - Post Processing Pop Up message
- After click on ‘Yes’ button Migration Accelerator will start performing post processing actions like processing the shortcut links. It will show success and failure count of post processing items.
Figure 13 - Processing window
Once post process is completed, user can go to Items List tab and check the status of items being post processed. E.g., the shortcut links items will now show the status message as: “File checked in successfully.”