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, a section element with an id attribute that matches this attribute must appear somewhere before this parent 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 parent section. 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 parent 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 parent section. 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 parent 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 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 a dbid attribute that matches this attribute must appear somewhere before this parent element in the syndication file. The referenced section element must have its mirror-source attribute set to true.

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 or name 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 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 parent 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.

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.