List Pages
List pages are one of two main types of action pages within Commerce Server Business Desk. List pages are characterized by several distinguishing features, as follows:
They are read-only. Data should never be modified on a list page (with the exception of search information in the find pane).
They appear along side the navigation pane, the latter of which allows a Business Desk user to leave the current module by selecting a different module. The list page is displayed in the right side of the Business Desk workspace.
Typically, list pages make use of a ListSheet HTML Component (HTC) for displaying data, using one of several distinct modes of operation offered by that HTC.
The list page is often divided into two distinct areas, arranging one above the other. The top area is known as the find pane, and typically contains a small number of EditField HTCs that allow the user to specify find criteria. The bottom area contains the ListSheet HTC mentioned above, and is known as the content pane. When a Find task is performed using the criteria specified in the find pane, the results are displayed in the ListSheet HTC in the content pane.
The following table describes the recommend logical structure for list pages.
Abbreviated List Page Code | Description |
|
List Page server-side routine to insert the proper taskbar and show the navigation pane. |
|
DIV containing the whole find pane. |
|
XML data-island containing the configuration data for the EditField HTCs. |
|
XML data-island containing the actual data to be displayed in the EditField HTCs. |
|
DIV containing the first of several EditField HTCs used in the find pane. |
|
DIV containing the second of several EditField HTCs used in the find pane. |
|
DIV containing the third of several EditField HTCs used in the find pane. |
|
End of the find pane DIV. |
|
DIV containing the whole content pane. |
|
XML data-island containing the configuration data for the ListSheet HTC. |
|
XML data-island containing the actual data to be displayed in the ListSheet HTC. |
|
DIV containing the ListSheet HTC used in the content pane. |
|
End of the content pane DIV. |