AttributeSetFilter Command

Use the AttributeSetFilter command in a Logic Template to filter out records that do or do not have set, a specified attribute within the specified attribute array.

An attribute array consists of anywhere from 1 to 64 consecutive attribute containers. Each attribute container contains 32 individual binary attributes, assigned 1 through 32 for the first container, 33 through 64 for the second container, and so on. Each attribute has only two possible values, 0 or 1. If the specified attribute has a value of 1, the attribute is set. If the attribute has a value of 0, the attribute is not set.

To handle uninitialized data, an attribute array with no attributes set ( ie: all attributes equal to 0 ) can be treated as a special case by setting the process flag to drop within the command. Setting the process flag to drop indicates records with attribute arrays with no attributes set are to be discarded. Setting the flag to keep indicates records with attribute arrays with no attributes set are to be passed through regardless of whether or not they match the filter criteria. Not setting the flag indicates that records with attribute arrays with no attributes set are not to be given any special consideration.

To execute a Attribute Set filter request, use the AttributeSetFilter command with three or four arguments:

AttributeSetFilter( fc, list, id ); or AttributeSetFilter( fc, list, id, flag );

AttributeSetFilter Arguments

Argument

Description

fc

The funcition code or type of filter to be requested.

list

The name of the data field, within each record containing the attribute list to be tested.

id

The name of the HTML variable containing the ID of the attribute to be tested.

flag

Indicate ( drop or keep ) special processing for records with no attributes set in all of list.

Access the AttributeSetFilter Dialog Box by selecting Attributes->Attribute Set menu item under the Filtering category of the Logic Template editor command menu.

Examples

Command

Description

AttributeSetFilter( ON, Class, AttributeID );

Pass records with the attribute identified by the ID in the HTML variable "AttributeID" set within the attribute list contained within the field "Class".

AttributeSetFilter( ON, Class, AttributeID, keep );

Pass records with no attributes or the attribute identified by the ID in the HTML variable "AttributeID" set within the attribute list contained within the field "Class".

AttributeSetFilter( OFF, Class, AttributeID );

Reject records with the attribute identified by the ID in the HTML variable "AttributeID" set within the attribute list contained within the field "Class".

AttributeSetFilter( OFF, Class, AttributeID, drop );

Reject records with no attributes or the attribute identified by the ID in the HTML variable "AttributeID" set within the attribute list contained in the field "Class".