Differenze

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

--- custom:api_js_gw_action [2022/06/14 17:20]
giorgio.scali creata
+++ custom:api_js_gw_action [2023/02/13 17:55] (versione attuale)
andrea.bocconi
@@ Linea 1: / Linea 1: @@
-executeGwAction();
+====== GwAction ======
- *
- * this will cause the execution of the gwAction, with name gwActionName, existing under the gwClass with name gwClassName
- * the gwAction will be invoked with the declared set of parameters, availables under the specified variables names
- *
- * @param gwActionName, String, required
- * @param gwClassName, String, required
- * @param functionParametersNames, String[], optional default []
- * @param functionParameters, Object[], optional default []
- * @returns
- *
- * Example:
-	var gwActionName = 'gwActionName';
-	var gwClassName = 'gwClassName';
-	var functionParametersNames = ['param1', 'param2'];
-	var functionParameters = ['abc', 123];
-	executeGwAction(gwActionName, gwClassName, functionParametersNames, functionParameters);
+===== executeGwAction() =====
-====== executeGwAction() ======
 This will cause the execution of the gwAction, with name gwActionName, existing under the gwClass with name gwClassName
@@ Linea 39: / Linea 20: @@
 executeGwAction(gwActionName, gwClassName, functionParametersNames, functionParameters);
+</code>
+==== Suggerimenti ====
+DA REPORT
+Se si hanno più pulsanti che aprono la stessa azione della stessa classe, ma con diverso numero di parametri passati
+es:
+<code javascript>// pulsante 1
+var avoidReturn = executeGwAction('open_detail', 'sec_service', ['itemId','layoutName'], ['newItem','new_service']);</code>
+<code javascript>// pulsante 2
+var avoidReturn = executeGwAction('open_detail', 'sec_service', ['itemId','layoutName','cod_order'], ['newItem','edit_service','ORD1']);</code>
+è necessario passare lo stesso numero di parametri, ovvero il numero massimo (nell'esempio 3 per entrambi, anche se la prima non utilizza il terzo parametro), altrimenti se viene eseguita per prima l'azione con meno parametri verrà passato il numero di parametri di quell'azione anche quando si proverà a lanciare una qualsiasi delle altre azioni.
+Diventa quindi:
+es:
+<code javascript>// pulsante 1
+var avoidReturn = executeGwAction('open_detail', 'sec_service', ['itemId','layoutName','cod_order'], ['newItem','new_service']);</code>
+<code javascript>// pulsante 2
+var avoidReturn = executeGwAction('open_detail', 'sec_service', ['itemId','layoutName','cod_order'], ['newItem','edit_service','ORD1']);</code>
+===== executeGwActionOnGwClassDetail() =====
+Execute js action in the gwClassDetail context. Like gwAction in toolbal, or in '...' button for the single record.
+ACL and DACL are checked server side.
+==== Parametri ====
+  * **gwClassName** String, required
+  * **itemId** String, required
+  * **gwActionName** String, required
+==== Esempi ====
+<code javascript example.js>
+var itemId = '123';
+var gwClassName = 'gwClassName';
+var gwActionName = 'gwActionName';
+executeGwActionOnGwClassDetail(gwClassName, itemId , gwActionName);
+</code>
+===== checkGwActionPermissions() =====
+This will check static and dynamic permissions for the gwAction, with name gwActionName, existing under the gwClass with name gwClassName
+The callback is invoked with argument the server side computed data
+If the gwAction with the specified name is not found a warn is however logged
+If gwActiveUser ha no execute permission upon the gwAction with the specified name a warn is however logged
+==== Parametri ====
+  * **gwActionName** String, required
+  * **gwClassName** String, required
+  * **itemId**, String, required
+  * **callback**, Object, required. Invoked at end with an incoming parameter Object done this way: {hasAction: true, gwAction: {..}, hasPermission: true}
+==== Esempi ====
+<code javascript example.js>
+var gwActionName = 'gwActionName';
+var gwClassName = 'gwClassName';
+var itemId = '123';
+var callback = function(
+	parmas //Object
+){
+	var hasAction = parmas.hasAction;
+	var gwAction = parmas.gwAction;
+	var hasPermission = parmas.hasPermission;
+	var item = parmas.item;
+	if(hasAction && gwAction && hasPermission){
+		//TODO
+	}
+};
+checkGwActionPermissions(gwActionName, gwClassName, itemId, callback);
 </code>