transmitoptions

Specifies types of options that are filtered for a particular transmission.

Filtering options means keeping or omitting all options of a particular type, rather than individual items (see transmititemrefs).

Syntax

   <transmitoptions>
      <filter>transmit flag</filter>
      <optiontype>option type₁</optiontype>
      ...
      <optiontype>option type_n</optiontype>
   </transmitoptions>

Note: There may be any number of option type entries.

Table 1. transmitoptions parameters
Parameter	Type	Description
transmit flag	keep	include types of options in the option type list with the transmission; omit those not in the list
	omit	omit types of options in the option type list from the transmission; include those not in the list
option type	string	specifies the type (element tag name) of options to be filtered

Available in

action, button, cell

Example

This sample specifies that only the active, mimedata, and value options should be included in the form data submitted to the form processing application.

   <transmitoptions>
      <filter>keep</filter>
      <optiontype>active</optiontype>
      <optiontype>mimedata</optiontype>
      <optiontype>value</optiontype>
   </transmitoptions>

Usage details

Default: keep all options (omit nothing), unless the containing item is omitted.
Element tag names can be specified with or without a namespace prefix. The default namespace URI is the XFDL namespace URI if no namespace prefix is given. If a namespace prefix is given, then the namespace URI to which the prefix is bound is used in determining whether or not each element matches the given filter component.
For example, the filter component <optiontype>triggeritem</optiontype> could be equivalently written as <optiontype>xfdl:triggeritem</optiontype> if the prefix xfdl is mapped to the XFDL namespace URI.
Other filters may take precedence over the transmitoptions option. Refer to Order of precedence of filters for more information on the order of precedence of filters.