Share via


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
<% InsertTaskBar %>
List Page server-side routine to insert the proper taskbar and show the navigation pane.
<DIV  id='FindByArea'>
DIV containing the whole find pane.
    <XML id='efMeta'> . . . </XML>
XML data-island containing the configuration data for the EditField HTCs.
    <XML id='efData'> . . . </XML>
XML data-island containing the actual data to be displayed in the EditField HTCs.
    <DIV id='edit1'> . . . </DIV>
DIV containing the first of several EditField HTCs used in the find pane.
    <DIV id='edit2'> . . . </DIV>
DIV containing the second of several EditField HTCs used in the find pane.
    <DIV id='edit3'> . . . </DIV>
DIV containing the third of several EditField HTCs used in the find pane.
</DIV>
End of the find pane DIV.
<DIV  id='ContentArea'
DIV containing the whole content pane.
    <XML id='lsMeta'> . . . </XML>
XML data-island containing the configuration data for the ListSheet HTC.
    <XML id='lsData'> . . . </XML>
XML data-island containing the actual data to be displayed in the ListSheet HTC.
    <DIV id='list1'> . . . </DIV>
DIV containing the ListSheet HTC used in the content pane.
</DIV>
End of the content pane DIV.


All rights reserved.