Unresolved references in content on checkin (1002)

General

In DITA and other modular data models, content files can contain references to other content files. On checkin operations, the content file references are resolved and associated with references to objects in the Cinnamon repository. If file references are found that are not associated with an object in the repository, the unresolved references are listed in the error message.

This typically happens when editing a file and inserting a link to a file in the file system that is not an object in Cinnamon. The correct way to insert links is as follows:

Standard method

• In CDCplus, check out the parent object.
• When CDCplus asks, confirm opening the file in an editor.
• Select the parent object.
• Select the tab Relations.
• Right-click in the Children section and select "Add a new relation" from the context menu.
• Navigate to the target object's folder and select the object to be referenced. You can also select multiple objects to be referenced.
• On some systems or with specific user groups, depending on the configuration, you must select the relation type. If the selection dialog is shown, select "Child content". If the dialog is not shown, the correct relation type has been chosen automatically.
• Push the Save button (diskette icon).
• Right-click the newly added relation and choose "Copy filename" from the menu.
• Using your editor, insert the referencing element into the parent file.
• Insert the clipboard content to the correct attribute - in the case of DITA, this is normally href or conref.
• Save the parent file.
• Check the parent file in.

Method with oXygen XML Editor plugin

oXygen plugin is a commercial product by our partner ​reinisch GmbH that simplifies handling of modular XML, or particularly DITA content. Please contact us for more info.

• In CDCplus, check out the parent object.
• When CDCplus asks, confirm opening the file in an editor.
• Insert the clipboard content to the correct attribute - in the case of DITA, this is normally href or conref.
• In oXygen, push the Add reference button and choose the object you want to reference.
• Save the parent file.
• Check the parent file in.