section-ref
A reference to a section to which this element's owning
content item (content
element) belongs. Since a
content item can belong to many sections, a
content
element may contain many
section-ref
elements. A section can be
referenced using any of the following attributes:
-
id-ref
-
source
andsource-id
-
dbid
-
unique-name
Import considerations
The referenced section must either be defined prior to this element in the syndication file or else already exist in the target publication.
Syntax
<section-ref id-ref="text"? publication-name="text"? (source="text" sourceid="text")? dbid="text"? unique-name="text"? todesk="(true|false)"? home-section="(true|false)"? />
Examples
This example imports an "image" content item. It includes a reference a section to which the content item is to belong. This section is set to be the content item's home section. The referenced section must already exist in the database or appear before this
content
element in the syndication file.Note the use of JSON syntax to include soft crop information in the
representations
field. For more information about this, see Importing Soft Crop Definitions.<content source="ex" sourceid="20" type="picture" state="published"> <section-ref source="ex" sourceid="s2" home-section="true"/> <field name="title">Croc</field> <field name="caption">A Croc on the beach</field> <field name="binary" title="crocodile">/tmp/escenic/import/croc.jpg</field> <field name="representations">{ "thumbnail": { "crop": { "width":400, "height":400, "x":0, "y":54 } }, "narrow": { "crop": { "width":250, "height":200, "x":0, "y":54 } }, "wide": { "crop": { "width":400, "height":400, "x":102, "y":100 } } }</field> </content>
Attributes
id-ref="
text"
(optional)-
The
id
of the section to which the content item represented by the owningcontent
element belongs/is to be added. If this attribute is specified, asection
element with anid
attribute that matches this attribute must appear somewhere before thissection-ref
element in the syndication file.If
dbid
orsource
andsourceid
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. source="
text"
(optional)-
The
source
of the section to which the content item represented by the owningcontent
element belongs/is to be added. 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 section with
source
andsourceid
attributes that matchsource
andsourceid
, or -
A
section
element withsource
andsourceid
attributes that matchsource
andsourceid
must appear somewhere before thissection-ref
element in the syndication file.
If
dbid
is specified, thensource
andsourceid
are ignored. -
sourceid="
text"
(optional)-
The
sourceid
of the section to which the content item represented by the owningcontent
element belongs/is to be added. 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 section with
source
andsourceid
attributes that matchsource
andsourceid
, or -
A
section
element withsource
andsourceid
attributes that matchsource
andsourceid
must appear somewhere before thissection-ref
element in the syndication file.
If
dbid
is specified, thensource
andsourceid
are ignored. -
dbid="
text"
(optional)-
The
dbid
of the section to which the content item represented by the owningcontent
element belongs/is to be added. 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
section
element with adbid
attribute that matches this attribute must appear somewhere before thissection-ref
element in the syndication file.
-
unique-name="
text"
(optional)-
The
unique-name
orname
of the section to which the content item represented by the owningcontent
element belongs/is to be added. If this attribute is specified, then one of the following conditions must be satisified:-
The target publication must already contain a 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 thissection-ref
element in the syndication file.
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. -
todesk="
(true|false)"
(optional)-
If set to
true
, then content item represented by the owningcontent
element is added to this section's default inbox (INBOX
). home-section="
(true|false)"
(optional)-
If set to
true
then this section is the home section of the content item represented by the owningcontent
element.