Preparing to use the Content List widget
To enable users to use the Content List widget, you must add the widget to a
page. You then must edit the settings for the Content List widget to indicate how the list of
documents is to be generated and, optionally, to configure a pop-up menu.
About this task
You can configure the Content List widget to retrieve
a list of documents in one of the following ways:
- By using a property list
- The property list contains the IDs of the documents that are to be listed in the Content List widget. To use a property list, you must first create a custom widget that publishes a Display documents event that contains the document IDs.
- By running a stored search
- A stored search is a file that contains the search criteria for retrieving the documents. You can create a stored search by creating and saving a search in IBM® Content Navigator..
- By passing criteria to a stored search and then running the search
- You can wire the Content List widget to substitute values in the
stored search criteria. If you do, the widget retrieves and displays
documents based on data that it receives from a published event.
For example, you can configure the Content List widget to substitute
the criteria values that are defined in the stored search. You can
substitute these values with work item field values that are published
by the In-basket widget or Step Completion widget. You can also substitute
values with key-value pairs that are published by a custom widget.
If you want to substitute search criteria with event data at run time, you must set the stored search criteria as editable conditions. If you do not wire the Content List widget to substitute stored search criteria, the widget retrieves documents based on the predefined search criteria.
Restriction: The Content List widget does not support certain MIME types that are
specific to Workplace and
Workplace XT. The widget does not
display these document classes correctly and, as a result, users might encounter errors when they
open the documents. To avoid these errors, use a property list or a stored search that excludes the
following MIME types:
- Entry templates
- application/x-filenet-customobjectentrytemplate
- IBM Enterprise Records records
- application/x-filenet-rm-electronicrecord
- Search templates
- application/x-filenet-search
- Workflow-related files
- application/x-filenet-scenariodefinition
This topic is shared by BAW, CP4BA. Last updated on 2025-03-13 12:15