2.4Internal links

Internal linking in cmsWorks means that an other document is referenced in an input field of the current document. This internal linking only exists within document properties. Only documents can be link targets. The data shown of those links is not only the ID but also the information about the linked document (like name, path, type).

The impact

When producing a website, either the content of a linked document is produced or a URL that leads to the linked content. This also may be combined.

If the linked document is move or renamed, all linking pages will instantly update the content or URLs because of this internal link connection. So the connection between documents remain stable and consistent.

Creating links

The document list input field collects one or more links to other documents. Those documents can be copied from cmsExplorer, from other document lists, from search or Workbook or from open documents as well. The order of documents within a document list is important and documents may also be removed from those lists.

Another type of internal link can be set within a Richtext or a Grid input field.

To find documents that are linking to the document in question use the action Linking documents in the document window.

Deleting documents

A document can only be deleted if no other document contains an internal link to this document. Even if the search shows no linking documents left there may be older versions of documents that contain such links. And because those old version could be reactivated, the linked document must not be deleted.

Publication dependencies

If a document should be published it first have to be approved for publication using . To perform a successful publication of a document all linked documents have to have the state published or approved. If a linked document is in state approved all links of this document will be checked too. This condition is to secure that an online version of the website is functioning as well as the preview.