section-acl

Represents an Escenic access control list (ACL), which assigns a specified role to one or more users or user groups. A role implies a defined set of access rights. This element represents a section ACL, so the access rights only apply to a specified section of the publication.

Syntax
<section-acl
    name="(reader|administrator|useradmin|editor|journalist)"
    id-ref="text"?
    (source="text" sourceid="text")?
    dbid="text"?
    exported-dbid="text"?
    unique-name="text"?
  >
  <user-ref/>*
  <user-group-ref/>*
</section-acl>
Attributes
name="(reader|administrator|useradmin|editor|journalist)"

The name of the role represented by this ACL.

Allowed values are:

reader
administrator
useradmin
editor
journalist
id-ref="text" (optional)

The id of the section to which this ACL is to apply. If this attribute is specified, a section element with an id attribute that matches this attribute must appear somewhere before this section-acl element in the syndication file.

If the section can not be found using dbid or unique-name or source and sourceid or any of those attributes is not specified, then this attribute will be used to find the section.

source="text" (optional)

The source of the section to which this ACL is to apply. 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 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 section-acl element in the syndication file.

If the section can not be found using dbid or the dbid attribute is not specified, then source and sourceid attributes are used to find the section.

sourceid="text" (optional)

The sourceid of the section to which this ACL is to apply. 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 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 section-acl element in the syndication file.

If the section can not be found using dbid or the dbid attribute is not specified , then source and sourceid attributes are used to find the section.

dbid="text" (optional)

The dbid of the section to which this ACL is to apply. 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 a dbid attribute that matches this attribute must appear somewhere before this section-acl element in the syndication file.

exported-dbid="text" (optional)

The dbid of the section to which this ACL is to apply.

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 section to which this ACL is to apply. 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 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 section-acl 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 the section can not be found using dbid or source and sourceid or those attributes are not specified, then this attribute will be used to find the section.