| Attributes |
| Name | Required | Request-time | Type | Description |
| href | true | true | java.lang.String |
the url of the JSP file representing the view
|
| tableName | true | true | java.lang.String |
the url of the table the view represents
|
| position | false | true | java.lang.String |
optional: the position to navigate to within
table "tableName"
for backwards compatibility is the same as
destPos!
|
| parentField | false | true | java.lang.String |
used if parentTable is different to
tableName: field(s) in the main form that
is/are linked to this form
|
| childField | false | true | java.lang.String |
used if parentTable is different to
tableName: field(s) in this form that is/are
linked to the parent form
|
| destPos | false | true | java.lang.String |
a value indicating the row to navigate to.
Position strings are used as request
parameters allowing the framework to keep
track of the position the user comes from or
goes to. This string is structured as
follows:
fieldId : fieldValueLength : fieldValue
It is important to note that if multiple
keys exist in the definition of the table,
your position string must includes values
for each key. (separated by dashes (-))
Example:
<! Jump to another JSP, specify position
using multiple keys-->
<db:gotoButton caption="View Sample
Details"
destination="/viewSample.jsp"
destTable="Sample"
destPos="1:6:widget-3:2:23"/>
|
| keyToDestPos | false | true | java.lang.String |
a key indicating the row to navigate to.
Example:
<! Jump to another JSP, specify position
through a key -->
<db:gotoButton caption="View Sample
Details"
destination="/viewSample.jsp"
destTable="Sample"
keyToDestPos="k_1_1@root"/>
|
| keyToKeyToDestPos | false | true | java.lang.String |
a key to the key indicating the row to
navigate to. For each record in the
result-set, the associatedRadio tag
generates a key reference which can be used
to retrieve a position string.
Example:
<!for each record, generate a key to the
position string -->
<db:body><db:associatedRadio
name="test"/></db:body>
<db:footer>
<! Jump to another JSP, specify position
(get second record using appropriate
key!)-->
<db:gotoButton caption="View Sample
Details"
destination="/viewSample.jsp"
destTable="Sample"
keyToKeyDestPos="test"/>
Check "customerlist.jsp" in example!
|
| singleRow | false | true | java.lang.String |
if set to true, only one row of data will be
fetched. default is false, so that all rows of
data will be fetched and the requested record
will be set as actual record.
|