Iterates through the items returned by a view, ftsearch, db, responses, or page tag as documents. The body of this command is output once per iteration, which means once per document in the result set. When a result contains no objects, the body of this tag is not evaluated. Use the novalues tag to create custom text to display when a result contains no objects. Use the item tag to access the items in a document.

Note If you use this tag within the context of the view tag, there will be a performance hit. The viewloop tag is a good alternative to use for views; it evaluates the body once per entry in the view, instead of loading a document for each entry in the view.

Contexts

Valid in:

db, ftsearch, responses, page, or view

authors, created, ifdocauthor, ifdocreader, item, formula, parentlink, unid, formlink, lastaccessed, lastmodified, responses

<domino:docloop
id="name of object variable"
count="number"
start="number"
direction="ASC|DSC|Ascending|Descending"
debug="true|false"
onfailure="inline|exception"
time="true|false">

The following attributes are optional.

count

Total number of objects to loop over. Passing a value of -1 to the loop tag displays all remaining objects. Default is -1. In the context of a page tag, this attribute is ignored.

Indicates the direction of iteration through the result. Must be one of the following:

ASC, DSC, Ascending, Descending

Default is Ascending. In the context of a page tag, this attribute is ignored.

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 docloop 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.

The object number to start looping at. Default is 1. In the context of a page tag, this attribute is ignored.

Example
See Also

The Domtags tag library

Glossary