TolliumControllerBase::SendApplicationMessage (open)

Send a message to an application, launch it if needed

Syntax

LOADLIB "mod::tollium/lib/internal/controllerbase.whlib";

MACRO SendApplicationMessage(STRING app, RECORD apptarget, RECORD messagedata, BOOLEAN reuse_instance)

Parameters

STRING app

Name of the application to start (usually 'modulename.applicationname')

RECORD apptarget

The target (eg document, schema) of the application. May be an empty record. An application instance only matches if it has the same application name and target

RECORD messagedata

If an existing record is passed, this is sent to the 'onmessage' handler of the application

BOOLEAN reuse_instance

If true, do not start a new instance of the application if it is already running, but pass the message to the existing application

Description

Application messages offer a one-way communication channel between applications, and allows for a way to start new applications