C:\DITA\WKFS_oXygen_Files\fragments\webhelp.fragment.head.xml
Jump to main content C:\DITA\WKFS_oXygen_Files\fragments\webhelp.fragment.before.body.xml

# About Content References

A Content Reference element allows you to reuse content from another document, or within the same document. Taglines are set up as Content References and other documents have the same content, allowing the content to be authored once and reused on subsequent documents.
Note: The Document ID can not be changed after content references have been added to the document.

To create a Content Reference, verify that both documents are checked out through TFS (the document that is being authored as well as the source document). Right-click in the appropriate location and select Content Reference.

1. Select Yes in the resulting dialogs.
2. Navigate to the location where you saved a copy of the Content Reference source file (REQ). The tool will require you to navigate to that working folder.
3. Once you select the source REQ file, a list of all the Sections and Notices in the referenced document appear. Select the content you need and click OK. Multiple Sections or Notices can be selected by using the Ctrl and Shift keys. If multiple Sections or Notices are selected, they are inserted into the new REQ file in the same order that they appear in the source REQ file.
4. When you verify your selection, select OK.

The content will be brought into your file and appear with blue highlighting. If future changes are needed to the content, the changes must be made in the source document and saved. When the new document is opened after changes have been made to the source document the content references will be updated automatically. This keeps the two documents synchronized.

The ContentReference is displayed in Yellow when the referring document is opened. The validation of the ContentReference is Pending, signifying that the tool is verifying with the database that the ContentReference is current. If Requirements Editor is unable to contact the database, the ContentReference remains Yellow. If Requirements Editor is able to contact the database and determine if the content is current, the ContentReference appears in blue, indicating Up to Date.

Following is a complete list of the ContentReference colors:

- Blue: connected to authoring DB and matches what is in the authoring DB
- Red: connected to authoring DB but does NOT match what is in the authoring DB
  - You can do an update to the reference in a read only file, and still execute the document.
- Orange: connected to authoring DB but cannot find the reference in the authoring DB
- Yellow: not connected to Authoring DB
- Pink: indicates the content is referenced by another document. Changes to this content will affect the content displayed elsewhere.

Content references are supported as elements that can be added to a table (through the <entry> element) as a child element. Adding a content reference tag (<ContentReference>) is supported in the list of elements permitted within a table structure. Specifically, the tag is permitted within the <entry> tag used to populate a table cell. The content reference tag is available in the Add Child Elements menu.

Note: When instances occur in which base content is incorrectly authored and a ContentReference rule is used outside a ContentReference, the base content update process and builds result in build failures. To help avoid this, a warning message is displayed when attempting to use an existing ContentReference rule (DTA/COND/ITR) outside of the ContentReference.

## Freezing Content References

In order to prevent content references from being updated, select Tools > Freeze Content References. This action freezes all content references within an REQ file.

Frozen ContentReference elements are indicated using a dark yellow background color.

The backgroundcolor is configurable within Tools > Options > Environment > Fonts and Colors.

Frozen ContentReference elements are given an attribute of updateable with a value of false. If the attribute does not exist the value is assumed true, allowing the ContentReference to be updated.
Note:

- This feature is only enabled if there are existing ContentRefernce elements within the open REQ file.
- When freezing content references, all content references within an REQ file are frozen. It is not possible to freeze individual content references.

To unfreeze content references, select Tools > Unfreeze Content References.

C:\DITA\WKFS_oXygen_Files\fragments\webhelp.fragment.after.body.xml