Adding a column to a list view
You can add a new table column to an existing Management Center list view.
Before you begin
Tip: This task file provides the generic
steps for adding a column to a list view. For a tutorial that includes
this topic, refer to Adding
a new column to the product list view.
You
can add a column to a list view to display a business object property.
If you are creating a new property for an object, ensure that you
have completed the following tasks to customize the persistence layer
and the Business Object Manager before you customize the user interface:
- Created a new WebSphere Commerce table in the schema.
- Generated object relational metadata and the physical SDO.
- Configured the Business Object Manager to include new properties in user data.
- Updated query templates for read and update.
Procedure
- Complete one of the following steps:
In the Enterprise Explorer view, expand , where Management_Center_component is
the name of the tool you want to customize. 
In the Enterprise Explorer view, expand , where Management_Center_component is
the name of the tool you want to customize.
- Complete one of the following steps:
- Determine the type of list view you
are updating and locate the class name that defines that type of list
view. All list view classes follow this naming convention: the name
begins with a three-character Management Center component
code, followed by the type of object, and then the type of list view.
For example,
class name="catCatalogEntryGrid"defines a list view for a catalog entry object within the catalog (cat) tool in the Management Center.Tip: A list views always extends wcfObjectGrid. For example catCatalogEntryGrid extends wcfObjectGrid. - Determine the type of list view you are
updating and locate the definition name that defines that type of
list view. All list view definitions follow this naming convention:
the name begins with a three-character Management Center component
code, followed by the type of object, and then the type of list view.
For example,
definitionName="catCatalogEntryBrowseGrid"defines a list view for a catalog entry object within the catalog (cat) tool in the Management Center.Tip: List view definitions are always instances of wcfObjectGrid. For example catCatalogEntryBrowseGrid is an instance of wcfObjectGrid.
- Add a tag to define a new column to the list view.
Columns definition classes all extend wcfGridColumn. The naming convention for these classes include the widget that is displayed in the column cells. For example, the wcfGridText class is used to define a column that displays text editors in the cells, and the lzx/commerce/foundation/restricted/ComboBox.lzx/wcfGridComboBox class is used to define a column that displays combination boxes.
Option Description Add a simple text column as the first column in a list viewAdd a <wcfGridText> tag as the first column tag in the
list view class:<class extends="wcfObjectGrid" name="catCatalogEntryGrid"> <wcfGridText name="column_ID" objectPath="object_path" propertyName="property_name" editable="true_or_false" text="column_heading" visible="true_or_false" width="pixels"/>The following example shows how to use the <wcfGridText> tag to add a simple 90 pixel column, called Price, to an editable list view:<wcfGridText name="price" objectPath="Product/ProductDescription" propertyName="x_product_price" editable="true" text="Price" visible="true" width="90"/>Add a simple text column as the first column
in a list viewAdd a <GridText> tag as the first column tag in the list
view definition:<GridComboBox propertyName="name" name="merchandisingAssocType" required="true" editable="true" text="${catalogResources.merchandisingAssociationAssocType_ColumnHeader}" width="120"/>Add a column that supports a combination box in a list view
(that is, users can select values for the column from a list)Add a <wcfGridComboBox> tag. To use wcfGridComboBox, the wcfPropertyDefinition class (which
defines the options list for the property) must already be defined
in the object definition class. The following example demonstrates
the declaration of a combination box column that you can use to choose
the type of merchandising association:<wcfGridComboBox propertyName="name" name="merchandisingAssocType" required="true" editable="true" text="${catalogResources.merchandisingAssociationAssocType_ColumnHeader.string}" width="120"/>Add a column that supports a combination box in a list view
(that is, users can select values for the column from a list)Add a <GridComboBox> tag. To use wcfGridComboBox, the wcfPropertyDefinition class (which
defines the options list for the property) must already be defined
in the object definition. The following example demonstrates the declaration
of a combination box column that you can use to choose the type of
merchandising association:<GridComboBox propertyName="name" name="merchandisingAssocType" required="true" editable="true" text="${catalogResources.merchandisingAssociationAssocType_ColumnHeader}" width="120"/>
What to do next
| Version | Steps |
|---|---|
|
|
|