Extending list screens

To add, remove, and rearrange columns in the list screen within the Applications Manager, complete the following steps.

1. Copy install_dir/repository/xapi/template/merged/configresource/genericscreens_modifications.xml.sample to install_dir/extensions/global/template/configresource/genericscreens_modifications.xml.
   The following is an example of the file format.

   <ScreenModifications>
     <resourceId of the list form you want to extend>
        <ListInfo>
            <Absolute>
              <List AttributeName="" ColumnTitle="" DataType=""/>
              <List AttributeName="" ColumnTitle="" DataType=""/>
           </Absolute>
            <Add>
              <List AttributeName="" ColumnTitle="" DataType=""/>
           </Add>
            <Remove>
              <List AttributeName="" ColumnTitle="" DataType=""/>
           </Remove>
         </ListInfo>
     </resourceId of the list form you want to extend> 
   </ScreenModifications>

2. Edit the genericscreens_modifications.xml file and insert entries for the resource IDs that correspond with the list screens that you want to extend.
   Tip: In order to determine the Resource ID for a specific list screen, complete the following steps:

   1. From within the Applications Manager, select the User Group screen.
   2. Click the Permission tab to display a hierarchical view of all permissions.
   3. Search the permission tree to find the list screen that you want to extend.
   4. Hover your mouse over the node to display the Resource ID using the tool tip.
3. Enter the ListInfo element attributes in the list modification XML file, using the descriptions listed in the following table:

   ListInfo Element	Purpose
   Absolute	Replaces the current columns of a list with the new columns you specify in the List elements. Overrides Add and Remove.
   Add	Adds one or more columns to the list screen. Add and Remove are mutually exclusive with Absolute.
   Remove	Removes one or more columns from the list screen. Add and Remove are mutually exclusive with Absolute.
   List	The List element is a sub-element of the Absolute, Add, or Remove element. Adds the following attributes (which must be specified): AttributeName - The name to display in the list attribute. ColumnTitle - The title to display in the list in the attribute. DataType - The data type to display in the new column. Must be a valid DataType Name within the datatypes.xml file.

4. Open the install_dir/repository/datatypes/datatypes.xml file to determine which data type you should specify in the DataType attribute.
5. If the data type you need is not in the datatypes.xml file, create a new data type, filling in the element attributes using the descriptions listed in the following table:

   DataType Element	Purpose
   Name	Identifier of the DataType. Must exactly match the List element DataType attribute used in the genericscreens_modifications.xml file.
   Type	Adds the following attributes (of which, Type and Size must be specified): CHAR - Attribute Size DATE - Attribute Size NUMBER - Attributes Size, DecimalDigits (optional), NegativeAllowed (optional), ZeroAllowed (optional) VARCHAR2 - Attribute Size

6. Save your changes to the genericscreens_modifications.xml file and close it.
7. Select the refresh cache icon that fits your needs as follows:
   • If you want to update one entity and its child resources - Select the specific entity and select the Refresh Entity Cache icon
   • If you want to update all resources - Select the Refresh Cache icon
8. Run the application again to test your changes.