# 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:

```javascript
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**

```javascript
//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

```javascript
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

```javascript
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:

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

## g**etLocalPersistentVariable(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:

```javascript
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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://4wsplatform.gitbook.io/api-mobile/mobile-javascript-api/variables-and-parameters.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.