Section Page content-ref

Represents a content-ref on an Escenic section page. The element attributes are used to identify the content item that the content-ref represents.

A content-ref element can contain child field elements in order to override the default contents of the summary fields displayed in the content-ref. The names of any child fields must be valid summary fields for the content item referenced by the content-ref. Summaries are defined in the target publication's content-type resource.

Syntax

<content-ref
    id-ref="text"?
    publication-name="text"?
    (source="text" sourceid="text")?
    dbid="text"?
    exported-dbid="text"?
  >
  <field>...</field>*
  <options>...</options>?
</content-ref>

Only one form of the field element may be used: Standard field.

Examples

This example shows a section-page content-ref element. The source and source-id attributes identify the referenced content item. This content item must already exist in the database or appear before this element in the syndication file. The optional field element inside the content-ref locally overrides the content of the same field in the referenced content item.
```
<content-ref source="ex" sourceid="19">
  <field name="leadtext">New lead text</field>
</content-ref>
```

Attributes

id-ref="text" (optional)

The id of the referenced content item. If this attribute is specified, a content element with an id attribute that matches this attribute must appear somewhere before this content-ref element in the syndication file. If the referenced content item does not belong to this content-ref's owning section, the it is automatically added during import.

If dbid or source and sourceid are specified, then this attribute is ignored.

publication-name="text" (optional)

The name of the publication to which the referenced content item or section belongs. This attribute may only be used in combination with the source and source-id attributes. It is needed to ensure unique identification in situations where cross-publishing is in use and the referenced content item or section does not belong to the current publication.

source="text" (optional)

The source of the referenced content item. If this attribute is specified, then sourceid must also be specified. One of the following two conditions must be satisfied:

The target publication must already contain a content item with source and sourceid attributes that match this element's source and sourceid, or
A content element with source and sourceid attributes that match source and sourceid must appear somewhere before this content-ref element in the syndication file.

If the referenced content item does not belong to this content-ref's owning section, the it is automatically added during import.

If dbid is specified, then source and sourceid are ignored.

sourceid="text" (optional)

The sourceid of the referenced content item. If this attribute is specified, then source must also be specified. One of the following two conditions must be satisfied:

The target publication must already contain a content item with source and sourceid attributes that match this element's source and sourceid, or
A content element with source and sourceid attributes that match source and sourceid must appear somewhere before this content-ref element in the syndication file.

If the referenced content item does not belong to this content-ref's owning section, the it is automatically added during import.

If dbid is specified, then source and sourceid are ignored.

dbid="text" (optional)

The dbid of the referenced content item. If this attribute is specified, then one of the following two conditions must be satisfied:

The target publication must already contain a section with a dbid attribute that matches this attribute, or
A content element with a dbid attribute that matches this attribute must appear somewhere before this content-ref element in the syndication file.

If the referenced content item does not belong to this content-ref's owning section, then it is automatically added during import.

This attribute is never present in syndication files that have been exported from a database. IDs are always written to exported-dbid attributes in exported syndication files.

exported-dbid="text" (optional)

The dbid of the referenced content item.

This attribute is generated during export from the , but ignored during import. It is provided mainly for information and debugging purposes.