signgroups

Specifies which groups are filtered for a particular signature.

Filtering a group means keeping or omitting all the cell items that are in the specified group.

For example, if a signgroups option specifies that the "colorcells" group should be kept, then all cells within the "colorcells" group will be signed.

Syntax

   <signgroups>
      <filter>group filter</filter>
      <groupref>group reference₁</groupref>
         ...
      <groupref>group reference_n</groupref>
   </signgroups>

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

Table 1. signgroup parameters
Parameter	Type	Description
group filter	keep	include groups of cells in the group reference list with the signature; omit those not in the list
	omit	omit groups of cells in the group reference list from the signature; include those not in the list
group reference	string	identifies a group whose cell items will be filtered

Available in

button, signature

Example

This example shows a signgroups setting that omits the group of cells named "monthlyPayCells".

   <signgroups>
      <filter>omit</filter>
      <groupref>monthlyPayCells</groupref>
   </signgroups>

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 signgroups options, 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 signgroups option. Refer to Order of precedence of filters for more information on the order of precedence of filters.