Differenze

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

--- sviluppo:cityware_wizard [2016/09/08 10:29] – l.cardinali
+++ sviluppo:cityware_wizard [2024/10/15 09:45] (versione attuale) – modifica esterna 127.0.0.1
@@ Linea 6: / Linea 6: @@
   * **wizardable**: Interfaccia da implementare obbligatoriamente
-  * **wizardableGrids**: Interfaccia da implementare se nella pagina ci sono grid popolate a mano (non tramite sql)
 ====== Wizard Container ======
@@ Linea 62: / Linea 61: @@
-Implementando l'interfaccia wizardable, verrà richiesto di implementare il metodo 'validaWizardStep($formData, &$msg)' in cui va gestita la validazione della form al click del tasto 'avanti'. Il metodo deve tornare true o false in base al risultato e concatenare i messaggi di errore su $msg.
+Implementando l'interfaccia wizardable, verrà richiesto di implementare i metodi:
+======
+* ** validaWizardStep($formData, &$msg)** in cui va gestita la validazione della form al click del tasto 'avanti'. Il metodo deve tornare true o false in base al risultato e concatenare i messaggi di errore su $msg.
+======
+* ** setValueToSave()** che serve per settare eventuali var non presenti in $_POST che si vogliono mantenere in cache. Deve tornare un array di elementi con chiave il nome del setter delle proprietà da gestire e valore i rispettivi record contenuti.
+es. Si deve utilizzare per risettare il valore delle grid.  Questo perché dalla $_POST non è possibile reperire il contenuto della grid per metterlo in cache e quindi all'indietro si perderebbe il contenuto.
+======
+* ** getAppliedCache()/setAppliedCache($appliedCache);** getter e setter da implementare (creare anche la property private $appliedCache; e gestirla nel getter/setter) per capire quando la form è stata aperta applicando la cache (getAppliedCache = true) oppure no. Se è stata applicata la cache ad esempio le combo devono essere inizializzate col valore precedente invece che con 'Selezionare..' di default.
-Implementando invece l'interfaccia wizardableGrids, verrà richiesto di implementare il metodo returnGridsValue() che deve tornare un array di elementi con chiave il nome della grid e valore i record contenuti. Questo perché dalla $_POST non è possibile reperire il contenuto della grid per metterlo in cache e quindi all'indietro si perderebbe il contenuto.
+All'evento 'indietro' la cache è automatica, mentre per gestire la cache all'avanti va implementato il metodo **applyCacheNext($currentNameForm, $oldNameForm, $cacheValue)**. Questo metodo torna la form corrente in cui si sta andando, quella precedente e la cache della form corrente. I valori in cache vanno confrontati con quelli in $_POST per capire se sono state eseguite modifiche alla form precedente che annullano la validità della cache sulla form successiva(return false) oppure no (return true). Se questo metodo torna true verrà applicata la cache sennò no.
 Per gestire il salvataggio finale/azioni varie è possibile in ogni step, aggiungere delle operazioni o salvarsi dei dati.
@@ Linea 74: / Linea 80: @@
 In questo modo si aggiunge un valore in cache per poi riutilizzarlo alla fine (metodo postComplete). Se viene passata $formName oppure $formName e $formKey questo valore viene pulito in automatico facendo indietro dalla form '$formName' se invece non si passa $formName il valore rimane fisso ed al limite può essere cancellato a mano (cleanFixedParameterCache).
 es.
-$this->addFixedParameterCache('CODPROF', $_POST['cwdDtaTitstuWiz_CODPROF'], $currentStep, $currentKey);
+''$this->addFixedParameterCache('CODPROF', $_POST['cwdDtaTitstuWiz_CODPROF'], $currentStep, $currentKey);''
 ======
@@ Linea 84: / Linea 90: @@
 es.
-$value = array('PROGENTE' => 1,'DESCRIZ' => "Prova",'ALIAS' => "PROVA");
+  '' $value = array('PROGENTE' => 1,'DESCRIZ' => "Prova",'ALIAS' => "PROVA");
-$this->addOperationCache($currentStep, $currentKey, "salvoGruppi", itaModelService::OPERATION_INSERT, "BOR_GRUPPI", $value);
+    $this->addOperationCache($currentStep, $currentKey, "salvoGruppi", itaModelService::OPERATION_INSERT, "BOR_GRUPPI", $value);''
@@ Linea 92: / Linea 98: @@
 Se vanno eseguite delle operazioni fuori transazione,al 'conferma' è disponibile anche il metodo generateOutput() che parte dopo postComplete ed è fuori transazione.
-Per gestire i messaggi finali, in caso di errore o esito positivo, nella superclasse ci sono $completeErrorMsg e $completeMsg che vanno valorizzati con i messaggi da stampare ($completeMsg se non valorizzato di default prende: 'Pratica conclusa con successo').
+Per gestire i messaggi finali, in caso di errore o esito positivo, nella superclasse ci sono $completeErrorMsg e $completeMsg che vanno valorizzati con i messaggi da stampare ($completeMsg se non valorizzato di default prende: 'Pratica conclusa con successo'). {{counter}} visualizzazioni.