mirror-source

A reference to a section that this element's owning section is to mirror. The owning section has no content of its own, but just mirrors the content of the section referenced here. The owning section's mirror-source attribute may not be set to true.

Syntax
<mirror-source
    id-ref="text"?
    (source="text" sourceid="text")?
    dbid="text"?
    exported-dbid="text"?
    (unique-name="text")?
    publication-name="text"?
  />
Examples
  • This example imports a mirror section and illustrates the use of the mirror-source element to reference the section that is to be mirrored. The referenced section must already exist in the database or appear before this element in the syndication file.

    <section source="ex" sourceid="s5" name="example-mirror-target" mirror-source="true">
      <parent unique-name="ece_incoming"/>
      <mirror-source unique-name="example-mirror-source"/>
    </section>
Attributes
id-ref="text" (optional)

The id of the section this section is to mirror. If this attribute is specified, a section element with an id attribute that matches this attribute must appear somewhere before this mirror-source element in the syndication file. The referenced section element must have its mirror-source attribute set to true.

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

source="text" (optional)

The source of the section this section is to mirror. 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 mirrorable section with source and sourceid attributes that match source and sourceid, or

  • A section element with source and sourceid attributes that match source and sourceid must appear somewhere before this mirror-source element in the syndication file. The referenced section element must have its mirror-source attribute set to true.

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

sourceid="text" (optional)

The sourceid of the section this section is to mirror. 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 mirrorable section with source and sourceid attributes that match source and sourceid, or

  • A section element with source and sourceid attributes that match source and sourceid must appear somewhere before this mirror-source element in the syndication file. The referenced section element must have its mirror-source attribute set to true.

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

dbid="text" (optional)

The dbid of the section this section is to mirror. If this attribute is specified then one of the following two conditions must be satisfied:

  • The target publication must already contain a mirrorable section with a dbid attribute that matches this attribute, or

  • A section element with a dbid attribute that matches this attribute must appear somewhere before this mirror-source element in the syndication file. The referenced section element must have its mirror-source attribute set to true.

exported-dbid="text" (optional)
unique-name="text" (optional)

The unique-name or name of the section this section is to mirror. If this attribute is specified, then one of the following conditions must be satisified:

  • The target publication must already contain a mirrorable section with a uniquename or name attribute that matches this attribute, or

  • A section element with a unique-name or name attribute that matches this attribute must appear somewhere before this mirror-source element in the syndication file. The referenced section element must have its mirror-source attribute set to true.

If this is not the case, or if there is a matching name attribute but it is not unique, then import will fail.

If dbid or source and sourceid or id 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.