Lotus Domino Designer 8 Help

JSP CUSTOM TAG LIBRARIES

formlink tag
Example

Generates a link between a page containing a viewloop or docloop tag and a page containing a document or form tag. The text attribute or tag body is evaluated and generated as the body of a HTML <A> tag (which is an anchor tag). Using this tag, you can link to another page without having to supply the following page parameters to the linked page: unid, viewname, dbname, and dbserver. These parameters are automatically retrieved by the form or document tags on the destination page.

Note This tag generates HTML that causes the page to reload when a user clicks it. If you want to save the parameters that you passed into the page, you must use a preserve tag for each parameter you want to save or it will be lost when the page reloads.

Contexts

Valid in:

Syntax

<domino:formlink href="name of page with form or document tag" asresponse="true|false" text="hypertext link content" debug="true|false" onfailure="inline|exception" time="true|false" The standard HTML tag attributes listed below>

Attributes

asresponse

Boolean value. If true, indicates that the link should create a new response; it generates a responseto page parameter. If false, indicates that the link should create a new document; it generates a unid page parameter. Default is false. Optional.

href

The name of the page that contains the document or form tag. Augments any specified arguments with the current document's unid attribute value, the current viewname attribute, and propagates the dbname and dbserver attribute values. Required.

text

Hypertext link content. If no text attribute is specified, the body of the tag is used as the link text. If the tag has no body, the default text "Edit" or "Respond"(if the asresponse attribute equals true) is generated as the link in a localized format. Optional.

See the Common Domino JSP tag attributes section for definitions of debug, onfailure, and time.

HTML Attributes

Domino supports the following HTML tag attributes. See the Common HTML tag attributes section for their definitions.