Skip to content

CTX

Introduction

The CTX pre-defined object returns information about the options influencing the analysis or the definitions of the extraction templates.

The methods of the object are described below.

getOptions

The getOptions method returns an object whose properties represent the options affecting or reflecting the analysis.
When used in the Studio IDE, the options are those set in Studio project settings plus others related to the analysis. For example, the JSON corresponding to the returned object could be like this:

{
    "enhanced_output": "false",
    "debugger": "true",
    "debugger_port": "9091",
    "explain_rule": "-1",
    "all_categories": "true",
    "filename": "Doc185672.xml.txt"
}

where:

  • enhanced_output: the current value of the Enable Advanced Disambiguation Info configuration property.
  • debugger: if true, the Studio IDE debugger is on.
  • debugger_port: the current value of the Debugger Port configuration property.
  • all_categories: corresponds to the Show All Categories configuration property.
  • filename: the name of the file being analyzed.

When using the text intelligence engine via the Studio Local Deployment Agent API or when uploading a model to Platform and then publishing the model to NL Flow, putting it in a workflow and using it via NL Flow API, the options are those specified in the input JSON under the options key. For example:

"options": {
    "custom": {
        "doSomethingSpecial": true
    }
}

The custom key in the input JSON corresponds to the custom_options property of the object returned by the method.

The syntax is:

CTX.getOptions()

For example, this code can access the doSomethingSpecial option of the example above and takes it into account:

var options = CTX.getOptions();

if( options.hasOwnProperty('custom') &&
    options.custom.hasOwnProperty('doSomethingSpecial') ) {
    // Do something special
}

getTemplates

The getTemplates method returns an array containing the definition of the extraction templates with their fields and fields' attributes.

For example, the JSON corresponding to the array could be something like this:

[
    {
        "template": "TEMPLATE01",
        "fields": [
            {
                "field": "FIELD01",
                "cardinal": "false",
                "solitary": "false"
            },
            {
                "field": "FIELD02",
                "cardinal": "false",
                "solitary": "false"
            }
        ]
    }
]

where cardinal and solitary are field attributes.

The syntax is:

CTX.getTemplates()

getTaxonomy

The getTaxonomy method returns an array of objects containing the project taxonomy.

Each item of the array represent a node of the taxonomy—a domain—with its descendants and has this structure:

{
    "name": domainName,
    "label": domainLabel[,
    "domains": array]
}

where domainName is the name of the domain, domainLabel is the optional label of the domain and domains, which is present only for non-leaf nodes, is an array each item of which represents a child node and as the same structure as above.

The syntax is:

CTX.getTaxonomy()

getAttributeMatch

The getAttributeMatch method must be used in functions invoked via the SCRIPT attribute used in a plus (+) combination with another attribute, for example:

KEYWORD("an apple a day keeps the doctor away") + SCRIPT(function)

The method returns the range of tokens matched by the previous attribute.
For example, given a rule with a condition containing the operand above, if the analyzed text is:

As the saying goes, an apple a day keeps the doctor away.

and the function specified as an argument to the SCRIPT attribute is like this:

function testAttributeMatch(index, params) {
    var match = CTX.getAttributeMatch();
    ...

during the analysis the match variable is an object like this:

{
    "tokenBegin": "5",
    "tokenEnd": "12"
}

tokenBegin is the number of the first token of the range matched by the KEYWORD attribute (an), tokenEnd is the number of the last token of the range (away).

Depending on the values of tokenBegin and tokenEnd and other variables, the function code can return true (the SCRIPT attribute is matched) or false (the SCRIPT attribute is not matched), in order to make true or false the combination with the previous attribute, i.e. the entire operand of the condition.

The syntax of the method is:

CTX.getAttributeMatch()