Lotus Domino Designer 8 Help

JSP CUSTOM TAG LIBRARIES

parentlink tag
Generates a link between a document and its parent that is created using document or form tags. Achieves this by generating a link to the JSP page that displays or edits the parent of the current document. The text attribute or tag body is evaluated and generated as the body of a HTML <A> or anchor tag. Using this tag, you can link to a document's parent without having to supply the following page parameters to the linked page: unid of the parent document, viewname, dbname, and dbserver. These parameters are automatically retrieved by the form or document tags on the destination page.

Note If you use this tag in the context of a viewloop tag, forces the document to be loaded, which may impair scalability.

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:parentlink href="name of page with parent form or document tag" showdisabled="true|false" text="hypertext link content" debug="true|false" onfailure="inline|exception" time="true|false" The standard HTML tag attributes listed below>

Attributes

The following attributes are optional:

href

Name of the page that contains the parent form or document tag. Augments any specified arguments with the unid and viewname attributes for the current document and propagates the dbname and dbserver attribute values. If this attribute is not specified and the tag is used in the context of a form or document, generates a link to the current JSP page, preserving all arguments. If this attribute is not specified and the tag is used in the context of a viewloop or docloop tag, an exception is thrown.

Note If your href destination jsp contains a form or document tag with a fixed unid attribute value, the document identified by the form or document tag's unid attribute will open instead of the parent document.

showdisabled

Boolean value. If true, generates the body of the tag even when no parent document is available. Default is false.

text

Text to use as the hypertext link. If not specified, the link is generated from the tag body. If the tag has no body, the default text "Parent" (localized) is generated as the hypertext link.

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.