Skip to main content
Version: 1.2.x

Class: Processor

Methods

expandString()

expandString(toExpand): string

Expands all macros contained in a string. For example, if you want to use the USERNAME environment variable, which you have defined in an Environment Resource you can do so like this:

// Get the username which is defined in one of your environment resources:
let username = processor.expandString('The username is ${lay:USERNAME}.');

// Output: "The username is layline.", where "layline" is the value of the USERNAME environment variable.

Check out the macro documentation for more information on how to address expandable strings.

Parameters

toExpand: string

Returns

string

Expanded string


getArguments()

getArguments(): object

Returns arguments which you have configured via the UI as part of a Javascript Asset. The list of provided arguments are in JSON-Format. You enter them using the Javascript Asset editor and then retrieve them using this method.

Returns

object

Configured arguments as a Javascript object

Example

// Get the Processor's configured arguments:
const args = processor.getArguments();

// Now access the individual arguments like this:
let myProp = args.myProp;

getName()

getName(): string

Get the name of the current Processor.

Returns

string

Processor name

Example

// Get the Processor's name:
processor.getName();

getOutputPort()

getOutputPort(portName): OutputPort

Get the OutputPort information for a given output port.

Parameters

portName: string

Returns

OutputPort

Output port instance information.

Example

// Set stream output name:
let OUTPUT_PORT = processor.getOutputPort('Output');

logError()

logError(msg): void

Logs a message with Severity.ERROR to the processor log. You can view this both via the Audit Trail in the UI and output in the process terminal output.

Parameters

msg: string

Information you want to log.

Returns

void

Example

processor.logError('Ran into the following problem: ' + problem);

logFatal()

logFatal(msg): void

Logs a message with Severity.FATAL to the processor log. You can view this both via the Audit Trail in the UI and output in the process terminal output.

Parameters

msg: string

Information you want to log.

Returns

void

Example

processor.logFatal('Ran into the following problem: ' + problem);

logInfo()

logInfo(msg): void

Logs a message with Severity.INFO to the processor log. You can view this both via the Audit Trail in the UI and output in the process terminal output.

Parameters

msg: string

Information you want to log.

Returns

void

Example

processor.logInfo('Here is some interesting information: ' + info);

logWarning()

logWarning(msg): void

Logs a message with Severity.WARNING to the processor log. You can view this both via the Audit Trail in the UI and output in the process terminal output.

Parameters

msg: string

Information you want to log.

Returns

void

Example

processor.logWarning('Here is a warning: ' + warning);