SystemApp Object

In logic, a SystemApp is an object that contains information about the parameters to be used when calling a system application. A system application is an application that is loaded on a device and is generally not part of the CSPro suite of applications and tools. On Android, the SystemApp object also stores any information that resulted from the running of the system application.

Functionality

A SystemApp is a CSPro logic object and the following functions can be called via dot notation:

Function	Description
clear	Clears any stored arguments.
exec	Executes the system application.
getResult	Gets a result returned from the system application.
setArgument	Stores the argument for use when executing the system application.

getLabel	Returns the symbol's label.
getName	Returns the symbol's name.
getJson	Returns the symbol's metadata and value represented in JSON.
getValueJson	Returns the symbol's value represented in JSON.
updateValueFromJson	Modifies the symbol based on a JSON representation of the value.

Assignments

When a SystemApp is used as an argument to a user-defined function, it is passed by reference.

Example

// play the training video in Windows Media Player
SystemApp windows_media_player;
windows_media_player.setArgument(pathconcat("../Videos/Census Training.mp4"));
windows_media_player.exec("wmplayer.exe");