Service Data Table control

By using the Service Data Table control, similar to the Table control, you can create a repeating table. The Service Data Table control must specify a service flow with Ajax access that returns the data that will be displayed in the table. For this reason, do not bind the Service Data Table to a variable.

Configuration properties

Set or modify configuration properties for the control, such as appearance, behavior, columns, and performance properties, in the Configuration properties tab.

Screen size: A configuration property that has the Screen Sizes icon beside the property name can have different values for each screen size. If you do not set a value, the screen size inherits the value of the next larger screen size as its default value. If you are using the Process Designer desktop editor, you are setting the value for the large screen size. The other screen sizes inherit this value.

Theme definitions: Theme definitions specify the colors and styles for a control and determine the appearance of the control. You can preview the look and feel of controls in the theme editor. See Themes.

The appearance configuration properties for the Service Data Table control are shown in the following table:

Table 1. Appearance configuration properties for the Service Data Table control
Appearance configuration property	Description	Data type
Table style	Set the table style to use.	`String`
Color style	Set the color style for the table.	`String`
Highlight selection	Shades rows in a selected state. This option requires that a color style other than `None` be specified.	`Boolean`
Width	The width in px, %, or em, for example 50px, 20%, or 0.4 em. If no unit is specified, px is assumed.	`String`
Height	The height of the table in px or em (not including the header or footer if shown), for example 50px or 0.4 em. If no unit is specified, px is assumed.	`String`

The behavior configuration properties for the Service Data Table control are shown in the following table:

Table 2. Behavior configuration properties for the Service Data Table control
Behavior configuration property	Description	Data type
Data service	The service flow with Ajax access to use with this control. The service flow supplies data to the table.	`Service`
Service data	Input data for the data service. Its type should match the input type for the service.	`ANY`
Start empty	The table is initially empty. The table is populated by having the service run by using the refresh method	`Boolean`
Selection mode	The table item selection mode.	`String`
Show footer	Shows the table footer.	`Boolean`
Show table stats	Shows the table statistics (for example "Showing 1 to 5 of 59 entries").	`Boolean`
Show pager	Enables pagination.	`Boolean`
Show page sizer	Enables the option to choose the number of rows to display per page.	`Boolean`
Initial page size	The initial maximum number of entries to be shown per page.	`Integer`

The columns configuration properties for the Service Data Table control are shown in the following table:

Table 3. Columns configuration properties for the Service Data Table control
Columns configuration property	Description	Data type
dataElementName	Name of the data element to display for the column.	`String`
renderAs	Select how cell should be rendered.	`String`
visibility	The visibility of the column.	`String`
sortable	If this option is enabled, users can sort the table by using this column.	`Boolean`
options	Optional data to pass to the cell, depending on the type of data in the column: `Decimal: thousandsSeparator`, `decimalPlaces`, `decimalSeparator`, `postfix`, `prefix - DatePicker: datePattern - Link: href - Integer: thousandSeparator`.	`String`
css	CSS options to add to the column, such as color:#00ff00.	`String`
width	The column width.	`String`
label	Set the column label.	`String`

The performance configuration properties for the Service Data Table control are shown in the following table:

Table 4. Performance configuration properties for the Service Data Table control
Performance configuration property	Description	Data type
Async loading	Provides a better UI experience for large data sets (at the expense of slower overall row-loading time once the section starts loading).	`Boolean`
Async batch size	Defines how many rows are loaded synchronously in an asynchronous batch. This option can help you optimize synchronous compared with asynchronous loading performance.	`ANY`

Events

Set or modify the event handlers for the control in the Events tab. You can set events to be triggered programmatically or when a user interacts with the control. For information about how to define and code events, see User-defined events.

The user does not interact with the Service Data Table control, but rather the events are activated when the user gets a result or error from the service flow call.

The Service Data Table control has the following types of event handlers:

On load: Activated when the table loads, for example:
```
me.setPageIndex(0);
```
On service data loaded: Activated when a service flow with Ajax access that supplies data to the table completes successfully, for example
```
alert("service flow has returned with data");
```
On service data error: Activated when a service flow with Ajax access that supplies data to the table completes successfully, for example
```
alert("service flow has returned with an error");
```
On custom cell: Activated when a cell loads with custom rendering options if the Render configuration value is set to Custom in the Columns section, for example
```
var div = document.createElement("div"); div.innerHTML =cell.row.data[cell.varName]; return div;
```
On rows loaded: Applicable only for paged tables, this event is activated only when rows are displayed, for example
```
alert("All rows have " + (all ? "" : "NOT") + " been loaded");
```
On rows selected by user: Activated when a row is selected by a user, for example
```
alert("Selected row has index " + row.index);
```

Methods

For detailed information about the available methods for the Service Data Table control, see the Service Data Table JavaScript API.

Additional resources

For information about how to create a coach, see Building coaches.
For information about standard properties (General, Configuration, Positioning, Visibility, and HTML Attributes), see Coach view properties.