%iKnow.DeepSee.CubeUtils
deprecated class %iKnow.DeepSee.CubeUtils extends %Library.RegisteredObject
The InterSystems IRIS NLP iKnow technology is now deprecated. Please see the product documentationOpens in a new tab for more detail.
This class offers a number of utility options for interacting with DeepSee-managed domains.Method Inventory
- CreateEOCube()
- CreateMRCube()
- GetDomainId()
- GetIKnowMeasures()
- GetMeasureInfo()
- GetSummary()
- LoadTermListAsDictionary()
- LoadTermListAsSkipList()
- UpdateDictionary()
- UpdateMatching()
Methods
This method creates a new DeepSee Cube definition representing the entities occurring in the textual contents of an iKnow measure pIKnowMeasure in cube pCube. The generated cube will have a set of meaningful dimensions for this entity occurrence level as well as a relationship to pCube, so all of its dimensions are also available for the new cube. The name of this cube will be "pCube > pIKnowMeasure > Entity Occurrences" and can be used or modified just like any other DeepSee cube after creation.
Setting pBuild to 1 will automatically build the cube.
NOTE: some of the functionality exposed by this cube can be achieved by using the iKnow plugin exposing numerical query results %DeepSee.PlugIn.iKnow as a calculated measure, without the need to create any additional cubes.
This method creates a new DeepSee Cube definition representing the matching results occurring in the textual contents of an iKnow measure pIKnowMeasure in cube pCube. The generated cube will have a set of meaningful dimensions for this dictionary match level as well as a relationship to pCube, so all of its dimensions are also available for the new cube. The name of this cube will be "pCube > pIKnowMeasure > Matching Results" and can be used or modified just like any other DeepSee cube after creation.
Setting pBuild to 1 will automatically build the cube.
NOTE: most of the functionality exposed by this cube can be achieved by using the iKnow plugin for Dictionaries %DeepSee.PlugIn.iKnowDictionary as a calculated measure, without the need to create any additional cubes.
Fetches measure info from the cube definition:
- pSourceType: the value of the iKnowSource attribute
- pDomainId: the iKnow domain (ID) containing the data for this measure
- pDomainName: the iKnow domain (name) containing the data for this measure
- pDomainType: "iKnow" for an iKnow-managed domain, "DeepSee" for a DeepSee-managed one
- pParams: the semicolon-delimited list of domain parameter name/value pairs to use apply to the domain instantiated for this measure
- pDictionaries: the comma-delimited list of Term Lists to match against.
Shorthand method to retrieve a summary of the iKnow measure value for pMeasure in cube pCube for the record identified by pSourceObjectId. Using pLength, the user can supply a desired summary length (in sentences).
This method is available as a SQL stored procedure and can be invoked in a Listing through using the $$$IKSUMMARY keyword.
Loads the elements of a TermList as Dictionary Terms into a given iKnow measures domain,
taking the key as the Term string and value as the items name. The Terms will all be added
to a single dictionary named after this TermList.
The following fields will be interpreted along the way, if present:
- "URI": the unique identifier for the Item level the value field refers to. If not present, a URI of the form :pTermList:value will be created.
- "language": the two-letter language code to use for this term. Defaults to English ("en") if not present.
If pMatch is 1, the newly created dictionary will be matched against the contents of the domain. If set to 2, all existing dictionaries will be matched and if set to 0, no matching will occur as part of this method invocation.
If pClear is 1, any existing dictionary named pTermList will be deleted prior to loading this Term List. If set to 0, none will be dropped. The option to clear all dictionaries using the value 2 is discontinued as from 2013.2.
Loads the elements of a Term List as a SkipList into a given iKnow measures domain,
using just the key as a string to be Skiplisted. The Terms will all be added
to a single Skiplist named after this Term List.
If a SkipList with the given name already exists, its contents will be replaced by the
contents of the supplied Term List. If no value is supplied for pTermList,
its value will be derived from the value of the domain parameter $$$IKPDSSKIPLIST.
This method will update matching results for the Term List identified by pTermList to reflect the changes made to the Term List entries. If pCube is left blank, this method will be invoked for all cubes in this namespace. If pMeasure is left blank, it will be called for all iKnow measures in pCube.
Using pClearFirst, the user can specify whether or not the existing dictionary should first be dropped before reloading it from the Term List. Leave pClearFirst at 0 if you only appended to the Term List and use 1 if any existing terms were changed or removed.
Inherited Members
Inherited Methods
- %AddToSaveSet()
- %ClassIsLatestVersion()
- %ClassName()
- %ConstructClone()
- %DispatchClassMethod()
- %DispatchGetModified()
- %DispatchGetProperty()
- %DispatchMethod()
- %DispatchSetModified()
- %DispatchSetMultidimProperty()
- %DispatchSetProperty()
- %Extends()
- %GetParameter()
- %IsA()
- %IsModified()
- %New()
- %NormalizeObject()
- %ObjectModified()
- %OriginalNamespace()
- %PackageName()
- %RemoveFromSaveSet()
- %SerializeObject()
- %SetModified()
- %ValidateObject()