documentazione_3di_riservata:docway4:azioni_massive_lua
Differenze
Queste sono le differenze tra la revisione selezionata e la versione attuale della pagina.
| Entrambe le parti precedenti la revisioneRevisione precedenteProssima revisione | Revisione precedente | ||
| documentazione_3di_riservata:docway4:azioni_massive_lua [2017/10/17 10:54] – [Avvio di una specifica azione] mbernardini | documentazione_3di_riservata:docway4:azioni_massive_lua [Data sconosciuta] (versione attuale) – eliminata - modifica esterna (Data sconosciuta) 127.0.0.1 | ||
|---|---|---|---|
| Linea 1: | Linea 1: | ||
| - | ====== Azioni massive tramite Stored Procedure LUA ====== | ||
| - | |||
| - | Possibilità di lanciare delle azioni massive definite tramite stored procedure LUA da: | ||
| - | * Lista titoli derivanti da una ricerca su DocWay o ACL | ||
| - | * Visualizzazione di uno specifico record su DocWay o ACL | ||
| - | |||
| - | ===== Configurazione ===== | ||
| - | |||
| - | ==== File di properties ==== | ||
| - | |||
| - | Per attivare il modulo relativo alle azioni massive occorre settare la property // | ||
| - | |||
| - | < | ||
| - | # Abilitazione delle esportazioni massive tramite stored procedure LUA (' | ||
| - | abilitaAzioniMassiveLUA=no | ||
| - | |||
| - | # Nome della stored procedure LUA attraverso la quale recuperare l' | ||
| - | # dei relativi parametri di input). Corrisponde al parametro da passare al comando eXtraWay attraverso l' | ||
| - | # <?xml version=" | ||
| - | # <cmd stored=" | ||
| - | # </ | ||
| - | nomeStoredProcedureLuaAzioniMassive=$.massive.getAvailableMassiveOperations | ||
| - | </ | ||
| - | |||
| - | Oltre all' | ||
| - | |||
| - | ==== Diritti ==== | ||
| - | |||
| - | Da interfaccia applicativa, | ||
| - | |||
| - | <code xml acl.xml> | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | <group label=" | ||
| - | ... | ||
| - | <group label=" | ||
| - | ... | ||
| - | <right cod=" | ||
| - | </ | ||
| - | ... | ||
| - | </ | ||
| - | </ | ||
| - | ... | ||
| - | </ | ||
| - | </ | ||
| - | |||
| - | <code xml docway.xml> | ||
| - | < | ||
| - | < | ||
| - | <db nome=" | ||
| - | <group label=" | ||
| - | ... | ||
| - | <group label=" | ||
| - | ... | ||
| - | <right cod=" | ||
| - | </ | ||
| - | ... | ||
| - | </ | ||
| - | ... | ||
| - | </db> | ||
| - | ... | ||
| - | </ | ||
| - | </ | ||
| - | |||
| - | <WRAP center round info 100%> | ||
| - | Se i file dei diritti //acl.xml// e // | ||
| - | </ | ||
| - | |||
| - | <WRAP center round important 100%> | ||
| - | Se su DocWay sono stati configurati più archivi (es. archivio periferico) occorre definire il diritto di azioni massive per ogni archivio docway definito sul file docway.xml | ||
| - | </ | ||
| - | |||
| - | <code xml docway_periferico.xml> | ||
| - | < | ||
| - | < | ||
| - | <db nome=" | ||
| - | <group label=" | ||
| - | ... | ||
| - | <group label=" | ||
| - | ... | ||
| - | <right cod=" | ||
| - | </ | ||
| - | ... | ||
| - | </ | ||
| - | ... | ||
| - | </db> | ||
| - | ... | ||
| - | <db nome=" | ||
| - | <group label=" | ||
| - | ... | ||
| - | <group label=" | ||
| - | ... | ||
| - | <right cod=" | ||
| - | </ | ||
| - | ... | ||
| - | </ | ||
| - | ... | ||
| - | </db> | ||
| - | ... | ||
| - | </ | ||
| - | </ | ||
| - | |||
| - | ===== Specifiche funzionali ===== | ||
| - | |||
| - | Gli script LUA da realizzare per poter implementare le azioni massive su DocWay (o ACL) sono sintetizzati come segue: | ||
| - | * Uno script attraverso il quale recuperare l' | ||
| - | * Uno script per ogni azione massiva, corrispondente all' | ||
| - | |||
| - | Di seguito è indicata la definizione del paradigma di comunicazione implementato per la comunicazione fra l' | ||
| - | |||
| - | ==== Elenco azioni disponibili ==== | ||
| - | |||
| - | Recupero delle possibili azioni massive in base alla pagina dell' | ||
| - | |||
| - | === Richiesta === | ||
| - | |||
| - | <code xml> | ||
| - | <?xml version=" | ||
| - | <cmd stored=" | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | </ | ||
| - | </ | ||
| - | |||
| - | <WRAP center round important 60%> | ||
| - | **N.B.** I parametri indicati nel comando sopra non vengono inviati al server in chiaro ma codificati in Base64 (attributo **mode=" | ||
| - | </ | ||
| - | |||
| - | Sono previsti i seguenti parametri: | ||
| - | * **db** - corrisponde al database eXtraWay al quale sono connesso | ||
| - | * **page** - corrisponde alla pagina dell' | ||
| - | * **dbTable** - tipologia di record sul quale sto operando (es. @persona_interna, | ||
| - | * **N.B.** Il parametro //__dbTable potrebbe essere vuoto__//. Un esempio è il caricamento della lista titoli da ricerca globale | ||
| - | |||
| - | === Risposta === | ||
| - | |||
| - | <code xml> | ||
| - | <?xml version=" | ||
| - | <rsp ack=" | ||
| - | <dtl dtype=" | ||
| - | < | ||
| - | <azione titolo=" | ||
| - | <azione titolo=" | ||
| - | <azione titolo=" | ||
| - | < | ||
| - | <param id=" | ||
| - | </ | ||
| - | </ | ||
| - | <azione titolo=" | ||
| - | </ | ||
| - | </ | ||
| - | </ | ||
| - | </ | ||
| - | |||
| - | La risposta contiene l' | ||
| - | |||
| - | Per ogni azione massiva sono indicati le seguenti impostazioni: | ||
| - | * Nome dell' | ||
| - | * Descrizione dell' | ||
| - | * Nome della stored procedure LUA da invocare per avviare l' | ||
| - | |||
| - | Ogni azione massiva, inoltre, può prevedere l' | ||
| - | * Nome del parametro da settare per l' | ||
| - | * Etichetta da mostrare all' | ||
| - | * Eventuale messaggio di aiuto da mostrare all' | ||
| - | * Tipo di dato del parametro (attributo **@tipo**). In base alla tipologia del dato è possibile differenziare il campo da mostrare all' | ||
| - | * Valori possibili: //text// | ||
| - | * Obbligatorietà del parametro (attributo **@required**). Se true il parametro di input è richiesto per l' | ||
| - | ==== Avvio di una specifica azione ==== | ||
| - | |||
| - | Avvio dell' | ||
| - | |||
| - | === Richiesta === | ||
| - | |||
| - | <code xml> | ||
| - | <?xml version=" | ||
| - | <cmd stored=" | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | </ | ||
| - | </ | ||
| - | |||
| - | <code xml> | ||
| - | <?xml version=" | ||
| - | <cmd stored=" | ||
| - | < | ||
| - | < | ||
| - | </ | ||
| - | </ | ||
| - | |||
| - | <WRAP center round important 60%> | ||
| - | **N.B.** I parametri indicati nei comandi sopra non vengono inviati al server in chiaro ma codificati in Base64 (attributo **mode=" | ||
| - | </ | ||
| - | |||
| - | Sono previsti i seguenti parametri: | ||
| - | * **selectionId** - Identificazione della selezione sulla quale è stata invocata l' | ||
| - | * **physicalId** - Identificazione del numero fisico del record sul quale è stata invocata l' | ||
| - | * **piLoginName** - Username dell' | ||
| - | * Ogni altro parametro di input specifico dell' | ||
| - | |||
| - | === Risposta === | ||
| - | |||
| - | <code xml> | ||
| - | <?xml version=" | ||
| - | <rsp xmlns: | ||
| - | <dtl dtype=" | ||
| - | < | ||
| - | action=" | ||
| - | evaluationDate=" | ||
| - | db=" | ||
| - | userId=" | ||
| - | recordCounter=" | ||
| - | changedCounter=" | ||
| - | changedList="" | ||
| - | changedSelId="" | ||
| - | failActionCounter=" | ||
| - | failActionList="" | ||
| - | failActionSelId="" | ||
| - | failLockCounter=" | ||
| - | failLockList=" | ||
| - | failLockSelId="" | ||
| - | failSaveCounter=" | ||
| - | failSaveList="" | ||
| - | failSaveSelId="" | ||
| - | ></ | ||
| - | </ | ||
| - | </ | ||
| - | </ | ||
| - | |||
| - | I dati caricati da DocWay (o ACL) come risultato dell' | ||
| - | * Numero totale di documenti elaborati (attributo **@changedCounter**) | ||
| - | * Numero di errori dovuti a lock su documenti (attributo **@failLockCounter**) | ||
| - | * Numero di errori di elaborazione riscontrati (somma dei valori presenti sugli attributi **@failActionCounter** e **@failSaveCounter**) | ||
| - | |||
| - | Di seguito viene mostrato un esempio di XML di ritorno contenente un errore riscontrato a livello di elaborazione LUA: | ||
| - | |||
| - | <code xml> | ||
| - | <?xml version=" | ||
| - | <rsp ack=" | ||
| - | <dtl dtype=" | ||
| - | < | ||
| - | action=" | ||
| - | evaluationDate=" | ||
| - | db=" | ||
| - | userId=" | ||
| - | recordCounter=" | ||
| - | procFault=" | ||
| - | ></ | ||
| - | </ | ||
| - | </ | ||
| - | </ | ||
| - | |||
| - | In questo caso a livello di interfaccia DocWay (o ACL) viene mostrato all' | ||
/data/attic/documentazione_3di_riservata/docway4/azioni_massive_lua.1508230447.txt.gz · Ultima modifica: 2017/10/17 10:54 da mbernardini