JSP CUSTOM TAG LIBRARIES
document tag
Enables an author to create or edit a document. The body of this tag is always evaluated. You can use the
item
,
setitem
, and
formula
tags within the body of this tag. To display the document, use the
item
and
formula
tags within the body. To edit the document, use the setitem tag within the body. If you set the value of an item using the setitem tag within the body of this tag, you must save your changes also within the body of this tag. You can save your changes by either:
specifying an id attribute, and calling <id>.save() in a scriptlet
using the
savenow
tag
If you do not save your changes within the body of this tag, they will not be saved to the database.
Contexts
Valid in:
None required;
db
,
session
Creates for:
ifauthor
,
authors
,
created
,
ifdbrole
,
ifdepositor
,
ifdesigner
,
ifdocauthor
,
ifdocreader
,
ifeditor
,
formula
,
item
,
lastaccessed
,
lastmodified
,
ifmanager
,
ifnoaccess
,
parentlink
,
ifreader
,
responses
,
setitem
,
unid
Syntax
<domino:document
id="name of object variable"
dbname="database name"
dbserver="server name"
host="CORBA server name"
user="login information"
password="password associated with user"
unid="universal id for document to edit"
responseto="unid of parent document"
schema="Domino form name for new document schema"
debug="true|false"
onfailure="inline|exception"
time="true|false">
Attributes
The following attributes are optional:
dbname
Name of the database to find or create the document in.
dbserver
Name of the server hosting the database. Default is local.
host
Name of the Domino CORBA (Common Object Request Broker Architecture) server to use to host the back-end classes. If specified, forces a CORBA session. If not specified, a Domino server must be running locally on the same machine that is running the JSP Web container. Default is null which creates a local, non-CORBA, session.
id
If you specify an id name, creates a variable that contains the associated
lotus.domino.Document object
. The variable created is only available within the body of the document tag. If not specified, no programmatic access to the Document object is available. However, you can still access items of the object using the
item
tag.
password
Password associated with the value specified in the user attribute.
responseto
Universal id of the document that a new document is a response to.
schema
Name of a Domino form in the database to use as a schema. The schema sets the initial values of a new document, runs centralized validations and field post-processing before a document is saved.
unid
Universal ID of the document you want to edit. If not specified, creates a new document.
user
Login information of the session this database was opened in. If this tag is being used in the context of the session tag, its value is ignored.
See the
Common Domino JSP tag attributes
section for definitions of debug, onfailure, and time.
See Also
The Domtags tag library
Glossary
Feedback on
Help
or
Product Usability
?
Help on Help
All Help Contents
Glossary