List Designer

This article contains the following topics:
casm1401
This article contains the following topics:
List forms (HTML templates with names of the form list_xxx.htmpl) are used to search the database and display search results. They consist of a search filter at the top of the form, where the user specifies search criteria, and a results list at the bottom of the form, listing records retrieved by the search. Use the drag-and-drop method to design the results list.
Add a Results List
List
To add the results list control to the List form, use drag-and-drop on the List button to place it on the desired area. This action places a blank frame on the form. Double-click the frame to define the columns and headers.
Modify Results List
To modify the Results List, double-click it and modify the properties. Click OK after making the required changes.
How to Disable Tenant Column Sorting
By default, you can sort the Tenant column on a list form. To disable Tenant column sorting, add the following value to the appropriate list form:
tenantSort=no
If a form includes a Tenant column, and you do not want it sorted, you can add the following line to the list form:
var tenantSort = "no"
The Tenant column is disabled on the list form.
Disable the Export Button on a List Form
HID_Disable the Export Button on a List Form
You can disable the Export button that appears on the list form pages in CA SDM.
Follow these steps:
  1. Open a list form, such as list_cr.htmpl (Request List).
  2. Double-click the results list.
    The properties dialog appears, showing the existing list definition.
  3. On the Source tab, locate the sfStart macro.
  4. Change the value to export=no as follows:
    <pdm_macro name=sfStart factory=nr export=no>
    The Export button is disabled on the list form.
How to Export Fields Not Included on List Forms
HID_How to Export Fields Not Included on List Forms
You can include a new field to export but not list.
Follow these steps:
  1. Open the Properties dialog and click Add.
  2. Select an attribute from the Attribute list, for example, Urgency.
  3. Select the Export option.
  4. On the Source tab, replace NAME=lsCol with NAME=lsExport as follows:
    <PDM_MACRO NAME=lsExport hdr="Urgency" attr=urgency justify=left>:
  5. Click OK.
    When a user clicks the Export button on a list form, the Urgency field is exported.
Export the Relative Attribute Value
HID_Export the Relative Attribute Value
By default, the common name value of an SREL column is exported. You can export the Relative Attribute value by modifying the lsCol macro.
Follow these steps:
  1. Open a list form for editing, for example, list_cr.htmpl.
    The list form opens.
  2. Click the Source tab and locate the lsCol macro as follows:
    <PDM_MACRO NAME=lsCol hdr="Priority/Parent" attr=priority sort="DESC">
  3. Copy the code string to the next line, and do the following:
    • Change the lsCol value to lsExport.
    • Add the common_name= no option.
  4. Click OK.
    When a user clicks the Export button on the list form, the Relative Attribute value exports.