transmititemrefs

Specifies individual items that are filtered for a particular transmission.

Filtering item references means keeping or omitting individual items, rather than all items of a particular type (see transmititems).

Syntax

   <transmititemrefs>
      <filter>transmit flag</filter>
      <itemref>item reference₁</itemref>
      ...
      <itemref>item reference_n</itemref>
   </transmititemrefs>

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

Table 1. transmititemrefs parameters
Parameter	Type	Description
transmit flag	keep	include items in the item reference list with the transmission; omit those not in the list
	omit	omit items in the item reference list from the transmission; include those not in the list
item reference	string	identifies the item to be filtered

Available in

action, button, cell

Examples

This sample specifies that only the item on page1 called “MgrSignButton” should be transmitted, and that all other items should be omitted.

   <transmititemrefs>
      <filter>keep</filter>
      <itemref>page1.MgrSignButton</itemref>
   </transmititemrefs>

This sample shows how you would use transmititemrefs in conjunction with transmititems: although all items that are buttons are omitted, the button on page1 called “MgrSignButton” will be kept.

   <transmititems>
      <filter>omit</filter>
      <itemtype>button</itemtype>
   </transmititems>
   <transmititemrefs>
      <filter>keep</filter>
      <itemref>page1.MgrSignButton</itemref>
   </transmititemrefs>

Usage details

Default: omit nothing (keep all items), unless the containing page is omitted
Other filters may take precedence over the transmititemrefs option. Refer to Order of precedence of filters for more information on the order of precedence of filters.