signdatagroups

Specifies which datagroups are filtered for a particular signature.

Filtering a datagroup means keeping or omitting all of the data items that are in the specified datagroup.

For example, if a signdatagroups option specifies that the "attachments" datagroup should be kept, then all data items within the "attachments" group will be signed.

This filter applies to all data items present at the time of signing, including those added as enclosures.

Syntax

   <signdatagroups>
      <filter>datagroup filter</filter>
      <datagroupref>datagroup reference₁</datagroupref>
         ...
      <datagroupref>datagroup reference_n</datagroupref> 
   </signdatagroups>

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

Table 1. signdatagroups parameters
Parameter	Type	Description
datagroup filter	keep	include datagroups in the datagroup reference list with the signature; omit those not in the list
	omit	omit datagroups in the datagroup reference list from the signature; include those not in the list
datagroup reference	string	identifies a datagroup whose data items will be filtered

Available in

button, signature

Example

This example specifies a signdatagroups option that keeps the datagroup called “Business_Letters”.

   <signdatagoups>
      <filter>keep</filter>
      <datagroupref>Business_Letters</datagroupref>
   </signdatagroups>

Usage details

Default: omit nothing (keep all data items), unless the containing page is omitted
Since enclosed files can belong to several datagroups, and datagroups can contain several enclosed files, care must be exercised when setting up signdatagroups options to ensure that only the desired datagroups are filtered.
Other filters may take precedence over the signdatagroups option. Refer to Order of precedence of filters for more information on the order of precedence of filters.