WikiUp

::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:
  1. il questionario
  2. il contesto o ambiente
  3. l'utente
  4. 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)

  1. ACT.SAV salva la configurazione con il nome corrente (SAVe)
  2. ACT.SAS salva con nome differente la configurazione (Save AS)
  3. ACT.DEL elimina la configurazione (DELete)
  4. ACT.OPN mostra la lista dei setup e consente di selezionarne uno. Il setup selezionato viene restiuito.
  5. ACT.NEW creo una nuova configurazione
  6. ACT.EDT modifico la configurazione specificata dalle chiavi passate
  7. ACT.LIS restituisco la lista delle configurazioni in formato XML(LISt)
  8. ACT.GET Leggo il setup selezionato da AS400 e lo restituisco come XML senza eseguire il lock
  9. 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.
  10. ACT.GES apro la finestra di gestione setup in modalità gestione (con tutti i pulsanti attivi)
  11. GES.GES gestione setup. apro la finestra di gestione setup in modalità gestione
  12. 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.
  13. STD.CON restituisce il setup di default per un tipo setup
  14. 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









































Add new attachment

Only authorized users are allowed to upload new attachments.
«