The DSP tag library lets you work with Nucleus components and other dynamic elements in your JSPs. DSP library tags support both runtime expressions, such as references to scripting variables, and the JSTL Expression Language (EL) elements, which also evaluated at runtime.
The table below lists alphabetically the tags that are implemented in the DSP tag libraries. This appendix combines these tag libraries into one discussion by describing all relevant attributes and properties for each tag.
This section is followed by a complete discussion of each tag, its attributes and, when applicable, its variables and properties.
Attributes accept values used to set properties on a tag. For example, the
var
attribute names an EL variable that references the object of this tag. Other tags can use EL to reference the object’s properties.Variables provide a way to set dynamic values with runtime expressions.
Properties refer to properties of the object referenced by the EL variable. Other tags can use properties to access content in that object.
Finally, an example and corresponding explanation are provided for each tag.
DSP tag names and attributes that have equivalent names in HTML, JSP, or WML typically replicate the functionality of the corresponding tag while providing extra functionality. One exception applies: the iclass
attribute is used in place of the class
attribute to avoid using a standard method name in Java code. The discussions that follow omit explanations for non-required attributes that provide expected functionality, such as onmouseover
and other custom event attributes. All such attributes are specified in the TLD with lowercase characters.
See the DSP tag libraries tld
files for a listing of each tag and its attributes: <ATG9dir>/DAS/taglib/dspjspTaglib/1.0/tld
.
Summary of DSP tags
DSPtag | Summary description |
---|---|
Supports passing values to component properties and page parameters on click-through. Also handles URL rewriting. | |
Starts a transaction. | |
Completes a transaction. | |
Determines whether a Collection contains a specific single valued item. | |
Determines whether a Collection contains an EJB. | |
Manages a transaction by starting the transaction, checking for errors, rolling back the transaction when errors are found and committing it when they are not. | |
Invokes an ATG Servlet Bean. | |
Determines whether two EJBs have the same primary keys. | |
Encloses a form that can send DSP form events. | |
Embeds a page by encoding the | |
Introduces a page parameter or component property value as an element in a JSP. | |
Encloses a form that can send WML form events. | |
Embeds a dynamic page, by encoding the | |
Inserts an image. | |
Imports a Nucleus component into a page so it can be referred to without using its entire pathname. Also, creates a reference to a Nucleus component in an attribute visible to EL expressions. | |
Embeds a page into another page. | |
Passes values to a component property on submission. | |
References a page, such as a stylesheet, by encoding the | |
Specifies content to be rendered by an enclosing | |
Specifies content to be rendered by an enclosing | |
Provides the sorting pattern to parent tag dsp:sort. | |
Enables ATG page processing functionality. | |
Stores a value in a parameter. | |
Passes values to a component property on submission. (WML) | |
Sets a component property from dsp:a tag. | |
Causes any actions in the current transaction to be returned to their pretransaction state. | |
Passes values to a component property on submission. | |
Specifies that, when a transaction is prompted to end, it ends in a rollback action. | |
Sets the value of a component property or a page parameter to a specified value. | |
Sets attribute display format to XML or HTML. | |
Organizes the contents of a Container or array based on a sorting pattern. | |
Makes an object’s descriptive information available so other tags can find out its size, data type, and so on. | |
Passes values to a component property on submission. | |
Introduces a page parameter, standard JavaBean or Dynamic Bean component, or constant value as an element in a JSP that other tags can render using EL. | |
Reads the current transaction’s status. | |
Retrieves and displays the value of a page parameter, component property, or constant value. |