Fixing broken links using the Fixup link references wizard

Use the Fixup Link References wizard to fix large numbers of broken links.

Although you can fix broken links by double-clicking the broken link entries in the Problems view and manually correcting the errors in Page Designer, the Fixup Link References wizard is especially adept at fixing errors that occur if you move a file that is the target of links to a different folder.

To fix links using the Fixup Link References wizard, complete the following steps:

1. Right-click a resource (a project, folder, or file) from the Enterprise Explorer view.

2. Select

   Link Utilities | Fix Broken Links from the pop-up menu; the Fixup Link References wizard opens. The wizard populates the table with the broken links, the suggested fixed link (if it can determine this information), and the location of the broken link. Each link is designated by the wizard to either be fixed or skipped, as indicated by the Fix icon () or the Skip icon ()

   To change a designation, highlight the link and click on the Fix button or the Skip button. The icon in front of the link changes based on your choice. You can also designate your choice by clicking directly on the icons. Note that there must be data in the Fixed Link field before you can change these designations. Each time you change a designation, the counter at the bottom keeps track of how many link are selected to be fixed or skipped.

3. You can change how the links are structured by selecting one of the following styles from the pull-down menu:

   Use existing style,

   Use document relative links,

   Use document root relative links. The

   Fixed Link column is updated to reflect the structure selection.

4. You can check the

   Group links that go to the same destination check box to group all of the broken links that point to the same location into one row in the table. Any change you make to a grouped row are applied to all instances of that broken link.

5. Ensure the link text in the

   Fixed Link field for each link is accurate.

   When deciding how to fix a broken link, it can be useful to look at the

   Context box, which displays the source where the broken link is located. If you select a different broken link in the table, the

   Context view is refreshed with the source surrounding the selected broken link. Note that you cannot enter or change text in the Context box.

   If the wizard cannot suggest a way to fix the broken link, you can manually enter the text in the Fixed Link field by clicking in the field. You can also locate a link by clicking the

   Suggestions button and navigating to the correct link.

   • If you click on the Suggestions button, select one of the entries in the

     Suggestions field to populate the

     Fixed Link field. (Links to resources within the current project are listed above suggestions to links to resources in external projects.) Note that all suggestions are structured with paths relative to the document root; however, the

     Fixed Link field in the Fixup Link Reference wizard will be populated according to the structure you designate.

   • Alternately, click Browse to locate the location of the link target manually. You can browse for a

     File,

     Servlet, or

     Class.

   Click OK when you are satisfied with the new link. The Fixed Link field is populated in the table in the Fixup Link Reference wizard.

6. When you are satisfied with your selections and the fixed link values, click

   Fixup Links. The links are all updated to reflect the values in the

   Fixed Link column, and the wizard closes.

Another useful feature when fixing broken links is the ability to sort the broken links by location. Clicking the

Found in Page heading sorts the rows by their location. This may be useful if you want to correct broken links based on their page location.

---