Rebuild all relationships in one component

You can use an automated tool to repair multiple invalid relationships that occur when references to other components or elements are broken. Use caution when selecting this option because after you confirm that you want to use the tool, the action can't be undone.

A content owner or administrator can set permissions to deny access to components or folders. If your permissions to content has been blocked and you are not an administrator, you cannot use the Advanced options in a project's Content pane.

Tips and Tricks

  • Although you can do this action from the Components browser or a project, these instructions tell you how to do it from the Components browser.
  • You can also use this action on multiple components at once. Follow the steps in Rebuild all relationships in multiple components.
  • You can only create relationships to elements with ID values. For more information read Repair component relationships.
  • The auto-repair tool is helpful when you want to fix a single relationship, but you can use it repeatedly to fix multiple broken relationships one at a time. Follow the steps in Auto-repair an invalid component relationship.
  • If the auto-repair tool can't correct the invalid relationship, you can fix it manually. Follow the steps in:
  • Inspire now supports content references to ditabase topics. A ditabase topic is a composite topic. Before maps, ditabase was used to collect multiple topics and structure them within a single topic file.
    • If you use a conref to a ditabase topic, Inspire no longer identifies it as an invalid relationship.

  • When you repair a self-referencing link, the following syntax is used:

    • If a cross-reference is pointing to content in a separate file, Inspire includes the file name:
      <filename>#<rootid>/<elementid>
    • If a cross-reference is pointing to content that exists in the same file, DITA assumes it's the same, so Inspire drops the file name:
      #<rootid>/<elementid>

To rebuild all relationships in one component:

  1. Click Components_TopMenuOpt Components.
  2. In the Folders pane, navigate to the folder where you've saved the component.
  3. In the Components pane, select the component that has an invalid relationship that you want to repair.
    Components with an invalid relationship display an Invalid icon .
  4. Right-click the component's row, select Advanced, and then select Relationships...
    You can also click the Options menu, select Advanced, and then select Relationships...
  5. On the Manage relationships dialog, you'll see a list of any invalid references.

    By default, when you open the Manage Relationships screen, only references that are Invalid are shown.

  6. To see all relationships, you must clear the default selection of Only Show Invalid Relationships and click Refresh.

  7. On the Manage Relationships screen, click Rebuild All Relationships.
  8. On the confirmation dialog, click Yes.

    You see the following notifications in Inspire:

    When you complete a task that triggers a notification, such as repairing relationships, the Slack and email message bodies contain:

    • The title and file name of the component that was repaired.
    • Ten or less Issues, Errors, and Warnings.
    • A link at the bottom of the message [See Full Version].
    • You can click the [See Full Version] link to expand a section under the link with the full details.
    • For more information, review the Sample Inspire notification.