This is the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

Page Refinement - Fix Broken Links

This article documents the ability of WikiTraccs to fix broken links.

    Note: Fixing Broken Links is available as of WikiTraccs v1.28.8.

    Getting Started Quickly

    Here’s how to enable and start fixing broken links:

    1. Enable Page Refinement mode:
      1. in the menu bar of WikiTraccs.GUI, click Settings -> Configure Transformation to open the settings dialog
      2. as Mode select Refine Migrated Pages
      3. check the Fix Broken Links action
      4. click Ok to save the settings and close the settings dialog
    2. Choose selectors in the Space Inventory list, just as you would before starting an actual migration
    3. Click Start Transformation to start

    Note that WikiTraccs highlights the chosen mode (so you can be sure it’s the right one), here Refine Pages - Log Links, Fix Links:

    Further Reading

    Please refer to the Log Broken Links page about the following topics, as they also apply to fixing links:

    • Prerequisites
    • Granularity
    • How to Select Sites
    • Where to Find the Link Report
    • How does WikiTraccs Identify Broken Links
    • Limitations

    Tutorial Video

    This 18-minute video shows where broken links come from and how to fix them.

    The video shows two migration waves, the first of which creates broken links, and the configuration involved. Then it shows how to run the link fixer to fix those links.

    The link report file (see Log Broken Links for details on that) for the fix action contains additional status values:

    • ResultSkippedLink - link could not be fixed (either because the page was not found in SharePoint, or because multiple pages were found)
    • ResultSuccessReplacedSomething - link was replaced by new (working) link

    Also, the new page version is logged. Note that each changed web part increases the major page version by one, so, updating three text web parts on a page will increase the major page version by three.