At line 1 added 187 lines |
%%(display:none) |
{{{ |
WikiUp |
}}} |
/% |
[{TableOfContents }]\\ |
::HEA RESP(FF) STAT(80) USAG(OM) DTAG(20120113) ORAG(112500)\\ |
!!! OBIETTIVO\\ |
Gestione delle impostazioni utente in LoocUp.\\ |
Queste impostazioni sono anche chiamate Setup o configurazioni.\\ |
\\ |
Questo servizio è anche in grado di gestire le configurazioni identificate dagli oggetti J5.\\ |
Un oggetto J5 può essere utilizzato all'interno di setup e consente di creare domande configurate in modo molto semplice.\\ |
La modifica di una configurazione di tipo J5 non avverrà chiamando direttamente il servizio ma sarà trasparente all'utente in quanto sarà l'object field stesso a gestire questo tipo di oggetto.\\ |
Per completezza riportiamo comunque la sintassi:\\ |
F(G30;JA_00_01;GES.EDT) 1(J5) P(SCP(script_da_filtrare) SEC(sezioni da utilizzare separate dalla virgola) FORJ5(formato risposta, oggetto di tipo V2FORJ5))\\ |
\\ |
NOTA: la documentazione è presente per il metodo GES.EDT e i parametri sono quelli in cui la descrizione comincia per J5.\\ |
\\ |
\\ |
\\ |
\\ |
!! Cosa è un setup\\ |
Un setup è un XML che contiene le impostazioni di un modulo o di un componente di LoocUp.\\ |
\\ |
!! Identificazione di un setup\\ |
\\ |
Un setup è identificato da quattro codici:\\ |
# il questionario\\ |
# il contesto o ambiente\\ |
# l'utente\\ |
# il nome\\ |
\\ |
\\ |
Il questionario definisce le domande da porre, tranne nel caso di tipo U-, nel qual caso le domande o sono ricavate dal K5 o dal parametro SECLS oppure non esiste un questionario perchè le risposte sono ad esempio ricavate da impostazioni grafiche (es. dimensione finestra).\\ |
\\ |
Il questionario raggruppa configurazioni omogenee: non ha infatti senso che un setup di un albero venga utilizzato per l'editor e viceversa.\\ |
\\ |
Se è di tipo REL- significa che c'è un questionario associato ed è definito nel file SCP_CFG. Il nome del questionario è GRA_xxx, dove xxx è il codice del modulo di cui si desidera definire il setup.\\ |
Nel caso in cui è di tipo REU- non esiste un questionario associato. Questionari di tipo REU- sono utilizzati ad esempio per i setup della matrice e contengono informazioni tipo dimensioni finestre, raggruppamento effettuati o altro. L'applicazione stessa decide cosa e come memorizzare.\\ |
\\ |
!! Identificazione questionario\\ |
Il questionario viene indicato nell'oggetto 1.\\ |
La struttura del questionario viene creata in modo diverso in base al tipo del questionario e in base al parametro SECLS.\\ |
* Questionario è di tipo U- con K6 non definita: si tratta di questionari in cui non c'è un elenco di domande da porre perchè le risposte sono costruite in base a impostazioni grafiche o da un programma. In questo caso il gestore dei setup non fornisce la funzionalità di mofica con un G30.\\ |
* Questionario di tipo U- con K6 definita: nel K6 viene indicato il questionario da cui estrarre le risposte. Del questionario indicato viene utilizzata la sezione che si ricava prendendo i caratteri dal quinto in poi del K1 e concatenandoli al prefisso "G.SET."\\ |
* Questionario di altro tipo, normalmente di tratta di L-: mediante il parametro SECLS(sez1,sez2, ... sezN) posso specificare quali sezioni utilizzare. Se non fosse definito verranno mostrate tutte le sezioni.\\ |
\\ |
!! Memorizzazione dei setup\\ |
I setup vengono salvati su AS400 nel file B£MEDE0F.\\ |
La dimensione massima di un setup è di 25000 caratteri.\\ |
\\ |
!! Configurazioni di Default\\ |
Come su As400 la configurazione di default è quella che ha codice **. Dato un modulo la configurazione valida per tutti gli utenti e per tutti i contesti sarà identificata dalle chiavi "**", "**" e "**".\\ |
\\ |
!! Meccanismo di risalita\\ |
Ogni modulo quando si avvia carica la configurazione di default utilizzando come valore del codice 1 di configurazione il contesto, come codice 2 l'utente e come codice 3 **.\\ |
Se la configurazione cercata non è presente, se nel parametro è indicato RIS(1) allora viene eseguita la risalita secondo lo schema seguente:\\ |
\\ |
__Codice__|__Codice2__|__Codice__\\ |
contesto|utente|nome\\ |
contesto|utente|**\\ |
contesto|**|chiave\\ |
contesto|**|**\\ |
L(PUN)\\ |
--|utente|nome\\ |
--|utente|**\\ |
--|**|nome\\ |
--|**|**\\ |
\\ |
\\ |
\\ |
\\ |
!! Gestione dei setup\\ |
\\ |
Il tasto F17 in loocup da' l'accesso al gestore dei setup.\\ |
\\ |
L'utente può vedere i setup del modulo o componente con cui sta interagendo e creare o modificare i setup presenti.\\ |
\\ |
Le azioni che l'utente può compiere sono indicate dall'AS400 e da LoocUp.\\ |
\\ |
\\ |
\\ |
\\ |
!!! FUNZIONI/METODI\\ |
!! Azioni dirette o singole (ACT)\\ |
# ACT.SAV salva la configurazione con il nome corrente (SAVe)\\ |
# ACT.SAS salva con nome differente la configurazione (Save AS)\\ |
# ACT.DEL elimina la configurazione (DELete)\\ |
# ACT.OPN mostra la lista dei setup e consente di selezionarne uno. Il setup selezionato viene restiuito.\\ |
# ACT.NEW creo una nuova configurazione\\ |
# ACT.EDT modifico la configurazione specificata dalle chiavi passate\\ |
# ACT.LIS restituisco la lista delle configurazioni in formato XML(LISt)\\ |
# ACT.GET Leggo il setup selezionato da AS400 e lo restituisco come XML senza eseguire il lock\\ |
# ACT.GTW Leggo il setup selezionato da AS400 e lo restituisco come XML senza eseguire il lock. L'XML del setup letto viene visualizzandolo con il programma predefinito.\\ |
# ACT.GES apro la finestra di gestione setup in modalità gestione (con tutti i pulsanti attivi)\\ |
# GES.GES gestione setup. apro la finestra di gestione setup in modalità gestione\\ |
# LIS.ALL restituisce la lista dei setup completa dell'XML del setup. Il metodo esegue una prima lettura nella quale ottiene l'elenco dei setup ed esegue quindi altre n letture per leggere l'XML del setup. Il documento XML restituito ha come nodo radice __UiSmeup__ e come contenitore degli n setup il nodo __SetupList__.\\ |
# STD.CON restituisce il setup di default per un tipo setup\\ |
# STD.COM completa un setup passato in INPUT sulla base del tipo setup e del contesto in cui è chiamato\\ |
Per i metodi in cui il campo Parametro è definito si può specificare se andare in gestione dopo l'azione se mostrare le informazioni di debug del modulo.\\ |
\\ |
!! GES mostro la finestra di gestione dei setup\\ |
Se questo parametro è blank significa che tutti i pulsanti sono attivi\\ |
E' anche possibile la gestione dei singoli pulsanti.\\ |
Viene utilizzato il parametro secondo una logica posizionale.\\ |
Ad ogni posizione corrisponde un pulsante o un'azione e si può abilitare o disabilitare.\\ |
Per i dettagli vedi la sezione dei parametri.\\ |
! Nota\\ |
I pulsanti Salva, Salva con nome e Elimina, sono abilitati dal setup letto da AS400: se ad esempio un setup è vincolato allora sarà possibile solo salvarlo con un nome diverso.\\ |
Se il setup letto è nullo o non è stato passato, allora varranno i vincoli di lock definiti nel parametro.\\ |
\\ |
!! Significato dei parametri\\ |
Metodo|Parametro|Valore|Significato\\ |
ACT.NEW|XMLRS|RIS|Risposte/Risposta\\ |
ACT.NEW|XMLRS|TREE|Divise per sezione\\ |
ACT.NEW|XMLRS|TREE_DR|Per sezione con valori nel testo del tag\\ |
ACT.NEW|XMLRS|TREE_DR_CMA|Come sopra, se config. multipla valori negli attributi\\ |
ACT.NEW|EXEC_MODE|BCH|Batch: non visualizza ne consente modifica\\ |
ACT.NEW|EXEC_MODE||Modalità normale: visaulizza e modifica\\ |
ACT.NEW|MODSET|W|Editabile\\ |
ACT.NEW|MODSET|R|Sola lettura\\ |
ACT.EDT|XMLRS|RIS|Risposte/Risposta\\ |
ACT.EDT|XMLRS|TREE|Divise per sezione\\ |
ACT.EDT|XMLRS|TREE_DR|Per sezione con valori nel testo del tag\\ |
ACT.EDT|XMLRS|TREE_DR_CMA|Come sopra, se config. multipla valori negli attributi\\ |
ACT.EDT|EXEC_MODE|BCH|Batch: non visualizza ne consente modifica\\ |
ACT.EDT|EXEC_MODE||Modalità normale: visaulizza e modifica\\ |
ACT.EDT|MODSET|W|Editabile\\ |
ACT.EDT|MODSET|R|Sola lettura\\ |
GES.|XMLRS|RIS|Risposte/Risposta\\ |
GES.|XMLRS|TREE|Divise per sezione\\ |
GES.|XMLRS|TREE_DR|Per sezione con valori nel testo del tag\\ |
GES.|XMLRS|TREE_DR_CMA|Come sopra, se config. multipla valori negli attributi\\ |
GES.|EXEC_MODE|BCH|Batch: non visualizza ne consente modifica\\ |
GES.|EXEC_MODE||Modalità normale: visaulizza e modifica\\ |
GES.|MODSET|W|Editabile\\ |
GES.|MODSET|R|Sola lettura\\ |
GES.GES|XMLRS|RIS|Risposte/Risposta\\ |
GES.GES|XMLRS|TREE|Divise per sezione\\ |
GES.GES|XMLRS|TREE_DR|Per sezione con valori nel testo del tag\\ |
GES.GES|XMLRS|TREE_DR_CMA|Come sopra, se config. multipla valori negli attributi\\ |
GES.GES|EXEC_MODE|BCH|Batch: non visualizza ne consente modifica\\ |
GES.GES|EXEC_MODE||Modalità normale: visaulizza e modifica\\ |
GES.GES|MODSET|W|Editabile\\ |
GES.GES|MODSET|R|Sola lettura\\ |
\\ |
\\ |
\\ |
\\ |
\\ |
\\ |
\\ |
\\ |
\\ |
\\ |
\\ |
\\ |
\\ |
\\ |
\\ |
\\ |
\\ |
\\ |
\\ |
\\ |
\\ |
\\ |
\\ |
\\ |
\\ |
\\ |
\\ |
\\ |
\\ |
\\ |
\\ |
\\ |
\\ |
\\ |
\\ |
\\ |
\\ |
\\ |
\\ |
\\ |
\\ |