DigestGrouping Element for Field (ADF)
Indicates whether the value of the notification field is considered when grouping notifications for digest delivery.
Syntax
<NotificationClasses>
<NotificationClass>
<Schema>
<Fields>
<Field>
...
<DigestGrouping>
Element Characteristics
| Characteristic | Description |
|---|---|
Data type |
Boolean. |
Default value |
false. |
Occurrence |
Optional once per Field element. |
Updates |
Can be added, deleted, and modified when updating the application. |
Element Relationships
| Relationship | Elements |
|---|---|
Parent element |
|
Child elements |
None. |
Remarks
If you are using digest delivery and you want to use a notification field to group messages, set DigestGrouping to true. For example, if a flight application sends notifications for multiple carriers, you can set DigestGrouping to true on the Carrier field so that the notifications for a carrier are grouped into a single notification.
If you are using digest delivery but you do not set DigestGrouping to true on any fields, Microsoft SQL Server 2005 Notification Services will group messages within a notification batch that have the same SubscriberId, DeviceName, and SubscriberLocale values.
Important
If you add, delete, or update a DigestGrouping element, updating the application deletes and re-creates the notification class to which it corresponds. This includes dropping and re-creating the SQL Server tables used by this notification class.
Example
The following example shows a DigestGrouping element set to true to indicate that the application uses the StockSymbol field to determine whether to group individual notifications together for digest delivery.
<Field>
<FieldName>StockSymbol</FieldName>
<FieldType>char(10)</FieldType>
<DigestGrouping>true</DigestGrouping>
</Field>
See Also
Other Resources
Defining the Notification Schema
Configuring Content Formatters
Updating Instances and Applications