Migrator for Notes to SharePoint 6.16 - User Guide

Update Links tab

Update Links tab

You can use this tool to update the locations of your migrated documents in the Link Tracking database. This will be useful if the locations of your migrated documents have changed (for example, you may have changed the external host name of your SharePoint server, changed the path for a SharePoint site, or moved your content database to a different server).

For example, imagine that you have migrated all your Notes documents to a staging SharePoint environment (http://staging01:8080) and now it is time to go live. You plan to detach your content database and reattach it in your production environment or even a hosted environment such as Microsoft SharePoint Online (say, http://acme.sharepoint.online). The "Update links in the Link Tracking Database" function will allow you to update all references to documents that will be impacted by this move in the Link Tracking Database.

Table 50. Update Links tab

Property	Description
Old URL Prefix	Enter the URL prefix of the documents as they currently appear in the Link Tracking database.
New URL Prefix	Enter the new URL prefix that you want to be the replacement for the above URL prefix.
Update locations of referring documents	Select this check box to update the table of referring documents (documents that contain links to other documents) in addition to updating the locations of your documents. You should only choose this option if the documents at the NEW location will be reachable by the Link Tracking Finalizer tool. In particular, if you are preparing to finalize a set of documents before moving them, you should NOT select this option. If you do, the Finalizer tool will not be able to find them.
Preview	Click this button to preview the current references to documents as stored in the Link Tracking database and the proposed new references to the documents. When the Preview button is pressed, he Progress area at the bottom of the form will become visible if it is not already. The Update Preview tab will appear with the proposed changes. Note that once the Update Preview tab appears, it will continue to be available with the last results. These results are not saved. NOTE: Data can be copied out of the Update Preview tab by selecting a Cell, Row or the whole table (upper Left box in the grid) and using Ctrl-C. It can be pasted into a file or into Excel for analysis.
Update	Click this button when you are ready to make the changes in the Link Tracking database. If you have lots of documents to update, you will see a status page that updates every few seconds and then a final results page.

Link Finalization tab

Link Finalization tab

You can use this tool to update or permanently replace all Dynamic Links in a set of migrated documents. This works for links in SharePoint List Items, SharePoint Pages, InfoPath documents, Word documents or any other SharePoint target you chose to migrate to.

You can use this tool when updating the Link Tracking Database is not enough and you want to update the actual Dynamic Links in the migrated documents. The most common reason to do this is to permanently replace all Dynamic Links with direct links to the last known locations of the target documents. A secondary reason might be to change the location of your Redirector Page.

This tool allows you to select the set of documents that contain dynamic links that you want to update.

TIP: When you decide what you want to do with Dynamic Links that point to migrated documents, the most common choice is to replace them with direct links to the migrated documents (that is, their new URLs in SharePoint). Since this is a permanent, irreversible operation, we refer to it as "Finalization". TIP: When you decide what you want to do with Dynamic Links that point to documents that have not been migrated to known SharePoint locations, we recommend to leave them as is, in case you want to migrate the linked-to documents later. If you are really sure that those documents are going to stay in Notes, you can finalize those links with the original Notes/Domino URLs.

Table 51. Link Finalization tab

Property	Description
Which migrated documents are to be processed?
All migrated documents	Select this radio button to process all migrated documents in the Link Tracking Database.
Specific migrated documents	Select this radio button to process the migrated documents you specify. To specify documents by folder, enter the folder relative path; To specify documents by URL, enter the string that the document URLs start with.
Which DocLinks in the migrated documents you select are to be processed?
All DocLinks	Select this radio button to finalize all DocLinks in the migrated documents.
DocLinks in specific migrated documents	Select this radio button to finalize DocLinks in the specific migrated documents. To specify documents by folder, enter the folder relative path; To specify documents by URL, enter the string that the document URLs start with.
Links to Migrated Documents
Modify Dynamic Links to Migrated Documents	Select this check box to modify the links. To leave the Dynamic Links as they currently are, do not select this check box. If this check box is selected, you have the following choices: • Finalize Dynamic Links with Direct Links: Click this radio button to replace the Dynamic Links with direct links that point to the last known locations of the migrated target documents (that is, their new URLs in SharePoint) CAUTION: You should only perform this operation when you are sure that the documents your links are pointing to are indeed "final" and that they are not still moving around. If you have moved (or plan to move) these documents or otherwise change their external addresses, be sure to run the "Update links in the Link Tracking Database" tool before you finalize your links. This is a permanent change that cannot be reversed using this tool. • Replace Dynamic Links with this Alternate URL: Click this radio button to change the Dynamic Link to reference a different Redirector Page or to a static URL. Be sure to use the {0} notation to encode the unique identifier of the target document in the link.
Links to Non-Migrated Documents
Modify Dynamic Links to Non-Migrated Documents	Select this check box to modify the links. To leave the Dynamic Links as they currently are, do not select this check box. This is the recommended option. If this check box is selected, you have the following choices: • Replace Dynamic Links with this Alternate URL: Click this radio button to change the Dynamic Link to reference a different Redirector Page or to a static URL. Be sure to use the {0} notation to encode the unique identifier of the target document in the link. • Replace Dynamic Links with Direct Links when possible, otherwise remove them: Click this radio button to change these Dynamic Links to Direct Links that point to the original locations of target documents in Notes/Domino. CAUTION: notes://... URLs are not allowed in SharePoint Items. So finalizing such links in (for example) rich text fields in List Items renders them completely inoperable. It is safe, however, to finalize notes://... links in library files such as InfoPath or Word documents. This is a permanent change and is not reversible using this tool.
Preview	You can preview the proposed changes of the operation by clicking this button.
Finalize	Click this button to make the desired changes. The Log tab will display the results.

Log tab

Log tab

This tab displays the results from running the Link Finalization tool.

The Session dropdown allows you to choose the results of a particular finalization run.

NOTE: When viewing an old 5.2/5.3 database, this list may not contain specific results sets.

Table 52. Log tab

Property	Description
Column to Filter and Filter Text drop downs	When combined, allows you to locate specific text within the results.
Show Errors Only check box	Reduces the current result set to only those items that have error information present.

License

License

The License node is where you can import your license file to install, and check your license details. For how to import and install your license, refer to the section Licensing and product editions in the Migrator for Notes to SharePoint Installation Guide.

To check your license details, right click on the License node in the console, and select License Details....The dialog box Migrator for Notes to SharePoint License Status opens.

The License Info tab in the dialog box contains the general information regarding your license:

•	Product name

•	Product version

•	License number

•	Database limit

•	Product edition

•	License type

•	License expiration date

The License Consumption tab in the dialog box contains the consumption details on your license (the database limit shown on the License Info tab) by listing out which databases have consumed the license with the database ID and title on these actions:

•	Analyze Database

•	Recompute Database Details

•	Apply Class Rules

•	Migrate to SharePoint

•	Recover Link Tracking Data

•	Generate InfoPath Form Template

•	Generate Third-party Form Template

•	Export Data Analysis Details

•	Export Database Records

•	Extract Database Users

NOTE: You will be prompted to confirm the license consumption when you perform the actions above.