user-ref

References a user to which the role represented by this element's owning ACL is to be assigned.

Syntax
<user-ref
    id-ref="text"?
    (source="text" sourceid="text")?
    username="text"?
    dbid="text"?
    exported-dbid="text"?
  />
Attributes
id-ref="text" (optional)

The id of the referenced user. If this attribute is specified, a user element with an id attribute that matches this attribute must appear somewhere before this user-ref element in the syndication file.

If the user can not be found using dbid or username or source and source-id or those attributes are not specified, then this attribute is used to find the user.

source="text" (optional)

The source of the referenced user. If this attribute is specified, then sourceid must also be specified. One of the following two conditions must be satisfied:

  • The database must already contain a user with source and sourceid attributes that match source and sourceid, or

  • A user element with source and sourceid attributes that match source and sourceid must appear somewhere before this user-ref element in the syndication file.

If the user can not be found using the dbid attribute or the dbid attribute is not specified, then source and sourceid attributes will be used.

sourceid="text" (optional)

The sourceid of the referenced user. If this attribute is specified, then source must also be specified. One of the following two conditions must be satisfied:

  • The database must already contain a user with source and sourceid attributes that match source and sourceid, or

  • A user element with source and sourceid attributes that match source and sourceid must appear somewhere before this user-ref element in the syndication file.

If the user can not be found using the dbid attribute or the dbid attribute is not specified, then source and sourceid attributes will be used.

username="text" (optional)

The username of the referenced user. If this attribute is specified then one of the following two conditions must be satisfied:

  • The target publication must already contain a "person" or "user" content item with a username field that matches this attribute, or

  • A user element with a field called username that matches this attribute must appear somewhere before this user-ref element in the syndication file.

If the user can not be found using the dbid or source and sourceid or those attributes are not specified, then username attribute will be used to find the user.

dbid="text" (optional)

The dbid of the referenced user. If this attribute is specified then one of the following two conditions must be satisfied:

  • The target publication must already contain a user with a dbid attribute that matches this attribute, or

  • A user element with a dbid attribute that matches this attribute must appear somewhere before this user-ref element in the syndication file.

exported-dbid="text" (optional)

The dbid of the referenced user.

This attribute is generated during export from the Content Engine, but ignored during import. It is provided mainly for information and debugging purposes.