user
Represents a special kind of content item used to store user information about users of a publication.
Syntax
<user id="text"? (source="text" sourceid="text")? dbid="text"? exported-dbid="text"? > <field>...</field>* </user>
Only one form of the field
element may be used:
User field.
Attributes
id="
text"
(optional)-
A unique identifier for this
user
element. It is only valid and unique within the current syndication file and can be used to enable the establishment of relationships between elements in the file. Other elements in the file haveid-ref
attributes that can be used to referenceuser
elements. If auser
element does not have anid
attribute then it must have either adbid
attribute or both asource
and asourceid
attribute. Auser
element may have several or all of these attributes, in which case any of them can be used for establishing relationships.The
id
attribute is not imported along with users. Unless adbid
attribute has been specified, all imported users are assigned new internal IDs during import. source="
text"
(optional)-
The name of the system from which this user originates. Together with the
sourceid
attribute it forms a globally unique external identifier for the user that can be used for establishing relationships between elements in the syndication file. Other elements in the file havesource
andsourceid
attributes that can be used for this purpose. If this attribute is specified then asourceid
attribute must also be specified. If auser
element does not have asource
andsourceid
attribute then it must have either adbid
attribute or anid
attribute. Auser
element may have several or all of these attributes, in which case any of them can be used for establishing relationships.If supplied,
source
andsourceid
are imported and stored with users. Ifsource
andsourceid
are supplied anddbid
is not supplied, then they are used to lookup an existing user. If a user with matchingsource
andsourceid
is found, then this user is updated; otherwise a new user is created.If supplied,
source
andsourceid
are imported and stored when creating new users, but not when updating existing users. sourceid="
text"
(optional)-
The id of this user in the system from which it originates. Together with the
source
attribute it forms a globally unique external identifier for theuser
that can be used for establishing relationships between elements in the syndication file. Other elements in the file havesource
andsourceid
attributes that can be used for this purpose. If this attribute is specified then asource
attribute must also be specified. If auser
element does not have asource
andsourceid
attribute then it must have either adbid
attribute or anid
attribute. Auser
element may have several or all of these attributes, in which case any of them can be used for establishing relationships.If
source
andsourceid
are supplied anddbid
is not supplied, then they are used to lookup an existing user. If a user with matchingsource
andsourceid
is found, then this user is updated; otherwise a new user is created.If supplied,
source
andsourceid
are imported and stored when creating new users, but not when updating existing users. dbid="
text"
(optional)-
The internal Content Engine ID of this user, which can be used when importing updated versions of existing content items. It can also be used for establishing relationships between elements in the syndication file. Other elements in the file have
dbid
attributes that can be used for this purpose. If auser
element does not have adbid
attribute then it must have either asource
andsourceid
attribute or anid
attribute. Auser
element may have several or all of these attributes, in which case any of them can be used for establishing relationships.You should only use the
dbid
attribute when importing updated versions of existing users.This attribute is never present in syndication files that have been exported from a database. The ID is always written to the
exported-dbid
attribute in exported syndication files. exported-dbid="
text"
(optional)-
The internal Content Engine ID of this user, which can be used to identify the user in the database from which it was exported.
This attribute is generated during export from the , but ignored during import. It is provided mainly for information and debugging purposes.