Dynamic Table Portlet

Portlet Title	Dynamic Table
Portlet Name	wm_table
Portlet File Name	wm_table.pdp
Top-level Folder	system
JSR168 Portlet?	No
Alias	portlet.table
Default Instances of the portlet	None

System. Page developers using My webMethods Server version 6.x can use this portlet to display data in a table. For My webMethods Server version 7.x and later, use the Table controls that the webMethods CAF framework provides.

Page developers can embed the Dynamic Table portlet into a custom portlet using the <portlet:portlet> JSP tag, and then configure the datasource of the data to display in the table.

Alternatively, page developers can publish the Dynamic Table portlet as a standalone portlet and configure it to use My webMethods Server commands or wiring to provide the data to display.

If a page developer specifies more than one data property, the order of precedence is as listed in the following table:

Data Property	Precedence
command	Overrides all other properties.
sliceCommand	Overrides listCommand, slice, and list.
listCommand	Overrides slice and list.
slice	Overrides list.
list	No override applies.

Identifies unsorted, unpaged data to display in the table. Specify the data using a list (java.util.List), array, comma-separated values (CSV) string, or XML Document Object Model (DOM) node.

To identify the data to display in the table, you should specify this List (list) property, the List Command (listCommand) property, the Slice (slice) property, or the Slice Command (sliceCommand) property. If none of these properties have values, the table will be empty.

Identifies unsorted, unpaged data to display in the table. Specify a My webMethods Server command to invoke to produce the data to display. When you use this property, you can also specify:

Resource (resource) property to identify a My webMethods Server resource against which to execute the command

Identifies the sorted and paged data slice to display in the table. Specify the data using a list (java.util.List), array, comma-separated values (CSV) string, or XML Document Object Model (DOM) node.

To identify the data to display in the table, you should specify this Slice (slice) property, the List Command (listCommand) property, or the Slice Command (sliceCommand) property. If none of these properties have values, the table will be empty.

Identifies sorted and paged data slice to display in the table. Specify a My webMethods Server command to invoke to produce the data to display. When you use this property, you can also specify:

Resource (resource) property to identify a My webMethods Server resource against which to execute the command

To identify the data to display in the table, you should specify this Slice Command (sliceCommand) property, the List (list) property, the List Command (listCommand) property, or the Slice (slice) property. If none of these properties have values, the table will be empty.

Identifies the My webMethods Server resource against which to execute the command specified in the List Command (listCommand) or Slice Command (sliceCommand) property. Specify the thingID or alias of the resource.

If you specify the Portlet (portlet) property, it is used instead of this property. If neither this property nor the Portlet (portlet) property has a value, the List Command or Slice Command is invoked without a specific resource.

This property is ignored if you do not specify the List Command (listCommand) or Slice Command (sliceCommand) property.

Identifies the portlet to use for paging and sorting controls when the Dynamic Table portlet is used inside another legacy portlet. Specify the thingID or alias of the portlet. If the property has no value, it defaults to this portlet's thingID.

Identifies parameters to use with the command specified in the List Command (listCommand) or Slice Command (sliceCommand) property. Specify the parameters in the form of URL parameters, for example, paramOne=valueOne&paramTwo=valueTwo. If this property has no value, the command is executed with no additional parameters.

This property is ignored if you do not specify the List Command (listCommand) or Slice Command (sliceCommand) property.

Defines the titles, or headers, to use for the columns in the table. Specify a comma-separated list of titles. For example, for a table with four columns you might specify:

Defines the sort keys to use for each column of the table. A sort key is a property to use for sorting. Specify a comma-separated list of sort keys. If you do not specify a sort key for a column, that column is not sortable. For example, for a table with four columns you might specify the following where the third column is not sortable:

Defines the values to specify in each column. Specify a comma-separated list of the properties to display in each column. For example, for a table with four columns you might specify:

Defines how to link the data displayed in each column of the table. Specify a comma-separated list of links. If you do not specify a link for a column, the data in that column is displayed without a link. For example, for a table with four columns you might specify the following where only the first and second columns are linked:

Defines the tooltips for each column's value. Specify a comma-separated list of text to use for tooltips. For example, for a table with four columns you might specify the following where only the second and third columns have tooltips:

Defines the alignment to use for each column. Specify a comma-separated list of alignment values. For alignment values, you can specify the following left, right, centered, or specify nothing if you want to use the default value. The default alignment value is left. For example, for a table with four columns you might specify the following:

Defines the width of each column. Specify a comma-separated list of widths using either a percentage of the table or pixel value. For example, for a table with four columns you might specify:

If the property has no value, column widths are determined by the client browser, based on the amount of content in each column.

Defines whether to wrap the data in each column. Specify a comma-separated list of wrap values. For wrap values:

Defines how to select a row. Specify a row property to use for a selection key. For example, to select a row using its ID property, specify {ID}. If the property has no value, the rows of the table will not be selectable. A row is selected if its property value matches a value in the Selection (selection) property.

Identifies the values to use for selecting table rows. Specify a list of selection values. If the property has no value, no table rows are selected by default.

For example, if you specify {ID} for Selected (selected) and 1,3,5 for Selection (selection), the rows with ID property value of 1, 3, or 5 are selected.

Indicates whether end users can select rows in the table. Specify one of the following:

Indicates whether end users can select multiple rows in the table at one time. Specify one of the following:

The order of precedence between allowMultipleSelection and allowSelection is described in the following table:

	allowMultipleSelection = false	allowMultipleSelection = true
allowSelection = false	Users cannot select any rows.	Users can select multiple rows at a time.
allowSelection = true	Users can select one row at a time.	Users can select multiple rows at a time.

Defines the index of the first table row to display. Specify the index number, which is one-based; that is, specify 1 to display row one of the table. If the property has no value, it defaults to 1.

Defines the number of rows to display per page. Specify a whole number that is one or greater. If the property has no value, the portlet determines the number of items to display per page from the user preferences in the User Profile; the default user preference value is 10.

Defines how to sort the table data. Specify the row property on which to sort. For example, to sort the table by the ID property, specify {ID}. If the property has no value, the table data is not sorted.

Defines the order in which to sort the table data. Specify one of the following:

Defines the query string that the table's datasource should use to generate the table data. The value you specify depends on the datasource. If the property has no value, a query string is not used. Note that most datasources do not require or use a query string.

Defines the namespace to use for the paging cookie and/or paging links. Specify an arbitrary string to identify the namespace. If the property has no value, a special namespace is not used.

Defines the display style for the table. Specify one of the following:

standard – Default. Displays the table in the standard My webMethods Server table style.

condensed – Displays the table slightly condensed, depending on the skin that is used.

Indicates whether to display column headers. Specify one of the following:

Indicates whether to display the paging footer for the table. Specify one of the following:

Indicates whether to display the total number of rows in the table. Specify one of the following:

Indicates whether to display the total number of selected rows in the table. Specify one of the following:

Indicates whether to display links to individual pages, (for example, ... 4 5 6 7 8 9 10 11 12 13 ...). Specify one of the following:

Indicates whether to display an empty message in the table contents when there is no table data to display. Specify one of the following:

false – Display nothing in the table contents when there is no table data to display.

The default empty message is "Empty". If you want to display alternative text, use the emptyMessage property.

Defines a set of alternate column headers to use when the table is exported. If you specify a value for this property, when the table is exported, the export uses the textTitles values in place of the column titles defined by the Titles (titles) property. Specify a comma-separated list of column titles, for example:

You can use this property in conjunction with the textValues property to export a different set of columns than are normally displayed for the table.

If the property has no value, when the table is exported, the column titles defined by the Titles (titles) property are used.

Defines a set of alternate column values to use for a table export. If you specify a value for this property, when the table is exported, the values you define with the textValues property are exported rather than the values defined by the Values (values) property. Specify a comma-separated list of properties for example:

You can use this property in conjunction with the textTitles property to export a different set of columns than are normally displayed for the table.

If the property has no value, when the table is exported, the values defined by the Values (values) property are exported.

Identifies alternate values to use for selecting table rows. Specify a list of selection values.

If you specify a value for this property, for example, "mySelectionProperty", the portlet uses the property with the specified name to determine the selected rows instead of the Selection (selection) property. If the property has no value, the Selection (selection) property is used.

Identifies client-side JavaScript to invoke when an end user selects or deselects a row. Specify the name of the JavaScript onchange handler. If the property has no value, custom JavaScript is not invoked when a table row selection changes.

Identifies a paging cookie to use instead of the values in the Start (start), Sort Key (sort), Sort Order (order), and Query String (queryString) properties. Specify the name of the paging cookie.

If the property has no value, a paging cookie is automatically generated and populated with the values specified in the Start (start), Sort Key (sort), Sort Order (order), and Query String (queryString) properties.

Indicates whether to submit the form containing the table (with a void portlet-controller method) when an end user selects a paging link. Specify one of the following:

true – Submit the form (with a void pca method) when an end user selects a paging link.

false – Default. Use regular paging links when an end user selects a paging link.

Defines the empty message. Specify the text to display in the table contents when there is no table data to display. The portlet uses the emptyMessage when the Show Empty (showEmpty) property is true. If the emptyMessage property has no value, the empty message defaults to Empty.

Indicates whether to display the Export Table button. Specify one of the following:

Indicates whether to show paging information in the table header or the table footer. Specify one of the following:

true – Display the total number of rows, total selected rows, and the Export Table button in the table header.

false – Default. Display the total number of rows, total selected rows, and the Export Table button in the table footer.

Note that the paging items displayed also depend on the values of the Show Total (showTotal), Show Total Selection (showTotalSelection), and showExport properties. The values of these properties must be true for the corresponding information to be displayed in the table header or table footer.

Indicates that you want to group rows into categories and defines how to categorize the rows. Specify the row property to use to categorize the table rows. All the rows that have the same value for the row property you specify will be in the same category. For example, to categorize rows by their priority property, specify {priority}. If the categorized property has no value, the portlet does not categorize rows.