INFOMAPS Procedure

UPDATE FILTER Statement

Updates the properties of a specified filter in the current information map.

Syntax

UPDATE FILTER "filter-ID" <options>;

Summary of Optional Arguments

specifies a conditional expression that is used to filter the data.
specifies how custom properties for the filter are updated.
specifies the description of the filter.
specifies whether to hide the filter from users of the information map.
specifies the ID of the filter to update.
specifies the name assigned to the filter in the information map.

Required Argument

"filter-ID"
specifies the ID of the filter to update.

Optional Arguments

CONDITION="conditional-expression"
specifies a conditional expression that is used to filter the data.
CUSTOM_PROPERTIES=NONE | ADD (custom-properties-list) | REMOVE (property-names-list) | <REPLACE> (custom-properties-list)
specifies how custom properties for the filter are updated. Custom properties are supported by specific SAS applications such as SAS Marketing Automation. Valid operations are the following:
NONE
removes all custom properties from the filter, if there are any.
ADD (custom-properties-list)
adds the specified custom properties to the filter.
The form of the custom-properties-list value is
("property-name-1" "property-value-1" <"description-1">)
...
("property-name-n" "property-value-n" <"description-n">)
where
property-name
specifies the name of the property.
Restriction:Property names cannot begin with an underscore (_) character.
Requirement:Property names must be unique. If a specified property name already exists in the filter, then the UPDATE FILTER statement will fail. Therefore, it is recommended that you add a prefix or suffix to the property name to ensure uniqueness.
property-value
specifies the value of the property.
description
specifies the description of the property. The description is optional.
REMOVE (property-names-list)
removes the specified custom properties from the filter.
The form of the property-names-list value is
"property-name-1" <... "property-name-n">
Interaction:If you specify both the ADD and REMOVE operations, then the REMOVE operation occurs first.
<REPLACE> (custom-properties-list)
replaces the current custom properties for the filter with the specified properties.
See the ADD operation for a description of the form of the custom-properties-list value.
Default:REPLACE (if a custom properties list is specified with no operation keyword)
DESCRIPTION="descriptive-text"
specifies the description of the filter.
Alias:DESC=
HIDDEN=YES | NO
specifies whether to hide the filter from users of the information map. By default, the filter is available to users of the information map. Specify HIDDEN=YES if you want to hide the filter from users (for example, when the filter is used as an assigned filter for a data source and therefore should not be applied again).
Default:NO
ID="filter-ID"
specifies the ID for the filter to update.
NAME="filter-name"
specifies the name assigned to the filter in the information map.

Example

update filter "ageFilter"
   condition="<<Class.Age>> = 10"
   description="Ten years old only"
   name="Age Filter";