The dataview Element renders a form showing data that is not
necessarily specific to an SDI. Unlike SDI-specific Elements (such as List,
Search, and Maint), the dataview tag can retrieve data from any columns of any
tables, then render a form to display the data. However, this Element does not
use the SDI mechanisms. Accordingly, it can only render data, and can not take
advantage of features provided by SDI-specific Elements.
These Elements are not specific to any Page Type, i.e., you
can use them with any Page Type or custom JSP.
Information can be presented in a form (single data item) or
grid (multiple data item) style defined by the LabVantage CSS.
dataview
Element Properties
|
| Property Name |
Description |
| style |
Determines how data are displayed based on page functionality:
| Value | Description | | Form | Generates a form. This is the page style for displaying a single
item. | | Grid | Generates grid. This is the page style for displaying multiple
items. |
Functionality of the form and grid are identical. This property determines
only which class in the LabVantage CSS renders
the style. |
| Form Columns |
Number of columns displayed on each row. This applies only to the Form
style (above). For example, if you are displaying values from the name and
department columns of a table:
Form Columns = 1 | name | Dr. Clarke | | department | Research |
Form Columns = 2 | name | Dr. Clarke | department | Research |
|
| Columns |
Specifies attributes of columns on the form or grid:
| Property Name | Description | | Identifier | Unique identifier for this item, rendered as an ID attribute in
the HTML tag. | | Column Id | Identifier of the table column to be displayed in the form or grid. | | title | Text displayed to identify the Column Id. | | Mode | Specifies how the input form control (generated HTML input tag)
works. This tool automatically determines if you have chosen an appropriate
mode to display the data (defined in the third column below). If not,
it selects an appropriate mode. Possible values:
| Value | Description | Designed for use with . . . | | input | Equivalent to type=text attribute of HTML input tag. | Inputs. | | readonly | Equivalent to readonly attribute of HTML input tag. | All data. | | hidden | Equivalent to type=hidden attribute of HTML input tag. | All data. | | lookup | Text field with capability to open a search window and find
a value of "string" data type. | All data. | | dropdownlist | Equivalent to HTML select tag that inserts a select form control. | All data. | | checkbox | Equivalent to type=checkbox attribute of HTML input tag. | All data. | | radiobutton/vertical | Equivalent to type=radio attribute of HTML input tag. This
arranges the radios vertically within the column. | Generally best for choosing from more than two
values. | | radiobutton/horizontal | Equivalent to type=radio attribute of HTML input tag. This
arranges the radios horizontally within the column. | | datelookup | Date field with capability to open a search window and find
a value of "date" data type. | LabVantage "date" data type. | | password | Entry field that displays asterisks for each character you
enter. | Entering passwords. |
| | Link URL | Specifies attributes of a hyperlinked title, activated by clicking
the text displayed by the title property:
| Property Name | Description | | HRef | Destination of the link, specified as a call to the Request
Controller. For syntax rules and guidelines, see Request
Controller and Variables. | | Target | Name of the window in which the linked page opens. You can
enter any name here, and the new window (browser instance) will
automatically assume that name. If you do not specify a target,
the linked page opens in the current window. | | Tip | Popup text displayed on mouseover. |
| | CSS Class | Class in the CSS defined for the Layout. The default CSS is WEB-CORE/stylesheets/sapphire.css. | | Display Value | Values displayed in place of the corresponding retrieved values.
Separate each with a semicolon. For example, if you retrieve values
from the createby column, you could specify JDrake=JD. All values
retrieved as JDrake would then be displayed as JD. This works only
if you replace the entire retrieved string (it does not work on partial
strings). | | Column Span | Number of columns over which the current column spans (must be less
than or equal to the total number of columns). | | Translate Value | Yes allows translation of the value. |
|
| SQL |
If the dataset object is not defined, this SQL is executed to create the
dataset. This substitution using [sdcid], [keyid1], [sysuserid], and [currentuser]. |