Show TOC

Procedure documentationPersonalizing the List ATS Component Locate this document in the navigation structure

 

At runtime, users can personalize a list component to suit their own requirements.

For example, he or she can specify which columns should be visible and whether they should be sorted, filtered or even grouped. Users can also create separate Views, each with different settings. For example, a particular View may contain only a small subset of the total amount of columns in the table.

Prerequisites

Personalization of this component is only possible for those list components implemented using the FPM_LIST_UIBB_ATS Web Dynpro component.

Personalization of this component through the Personalization dialog box is only possible if the Personalize button has been enabled in the General Settings panel of this component's configuration in FLUID.

Procedure

Depending on the settings specified in the feeder class of the application, users can personalize this component using the following approaches:

  • Personalization Dialog Box

    Various personalization options are presented in a dialog box. Any changes you make persist; the changes are still visible the next time you open the application. To remove all your changes, open the Personalization dialog box and choose Reset to Default, followed by Save. The options are reset to those that were delivered with the application, or to the Customizing settings of the application (if such a Customizing exists).

  • Menu Options in Column Headers

    If personalization features are available through menu options in the headers of the columns in the table, a small icon appears in the bottom-right corner of the cell containing the column header when you hover over it with the mouse. Changes you make using this method do not persist; when you open the application again, your changes are no longer visible.

The following procedure uses the Personalization dialog box.

To personalize this component at runtime, proceed as follows:

  1. At runtime, in the toolbar of the component or in the relevant panel header, choose the Personalize button.

    The Personalization dialog box appears. It contains a section for Views, a tabstrip containing one or more tabs, and a toolbar.

  2. You can now make the following changes:

    • Views

      Views enable you to quickly display the information in a table that is of most interest to you. For example, you may have a table with a large number of columns, of which the most interesting are positioned at the start of the table and at the end of the table. To avoid scrolling to those columns at the end of the table, you can hide those columns of little interest and then create a new View displaying only the important ones. The original View still remains available.

      Choose a View from the Current View dropdown list. If no View has been created, the Standard View is displayed.

      To create a new View, make your changes on the relevant tabs and choose the Save As button. Choose Save to save subsequent changes to the View.

      Select the Display this View on Open to set a default View.

    • Tabstrip

      Depending on what has been specified by the application for this component's configuration, the following tabs are displayed:

      • Columns

        Use the arrows between the Displayed Columns and Available Columns to hide or display individual columns in the table. Use the Up and Down buttons to rearrange the order of the columns displayed in the table. As an alternative to using the arrows and buttons, you can also drag and drop the columns (be sure to select the row by clicking the first cell in the row).

        You can also specify the number of rows to display in the list, and the width of each column.

        Choose the Allow Horizontal Scrolling to display a horizontal scroll bar. When you select this option, you also have the Fixed option to specify whether certain columns should remain fixed on the screen as you scroll through the columns in the table.

      • Sorting and Grouping

        Select a column from the Sort By dropdown list to sort the list with respect to the chosen column. You can specify whether the list should be sorted in ascending or descending order. Choose the Add Line button to sort the list by additional columns.

        Select the Group Column checkbox to group rows according to the unique entries in the column (visible in the Sort By dropdown list). An extra column appears as the first column in the table displaying each unique entry. Using the expand/collapse icons next to each unique entry, you can display all those rows related to the group.

        To ungroup your data, choose the Ungroup menu option in the header of the column you originally grouped by.

      • Filter

        Display only a selection of data in the list by adding a filter. Choose a column from the Attribute Selection dropdown list, specify the Operator Selection and enter the relevant text in the field on the right. Add extra criteria to your filter by choosing the Insert New Line button. To exclude certain data from the results of your filter, choose the Add Criteria to Exclude link and specify the criteria.

      • Aggregation

        This tab provides you with some simple mathematical functions (Sum, Minimum, Maximum, and Average) which you can display in your data at runtime.

        Choosing one of these functions generates an extra row (highlighted in yellow) at the end of the table, showing the result of the function and an icon indicating which function you have used. If the data is grouped, the function result is additionally displayed for each group; the function result is displayed in the same row as the group heading and in the column which you have grouped by.

  3. Choose Save to return to your data and see the changes you have specified.

More Information