Skip to main content

Sorry, your browser does not support JavaScript or JavaScript is disabled. Please enable JavaScript or use another browser to have a better experience.

Percent classes:

%Api

%Archive

%CSP

%Collection

%DeepSee

%Dictionary

%DocDB

%Embedding

%Exception

%ExtentMgr

%External

%FileMan

%Installer

%Iterator

%JSON

%Library

%MFT

%Monitor

%Net

%OAuth2

%Projection

%REST

%Regex

%SAML

%SOAP

%SQL

%SYS

%SYSTEM

%Stream

%Studio

%UnitTest

%WebStress

%XDBC

%XML

%ZEN

%ZHS

%ZHSLIB

%ZHSMOD

%iFind

%iKnow

Classification

Compiler

Configuration

DeepSee

Domain
DomainDefinition

Filters

Matching

Metrics

Model

NativeSupport

Objects

Queries

REST

Semantics

Source

Stemming

Tables

TextTransformation

UI

UserDictionary

Utils

%xsd

Backup

Config

DataMove

INFORMATION

Journal

MonitorTools

OAuth2

PKI

SYS

Security

Health Connect 2024.3
Documentation

%iKnow.TextTransformation.Definition

deprecated abstract class %iKnow.TextTransformation.Definition extends %Library.RegisteredObject

This class represents a Text Transformation model, as defined in its Transformation XData block. See the %Apply() and %ApplyBatch() methods for ways how to invoke this model on input text.

Method Inventory

%Apply()
%ApplyBatch()
%ApplyStream()
%CreateKeyValue()
%CreateSection()
%OnAfterTransformation()
%OnBeforeTransformation()
%OnCreateKeyValue()
%OnCreateSection()

Parameters

parameter DEFAULTSECTIONHEADER = no header;

Methods

final classmethod %Apply(ByRef pString As %String, Output pOutput As %iKnow.TextTransformation.Output) as %Status

Invokes the model defined in Transformation on the string pString, identifying sections, headers and key-value pairs as specified in the model. These elements are returned through an pOutput object of the output class specified in the model, defaulting to %iKnow.TextTransformation.Output.

pString may also be supplied as an array of strings representing consecutive lines of text (by reference). To invoke the model in batch on a bunch of records, use %ApplyBatch().

final classmethod %ApplyBatch(pResultSet As %ResultSet) as %Status

Invokes the model specified in Transformation on all records retrieved by pResultSet, populating and saving an output object for each record. The first column of pResultSet is used as an identifier and saved as the Ref property of the output object. The second column is assumed to contain the text to be transformed by this model.

Note that the output object used for this batch operation should inherit from %Persistent in order for the output to be effectively persisted.

See also %Apply().

final classmethod %ApplyStream(pStream As %Stream.Object, Output pOutput As %iKnow.TextTransformation.Output) as %Status

Invokes the transformation model on a character stream. See also %Apply().

final method %CreateKeyValue(ByRef pOutput As Output, pHeader As %String, pKey As %String, pValue As %String, pLocation As OutputLocation) as %Status

Helper method to create a KeyValue object. Custom code in any of the callbacks (such as %OnBeforeTransformation()) may invoke this method to add default key value pairs.

final method %CreateSection(ByRef pOutput As Output, pHeader As %String, pText As %String, pLocation As OutputLocation, ByRef pKeyValues) as %Status

Helper method to create a Section object. Custom code in any of the callbacks (such as %OnBeforeTransformation()) may invoke this method to add default sections. Note that no further callbacks are invoked for key-value pairs in the pKeyValues array.

method %OnAfterTransformation(ByRef pOutput As Output) as %Status

This callback method is invoked after a record has been processed, before the Output object is saved.

method %OnBeforeTransformation(ByRef pOutput As Output) as %Status

This callback method is invoked before a record is processed, after the Output object has been instantiated.

method %OnCreateKeyValue(ByRef pKeyValue As OutputKeyValue, ByRef pOutput As Output) as %Status

Callback method invoked upon the creation of a KeyValue object. Use this callback to customize behavior upon creating key-value pairs. Setting pKeyValue to null will prevent the key-value pair from being added to the output.

method %OnCreateSection(ByRef pSection As OutputSection, ByRef pOutput As Output) as %Status

Callback method invoked upon the creation of a Section object. Use this callback to customize behavior upon creating sections. Setting pSection to null will remove the section from the output.