Insert content references​ in Oxygen

When you're working on a document in the Oxygen-based editor, you can reuse content from other components using content references (conref). This lets you take content from somewhere else and make it appear (exactly as it is) inline where you reference it.

Tips and tricks

Other ways to add content references in Oxygen

ID attributes
Before you can create a content reference, the source content must have an id attribute that the conref can reference.

You can only create a cross-reference to elements with ID values. An administrator can configure elements in the Element Management module and set Yes or No for the Needs Id property.

  • If you need to reference an element that doesn't have an ID, contact your administrator.
  • To configure elements, an administrator can follow the steps in Manage elements.

To insert content references:​

  1. In Inspire, go to Components.
  2. Navigate to the DITA topic where you want to insert a content reference.
  3. Right-click the topic and select Edit ...
  4. Select the text where you want to insert the content reference.
  5. From the toolbar select the link icon , and then select Oxygen_Conrefs Content Reference...
    Note: You can also insert a content reference by right-clicking on the selected text, selecting Reuse, and then Content Reference.
  6. On the Select Component dialog, in Folders, navigate to the file that contains the content you want to reference, and then click Select.
  7. On the Content Reference dialog, in the top grid, use the Target ID, Element, and Content columns to find the block of content you want to reference.
  8. To select a reference, click the option in the Sel column for the row you want.
  9. Click OK.
    You'll see the following changes:
    • ln the Editor pane, the link name has been updated.
    • In the Outline pane, in Structure, the cross link name has been updated.
  10. In the toolbar, click Save and Submit.

    After creating a reference to another component, Inspire tracks the relationship.

    • If the following statements are both true:
      • An administrator has enabled an optional feature to help you manage referenced content
      • Changes are made in the referenced component that impacts the reference
    • The user is warned that this referenced component will be updated also.
    • For more information, read Save changes in referenced components.
    Troubleshooting:
    If you make changes to links and references, you can ensure the most up-to-date information is being displayed by following these steps:
    1. Go to the toolbar.
    2. Click the Refresh references icon .

      Whenever you refresh references, Inspire automatically:

      • Saves the changes locally
      • Submits the changes to the database
      • Reloads the content in the editor