Differenze

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

--- custom:api_js_open_project_with_session_parameter [2020/02/03 18:08]
mariasole.angelucci
+++ custom:api_js_open_project_with_session_parameter [2020/02/04 12:48] (versione attuale)
mariasole.angelucci
@@ Linea 1: / Linea 1: @@
-====== Apertura di un progetto con una variabile in sessione ======
-Una volta selezionato un elemento della classe, lo apre in un progetto (che viene scelto all'interno dell'azione) e ne aggiorna le variabili di sessione. La pagina iniziale che viene aperta e il relativo gwMenuTitle devono essere opportunamente configurati nell'xml del progetto.
+====== Apertura di un progetto con parametri in sessione ======
+Questa azione, associata a una certa classe, permette di aprire un elemento della classe in un progetto che deve essere specificato nel corpo dell'azione.
+Una volta aperto il progetto, ne vengono aggiornati i parametri in sessione: questi ultimi possono essere visualizzati nel gwMenuTitle, che deve essere opportunamente configurato nell'xml del progetto (come descritto nella sezione [[gwusermanual:interface:interface:menu#titolo_di_progetto_con_variabile_di_sessione|Titolo di progetto con parametri in sessione]]).
 ===== Parametri =====
-  * **session_code_field**
+Il corpo dell'azione consiste di due parti: prima deve essere creato un oggetto chiamato "params", il quale va popolato delle proprietà descritte di seguito; infine viene richiamata una funzione //javascript// dal nome gwChangeElementsInSessionCallback, il cui input è, appunto, l'oggetto "params".
-  * **session_code_field_name**
+\\
-  * **cod2**
+Nel dettaglio, "params" deve contenere i seguenti valori:
-  * **show2**
+  * **browserWinName**: è il nome del progetto da aprire;
-  * **browserWinName**
+  * **session_code_field**:  è il nome del parametro in sessione che contiene il campo “fieldToStore” dell’elemento da visualizzare nel progetto. Deve avere lo stesso valore del parametro "session_code_field" definito all'interno della funzione gwChangeElementsInSessionStartup nel tag gwMenuTitle nell'xml del progetto;
+  * **session_code_field_name**: è il nome del parametro in sessione che contiene il campo “fieldToShow” dell’elemento da visualizzare. Anche il valore di questa proprietà è quello definito nell'xml del progetto;
+  * **cod2**: è il valore del campo "fieldToStore". Per ottenere tale valore, deve essere richiamato l'oggetto data.itemDB e poi si deve prendere da questo oggetto la proprietà di interesse utilizzando l'operatore punto e il nome del campo;
+  * **show2**: è il valore del campo “fieldToShow”, ottenuto come il precedente.
 ===== Esempio =====
-<code>
+<code javascript>
 var params = {};
+params.browserWinName = 'Assegnazione_spazi';
 params.session_code_field = 'session_building_code';
 params.session_code_field_name = 'session_building_code_name';
 params.cod2 = data.itemDB.cod_building;
 params.show2 = data.itemDB.name_building;
-params.browserWinName = 'Assegnazione_spazi_test';
 gwChangeElementsInSessionCallback(params);
 </code>