Differenze

Queste sono le differenze tra la revisione selezionata e la versione attuale della pagina.

--- custom:api_js_session_parameters [2023/09/05 10:24]
giorgio.scali
+++ custom:api_js_session_parameters [2023/09/13 12:09] (versione attuale)
giorgio.scali [removeGwSessionParameters()]
@@ Linea 2: / Linea 2: @@
 Esistono delle API per poter gestire dei parametri legati alla sessione utente corrente:
   * [[:custom:api_js_session_parameters#addGwSessionParameter|addGwSessionParameter()]]
   * [[:custom:api_js_session_parameters#addGwSessionParameters|addGwSessionParameters()]]
   * [[:custom:api_js_session_parameters#getGwSessionParameters|getGwSessionParameters()]]
+  * [[:custom:api_js_session_parameters#setGwSessionParameters|setGwSessionParameters()]]
   * [[:custom:api_js_session_parameters#removeGwSessionParameter|removeGwSessionParameter()]]
   * [[:custom:api_js_session_parameters#clearAllGwSessionParameters|clearAllGwSessionParameters()]]
+  * [[:custom:api_js_session_parameters#clearGwSessionParameters|clearGwSessionParameters()]]
 ==== addGwSessionParameter() ====
-Aggiunge un paramtero //paramName// in sessione, con valore //paramValue//.
+Aggiunge un paramtero //paramName// in sessione, con valore //paramValue//. Se il parametro è già presente il suo valore viene sovrascritto. Gli altri parametri non sono modificati.
 <code javascript>
@@ Linea 26: / Linea 28: @@
 ==== addGwSessionParameters() ====
-Aggiunge tutti i parametri di //parametersMap// in sessione.
+Aggiunge tutti i parametri di //parametersMap// in sessione. Se i parametri sono già presenti i loro valori vengono sovrascritti. Gli altri parametri non sono modificati.
 <code javascript>
 var parametersMap = {p1: 'one', p2: 2};
 var params = {
 	callback: function(jsonServerResponse){
+		let success = jsonServerResponse.success;
+		let description = jsonServerResponse.description;
+		let sessionParameters = jsonServerResponse.responseHashMap.sessionParameters;
 	},
 	errorCallback: function(jsonServerResponse){
@@ Linea 37: / Linea 43: @@
 addGwSessionParameters(parametersMap, params);
 </code>
 ==== getGwSessionParameters() ====
@@ Linea 45: / Linea 50: @@
 	callback: function(sessionParameters){
 		var p1 = sessionParameters.p1;
-			...
+		...
 	},
 	errorCallback: function(jsonServerResponse){
@@ Linea 51: / Linea 56: @@
 };
 getGwSessionParameters(params);
+</code>
+==== setGwSessionParameters() ====
+**Dalla versione 4.6.9**
+Imposta i parametri di //parametersMap// in sessione. Sovrascrivendo tutti i parametri eventualmente gia presenti.
+<code javascript>
+var parametersMap = {p1: 'one', p2: 2, p3: true};
+var params = {
+	callback: function(jsonServerResponse){
+		let success = jsonServerResponse.success;
+		let description = jsonServerResponse.description;
+		let sessionParameters = jsonServerResponse.responseHashMap.sessionParameters;
+	},
+	errorCallback: function(jsonServerResponse){
+	}
+};
+setGwSessionParameters(parametersMap, params);
 </code>
 ==== removeGwSessionParameters() ====
-Rimuove i parametri della mappa dalla sessione. Vengono valutate le sole //key//
+Rimuove i parametri della mappa dalla sessione. Vengono valutate le sole //key//. Gli altri parametri non vengono modificati.
 <code javascript>
 var sessionParameters = {p1: null, p2: null, p3: null};
-	var params = {
+var params = {
-		callback: function(sessionParameters){
+	callback: function(jsonServerResponse){
+		let success = jsonServerResponse.success;
+		let description = jsonServerResponse.description;
+		let sessionParameters = jsonServerResponse.responseHashMap.sessionParameters;
 		var p4Value = sessionParameters.p4;
 		...
@@ Linea 65: / Linea 92: @@
 	}
 };
-removeGwSessionParameters(params);
+removeGwSessionParameters(sessionParameters, params);
 </code>
 ==== clearAllGwSessionParameters() ====
-Rimuove tutti i parametri dalla sessione
+**@Deprecated**
+Rimuove tutti i parametri dalla sessione.
+<code javascript>
+clearAllGwSessionParameters();
+</code>
+==== clearGwSessionParameters() ====
+**Dalla 4.6.9**
+Rimuove tutti i parametri dalla sessione.
 <code javascript>
 var params = {
-	callback: function(sessionParameters){
+	callback: function(jsonServerResponse){
+		let success = jsonServerResponse.success;
+		let description = jsonServerResponse.description;
+		let sessionParameters = jsonServerResponse.responseHashMap.sessionParameters;
 		//sessionParameters empty now
 		...
@@ Linea 80: / Linea 120: @@
 	}
 };
-clearAllGwSessionParameters(params);
+clearGwSessionParameters(params);
 </code>