parent
A reference to this section's parent section. This element makes it possible to establish section tree relationships during import. Note that the Content Engine's import subsystem does not tolerate unusually deep section hierarchies. Section trees that are more than 40 sections deep cannot be guaranteed to import successfully.
Syntax
<parent id-ref="text"? (source="text" sourceid="text")? dbid="text"? exported-dbid="text"? unique-name="text"? inherit-access-control-list="(true|false)"? />
Examples
This example imports a section. The child
parent
element specifies where the section is to be inserted into the section hierarchy. The referenced section must already exist in the database or appear before this element in the syndication file.<section source="ex" sourceid="s2" name="example-section"> <parent unique-name="ece_incoming"/> </section>
Attributes
id-ref="
text"
(optional)-
The
id
of the parent section. If this attribute is specified, asection
element with anid
attribute that matches this attribute must appear somewhere before thisparent
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 parent section. 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 thisparent
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 parent section. 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 thisparent
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 parent section. 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 thisparent
element in the syndication file. The referencedsection
element must have itsmirror-source
attribute set totrue
.
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 parent section.This attribute is generated during export from the , but ignored during import. It is provided mainly for information and debugging purposes.
unique-name="
text"
(optional)-
The
unique-name
orname
of the parent section. 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 thisparent
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. -
inherit-access-control-list="
(true|false)"
(optional)-
If set to
false
then the section will not inherit the access control list of the parent section, and the section will maintain its own access control list.Most sections should inherit the access control list of the parent. In a large section tree it is recommended that only a few of the sections have their own access control lists, since a large number of access control lists may impede search performance.