Skip to main content

%iKnow.Matching.MatchingQAPI

Class %iKnow.Matching.MatchingQAPI Extends %iKnow.Queries.AbstractQAPI [ Deprecated, System = 4 ]

This is an automatically generated class, offering a functionally equivalent set of methods and queries as %iKnow.Matching.MatchingAPI, exposed as SqlProc methods.

See the classdocs for %iKnow.Matching.MatchingAPI for more information.

Methods​

ClearLogs​

ClassMethod ClearLogs(domainId As %Integer) As %Boolean [ SqlProc ]

Clears any matching-related logfiles for the specified domain.

GetDictionaryMatchesExecute​

ClassMethod GetDictionaryMatchesExecute(ByRef qHandle As %Binary,  domainId As %Integer, string As %String(MAXLEN=32767), dictIds As %String(MAXLEN=32767) = "", page As %Integer = 1, pageSize As %Integer = 10, fullMatchOnly As %Integer = -1, profile As %iKnow.Matching.MatchingProfile = "", language As %String(MAXLEN=32767) = "", nGramMatches As %Integer = -1) As %Status [ Internal ]

Returns all potential matches for a given string. This string is treated as if it were a single entity and matched against single-entity Dictionary Terms. To find the matches for a full sentence, first index it and then call GetMatchesBySource using the source ID corresponding to the indexed sentence.

A Matching Profile to be used when calculating match scores can be specified either by passing in an %iKnow.Matching.MatchingProfile object, or a Matching Profile ID. When passing in the ID, a negative number is treated as a namespace-wide profile, whereas a positive ID will be looked up within the context of the domain. If no profile is specified, the default profile for this domain will be used.

Specifying "" for dictIds will return results for all Dictionaries in this domain.

GetDictionaryMatchesFetch​

ClassMethod GetDictionaryMatchesFetch(ByRef qHandle As %Binary, ByRef Row As %List, ByRef AtEnd As %Integer = 0) As %Status [ Internal, PlaceAfter = GetDictionaryMatchesExecute ]

GetDictionaryMatchesClose​

ClassMethod GetDictionaryMatchesClose(ByRef qHandle As %Binary) As %Status [ Internal, PlaceAfter = GetDictionaryMatchesExecute ]

GetDictionaryMatchesByIdExecute​

ClassMethod GetDictionaryMatchesByIdExecute(ByRef qHandle As %Binary,  domainId As %Integer, entUniId As %Integer, dictIds As %String(MAXLEN=32767) = "", page As %Integer = 1, pageSize As %Integer = 10, fullMatchOnly As %Integer = -1, profile As %iKnow.Matching.MatchingProfile = "", language As %String(MAXLEN=32767) = "") As %Status [ Internal ]

Returns all potential matches for the given entity ID.

A Matching Profile to be used when calculating match scores can be specified either by passing in an %iKnow.Matching.MatchingProfile object, or a Matching Profile ID. When passing in the ID, a negative number is treated as a namespace-wide profile, whereas a positive ID will be looked up within the context of the domain. If no profile is specified, the default profile for this domain will be used.

Specifying "" for dictIds will return results for all Dictionaries in this domain.

GetDictionaryMatchesByIdFetch​

ClassMethod GetDictionaryMatchesByIdFetch(ByRef qHandle As %Binary, ByRef Row As %List, ByRef AtEnd As %Integer = 0) As %Status [ Internal, PlaceAfter = GetDictionaryMatchesByIdExecute ]

GetDictionaryMatchesByIdClose​

ClassMethod GetDictionaryMatchesByIdClose(ByRef qHandle As %Binary) As %Status [ Internal, PlaceAfter = GetDictionaryMatchesByIdExecute ]

GetErrorsExecute​

ClassMethod GetErrorsExecute(ByRef qHandle As %Binary,  domainId As %Integer, since As %Date = 0) As %Status [ Internal ]

Returns any errors registered during the Matching process

GetErrorsFetch​

ClassMethod GetErrorsFetch(ByRef qHandle As %Binary, ByRef Row As %List, ByRef AtEnd As %Integer = 0) As %Status [ Internal, PlaceAfter = GetErrorsExecute ]

GetErrorsClose​

ClassMethod GetErrorsClose(ByRef qHandle As %Binary) As %Status [ Internal, PlaceAfter = GetErrorsExecute ]

GetMatchElementsExecute​

ClassMethod GetMatchElementsExecute(ByRef qHandle As %Binary,  domainId As %Integer, matchId As %Integer, vSrcId As %Integer = 0) As %Status [ Internal ]

Returns a detailed overview of all the elements in the match target, be it an entity-level, CRC-level or path-level match. The elements that are matched get annotated with the matched elements ID, value and eventually the output from a %iKnow.Matching.Formats.Format class if it was responsible for the match.

If a Virtual Source ID is supplied, the query runs in the context of that virtual source.

GetMatchElementsFetch​

ClassMethod GetMatchElementsFetch(ByRef qHandle As %Binary, ByRef Row As %List, ByRef AtEnd As %Integer = 0) As %Status [ Internal, PlaceAfter = GetMatchElementsExecute ]

GetMatchElementsClose​

ClassMethod GetMatchElementsClose(ByRef qHandle As %Binary) As %Status [ Internal, PlaceAfter = GetMatchElementsExecute ]

GetMatchesByCrcOccExecute​

ClassMethod GetMatchesByCrcOccExecute(ByRef qHandle As %Binary,  domainId As %Integer, crcOccId As %Integer, dictIds As %String(MAXLEN=32767) = "", page As %Integer = 1, pageSize As %Integer = 10, includeEntityMatches As %Boolean = 1, includePathMatches As %Boolean = 1, includeSentenceMatches As %Boolean = 1) As %Status [ Internal ]

Returns all the matches for the given CRC Occurrence. Use includeEntityMatches, includePathMatches and includeSentenceMatches to also include any matches for the Entities this CRC is composed of and the Paths these Entities participate in.

Specifying "" for dictIds will return results for all Dictionaries in this domain.

GetMatchesByCrcOccFetch​

ClassMethod GetMatchesByCrcOccFetch(ByRef qHandle As %Binary, ByRef Row As %List, ByRef AtEnd As %Integer = 0) As %Status [ Internal, PlaceAfter = GetMatchesByCrcOccExecute ]

GetMatchesByCrcOccClose​

ClassMethod GetMatchesByCrcOccClose(ByRef qHandle As %Binary) As %Status [ Internal, PlaceAfter = GetMatchesByCrcOccExecute ]

GetMatchesByDictionaryItemIdExecute​

ClassMethod GetMatchesByDictionaryItemIdExecute(ByRef qHandle As %Binary,  domainId As %Integer, dictItemId As %Integer, page As %Integer = 1, pageSize As %Integer = 10, filter As %String(MAXLEN=32767) = "", targetTypes As %String(MAXLEN=32767) = "", ensureMatched As %Boolean = 1) As %Status [ Internal ]

This query returns all the match occurrences for the Dictionary Item specified through dictItemId.

Specifying a %iKnow.Filters.Filter object as filter will restrict the search space to only those sources satisfying the filters criteria. Through targetTypes, the desired target types can be specified in a %List (defaults to all types).

GetMatchesByDictionaryItemIdFetch​

ClassMethod GetMatchesByDictionaryItemIdFetch(ByRef qHandle As %Binary, ByRef Row As %List, ByRef AtEnd As %Integer = 0) As %Status [ Internal, PlaceAfter = GetMatchesByDictionaryItemIdExecute ]

GetMatchesByDictionaryItemIdClose​

ClassMethod GetMatchesByDictionaryItemIdClose(ByRef qHandle As %Binary) As %Status [ Internal, PlaceAfter = GetMatchesByDictionaryItemIdExecute ]

GetMatchesByDictionaryItemURIExecute​

ClassMethod GetMatchesByDictionaryItemURIExecute(ByRef qHandle As %Binary,  domainId As %Integer, dictItemURI As %String(MAXLEN=32767), page As %Integer = 1, pageSize As %Integer = 10, filter As %String(MAXLEN=32767) = "", targetTypes As %String(MAXLEN=32767) = "", xDomDicts As %Boolean = 0) As %Status [ Internal ]

This query returns all the match occurrences for the Dictionary Item specified through dictItemURI.

Specifying a %iKnow.Filters.Filter object as filter will restrict the search space to only those sources satisfying the filters criteria. Through targetTypes, the desired target types can be specified in a %List (defaults to all types).

GetMatchesByDictionaryItemURIFetch​

ClassMethod GetMatchesByDictionaryItemURIFetch(ByRef qHandle As %Binary, ByRef Row As %List, ByRef AtEnd As %Integer = 0) As %Status [ Internal, PlaceAfter = GetMatchesByDictionaryItemURIExecute ]

GetMatchesByDictionaryItemURIClose​

ClassMethod GetMatchesByDictionaryItemURIClose(ByRef qHandle As %Binary) As %Status [ Internal, PlaceAfter = GetMatchesByDictionaryItemURIExecute ]

GetMatchesByDictionaryTermIdExecute​

ClassMethod GetMatchesByDictionaryTermIdExecute(ByRef qHandle As %Binary,  pDomainId As %Integer, pDictTermId As %Integer, pPage As %Integer = 1, pPageSize As %Integer = 10, pFilter As %String(MAXLEN=32767) = "", pTargetTypes As %String(MAXLEN=32767) = "", pEnsureMatched As %Boolean = 1) As %Status [ Internal ]

This query returns all the match occurrences for the Dictionary Term specified through pDictTermId.

Specifying a %iKnow.Filters.Filter object as pFilter will restrict the search space to only those sources satisfying the filters criteria. Through pTargetTypes, the desired target types can be specified in a %List (defaults to all types).

GetMatchesByDictionaryTermIdFetch​

ClassMethod GetMatchesByDictionaryTermIdFetch(ByRef qHandle As %Binary, ByRef Row As %List, ByRef AtEnd As %Integer = 0) As %Status [ Internal, PlaceAfter = GetMatchesByDictionaryTermIdExecute ]

GetMatchesByDictionaryTermIdClose​

ClassMethod GetMatchesByDictionaryTermIdClose(ByRef qHandle As %Binary) As %Status [ Internal, PlaceAfter = GetMatchesByDictionaryTermIdExecute ]

GetMatchesByEntOccExecute​

ClassMethod GetMatchesByEntOccExecute(ByRef qHandle As %Binary,  domainId As %Integer, entOccId As %Integer, dictIds As %String(MAXLEN=32767) = "", page As %Integer = 1, pageSize As %Integer = 10, includeCrcMatches As %Boolean = 1, includePathMatches As %Boolean = 1, includeSentenceMatches As %Boolean = 1, vSrcId As %Integer = 0) As %Status [ Internal ]

Returns all the matches for the given Entity Occurrence. Use includeCrcMatches, includePathMatches and includeSentenceMatches to also include any matches for the CRC, Path or Sentence in which this Entity Occurrences participates.

Specifying "" for dictIds will return results for all Dictionaries in this domain.

GetMatchesByEntOccFetch​

ClassMethod GetMatchesByEntOccFetch(ByRef qHandle As %Binary, ByRef Row As %List, ByRef AtEnd As %Integer = 0) As %Status [ Internal, PlaceAfter = GetMatchesByEntOccExecute ]

GetMatchesByEntOccClose​

ClassMethod GetMatchesByEntOccClose(ByRef qHandle As %Binary) As %Status [ Internal, PlaceAfter = GetMatchesByEntOccExecute ]

GetMatchesByPathExecute​

ClassMethod GetMatchesByPathExecute(ByRef qHandle As %Binary,  domainId As %Integer, pathId As %Integer, dictIds As %String(MAXLEN=32767) = "", page As %Integer = 1, pageSize As %Integer = 10, includeEntityMatches As %Boolean = 1, includeCrcMatches As %Boolean = 1, includeSentenceMatches As %Boolean = 1) As %Status [ Internal ]

Returns all the matches for the given Path. Use includeEntityMatches, includeCRCMatches and includeSentenceMatches to also include any matches for the Entities this path is composed of and the CRCs or Sentences these Entities participate in.

Specifying "" for dictIds will return results for all Dictionaries in this domain.

GetMatchesByPathFetch​

ClassMethod GetMatchesByPathFetch(ByRef qHandle As %Binary, ByRef Row As %List, ByRef AtEnd As %Integer = 0) As %Status [ Internal, PlaceAfter = GetMatchesByPathExecute ]

GetMatchesByPathClose​

ClassMethod GetMatchesByPathClose(ByRef qHandle As %Binary) As %Status [ Internal, PlaceAfter = GetMatchesByPathExecute ]

GetMatchesBySentenceExecute​

ClassMethod GetMatchesBySentenceExecute(ByRef qHandle As %Binary,  domainId As %Integer, sentenceId As %Integer, dictIds As %String(MAXLEN=32767) = "", page As %Integer = 1, pageSize As %Integer = 10, includeEntityMatches As %Boolean = 1, includeCrcMatches As %Boolean = 1, includePathMatches As %Boolean = 1) As %Status [ Internal ]

Returns all the matches for the given Sentence. Use includeEntityMatches, includeCrcMatches and includePathMatches to control which (target) types of matches should be included in the result.

Specifying "" for dictIds will return results for all Dictionaries in this domain.

GetMatchesBySentenceFetch​

ClassMethod GetMatchesBySentenceFetch(ByRef qHandle As %Binary, ByRef Row As %List, ByRef AtEnd As %Integer = 0) As %Status [ Internal, PlaceAfter = GetMatchesBySentenceExecute ]

GetMatchesBySentenceClose​

ClassMethod GetMatchesBySentenceClose(ByRef qHandle As %Binary) As %Status [ Internal, PlaceAfter = GetMatchesBySentenceExecute ]

GetMatchesBySourceExecute​

ClassMethod GetMatchesBySourceExecute(ByRef qHandle As %Binary,  domainId As %Integer, externalId As %String(MAXLEN=32767), dictIds As %String(MAXLEN=32767) = "", page As %Integer = 1, pageSize As %Integer = 10) As %Status [ Internal ]

Returns all the matches for the given Source, as identified by its external ID.

Specifying "" for dictIds will return results for all Dictionaries in this domain.

GetMatchesBySourceFetch​

ClassMethod GetMatchesBySourceFetch(ByRef qHandle As %Binary, ByRef Row As %List, ByRef AtEnd As %Integer = 0) As %Status [ Internal, PlaceAfter = GetMatchesBySourceExecute ]

GetMatchesBySourceClose​

ClassMethod GetMatchesBySourceClose(ByRef qHandle As %Binary) As %Status [ Internal, PlaceAfter = GetMatchesBySourceExecute ]

GetMatchesBySourceIdExecute​

ClassMethod GetMatchesBySourceIdExecute(ByRef qHandle As %Binary,  domainId As %Integer, srcId As %Integer, dictIds As %String(MAXLEN=32767) = "", page As %Integer = 1, pageSize As %Integer = 10) As %Status [ Internal ]

Returns all the matches for the given Source, as identified by its Source ID (interpreted as a Virtual Source if a negative value is supplied).

Specifying "" for dictIds will return results for all Dictionaries in this domain.

GetMatchesBySourceIdFetch​

ClassMethod GetMatchesBySourceIdFetch(ByRef qHandle As %Binary, ByRef Row As %List, ByRef AtEnd As %Integer = 0) As %Status [ Internal, PlaceAfter = GetMatchesBySourceIdExecute ]

GetMatchesBySourceIdClose​

ClassMethod GetMatchesBySourceIdClose(ByRef qHandle As %Binary) As %Status [ Internal, PlaceAfter = GetMatchesBySourceIdExecute ]

GetSentenceIdForMatchTarget​

ClassMethod GetSentenceIdForMatchTarget(domainId As %Integer, targetType As %Integer, targetId As %Integer, vSrcId As %Integer = 0) As %Library.Integer [ SqlProc ]

Utility method to retrieve the Sentence ID for a given match target, as specified by its target type (either of $$$DMTARGETENTITY, $$$DMTARGETCRC, $$$DMTARGETPATH or $$$DMTARGETSENT) and ID.

GetSourceIdForMatchTarget​

ClassMethod GetSourceIdForMatchTarget(domainId As %Integer, targetType As %Integer, targetId As %Integer) As %Library.Integer [ SqlProc ]

Utility method to retrieve the Source ID for a given match target, as specified by its target type (either of $$$DMTARGETENTITY, $$$DMTARGETCRC, $$$DMTARGETPATH or $$$DMTARGETSENT) and ID.

GetTopItemsExecute​

ClassMethod GetTopItemsExecute(ByRef qHandle As %Binary,  domainId As %Integer, page As %Integer = 1, pageSize As %Integer = 10, filter As %String(MAXLEN=32767) = "", dictIds As %String(MAXLEN=32767) = "", sortType As %Integer = {$$$SORTBYFREQUENCY}, vSrcId As %Integer = 0) As %Status [ Internal ]

Returns the Dictionary Items for which most matches have been found in this domain (optionally narrowed down through a %iKnow.Filters.Filter object passed in through filter). Result sort order is controlled by sortType:

  • $$$SORTBYFREQUENCY will sort by the number of actual matches for a Dictionary Item
  • $$$SORTBYSPREAD will sort by the number of distinct documents in which at least one match for the Dictionary Item occurs.
  • $$$SORTBYSCORE will sort by the total match score of all matches for a Dictionary Item

Specifying "" for dictIds will return results for all Dictionaries in this domain.

GetTopItemsFetch​

ClassMethod GetTopItemsFetch(ByRef qHandle As %Binary, ByRef Row As %List, ByRef AtEnd As %Integer = 0) As %Status [ Internal, PlaceAfter = GetTopItemsExecute ]

GetTopItemsClose​

ClassMethod GetTopItemsClose(ByRef qHandle As %Binary) As %Status [ Internal, PlaceAfter = GetTopItemsExecute ]

GetTopMatchesByDictionaryItemIdExecute​

ClassMethod GetTopMatchesByDictionaryItemIdExecute(ByRef qHandle As %Binary,  domainId As %Integer, dictItemId As %Integer, page As %Integer = 1, pageSize As %Integer = 10, filter As %String(MAXLEN=32767) = "", targetTypes As %String(MAXLEN=32767) = "", sortType As %Integer = {$$$SORTBYDOMAINDEFAULT}) As %Status [ Internal ]

This query returns the "best" matching results for the Dictionary Item specified through dictItemId, aggregated by matched unique target (entity, CRC, path or sentence). The meaning of "best" is defined by sortType: if set to $$$SORTBYFREQUENCY or $$$SORTBYSPREAD, results are sorted by decreasing number of matched occurrences, whereas $$$SORTBYSCORE will rank them according to the highest match score. The first two options will yield the most relevant results for entities and CRCs, with the score ranking a better fit for paths and sentences, as they inherently have frequency and spread equal to 1.

Specifying a %iKnow.Filters.Filter object as filter will restrict the search space to only those sources satisfying the filters criteria. Through targetTypes, the desired target types can be specified in a %List (defaults to all types).

GetTopMatchesByDictionaryItemIdFetch​

ClassMethod GetTopMatchesByDictionaryItemIdFetch(ByRef qHandle As %Binary, ByRef Row As %List, ByRef AtEnd As %Integer = 0) As %Status [ Internal, PlaceAfter = GetTopMatchesByDictionaryItemIdExecute ]

GetTopMatchesByDictionaryItemIdClose​

ClassMethod GetTopMatchesByDictionaryItemIdClose(ByRef qHandle As %Binary) As %Status [ Internal, PlaceAfter = GetTopMatchesByDictionaryItemIdExecute ]

GetTopMatchesByDictionaryItemURIExecute​

ClassMethod GetTopMatchesByDictionaryItemURIExecute(ByRef qHandle As %Binary,  domainId As %Integer, dictItemURI As %String(MAXLEN=32767), page As %Integer = 1, pageSize As %Integer = 10, filter As %String(MAXLEN=32767) = "", targetTypes As %String(MAXLEN=32767) = "", sortType As %Integer = {$$$SORTBYFREQUENCY}, xDomDicts As %Boolean = 0) As %Status [ Internal ]

This query returns the "best" matching results for the Dictionary Item specified through dictItemURI, aggregated by matched unique target (entity, CRC, path or sentence). The meaning of "best" is defined by sortType: if set to $$$SORTBYFREQUENCY or $$$SORTBYSPREAD, results are sorted by decreasing number of matched occurrences, whereas $$$SORTBYSCORE will rank them according to the highest match score. The first two options will yield the most relevant results for entities and CRCs, with the score ranking a better fit for paths and sentences, as they inherently have frequency and spread equal to 1.

Specifying a %iKnow.Filters.Filter object as filter will restrict the search space to only those sources satisfying the filters criteria. Through targetTypes, the desired target types can be specified in a %List (defaults to all types).

GetTopMatchesByDictionaryItemURIFetch​

ClassMethod GetTopMatchesByDictionaryItemURIFetch(ByRef qHandle As %Binary, ByRef Row As %List, ByRef AtEnd As %Integer = 0) As %Status [ Internal, PlaceAfter = GetTopMatchesByDictionaryItemURIExecute ]

GetTopMatchesByDictionaryItemURIClose​

ClassMethod GetTopMatchesByDictionaryItemURIClose(ByRef qHandle As %Binary) As %Status [ Internal, PlaceAfter = GetTopMatchesByDictionaryItemURIExecute ]

GetTopSourcesByDictionaryExecute​

ClassMethod GetTopSourcesByDictionaryExecute(ByRef qHandle As %Binary,  pDomainId As %Integer, pDictIds As %String(MAXLEN=32767), pPage As %Integer = 1, pPageSize As %Integer = 10, pFilter As %String(MAXLEN=32767) = "", pSortType As %Integer = {$$$SORTBYFREQUENCY}, pNormalizeLength As %Numeric = 0) As %Status [ Internal ]

Returns the sources best matching a given list of dictionaries specified through pDictIds, optionally filtered through pFilter. "Best matching" is defined as having the highest number of matches (if pSortType = $$$SORTBYFREQUENCY) or the highest total match score (if pSortType = $$$SORTBYSCORE).

If pNormalizeLength is set to a nonzero value, this number is used as the power of the sources length in entities (occurrences) to normalize the score.

GetTopSourcesByDictionaryFetch​

ClassMethod GetTopSourcesByDictionaryFetch(ByRef qHandle As %Binary, ByRef Row As %List, ByRef AtEnd As %Integer = 0) As %Status [ Internal, PlaceAfter = GetTopSourcesByDictionaryExecute ]

GetTopSourcesByDictionaryClose​

ClassMethod GetTopSourcesByDictionaryClose(ByRef qHandle As %Binary) As %Status [ Internal, PlaceAfter = GetTopSourcesByDictionaryExecute ]

GetTopTermsByItemIdExecute​

ClassMethod GetTopTermsByItemIdExecute(ByRef qHandle As %Binary,  pDomainId As %Integer, pDictItemIds As %String(MAXLEN=32767), pFilter As %String(MAXLEN=32767) = "", pSortType As %Integer = {$$$SORTBYFREQUENCY}, vSrcId As %Integer = 0) As %Status [ Internal ]

For a given Dictionary Item, returns all its Dictionary Terms sorted by the number of matches they have, optionally narrowed down through a %iKnow.Filters.Filter object passed in through pFilter). Result sort order is controlled by pSortType:

  • $$$SORTBYFREQUENCY will sort by the number of actual matches for the Dictionary Term
  • $$$SORTBYSPREAD will sort by the number of distinct documents in which at least one match for the Dictionary Term occurs.
  • $$$SORTBYSCORE will sort by the total match score of all matches for a Dictionary Term

GetTopTermsByItemIdFetch​

ClassMethod GetTopTermsByItemIdFetch(ByRef qHandle As %Binary, ByRef Row As %List, ByRef AtEnd As %Integer = 0) As %Status [ Internal, PlaceAfter = GetTopTermsByItemIdExecute ]

GetTopTermsByItemIdClose​

ClassMethod GetTopTermsByItemIdClose(ByRef qHandle As %Binary) As %Status [ Internal, PlaceAfter = GetTopTermsByItemIdExecute ]

GetTotalDictionaryScoresBySourceExecute​

ClassMethod GetTotalDictionaryScoresBySourceExecute(ByRef qHandle As %Binary,  domainId As %Integer, externalId As %String(MAXLEN=32767), sortType As %Integer = {$$$SORTBYFREQUENCY}) As %Status [ Internal ]

Returns summary information for all matches in a given source (identified by External ID), organized per Dictionary.

GetTotalDictionaryScoresBySourceFetch​

ClassMethod GetTotalDictionaryScoresBySourceFetch(ByRef qHandle As %Binary, ByRef Row As %List, ByRef AtEnd As %Integer = 0) As %Status [ Internal, PlaceAfter = GetTotalDictionaryScoresBySourceExecute ]

GetTotalDictionaryScoresBySourceClose​

ClassMethod GetTotalDictionaryScoresBySourceClose(ByRef qHandle As %Binary) As %Status [ Internal, PlaceAfter = GetTotalDictionaryScoresBySourceExecute ]

GetTotalDictionaryScoresBySourceIdExecute​

ClassMethod GetTotalDictionaryScoresBySourceIdExecute(ByRef qHandle As %Binary,  domainId As %Integer, srcId As %Integer, sortType As %Integer = {$$$SORTBYFREQUENCY}) As %Status [ Internal ]

Returns summary information for all matches in a given source (identified by Source ID), organized per Dictionary.

GetTotalDictionaryScoresBySourceIdFetch​

ClassMethod GetTotalDictionaryScoresBySourceIdFetch(ByRef qHandle As %Binary, ByRef Row As %List, ByRef AtEnd As %Integer = 0) As %Status [ Internal, PlaceAfter = GetTotalDictionaryScoresBySourceIdExecute ]

GetTotalDictionaryScoresBySourceIdClose​

ClassMethod GetTotalDictionaryScoresBySourceIdClose(ByRef qHandle As %Binary) As %Status [ Internal, PlaceAfter = GetTotalDictionaryScoresBySourceIdExecute ]

GetTotalItemScoresBySourceExecute​

ClassMethod GetTotalItemScoresBySourceExecute(ByRef qHandle As %Binary,  domainId As %Integer, externalId As %String(MAXLEN=32767), dictIds As %String(MAXLEN=32767) = "", sortType As %Integer = {$$$SORTBYFREQUENCY}) As %Status [ Internal ]

Returns summary information for all matches in a given source (identified by External ID), organized per Dictionary Item.

Specifying "" for dictIds will return results for all Dictionaries in this domain.

GetTotalItemScoresBySourceFetch​

ClassMethod GetTotalItemScoresBySourceFetch(ByRef qHandle As %Binary, ByRef Row As %List, ByRef AtEnd As %Integer = 0) As %Status [ Internal, PlaceAfter = GetTotalItemScoresBySourceExecute ]

GetTotalItemScoresBySourceClose​

ClassMethod GetTotalItemScoresBySourceClose(ByRef qHandle As %Binary) As %Status [ Internal, PlaceAfter = GetTotalItemScoresBySourceExecute ]

GetTotalItemScoresBySourceIdExecute​

ClassMethod GetTotalItemScoresBySourceIdExecute(ByRef qHandle As %Binary,  domainId As %Integer, srcId As %Integer, dictIds As %String(MAXLEN=32767) = "", sortType As %Integer = {$$$SORTBYFREQUENCY}) As %Status [ Internal ]

Returns summary information for all matches in a given source (identified by Source ID), organized per Dictionary Item.

Specifying "" for dictIds will return results for all Dictionaries in this domain.

GetTotalItemScoresBySourceIdFetch​

ClassMethod GetTotalItemScoresBySourceIdFetch(ByRef qHandle As %Binary, ByRef Row As %List, ByRef AtEnd As %Integer = 0) As %Status [ Internal, PlaceAfter = GetTotalItemScoresBySourceIdExecute ]

GetTotalItemScoresBySourceIdClose​

ClassMethod GetTotalItemScoresBySourceIdClose(ByRef qHandle As %Binary) As %Status [ Internal, PlaceAfter = GetTotalItemScoresBySourceIdExecute ]

InvalidateMatchingResults​

ClassMethod InvalidateMatchingResults(domainId As %Integer, dictIds As %String(MAXLEN=32767) = "", pMode As %Integer = 0) As %Boolean [ SqlProc ]

Deletes all current matching results for the list of Dictionary IDs passed in dictIds.

Specifying "" for dictIds will drop results for all Dictionaries in this domain.

pMode can be used to specify whether to keep intermediary (not source-related) matching results as follows:

  • 0: only source-related matching results are erased (default)
  • 1: the matching results for unique entities are also erased
  • 2: the matching results for unique entities and indexing results for dictionary terms are all erased (only available if dictIds="") This parameter is mostly for internal use.

Note: pMode=2 will not erase the indexing results for dictionary terms of cross-domain dictionaries.
Note: matching results for virtual sources are always completely dropped, regardless of the value of dictIds and with the same effect as pMode=1

MatchSource​

ClassMethod MatchSource(domainId As %Integer, srcId As %Integer, dictIds As %String(MAXLEN=32767) = "", overrideProfile As %iKnow.Matching.MatchingProfile = "") As %Boolean [ SqlProc ]

Matches an individual source against the list of Dictionary IDs passed in dictIds. Use negative numbers to identify any cross-domain dictionaries to match against. A Matching Profile to calculate match scores can be specified either by passing in an %iKnow.Matching.MatchingProfile object, or a Matching Profile ID. When passing in the ID, a negative number is treated as a namespace-wide profile, whereas a positive ID will be looked up within the context of the domain.

Specifying "" for dictIds will match against all Dictionaries in this domain and passing $$$ALLXDOMDICTIONARIES will match against all cross-domain dictionaries.

A negative Source ID is interpreted as a Virtual Source.

MatchSources​

ClassMethod MatchSources(domainId As %Integer, filter As %String(MAXLEN=32767) = "", dictIds As %String(MAXLEN=32767) = "", overrideProfile As %iKnow.Matching.MatchingProfile = "") As %Boolean [ SqlProc ]

Matches all sources in the domain, optionally restricted to those satisfying the criteria of a %iKnow.Filters.Filter object provided as filter, against the list of Dictionary IDs passed in dictIds. Use negative numbers to mark cross-domain dictionaries.

A Matching Profile to calculate match scores can be specified either by passing in an %iKnow.Matching.MatchingProfile object, or a Matching Profile ID. When passing in the ID, a negative number is treated as a namespace-wide profile, whereas a positive ID will be looked up within the context of the domain.

Specifying "" for dictIds will match against all Dictionaries in this domain and passing $$$ALLXDOMDICTIONARIES will match against all cross-domain dictionaries.