item (Domino DTD)
Represents an item in a note. Items store the content of a note. Every Domino note contains a set of items determined by the note class. All form notes, for example, contain the same set of items, though the values of the items differ from form note to form note. Likewise, view notes contain the same set of items. Documents, however, contain different items, depending on the form that was used to create them. An example of an item is the $Revisions item, which contains a list of time stamps that record when revisions were made to a note. This item is common to most notes, regardless of its class type. Each item has a name, type, one or more flags, a length, and a value.
Containment Hierarchy
Contained by: %note.epilog;
Contains: %simple.types;, %item.complex.types;
Syntax
<!ELEMENT item ( %simple.types; , %item.complex.types; )>Content
%simple.types; , %item.complex.types;Contains any one of the contents of the %simple.types; entity, followed by any one of the contents of the %item.complex.types; entity.
Attributes
<!ATTLIST item|
name |
%string; |
#REQUIRED |
|---|---|---|
|
sign |
%boolean; |
"false" |
|
seal |
%boolean; |
"false" |
|
sealed |
%boolean; |
"false" |
|
summary |
%boolean; |
#IMPLIED |
|
authors |
%boolean; |
"false" |
|
names |
%boolean; |
"false" |
|
readers |
%boolean; |
"false" |
|
placeholder |
%boolean; |
"false" |
|
protected |
%boolean; |
#IMPLIED |
|
unchanged |
%boolean; |
#IMPLIED |
>authors
Boolean value. If true, this item is an Authors item. An Authors item represents an Authors field on a form, which contains a list of users who are allowed to edit a document they did not create even though they only have Author access to the database in the ACL. Default is false.
name
Name of the item.
names
Boolean value. If true, this item is a Names item. A Names item represents a Names field, which contains a list of user names. Default is false.
placeholder
Boolean value. If true, this item is a placeholder for a form note. Default is false.
protected
Boolean value. If true, protects a field in an existing document from being edited by users with Author access.
readers
Boolean value. If true, this item is a Readers item. A Readers item represents a Readers field on a form, which contains a list of users who are allowed to read a document; all others are restricted from reading it. Default is false.
seal
Boolean value. If true, the content of the field is encrypted. Only readers who have an encryption key can access an encrypted field. Default is false.
sealed
Boolean value. If true, the item contains data encrypted by Notes. Only readers who have an encryption key can access an encrypted field. Default is false.
sign
Boolean value. If true, the field is electronically signed to prevent documents from being tampered with en route from one user to another. Default is false.
summary
Boolean value. If true, this item is a summary item. Items are classified as summary items if they are non-data notes or if they are only added to data notes in order to manage them. Items in data notes, like user fields specified in a form used to create documents, can be considered summary items if they are not comprised of Compound Document (CD) items, which hold rich text and attachments, and are individually less than 60K in size. Summary item values are always stored in the notes header and item descriptors, while non-summary item values may be stored elsewhere in the database. This attribute defaults to true for the following options of the %simple.types; entity: text, number, datetime. All others have no default.
unchanged
Boolean value. If true, the in-memory version of this item is identical to the on-disk version. The value of this attribute is only valid when exporting an item; it does not apply when importing.