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.
- 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).
- 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";
Copyright © SAS Institute Inc. All rights reserved.