If you have only a basic knowledge of XFDL, or if you simply want to reduce the size of your form, you should use compression rather than filtering. However, if you need to reduce the size of your form further, or if the application that will receive the transmission does not need all of the form information, then use filtering.
Filtering allows you to:
- Filter out all occurrences of an item type, such as all buttons or fields.
- Filter out groups of items or datagroups.
- Filter out all occurrences of a specific property, such as all background colors or active settings.
- Filter out individual items.
- Filter out all elements in a particular namespace, such as the custom namespace.
You can set up filters on any user control (such as a button or list choice) that causes the form to be transmitted, or in an automatic action that transmits the form.
You can control what the submission button will and will not submit in one of two ways:
- Specify the items that the button will submit. This is referred to as keep filtering.
- Specify the items that the button will not submit. This is referred to as omit filtering.
The following procedure describes how to set up filtering of individual items, but filtering of groups, datagroups, namespaces, options, optionrefs, and pagerefs is done in a similar manner.
To set up filtering of individual items for a submit button:
- If you do not have the Advanced IBM Forms Designer perspective open, click Window -> Open Perspective -> Advanced IBM Forms Designer.
- In the top right corner of the Properties view, click and ensure that Show Advanced Options is checked. and ensure that Show Advanced Options is checked.
- Select the button.
- In the Properties view, expand Transmit then expand transmititemrefs.
- In the filter value field, click one of the following:
In the refs value field, click to add an itemref reference. to add an itemref reference.
In the itemref value field, type the reference to the item to keep or omit. For example :
- keep to specify items to submit.
- omit to specify items to omit.
Continue adding itemref properties to keep or omit other objects.
Parent topic: Creating XFDL Submissions
XFDL options and array elements FD 801