transmitgroupsAdded by IBM on October 10, 2012 | Version 1 (Original)
|Specifies which groups are filtered for a particular transmission.
Filtering a group means keeping or omitting all the cell items that are in the specified group.
For example, if a transmitgroups option specifies that the "colorcell" group should be kept, then all cells within the "colorcell" group will be transmitted.
Note: There may be any number of group reference entries.
Table 1. transmitgroups parameters
|transmit flag||keep||include groups of cells in the group reference list with the transmission; omit those not in the list|
|omit||omit groups of cells in the group reference list from the transmission; include those not in the list|
|group reference||string||identifies a group whose cell items will be filtered|
Available in action, button, cell
Examples This sample specifies that only the items in the "countryCells" and "departmentCells" groups should be kept in the transmission.
This sample specifies that all groups of cells should be kept in the transmission except for "firstNameCells" group.
- Default: omit nothing (keep all cell items), unless the containing page is omitted.
- It is possible to have several list or popup items with the same group reference, as these are populated with cells that have the same group reference as the item which contains them. Therefore, when setting up a transmitgroups option, caution must be exercised in making group references to list or popup items which might be populated by the same group of cells.
- Other filters may take precedence over the transmitgroups option. Refer to Order of precedence of filters for more information on the order of precedence of filters.