InterSystems IRIS Data Platform 2020.4 > Class Reference > %SYS namespace > %iKnow.Filters.FilterWSAPI


class %iKnow.Filters.FilterWSAPI extends %SOAP.WebService

This class offers a Web Service access point to iKnow filters. Use the CreateAsString() and CreateGroupAsString() Web Services to generate the string representations of %iKnow.Filters.Filter objects that can then be passed on to the iKnow Query Web Service APIs.

Method Inventory


parameter NAMESPACE =;
Inherited description: NAMESPACE - Should be an unique URI Override this parameter in the subclass with the unique namespace URI of your organization. Override this parameter in the subclass.
parameter SECURITYRESOURCE = %Development;
Inherited description: This is a comma-delimited list of system Resources and associated permissions. A user must hold the specified permissions on all of the specified resources in order to view this page.
The format of each item in the list should be as follows:
Permission is optional, and defaults to USE if not supplied. If it is supplied, it should be one of USE, READ or WRITE. You can also specify or grouping using the '|' character, so 'R1,R2|R3,R3|R4' means you must have resource R1 and one of R2 or R3 and one of R3 or R4. So if you have R1,R3 it will pass, if you have R1,R4 it will not as it does not meet the R2|R3 condition. So the '|' or condition takes precedence over the ',' and condition.
parameter SERVICENAME = iKnow.Filters.FilterWSAPI;
Inherited description: SERVICENAME - Should be the name of the service for which this is a proxy. Override this parameter in the subclass.
Inherited description: When USECLASSNAMESPACES = 1, then the WSDL of the Web service reflects the namespaces defined for the referenced classes by the NAMESPACE parameters of those classes. The default, for compatibility with previous versions, is that the NAMESPACE parameters of the referenced classes are ignored when creating the WSDL. If USECLASSNAMESPACES has no value, then the default value from ^ISCSOAP("USECLASSNAMESPACES") is used.


classmethod ClearCachedFilter(domainId As %Integer, filterId As %Status) as %Status [ Language = objectscript, WebMethod ]

Clears a specific filter from the persistent filter cache, if it exists.

classmethod ClearCachedFilters(domainId As %Integer) as %Boolean [ Language = objectscript, WebMethod ]

Clears all filters from the persistent filter cache.

classmethod CreateAsString(filterName As %String, filterParams As %ListOfDataTypes) as %String [ Language = objectscript, WebMethod ]

This WebMethod is an access point to generate the string representation (as specified in ToString()) for %iKnow.Filters.Filter classes, accessible from Web Service scenarios.

When calling this method, you should supply the Filter Parameters as if calling the %New() method of this particular Filter implementation.

classmethod CreateGroupAsString(domainId As %Integer, groupLogic As %Integer = $$$GROUPFILTERAND, negated As %Boolean = 0, filters As %ListOfDataTypes) as %String [ Language = objectscript, WebMethod ]

This class enables Web Service users to create the string representation of a %iKnow.Filters.GroupFilter composed of multiple subfilters passed in using their respective string representations as the filters... parameter.

Inherited Members

Inherited Properties

Inherited Methods