Differenze

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

--- gwusermanual:interface [2019/11/06 09:42]
127.0.0.1 modifica esterna
+++ gwusermanual:interface [2022/05/10 18:29] (versione attuale)
giorgio.scali [Accordion e LeafItem]
@@ Linea 129: / Linea 129: @@
 ===XML leaf-item gwClassList===
 Utilizzato per la visualizzazione dei record di una classe di Geoweb in una lista «standard», presenta il seguente XML di configurazione (che dovrà essere incluso all’interno di un tag di tipo «accordion».
-<code java>
+Elenco attributi tag <leafItem>:
-<leafItem name="leafitem name" label="leafitem label" image="leafitem_image.png" type="gwClassList">
+  * **name** = nome del leaf item
-     <parameter name="className" value="class_name" hideToClient="false"></parameter>
+  * **label** = etichetta del leaf-item visualizzata nel menù di II° livello
+  * **image** = nome dell’immagine visualizzata nel menù di II° livello (../WEB/images)
+Elenco parametri:
+  * **gwClassName**: String, required. nome della classe di Geoweb
+  * **forcedToCheckDynamicPermissionActionsNamesList**: (**Dalla v 4.4.18**) String, optional. Lista, comma separated (',') dei nomi delle azioni di tipo //'Selezionati in Lista'/'Selezionati in Lista (Posto nella Toolbar)//' su cui forzare il check delle DACL (opportunamente configurate)
+Elenco parametri Deprecati:
+  * gwClassName: @Deprecated String, required. nome della classe di Geoweb
+Esempi:
+<code xml>
+<leafItem name="leafitem name" label="leafitem label" image="image.png" type="gwClassList">
+     <parameter name="gwClassName" value="gw_class_name" hideToClient="false"></parameter>
 </leafItem>
 </code>
+<code xml>
-  * leafitem name = nome del leaf item
+<leafItem name=«lf_risorse_umane" label="Risorse Umane" image="img_risorse_umane.png" type="gwClassList">
-  * label = etichetta del leaf-item visualizzata nel menù di II° livello
+     <parameter name="gwClassName" value="hr_risorse_umane" hideToClient="false"></parameter>
-  * image = nome dell’immagine visualizzata nel menù di II° livello (../WEB/images)
+</leafItem>
-  * className = nome della classe di Geoweb
+</code>
-<code java>
+<code xml>
-<leafItem name=«lf_risorse_umane" label="Risorse Umane" image=«img_risorse_umane.png" type="gwClassList">
+<leafItem name=«lf_risorse_umane" label="Risorse Umane" image="image.png" type="gwClassList">
-     <parameter name="className" value="hr_risorse_umane" hideToClient="false"></parameter>
+     <parameter name="gwClassName" value="gw_class_name" hideToClient="false"></parameter>
+     <parameter name="forcedToCheckDynamicPermissionActionsNamesList" value="gwActionName1,gwActionName2" hideToClient="false"></parameter>
 </leafItem>
 </code>
@@ Linea 330: / Linea 343: @@
 Utilizzato per l’esecuzione del codice di una azione, presenta il seguente XML di configurazione (che dovrà essere incluso all’interno di un tag di tipo «accordion».
-<code java>
+<code xml>
 <leafItem name=" leafitem_name" label=" leafitem_label" image=" leafitem_image.png" type="gwAction">
       <parameter name="gwClassName" value="class_name" hideToClient="false"></parameter>
@@ Linea 336: / Linea 349: @@
 </leafItem>
 </code>
+Attributi tag <leafItem> specifici:
+  * **autorun** Boolean, default, false. Quano il leafItem è il primo del primo //MenuDiSecondoLivello// del primo //MenuDiPrimoLivello//, con questo parametro a true, l'azione viene eseguita in automatico all'apertura del progetto
+  * **checkDynamicPermission** Boolean, default, false. (dalla **v 4.4.18**). Quando a true viene forzata la valutazione delle DACL anche al di fuori del contesto del gwRecord, come appunto è un leafItem. Da utilizzare previa specifica configurazione nel webadmin di FILTRI CUSTOM (o trasformati in CUSTOM automaticamente da Geoweb)
+Esempio codice con autorun:
+<code xml>
+<leafItem name=" leafitem_name" label=" leafitem_label" image=" leafitem_image.png" type="gwAction" autorun="true">
+      <parameter name="gwClassName" value="class_name" hideToClient="false"></parameter>
+      <parameter name="gwActionName" value="action_name" hideToClient="false"></parameter>
+</leafItem>
+</code>
+Esempio codice con checkDynamicPermission:
+<code xml>
+<leafItem name=" leafitem_name" label=" leafitem_label" image=" leafitem_image.png" type="gwAction" checkDynamicPermission="true">
+      <parameter name="gwClassName" value="class_name" hideToClient="false"></parameter>
+      <parameter name="gwActionName" value="action_name" hideToClient="false"></parameter>
+</leafItem>
+</code>
 ===XML leaf-item leafItemHierarchicalFilterMenu===
@@ Linea 515: / Linea 551: @@
 __**Parametri**__
-  * "className", String, richiesto, il nome della classe Geoweb della quale si vuole aprire la lista dei record.
+  * **className**, String, richiesto, il nome della classe Geoweb della quale si vuole aprire la lista dei record.
-  * "staticFilters", Object [], opzionale, default null, permette di imporre criteri di filtro per poter mostrare solo i record di dati aderenti. Array di oggetti JSON filtro [TODO MAKE LINK] del tipo:
+  * **staticFilters**, Object [], opzionale, default null, permette di imporre criteri di filtro per poter mostrare solo i record di dati aderenti. Array di oggetti JSON filtro [TODO MAKE LINK] del tipo:
  <code java>
      {
@@ Linea 528: / Linea 564: @@
 </code>
-  * "hideToolbar", Boolean , opzionale, default false, se true nasconde la Toolbar
+  * **hideToolbar**, Boolean , opzionale, default false, se true nasconde la Toolbar
-  * "hideNewIgnorePermissions", Boolean , opzionale, default false, se true nasconde dalla Toolbar il tasto Nuovo a prescindere dai permessi che ha il gruppo a cui appartiene l'utente su quella classe
+  * **hideNewIgnorePermissions**, Boolean , opzionale, default false, se true nasconde dalla Toolbar il tasto Nuovo a prescindere dai permessi che ha il gruppo a cui appartiene l'utente su quella classe
-  * "hideDeleteIgnorePermissions", Boolean , opzionale, default false, se true nasconde dalla Toolbar il tasto Cancella a prescindere dai permessi che ha il gruppo a cui appartiene l'utente su quella classe
+  * **hideDeleteIgnorePermissions**, Boolean , opzionale, default false, se true nasconde dalla Toolbar il tasto Cancella a prescindere dai permessi che ha il gruppo a cui appartiene l'utente su quella classe
-  * "forceListedAttributes" Boolean , opzionale, default false, lavora insieme al parametro 'listedAttributesNames' se true mostra in griglia solo le colonne degli attributi il cui name è specificato nella lista listedAttributesNames
+  * **hideActionsDropDownButtonColumn** Boolean, opzionale, default false. Determina se il button 'More Options' (AKA 'Tre puntini') sarà visibile o meno. Quando è valorizzato sovrascrive, localmente, l'eventuale configurazione globale per la specifica gwClass (o per tutte) che può essere impostata a livello di Progetto, nell'apposita sezione con tag <gwClassSettings>.
-  * "listedAttributesNames", ArrayList<String>, opzionale, default null, valutato solo se 'forceListedAttributes' vale true. Lista, separata da virgola, dei nomi degli attributi le cui colonne vogliamo compaiano in griglia
+  * **hideIndirectSelectionColumn** Boolean, opzionale, default false. Determina se la colonna della griglia adibita alla selezione delle singole righe sarà visibile o meno. Quando è valorizzato sovrascrive, localmente, l'eventuale configurazione globale per la specifica gwClass (o per tutte) che può essere impostata a livello di Progetto, nell'apposita sezione con tag <gwClassSettings>.
-  * "hideAttributesNamesList", ArrayList<String>, opzionale, default null,. Lista, separata da virgola, dei nomi degli attributi le cui colonne vogliamo non compaiano in griglia: vengono rimosse dagli attributi in lista impostati sulla classe. Viene valutato solo con hideAttributesNamesList diverso da true
+  * **forceListedAttributes** Boolean , opzionale, default false, lavora insieme al parametro 'listedAttributesNames' se true mostra in griglia solo le colonne degli attributi il cui name è specificato nella lista listedAttributesNames
-  * "customBeforeColumns", ArrayList<HashMap<String, String>>, opzionale, default null. Lista (Array) di oggetti, ognuno dei quali contiene tutte le informazioni necessarie alla renderizzazione di tutte le celle di una colonna. Queste colonne vengono aggiunte PRIMA delle colonne degli attributi base in lista della classe. Ogni colonna è definita da oggetti del tipo:
+  * **listedAttributesNames**, ArrayList<String>, opzionale, default null, valutato solo se 'forceListedAttributes' vale true. Lista, separata da virgola, dei nomi degli attributi le cui colonne vogliamo compaiano in griglia
+  * **hideAttributesNamesList**, ArrayList<String>, opzionale, default null. Lista, separata da virgola, dei nomi degli attributi le cui colonne vogliamo non compaiano in griglia: vengono rimosse dagli attributi in lista impostati sulla classe. Viene valutato solo con hideAttributesNamesList diverso da true
+  * **customBeforeColumns**, ArrayList<HashMap<String, String>>, opzionale, default null. Lista (Array) di oggetti, ognuno dei quali contiene tutte le informazioni necessarie alla renderizzazione di tutte le celle di una colonna. Queste colonne vengono aggiunte PRIMA delle colonne degli attributi base in lista della classe. Ogni colonna è definita da oggetti del tipo:
   * { formatter: 'column_formatter', label: 'Header Label', width: 'auto' || 50, headerStyles: 'color: red;', styles: 'color: red;' }
-  * dove formatter è il nome della funzione js che genera il contenuto della cella (invocata con questi argomenti: 'item', 'rowIndex', 'cell'), label è l'intestazione della colonna, width può essere un numero intero (px) o 'auto', headerStyles e styles sono regole css applicate rispettivamente ad intestazione della colonna e celle.
+  * dove //formatter// è il nome della funzione js che genera il contenuto della cella (invocata con questi argomenti: 'item', 'rowIndex', 'cell'), label è l'intestazione della colonna, width può essere un numero intero (px) o 'auto', headerStyles e styles sono regole css applicate rispettivamente ad intestazione della colonna e celle.
-  *  "customAfterColumns", ArrayList<HashMap<String, String>>, opzionale, default null. Lista (Array) di oggetti, ognuno dei quali contiene tutte le informazioni necessarie alla renderizzazione di tutte le celle di una colonna. Queste colonne vengono aggiunte DOPO delle colonne degli attributi base in lista della classe. Ogni colonna è definita da oggetti del tipo:
+  *  **customAfterColumns**, ArrayList<HashMap<String, String>>, opzionale, default null. Lista (Array) di oggetti, ognuno dei quali contiene tutte le informazioni necessarie alla renderizzazione di tutte le celle di una colonna. Queste colonne vengono aggiunte DOPO delle colonne degli attributi base in lista della classe. Ogni colonna è definita da oggetti del tipo:
   * { formatter: 'column_formatter', label: 'Header Label', width: 'auto' || 50, headerStyles: 'color: red;', styles: 'color: red;' }
-  * dove formatter è il nome della funzione js che genera il contenuto della cella (invocata con questi argomenti: 'item', 'rowIndex', 'cell'), label è l'intestazione della colonna, width può essere un numero intero (px) o 'auto', headerStyles e styles sono regole css applicate rispettivamente ad intestazione della colonna e celle.
+  * dove //formatter// è il nome della funzione js che genera il contenuto della cella (invocata con questi argomenti: 'item', 'rowIndex', 'cell'), label è l'intestazione della colonna, width può essere un numero intero (px) o 'auto', headerStyles e styles sono regole css applicate rispettivamente ad intestazione della colonna e celle.
-  * "onRowClickFunctionName", String, opzionale, default null. Se presente indica il nome di una funzione js la quale verrà invocata (passando questi paramenti [/*Integer*/ rowIndex, /*Object*/ grid]) al click della riga della griglia. Ha priorita su onRowClickFunction
+  * **onRowClickGwActionName**, String, opzionale, default null. Se presente indica il //name// della gwAction, esistente nella stessa gwClass, che sarà invocata con il seguente set di parametri  [/*Integer*/ rowIndex, /*Object*/ grid, /*Object*/ item]. Ha priorità su //onRowClickFunctionName//
-  * "onRowClickFunction", String, opzionale, default null. Se presente indica direttamente il codice js che verrà invocato (passando questi paramenti [/*Integer*/ rowIndex, /*Object*/ grid]) al click della riga della griglia.
+  * **onRowClickFunctionName**, String, opzionale, default null. Se presente indica il nome nel definito nel name-space globale di una funzione js la quale verrà invocata (passando questi paramenti [/*Integer*/ rowIndex, /*Object*/ grid]) al click della riga della griglia. Ha priorità su //onRowClickFunctionString//
+  * **onRowClickFunctionString**, String, opzionale, default null. Se presente indica direttamente il codice js che verrà invocato (passando questi paramenti [/*Integer*/ rowIndex, /*Object*/ grid, /*Object*/ item], al click della riga della griglia
+__**Parametri Deprecati**__
+  * **onRowClickFunction**, String, opzionale, default null. Se presente indica direttamente il codice js che verrà invocato (passando questi paramenti [/*Integer*/ rowIndex, /*Object*/ grid, /*Object*/ item], al click della riga della griglia. Il parametro è deprecato: usa
+ **onRowClickFunctionString** al suo posto.
 Nella parte superiore della scheda è presente una toolbar che, a seconda del set di permessi (statici e dinamici) impostati nel Geoweb Admin, mostra tutta una serie di bottoni, in ordine da sinistra a destra:
@@ Linea 578: / Linea 622: @@
 __**JavaScript**__\\
-<code java>
+Esempi con codice minimale:
+<code javascript>
+var gwClassName = 'gwd_resource';
+openGwClassListTab(gwClassName);
+</code>
+<code javascript>
+var gwClassName = 'gwd_resource';
+var tabWidgetTitle = 'Risorse Operative'; //optional
+openGwClassListTab(gwClassName, tabWidgetTitle);
+</code>
+Esempi con utilizzo filtri statici:
+<code javascript>
 var gwClassName = 'gwd_resource';
 var tabWidgetTitle = 'Risorse Operative'; //optional
-var parametersMap = { //optional
+var options = { //optional
     forceReplaceTab: true,
     staticFilters: [
@@ Linea 588: / Linea 645: @@
     ]
 };
-openGwClassListTab(gwClassName, tabWidgetTitle, parametersMap);
+openGwClassListTab(gwClassName, tabWidgetTitle, options );
 </code>
-O, con la notazione più generale:
+Esempi con la notazione più generale:
-<code java>
+<code javascript>
 var tabWidgetType = 'gwClassList';
 var identifier = 'resources_list';
@@ Linea 609: / Linea 666: @@
 openTab(tabWidgetId, tabWidgetType, tabWidgetTitle, parametersMap);
 </code>
 __**LeafItem**__\\