Parameters	Properties	Methods	Queries	Indices	ForeignKeys	Triggers
3		24

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

Methods
%%OIDGet	%AddToSaveSet	%ClassIsLatestVersion	%ClassName
%ConstructClone	%DispatchClassMethod	%DispatchGetModified	%DispatchGetProperty
%DispatchMethod	%DispatchSetModified	%DispatchSetMultidimProperty	%DispatchSetProperty
%Extends	%GetParameter	%IsA	%IsModified
%New	%NormalizeObject	%ObjectModified	%OriginalNamespace
%PackageName	%RemoveFromSaveSet	%SerializeObject	%SetModified
%ValidateObject	ConvertParameter	Decrypt	Encrypt
EscapeHTML	EscapeURL	FileWSDL	GetBodyId
GetByCrcIds	GetByCrcMask	GetByCrcs	GetByDomain
GetByEntities	GetByEntityIds	GetByEquivalentIds	GetByEquivalents
GetByPathIds	GetCountByCrcIds	GetCountByCrcMask	GetCountByCrcs
GetCountByDomain	GetCountByEntities	GetCountByEntityIds	GetCountByPathIds
GetExternalId	GetFullReference	GetLanguages	GetSimilar
GetSourceId	GetSummary	GetSummaryDirect	GetTopLanguage
HyperEventBody	HyperEventCall	HyperEventFrame	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	SecurityOutGet
SecurityOutSet	ShowError	StartTimer	StopTimer
ThrowError	TimeoutSet	UnescapeHTML	UnescapeURL
WSAddSignatureConfirmation

• parameter NAMESPACE = "http://www.intersystems.com/iKnow/Queries/SourceWSAPI";

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.SourceWSAPI";

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.

• classmethod GetByCrcIds(domainid As %Integer, crcidlist As %ListOfDataTypes, page As %Integer = 1, pagesize As %Integer = 10, filter As %String = "", setop As %Integer = $$$UNION) as %XML.DataSet [ WebMethod ]

Retrieves all sources containing the given CRC ids.

See also GetByEntities for a description of the parameters.

• classmethod GetByCrcMask(domainid As %Integer, master As %String = $$$WILDCARD, relation As %String = $$$WILDCARD, slave As %String = $$$WILDCARD, page As %Integer = 1, pagesize As %Integer = 10, filter As %String = "") as %XML.DataSet [ WebMethod ]

Retrieves all sources containing a CRC satisfying the given CRC Mask.

See also GetByEntities for a description of the parameters.

• classmethod GetByCrcs(domainid As %Integer, crclist As %ListOfDataTypes, page As %Integer = 1, pagesize As %Integer = 10, filter As %String = "", setop As %Integer = $$$UNION) as %XML.DataSet [ WebMethod ]

Retrieves all sources containing the given CRCs.

See also GetByEntities for a description of the parameters.

• classmethod GetByDomain(domainid As %Integer, page As %Integer = 1, pagesize As %Integer = 10, filter As %String = "") as %XML.DataSet [ WebMethod ]

Returns a list of all sources within a domain, optionally filtered through a %iKnow.Filters.Filter object passed in as filter.

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

This method will retrieve all sources containing any (if = $$$UNION) or all (if = $$$INTERSECT) of the entities supplied through 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 sources satisfying the filter criteria.

Results are ordered by decreasing source id.

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

Retrieves all sources containing the given entity ids.

See also GetByEntities for a description of the parameters.

• classmethod GetByEquivalentIds(domainid As %Integer, entityidlist As %ListOfDataTypes, setid As %Integer, page As %Integer = 1, pagesize As %Integer = 10, filter As %String = "") as %XML.DataSet [ WebMethod ]

• classmethod GetByEquivalents(domainid As %Integer, entitylist As %ListOfDataTypes, setid As %Integer, page As %Integer = 1, pagesize As %Integer = 10, filter As %String = "") as %XML.DataSet [ WebMethod ]

• classmethod GetByPathIds(domainid As %Integer, pathidlist As %ListOfDataTypes, page As %Integer = 1, pagesize As %Integer = 10, filter As %String = "") as %XML.DataSet [ WebMethod ]

Retrieves all sources containing the given path ids.

See also GetByEntities for a description of the parameters.

• classmethod GetCountByCrcIds(domainid As %Integer, crcidlist As %ListOfDataTypes, filter As %String = "", setop As %Integer = $$$UNION) as %Library.Integer [ WebMethod ]

Retrieves the number of sources containing the given CRC ids.

See also GetByEntities for a description of the parameters.

• classmethod GetCountByCrcMask(domainid As %Integer, master As %String = $$$WILDCARD, relation As %String = $$$WILDCARD, slave As %String = $$$WILDCARD, filter As %String = "") as %Library.Integer [ WebMethod ]

Retrieves the number of sources containing a CRC satisfying the given CRC Mask.

See also GetByEntities for a description of the parameters.

• classmethod GetCountByCrcs(domainid As %Integer, crclist As %ListOfDataTypes, filter As %String = "", setop As %Integer = $$$UNION) as %Library.Integer [ WebMethod ]

Retrieves the number of sources containing the given CRCs.

See also GetByEntities for a description of the parameters.

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

This method returns the total number of sources in the specified domain, optionally filtered through a %iKnow.Filters.Filter object passed in as filter.

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

Retrieves the number of sources containing the given entities.

See also GetByEntities for a description of the parameters.

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

Retrieves the number of sources containing the given entity ids.

See also GetByEntities for a description of the parameters.

• classmethod GetCountByPathIds(domainid As %Integer, pathidlist As %ListOfDataTypes, filter As %String = "") as %Library.Integer [ WebMethod ]

Retrieves the number of sources containing the given path ids.

See also GetByEntities for a description of the parameters.

• classmethod GetExternalId(domainid As %Integer, srcId As %Integer) as %Library.String [ WebMethod ]

Retrieves the external ID for the source identified by srcId.

A negative srcId is considered to refer to a Virtual Source.

• classmethod GetFullReference(domainId As %Integer, srcId As %Integer) as %Library.String [ WebMethod ]

Retrieves the Full Reference for the source identified by srcId.

A negative srcId is considered to refer to a Virtual Source.

• classmethod GetLanguages(domainid As %Integer, sourceid As %Integer) as %XML.DataSet [ WebMethod ]

This method returns, for a given source, the list of languages the iKnow Automatic Language Identification algorithm has identified for the sentences it contains. For each language, it will list the sum of ALI confidence ratings when assigning the language to a sentence, plus the total number of sentences the language was assigned to. If ALI was disabled when indexing this source, confidence ratings will be set to 0.

A negative Source ID is interpreted as a Virtual Source.

• classmethod GetSimilar(domainid As %Integer, sourceid As %Integer, page As %Integer = 1, pagesize As %Integer = 10, filter As %String = "", algorithm As %String = $$$SIMSRCSIMPLE, algorithmParams As %ListOfDataTypes = "", blackListIds As %ListOfDataTypes = "") as %XML.DataSet [ WebMethod ]

Retrieves those sources that have similar content to the one specified through the sourceId parameter. Similarity is expressed by the (approximated) ratio between the length of the source and the overlap with the starting source, based on the chosen algorithm (according to the algorithm-specific algorithmParams).

Note: whenever possible, use a filter object to limit the search space for this query to perform adequately.

If the supplied Source ID is negative, it is treated as a Virtual Source. While this allows looking for sources similar to a Virtual Source, the query will not verify against other Virtual Sources and they will therefore not appear in the results of this query.

The blackListIds parameter allows a user to select one or more BlackLists of which the elements should be completely ignored in the similarity algorithm. Blacklisted elements will be ignored both for selecting similar candidates AND the calculation of their similarity score.

The following algorithms are currently available:

• $$$SIMSRCSIMPLE: basic algorithm simply looking at entities (or CRCs or CCs) present in the reference source.
  Parameters:
  1. targetType As %String - either "ent", "crc" or "cc" (case insensitive, defaults to "ent"). Please note this implies the result columns will represent the corresponding targets, despite being named "nbOfEnt***"
• $$$SIMSRCEQUIVS: similar to $$$SIMSRCSIMPLE, but also taking into account equivalent terms.
  Parameters:
  1. equivSetId As %Integer - equivalency set ID
• $$$SIMSRCDOMENTS starts looking for similar sources based on dominant terms in the reference source.
  Parameters:
  1. strict As %Boolean - whether or not to select only sources for which at least one of the reference source's dominant concepts are also dominant in a similar source. (defaults to 1)

• classmethod GetSourceId(domainid As %Integer, externalId As %String) as %Library.Integer [ WebMethod ]

Retrieves the source ID for the source identified by externalId.

• classmethod GetSummary(domainid As %Integer, sourceid As %Integer, length As %Integer = 5) as %XML.DataSet [ WebMethod ]

This method returns the most relevant sentences of the required document, in their original order. The number of sentences returned is controlled by the length parameter.

A negative Source ID is interpreted as a Virtual Source.

• classmethod GetSummaryDirect(domainId As %Integer, sourceId As %Integer, length As %Integer = 5, separator As %String = " ... ") as %Library.String [ WebMethod ]

This is a utility wrapper method around GetSummary, returning the summary sentences as a single concatenated string.

The isTruncated output parameter indicates whether or not the returned string is complete or was truncated to avoid MAXSTRING errors. This can happen when either an individual sentence surpassed the maximum string length or when the concatenation of these sentences surpassed it.

• classmethod GetTopLanguage(domainid As %Integer, sourceid As %Integer) as %Library.String [ WebMethod ]

This method returns the language of a given source, calculated as the one with the highest total confidence rating for the individual sentences in the source. This total confidence, as well as the number of sentences to which this language was assigned is provided through output variables totalConfidence and numberOfSentences.

A totalConfidence of 0 indicates ALI was switched off when indexing this source.

A negative Source ID is interpreted as a Virtual Source.