Add a dynamic list

The following files are created or modified by creating a dynamic list.

Files created:

Files modified:

To add a dynamic list:

  1. Create a dynamic list definition XML file that describes the frameset. Create the file, for example named newDynamicList.xml in the directory

    where component is the name of the component to which the dynamic list belongs.

    For more information, see Dynamic list definition.

  2. Register the dynamic list definition XML file in the appropriate resources.xml file. Multiple versions of this file exist, one for each component, in the following directory:

    Make an entry similar to the following code fragment in resources.xml: 

    <XML name="sampleList" file="sample/sampleList.xml"/>

    The name attribute becomes a key which will be used in a later step.

    Since the WebSphere Commerce configuration file references the resources.xml files, also update the WebSphere Commerce configuration file to register any new resources.xml files.

  3. If necessary write the JSP file and JavaScript file that define your dynamic list page. Java methods from the class com.ibm.commerce.tools.common.ui.taglibs.comm should be used to create your dynamic list table. For a list of these methods see Dynamic list Java methods.

    Your custom JSP file, myDynamicList.jsp, must include the following JavaScript files: 

    <SCRIPT SRC="/wcs/javascript/tools/common/Util.js"></SCRIPT>
<SCRIPT SRC="/wcs/javascript/tools/common/dynamiclist.js"></SCRIPT>

  4. Add your new dynamic list to a Tools User Interface Center menu system. This step is optional, depending on whether or not you want to add your dynamic list to an existing menu. To add your new dynamic list to a Tools User Interface Center menu system, for example, WebSphere Commerce Accelerator, see Integrating tools into a Tools User Interface Center for more information.

  5. Create a resource bundle adding text that appears as the title of the dialog. These files are in the following directory:

    • WC_eardir/properties/com/ibm/commerce/tools/componentname/properties

    • WCDE_installdir/properties/com/ibm/commerce/tools/componentname/properties

    where componentname is the component to which you are adding the dialog.

    If national languages are supported, create the national language resource bundles with the appropriate language text. The national language file names must end with the locale supported. For example, for a French-language resource bundle, the file name should be filename_fr_FR.properties

  6. Write context sensitive help files for your container element and panels and update a Tools User Interface Center help map XML file to include your help files. See Add context-sensitive help into a Tools User Interface Center for more information.

  7. Launch and test your dynamic list by doing the following:Stop and start WebSphere Commerce then test your new dynamic list. This is the URL of the newly created dynamic list: https://host_name:8000/webapp/wcs/tools/servlet/NewDynamicListView?ActionXMLFile=sample.sampleList&cmd=SampleListView

Related concepts

Related tasks

Related reference