Repair component relationships

You can repair a relationship when a reference to another component is broken or invalid. Inspire provides an auto-repair tool, or you can manually search for a valid component or element to repair the relationship. You can repair relationships at the component or element level.

Permission requirements

• 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.

• The AutoRepair and Rebuild All Relationships options may not be available. To use them, you must have one of the following permissions:

  • Administrator
  • Content browser module permissions with the can_rebuild_relationships property.

  Administrators can grant access to non-admin users or roles by following the steps in Allow a non-admin user to rebuild relationships.

Tips and Tricks

• 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.
• To fix multiple broken relationships at once, you can also use the Rebuild All Relationships option.
• If the auto-repair tool can't correct the invalid relationship, you can fix it manually in the Manage Relationships screen. Follow the steps in Manually repair an invalid relationship.
• If you aren't sure what to select using the Manage Relationships screen, you can open the component in the Oxygen editor and use the Validation pane to learn more about the error and fix it in the editor. Follow the steps in Check for errors in the Validation pane.
• You can only create relationships to elements with ID values. The following elements have ID values that can be configured in Element management:
  • fig
  • fn
  • hazardstatement
  • image
  • li
  • note
  • section
  • step
  • table
  • troubleshooting
  • concept
  • task
  • reference
  • topic
• 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.