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, asection
element with anid
attribute that matches this attribute must appear somewhere before thismirror-source
element in the syndication file. The referencedsection
element must have itsmirror-source
attribute set totrue
.If
dbid
orsource
andsourceid
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, thensourceid
must also be specified. One of the following two conditions must be satisfied:-
The target publication must already contain a mirrorable section with
source
andsourceid
attributes that matchsource
andsourceid
, or -
A
section
element withsource
andsourceid
attributes that matchsource
andsourceid
must appear somewhere before thismirror-source
element in the syndication file. The referencedsection
element must have itsmirror-source
attribute set totrue
.
If
dbid
is specified, thensource
andsourceid
are ignored. -
sourceid="
text"
(optional)-
The
sourceid
of the section this section is to mirror. If this attribute is specified, thensource
must also be specified. One of the following two conditions must be satisfied:-
The target publication must already contain a mirrorable section with
source
andsourceid
attributes that matchsource
andsourceid
, or -
A
section
element withsource
andsourceid
attributes that matchsource
andsourceid
must appear somewhere before thismirror-source
element in the syndication file. The referencedsection
element must have itsmirror-source
attribute set totrue
.
If
dbid
is specified, thensource
andsourceid
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 adbid
attribute that matches this attribute must appear somewhere before thismirror-source
element in the syndication file. The referencedsection
element must have itsmirror-source
attribute set totrue
.
-
exported-dbid="
text"
(optional)unique-name="
text"
(optional)-
The
unique-name
orname
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
orname
attribute that matches this attribute, or -
A
section
element with aunique-name
orname
attribute that matches this attribute must appear somewhere before thismirror-source
element in the syndication file. The referencedsection
element must have itsmirror-source
attribute set totrue
.
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
orsource
andsourceid
orid
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
andsource-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.