Variables and parameters

getVariable(varName)

Get a value stored in the predefined variables, automatically set by Platform, when the user logs on; value is fetched starting from the varName identifier

Argument	Description
varName	variable identifier

Example:

var languageId = getVariable("LANGUAGE_ID");
var languageId = getVariable("languageId");

getAppParameter(name)

Get a parameter value defined at application level, through the Web Designer in the Application Parameter folder of the App detail window.
Required parameters are:

Parameter	Description
name-parameter	name

getPanelParameter(name)

Get a parameter value passed to the current panel (trough the window args variable).
Required parameters are:

Parameter	Description
name-parameter	name

Example

//From the window "A" I open the window "B"

//Window A
var args = \{
    param1: "MyCustomParam"
\};

//...
//Window B
getPanelParameter('param1');   //Output: "MyCustomParam"

getBaseURL()

Fetch the base URL used by the app to connect to Platform's server side installation. This method is tipically used by getWebContent method.

getCurrentDate()

Return an internal string representation of the current date (with "yyyy-MM-dd" format), that can be used when creating javascript objects to insert/update and you need to pass a date.

getCurrentDateAndTime()

Return an internal string representation of the current date (with "yyyy-MM-dd HH:mm:ss" format), that can be used when creating javascript objects to insert/update and you need to pass a date.

getGPSLongitude()

returns the longitude GPS coordinate, expressed as a string

getGPSLatitude()

returns the latitudine GPS coordinate, expressed as a string

getUsername()

get the current user id

getApplicationId()

get the current applicationid

getToken()

get the authentication token, which can be used in case you need to invoke Platform web services; the parameter to include in the URL is: "&restfulToken="+getToken()

Note: It is strongly recommended to pass a String value, not a complex object, to ensure compatibility between Android and iOS apps

getUUID()

Return random UUID (UNIQUEIDENTIFIER) string.

STORE VARIABLES:

setUserSessionVariable(varName,varValue, log)

store temporarelly a value in the user mobile session; value is referred by the varName

log is an optional parameter available from versione 6.0.2, if true log the variable, default il false.

getUserSessionVariable(varName, log)

get a value previously stored in the user mobile session; value is fetched starting from the varName identifier

log is an optional parameter available from versione 6.0.2, if true log the variable, default il false.

setUserAppCustomVariable(varNames,varValues)

store temporarily a value in the user mobile and server session; value is referred by the varName
varNames and varValues can be a list of comma separated strings

var valueOfVarName = setUserAppCustomVariable('varName', 'value');
setUserAppCustomVariable('varName1,varName2,varName3', 'value1,value2,value3');

getUserAppCustomVariable(varName)

get a value previously stored in the user mobile and server session; value is fetched starting from the varName identifier

var valueOfVarName = getUserAppCustomVariable(varName);
logger('valueOfVarName: ' + valueOfVarName);

setLocalPersistentVariable(varName, varValue)

Store a value in the user mobile; value is referred by the varName
varValue can be an Object

Argument	Description
varName	variable name to set
varValue	Object to set on the variable

Example:

var value1 = \{"field1":"value for field 1", "field2": 2\};
var value2 = "value 2";
setLocalPersistentVariable("varName1", value1);
setLocalPersistentVariable("varName2", value2);

getLocalPersistentVariable(varName)

Get a value in the user mobile; value is referred by the varName
varName can be an Object

Argument	Description
varName	variable name to set

Example:

var value1 = getLocalPersistentVariable("varName1");
var value2 = getLocalPersistentVariable("varName2");

var opts = new Object();
opts['title'] = "Local Variables";
opts['subtitle'] = 'varName1: field1='+value1.field1+"\n    field2="+value1.field2+"\n"+
                   'varName2: '+value2;
opts['titleButtonSuccess'] = 'Ok';
var fun1 = function() \{ \};
showMessageDialog(opts,"fun1");

getAllUserSessionKeys()

Return an array with all key in user session.