transmitgroups

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.

Syntax

   <transmitgroups>
      <filter>transmit flag</filter>
      <groupref>group reference₁</groupref>
      ...
      <groupref>group reference_n</groupref>
   </transmitgroups>

Note: There may be any number of group reference entries.

Table 1. transmitgroups parameters
Parameter	Type	Description
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.

   <transmitgroups>
      <filter>keep</filter>
      <groupref>countryCells</groupref>
      <groupref>departmentCells</groupref>
   </transmitgroups>

This sample specifies that all groups of cells should be kept in the transmission except for “firstNameCells” group.

   <transmitgroups> 
      <filter>omit</filter>
      <groupref>firstNameCells</groupref>
   </transmitgroups>

Usage details

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.