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, auser
element with anid
attribute that matches this attribute must appear somewhere before thisuser-ref
element in the syndication file.If the user can not be found using
dbid
orusername
orsource
andsource-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, thensourceid
must also be specified. One of the following two conditions must be satisfied:-
The database must already contain a user with
source
andsourceid
attributes that matchsource
andsourceid
, or -
A
user
element withsource
andsourceid
attributes that matchsource
andsourceid
must appear somewhere before thisuser-ref
element in the syndication file.
If the user can not be found using the
dbid
attribute or thedbid
attribute is not specified, thensource
andsourceid
attributes will be used. -
sourceid="
text"
(optional)-
The
sourceid
of the referenced user. If this attribute is specified, thensource
must also be specified. One of the following two conditions must be satisfied:-
The database must already contain a user with
source
andsourceid
attributes that matchsource
andsourceid
, or -
A
user
element withsource
andsourceid
attributes that matchsource
andsourceid
must appear somewhere before thisuser-ref
element in the syndication file.
If the user can not be found using the
dbid
attribute or thedbid
attribute is not specified, thensource
andsourceid
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 calledusername
that matches this attribute must appear somewhere before thisuser-ref
element in the syndication file.
If the user can not be found using the
dbid
orsource
andsourceid
or those attributes are not specified, thenusername
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 adbid
attribute that matches this attribute must appear somewhere before thisuser-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.