Class Reference
%iKnow.Queries.PathWSAPI
Server:appadmin-00044-deployment-6bf4cbc86d-9f4xc
Instance:IRIS
User:SuperUser
 
-
  [USER] >  [%iKnow] >  [Queries] >  [PathWSAPI]
Private  Storage

deprecatedclass %iKnow.Queries.PathWSAPI extends %iKnow.Queries.AbstractWSAPI

This is an automatically generated class, offering a functionally equivalent set of methods and queries as %iKnow.Queries.PathAPI, exposed as WebMethod methods.

See the classdocs for %iKnow.Queries.PathAPI for more information.

Inventory

Parameters Properties Methods Queries Indices ForeignKeys Triggers
3 14


Summary

Properties
AddressingIn AddressingOut Attachments Base64LineBreaks
BodyId BodyXmlId ContentId ContentLocation
FaultAddressing FaultHeaders HeadersIn HeadersOut
ImportHandler IsMTOM Location MTOMRequired
MsgClass OutputTypeAttribute Password RMSession
ReferencesInline RequestMessageStart ResponseAttachments ResponseContentId
ResponseContentLocation SAXFlags SecurityContextToken SecurityIn
SecurityNamespace SecurityOut SessionCookie SoapFault
SoapVersion Timeout Transport Username
WriteSOAPBodyMethod

Methods
%AddEnvelopeNamespace %AddToSaveSet %ClassIsLatestVersion %ClassName
%ConstructClone %DispatchClassMethod %DispatchGetModified %DispatchGetProperty
%DispatchMethod %DispatchSetModified %DispatchSetMultidimProperty %DispatchSetProperty
%Extends %GetParameter %IsA %IsModified
%New %NormalizeObject %ObjectModified %OnCreateRMSession
%OriginalNamespace %PackageName %RemoveFromSaveSet %SerializeObject
%SetModified %ValidateObject ConvertParameter Decrypt
Encrypt EscapeHTML EscapeURL FileWSDL
GetAttributes GetBodyId GetByEntities GetByEntityIds
GetBySource GetCountByDomain GetCountByEntities GetCountByEntityIds
GetCountBySource GetEntities GetId GetSentenceId
GetSourceId GetValue HyperEventCall HyperEventHead
Include Initialize InsertHiddenField InsertHiddenFields
IsPrivate Link MakeFault MakeFault12
MakeSecurityFault MakeStatusFault NormalizeName OnCancelSecureConversation
OnPageError OnPostHTTP OnPostHyperEvent OnPostWebMethod
OnPreHyperEvent OnPreWebMethod OnRequestMessage OnSOAPRequest
OnStartSecureConversation Page Process ProcessBinary
ProcessBody ProcessBodyNode QuoteJS Reset
ReturnFault ReturnOneWay RewriteURL SOAPLogContains
ShowError StartTimer StopTimer ThrowError
UnescapeHTML UnescapeURL WSAddSignatureConfirmation


Parameters

• parameter NAMESPACE = "http://www.intersystems.com/iKnow/Queries/PathWSAPI";
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 SERVICENAME = "iKnow.Queries.PathWSAPI";
SERVICENAME - Should be the name of the service for which this is a proxy. Override this parameter in the subclass.
• parameter USECLASSNAMESPACES = 1;
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.

Methods

• classmethod GetAttributes(pDomainId As %Integer, pPathId As %Integer, vSrcId As %Integer = 0) as %XML.DataSet [ WebMethod ]

Returns all attributes for a given path. Any named attribute properties are also included through sub-nodes (not available through SQL or SOAP):

pResult(rowNumber, propertyName) = propertyValue

Please note this query only returns path-level attributes and not those attributes applying to individual entities or words within entities. To retrieve these, use GetOccurrenceAttributes in %iKnow.Queries.EntityAPI.

• classmethod GetByEntities(domainid As %Integer, entitylist As %ListOfDataTypes, page As %Integer = 1, pagesize As %Integer = 10, filter As %String(MAXLEN=32767)="", setop As %Integer = $$$UNION, pActualFormOnly As %Boolean = 0) as %XML.DataSet [ WebMethod ]

This method will return all Paths containing any (if setop = $$$UNION) or all (if setop = $$$INTERSECT) of the entities in the supplied entitylist.

The scope of this query can be limited through supplying a %iKnow.Filters.Filter object for the filter parameter to restrict the result to those Paths occurring in any source satisfying the filter criteria.

Results are sorted by decreasing path ID.

If stemming is enabled for this domain through $$$IKPSTEMMING, paths containing any actual form of the entities in entitylist will be returned. Use pActualFormOnly=1 to retrieve only those paths containing the actual forms in entitylist. This argument is ignored if stemming is not enabled.

• classmethod GetByEntityIds(domainid As %Integer, entityidlist As %ListOfDataTypes, page As %Integer = 1, pagesize As %Integer = 10, filter As %String(MAXLEN=32767)="", setop As %Integer = $$$UNION, pActualFormOnly As %Boolean = 0) as %XML.DataSet [ WebMethod ]

Retrieves paths based on entity IDs.

See also GetByEntities for a description of the parameters.

• classmethod GetBySource(domainid As %Integer, sourceidlist As %ListOfDataTypes, page As %Integer = 1, pagesize As %Integer = 10) as %XML.DataSet [ WebMethod ]

Retrieves the paths appearing in any of the sources supplied through sourceidlist.

To get the paths of a virtual source, only a single virtual source can be supplied using its negative ID value (otherwise, -1 is returned).

• classmethod GetCountByDomain(domainid As %Integer, filter As %String(MAXLEN=32767)="") as %Library.Integer [ WebMethod ]

Returns the number of paths in a domain, optionally restricted to those appearing in a source satisfying the %iKnow.Filters.Filter object supplied through filter.

• classmethod GetCountByEntities(domainid As %Integer, entitylist As %ListOfDataTypes, filter As %String(MAXLEN=32767)="", setop As %Integer = $$$UNION, pActualFormOnly As %Boolean = 0) as %Library.Integer [ WebMethod ]

Retrieves the number of paths containing the specified entities.

See also GetByEntities for a description of the parameters.

• classmethod GetCountByEntityIds(domainid As %Integer, entityidlist As %ListOfDataTypes, filter As %String(MAXLEN=32767)="", setop As %Integer = $$$UNION, pActualFormOnly As %Boolean = 0) as %Library.Integer [ WebMethod ]

Retrieves the number of paths containing the specified entity IDs.

See also GetByEntities for a description of the parameters.

• classmethod GetCountBySource(domainid As %Integer, sourceidlist As %ListOfDataTypes) as %Library.Integer [ WebMethod ]

Returns the total number of paths in the sources specified through sourceidlist. Use negative source IDs to refer to virtual sources.

• classmethod GetEntities(domainId As %Integer, pathId As %Integer, vSrcId As %Integer = 0) as %XML.DataSet [ WebMethod ]

Returns a detailed overview of the entities pathId consists of, including their unique and occurrence IDs, positions, roles and literal value.

The last two columns will only contain data if stemming is enabled for this domain through the $$$IKPSTEMMING domain parameter.

• classmethod GetId(domainid As %Integer, entityList As %ListOfDataTypes, vSrcId As %Integer = 0) as %Library.Integer [ WebMethod ]

This method will try to find a path corresponding to the supplied list of entities in the specified order. If no path is found, "" is returned.

When specifying a Virtual Source ID, it will treat the path as a virtual one, in the context of that vSrcId.

• classmethod GetSentenceId(domainId As %Integer, pathId As %Integer, vSrcId As %Integer = 0) as %Library.Integer [ WebMethod ]
Returns the sentence ID in which the supplied path ID occurs
• classmethod GetSourceId(domainId As %Integer, pathId As %Integer) as %Library.Integer [ WebMethod ]
Returns the source ID in which the supplied path ID occurs
• classmethod GetValue(domainid As %Integer, pathid As %Integer, vSrcId As %Integer = 0, pUseStems As %Boolean = 0) as %Library.List [ WebMethod ]

Returns the sequence of entity values corresponding to the specified path as a %List.

When specifying a Virtual Source ID, it will treat the pathId as a virtual one, in the context of that vSrcId.

If stemming is enabled for this domain through the $$$IKPSTEMMING domain parameter, you can use pUseStems=1 to get the stems rather than the entities for this path.



Copyright (c) 2025 by InterSystems Corporation. Cambridge, Massachusetts, U.S.A. All rights reserved. Confidential property of InterSystems Corporation.