%%(display:none)
{{{
WikiUp
}}}
/%
[{TableOfContents }]\\
!!! Scopo di questo documento\\
Illustrare come creare questionari.\\
Verranno forniti i concetti di base,  poi analizzati i vari tipi di questionari ed inifine l'utilizzo delle configurazioni.\\
\\
!!! Nomenclatura\\
* ''Configuratore'': insieme di domande, suddivise in una o più sezioni\\
* ''Configurazione'': insieme di risposte ottenute dalla compilazione di un configuratore\\
* ''Sezioni'': suddivisione logica di un questionario in più parti. Ogni sezione contiene una o più domande.\\
* ''Script di configurazione'': membri del file SCP_CFG che contengono la struttura del questionario\\
* ''Domanda configurata (a risposta) singola'': tipo di domanda in cui su un'unica riga posso immettere più valori\\
* ''Domanda configurata (a risposta) multipla'': tipo di domanda in cui l'utente può immettere una matrice di valori.\\
\\
!!! Aspetti Grafici\\
\\
a) E' stata migliorata la gestione delle icone, che vengono cambiate in base alle caratteristiche del campo quindi:\\
\\
[{Image src='immagini/MBDOC-LOCG30_B/03COMG3001.png' caption='' width='100%' style='max-width: 100%;'}]\\
b) La finestra viene dimensionata in base al contenuto\\
c) Le finestre non vengono sovrapposte una all'altra ma vengono posizionate in modo che si vedano tutte (leggermente scalate)\\
\\
\\
!!! Estensioni del richiamo come funzione\\
Esempio\\
La funzione F(G30;JA_00_01;GES.EDT) 1(J5;;) con i parametri P(SCP(EDT_BRE) FORJ5(P)) visualizza il contenuto dello script EDT_BRE in SCP_CFG sotto forma di G30 in questo modo\\
[{Image src='immagini/MBDOC-LOCG30_B/03COMG3004.png' caption='' width='100%' style='max-width: 100%;'}][{Image src='immagini/MBDOC-LOCG30_B/LOCG30_006.png' caption='' width='100%' style='max-width: 100%;'}]\\
Restituisce le scelte effettuate sotto forma di J5 con il formato indicato nel parametro FORJ5(P).\\
Questo parametro e' di tipo V2 FORJ5 e puo' assumere i seguenti valori:\\
* A Doppio apice\\
* P Parentesi\\
* F Fisso/Posizionale\\
Nel caso specificato sopra il ritorno delle risposte e':\\
[{Image src='immagini/MBDOC-LOCG30_B/LOCG30_007.png' caption='' width='100%' style='max-width: 100%;'}]* GRA: configuratore di componenti grafici\\
* ESE: esempi\\
* LST: configuratori di listener (ascoltatori di eventi)\\
* SER: configuratori di servizi\\
Verra' quindi visualizzato un questionario con le domande scritte all'interno dello script per\\
la configurazione richiesta.\\
Ad esempio:\\
[{Image src='immagini/MBDOC-LOCG30_B/LOCG30_008.png' caption='' width='100%' style='max-width: 100%;'}]Premendo F4, compare il questionario per la configurazione del componente EXD 'Scheda'\\
[{Image src='immagini/MBDOC-LOCG30_B/LOCG30_009.png' caption='' width='100%' style='max-width: 100%;'}]\\
!!! Albero editor di scheda\\
Il vecchio albero che si apriva dall'editor di scheda\\
[{Image src='immagini/MBDOC-LOCG30_B/03COMG3007.png' caption='' width='100%' style='max-width: 100%;'}]e' stato sostituito dal nuovo\\
[{Image src='immagini/MBDOC-LOCG30_B/LOCG30_010.png' caption='' width='100%' style='max-width: 100%;'}]\\
!!! Tipi di questionari\\
I questionari sono oggetti di tipo RE.\\
Comme illustrato nel documento introduttivo, si dividono in base all'orgine della struttura del questionario e a seconda della destinazione delle risposte fornite.\\
\\
Analizziamo le varie tipologie.\\
\\
!! Questionari T-\\
* __Utilizzo__:  manutenzione tabelle SmeUp.\\
* __Costruzione__: dedotte dalla struttura del tipo di tabella.\\
* __Struttura__: un'unica sezione\\
* __Formato risposte__: posizionale, scritte nel file delle tabelle di SmeUp (normalmente il Tabel00f)\\
* __File Configurazioni__: TABEL00F\\
* __Forma presentazione__: unica sezione.\\
* __Navigazione__:\\
* __Regole__: definite da programma (per gestire i range dei valori)\\
\\
!! Questionari Q-\\
* __Utilizzo__:  creazione configuratorei generici, dal configuratore di prodotto ad un questionario per raccogliere le preferenze degli utenti.\\
* __Costruzione__: utilizzando le tabelle SmeUp CFQ, CFS, CFD, CFV, CFC oppure appositi script.\\
* __Struttura__: composta da sezioni, con possibilità di includere questionari o di ripetere sezioni o gruppi di sezioni.\\
* __Formato risposte__: vari formati di XML.\\
* __File Configurazioni__: CFVARI0F, B£MEDE0F\\
* __Forma presentazione__: albero di navigazione con sezione corrente.\\
* __Navigazione__: Dalla prima sezione all'ultima.\\
* __Regole__: definite liberamente dal creatore del questionario, oppure tramite programmi appositi.\\
\\
!! Questionari L-\\
Questionari definiti all'interno del file SCP_CFG\\
* __Utilizzo__:  creazione configuratori  di servizio (configuratore di configuratori, wizard vari)\\
* __Costruzione__: tramite Wizard in Loocup\\
* __Formato risposte__: vari formati di XML.\\
* __File Configurazioni__:  B£MEDE0F\\
* __Forma presentazione__: pannello con n pannelli, ognuno con una sezione\\
* __Navigazione__: Libera\\
* __Regole__: non definite\\
\\
!! Questionari U-\\
Questionari ottenuti dall'unione di una o più sezioni di script oppure da impostazioni grafiche.\\
* __Utilizzo__:  raggruppare configurazioni eterogenee\\
* __Costruzione__: da codice: viene indicato lo script e quali sezioni utilizzare, oppure viene solo indicato il codice del questionario e quali sono le risposte da salvare.\\
* __Formato risposte__: vari formati di XML.\\
* __File Configurazioni__:  B£MEDE0F\\
* __Forma presentazione__: pannello contenente da 1 a n pannelli, ognuno con una sezione\\
* __Navigazione__: Libera\\
* __Regole__: non definite\\
\\
!! Questionari S-\\
Questionari definiti all'interno del file SCP_CFG\\
* __Utilizzo__:  creazione configuratori  di setup di moduli SmeUp\\
* __Costruzione__: tramite Wizard in Loocup\\
* __Formato risposte__: vari formati di XML.\\
* __File Configurazioni__:  B£MEDE0F\\
* __Forma presentazione__: pannello con n pannelli, ognuno con una sezione\\
* __Navigazione__: Libera\\
* __Regole__: non definite\\
\\
!!! Costruzione di un questionario\\
La costruzione di un questionario si differenzia in base al tipo.\\
\\
!! Costruzione di un questionario di tipo Q-\\
\\
Per la costruzione della struttura di un questionario di tipo Q- si rimanda alla documentazione del modulo CF, in particolare alla documentazione delle tabelle\\
* ''CFQ'': questionari\\
* ''CFS'': sezionidi questionario\\
* ''CFD'':domande di sezione\\
* ''CFV'': valori di domanda\\
* ''CFC'': configurazioni.\\
\\
Per la costruzione delle regole del questionario utilizzare la scheda CFBASE, sottoscheda Regole.\\
\\
Per il reference delle regole fare riferimento al manuale tecnico dell'applicazione CF: My Loocup, Appllicazioni\\
\\
!! Questionari L-, U- da script e S-\\
I questionari in oggetto sono definiti  come membri del file SCP_CFG.\\
Un unico script può contenere un solo questionario oppure da 1 a n questionari.\\
Ad esempio il membro GRA_EMU contiene un unico questionario, mentre EDT_SCH ne contiene varie decine.\\
Gli script multi questionario hanno una parte di indice che raggruppa i questionari in base all'utilizzo: ad esempio tutti i tag G.SET.XXX si troveranno sotto il gruppo G.SET, a sua volta membro del gruppo G.\\
Per accedere ad un determinato questionario si può utilizzare la sintassi CF S-__NOME_SCRIPT__/__SEZIONE__, dove __NOME_SCRIPT__/__SEZIONE__ deve avere una lunghezza minore uguale ai 10 caratteri.\\
\\
! Struttura script\\
Gli script che definiscono i questionari hanno una sintassi leggermente diversa da quella degli script delle schede in quanto alcuni tag si sviluppano su più righe, inoltre il significato di una riga potrebbe dipendere da quelle precedenti.\\
Questa condizione si verifica solo quando voglia definire domande configurate, a risposta singola oppure multipla.\\
\\
Gli script sono composti dalle seguenti parti:\\
* ''Sezione Header''\\
** ''KEY'': contiene le chiavi di salvataggio, da utilizzare quando si salva una configurazione\\
** ''POP'': le voci di popup da aggiungere al G30\\
** ''BOT'': quali pulsanti tra salva/salva con nome/ elimina sono attivi\\
* ''SEZ'': da questo tag, fino al tag RIG sono indicati i questionari da cui è composto lo script. Per ogni riga viene indicato il formato delle risposte.\\
* ''RIG'': da questo taga fino al tag LIS sono indicate le sezioni e le domande che compongono i vari questionari.\\
* ''LIS'': contiene i possibili valori che una risposta può assumere.\\
\\
Analizziamo i vari tag.\\
__Tag RIG__\\
Il tag specifica l'inizio della definizione di sezioni e domande.\\
\\
Una sezione è identificabile dal fatto che il primo carattere non è un ".".\\
Avremo pertanto che tutto quanto si trova tra due righe che non iniziano con il carattere "." costituisce il corpo di una sezione.\\
\\
Nota molto importante va posta a quelle riche che iniziano con il carattere ":": queste righe identificano una subsezione.\\
\\
Avremo pertanto che se una sezione contiene delle subsezioni, questa presenterà le sue domande divise in n gruppi distinti.\\
Si presenterà pertanto come un questionario composto da n sezioni.\\
\\
__Sintassi righe di sezione __\\
Le righe di sezione NON iniziano con il "."\\
Le righe di sezione possono avere codice e descrizione: il primo spazio suddivide questi due elementi.\\
\\
__Sintassi righe di subsezione __\\
Le righe di subsezione iniziano con il carattere ":"\\
Le righe di subsezione possono avere codice e descrizione: il primo spazio suddivide questi due elementi.\\
\\
__Sintassi righe di domanda__\\
Le righe di domanda iniziano con il carattere ".". La sintassi è guidata da apposito wizard.\\
Se ad una riga di domanda seguono due o più righe che iniziano per ".." questo significa che è una domanda configurata a risposta singola.\\
Se ad una riga di domanda che inizia con ".." seguono due o più righe che iniziano con "..." significa che è una domanda configurata a risposta multipla.\\
\\
__Tag KEY__\\
Il tag KEY è opzionale: il servizio che costruisce l'XML del questionario potrebbe costruirne uno diverso da quello definito nello script.\\
Posso avere da 0 a 3 tag Key.\\
\\
__Tag POP__\\
\\
__Tag LIS__\\
Se ad esempio una domanda chiederà la posizione, e i valori possibili sono alto basso oppure centro, andrò ad assegnare alla domanda come tipo risposta __.VPos.Vert__ e poi andrò a creare le seguenti righe nella sezione LIS:\\
Pos.Vert\\
.A            Alto\\
.C            Centro\\
.B            Basso\\
Il codice occupa 16 caratteri, compreso il punto iniziale. La descrizione si troverà  dal 17esimo carattere.\\
Anche per la definizione delle liste di valori c'è un apposito wizard.\\
\\
Alcune note sugli SCP_CFG EDT_xxx:\\
[Note su SCP_CFG EDT_xxx|MBDOC-LOCG30_C]\\
\\
!! ESEMPI\\
__Questionario Mono Sezione - ESE_001__\\
::RIGS1 prima sezione\\
.A Articolo                             AR                      015\\
.B Cliente                              CNCLI                   015\\
.C Libera                               **                      100\\
.D Con valori                           .VPos.Vert              001\\
::LISPos.Vert\\
.A              Alto\\
.C              Centro\\
.B              Basso\\
Vedi  (-)\\
-- F(G30;CFSER_02;STR.LET) 1(RE;L-;ESE_01) --\\
\\
__Questionario Multi sezione__\\
::RIGS1 prima sezione\\
.A Tipo                                 OG                      002\\
.B Parametro                            OG[A]                   010\\
.C codice                               [A][B]                  015\\
S2 seconda sezione\\
.E Articolo                             AR                      015\\
.F Cliente                              CNCLI                   015\\
.G Libera                               **                      100\\
.H Con valori                           .VPos.Vert              001\\
::LISPos.Vert\\
.A              Alto\\
.C              Centro\\
.B              Basso\\
\\
Vedi  (-)\\
\\
__Questionario Multi Questionario__\\
::SEZS\\
.A             Quest. 1                      "\\
.B             Quest. 2                      (\\
::RIGA\\
:S1A prima subsezione\\
.A Articolo                             AR                      015\\
.B Cliente                              CNCLI                   015\\
:S1B seconda subsezione\\
.C Libera                               **                      100\\
.D Con valori                           .VPos.Vert              001\\
B seconda sezione\\
.E Centro di lavoro                     RICDL                   015\\
.F Data                                 D8*YYMD                 015\\
.G Libera                               **                      100\\
.H Con valori                           .VPos.Vert              001\\
::LISPos.Vert\\
.A              Alto\\
.C              Centro\\
.B              Basso\\
\\
Vedi  (-)\\
Vedi  (-)\\
\\
Utilizzo S-\\
modifica di una configurazione\\
A(CFCF01X;GES;02) 1(CF;S-B£EQRY/A;0000202291)\\
\\
Utilizzo come SP\\
\\
Utilizzo nei wizard\\
\\
Utilizzo nei setup di componente (Emulatore, Scheda e componenti interni alla scheda)\\
\\
Utilizzo configurazione Listener.\\