%%(display:none)
{{{
WikiUp
}}}
/%
*\\
*  DOCUMENTAZIONE TECNICA DEI PGM 'VISUALIZZATORI' - V5DO01D_xx\\
*                                                  - V5DO05D_yy\\
*\\
*  E DEI RELATIVI FORMATI VIDEO                    - V5DO0xxV\\
*                                                  - V5DO5yyV\\
*\\
\\
****************************************************************\\
>>>   * Note e particolarità.\\
****************************************************************\\
* 1) Se si utilizza un formato solo, il tasto Enter equivale al\\
*    tasto F6=Conferma. (Il pgm forza il valore £F06 in £KEY).\\
\\
\\
****************************************************************\\
>>>   * INIDOC - Routine elaborazioni di inizio documento\\
****************************************************************\\
* Viene eseguita quando inizia la presentazione di un documento:\\
* - dopo aver impostato *IN11-15 e tutti i campi video\\
* - prima di azzerare gli errori ed eseguire il primo exfmt\\
\\
\\
****************************************************************\\
>>>   * CINx - Routines controlli / elaborazioni iniziali\\
****************************************************************\\
* Sono eseguite subito dopo l'exfmt, prima di ritornare al pgm\\
* chiamante per i controlli formali.\\
* Se si è premuto il tasto:\\
*  - Enter o F4: viene eseguita la CINx (dove x=numero formato)\\
*  - F6, F7 o F10/F14: vengono eseguite tutte le CINx\\
*    NB: attualmente F7 è gestito solo sulla testata (V5DO01D_xx)\\
*\\
* Modalità di segnalazione di un errore.\\
* Si può gestire un errore sia su un campo previsto dal pgm std\\
* (e quindi presente nelle schiere CWW/CWI), sia su un campo non\\
* previsto o su più campi contemporaneamente.\\
* 1) Errore su un campo previsto\\
*    E' sufficiente indicare il numero del campo, e il pgm ricava\\
*    dalle schiere l'indicatore di errore e il numero formato.\\
C*                    Z-ADD<nr.campo>JE\\
C*                    MOVEL<cod.err> £DMSME\\
C*                    MOVEL<msgf>    £DMSFI   <== se div. da MSGBA\\
C*          'XXXX'    CAT  'YYYY':n  £DMSVA   <== se richiesto\\
C*                    EXSR ADDER\\
* 2) Errore non su un campo previsto\\
*    Si deve accendere l'ind. di errore (61-99) e si deve anche\\
*    indicare, in negativo x distinguerlo, il numero del formato.\\
*    NB: per ogni campo non previsto si deve utilizzare un\\
*        indicatore dedicato, non usato per nessun altro campo\\
*        (neanche in altri formati)\\
C*                    SETON                     81\\
C*                    Z-SUB<nr.frmt> JE\\
C*                    MOVEL<cod.err> £DMSME\\
C*                    MOVEL<msgf>    £DMSFI   <== se div. da MSGBA\\
C*          'XXXX'    CAT  'YYYY':n  £DMSVA   <== se richiesto\\
C*                    EXSR ADDER\\
\\
\\
****************************************************************\\
>>>   * CFIx - Routines controlli / elaborazioni finali\\
****************************************************************\\
* Sono eseguite al rientro dal pgm chiamante, che ha fatto i\\
* controlli formali.\\
* Se si era usciti premendo sul FMTx il tasto:\\
*  - Enter o F4: viene eseguita la CFIx (dove x=numero formato)\\
*  - F6, F7 o F10/F14: vengono eseguite tutte le CFIx\\
*    NB: attualmente F7 è gestito solo sulla testata (V5DO01D_xx)\\
*\\
* Modalità di segnalazione di un errore: vedi sopra, sub CINx\\
\\
\\
****************************************************************\\
>>>   * CWW e CWI - Schiere definizioni campi\\
****************************************************************\\
* Modalità di modifica schiere:\\
* - I dati modificabili sono solo nelle prime 4 posizioni di\\
*   ogni riga.\\
*   Le posizioni dalla 5 in poi sono commenti e servono solo\\
*   come guida per facilitare la personalizzazione.\\
* - Le schiere sono posizionali, ossia il numero di ogni riga\\
*   la fa riferire ad uno specifico campo.\\
*   (Ad es: riga 2 --> dati del campo 'numero documento')\\
*   Pertanto non si deve modificare la posizione delle righe,\\
*   nè cancellare o inserire righe.\\
*\\
* CWW = nx, dove:\\
*       n = num. formato dove il campo è modificabile (I o I/O)\\
*           oppure (se solo O) dove deve essere decodificato.\\
*           Se ' ': il campo non è visualizzato, nè decodificato,\\
*                   pur essendo controllato dal pgm guida.\\
*       x = condizionamento campo: ' '=facolt. 'O'=obbligat.\\
* CWI = indicatori errore (61-99)\\
*       NB: su formati diversi si possono utilizzare gli stessi\\
*           indicatori, quindi per ogni formato sono disponibili\\
*           39 indicatori.\\
\\
\\
****************************************************************\\
>>>   * FORMATI VIDEO - Modalità di personalizzazione\\
****************************************************************\\
* - Non si possono cancellare formati, nè cambiarne il nome.\\
* - Il formato FMTH serve come Dizionario: da questo fmt si\\
*   copiano i campi che servono nei formati desiderati.\\
* - Da tutti i formati (escluso FMTH) si possono liberamente\\
*   spostare o anche cancellare tutti i campi.\\
* - Le dimensioni di tutti i campi possono essere liberamente\\
*   modificate.\\
*   (Si consiglia di usare +/-nn nel campo lunghezza)\\
* - Se si utilizza un formato solo, si consiglia di inibire il\\
*   tasto F6=Conferma, la cui funzione viene svolta da Enter.\\
* - Se si desidera richiedere la conferma esplicita con F6\\
*   anche con un formato solo, occorre valorizzare la variabile\\
*   §§CONF='1'\\
\\
\\
****************************************************************\\
>>>   * UTILIZZO INDICATORI\\
****************************************************************\\
*  01-10  Protezione campi dei gruppi 1-5 (tramite la classe di\\
*         autorizzazione PLC-V5TDOC,PLC-V5RDOC o PLC-BRARTI).\\
*         N.B.: Il pgm li reimposta prima di ogni exfmt.\\
*         01 ON : campi gruppo 1 non visualizzati\\
*         02 ON : campi gruppo 1 non modificabili (solo visual.)\\
*         03 ON : campi gruppo 2 non visualizzati\\
*         04 ON : campi gruppo 2 non modificabili ...\\
*  11-15  Azione sul record\\
*         11 ON : immissione\\
*         12 ON : modifica\\
*         13 ON : copia\\
*         14 ON : cancellazione\\
*         15 ON : visualizzazione\\
*  40    Attivazione scenario\\
*  41-45  Abilitazione modifica dei 5 campi quantità (solo sui\\
*         formati di gestione righe: V5DO5yyV).\\
*         41 ON : campo qtà 1 protetto (solo visualizzato)\\
*         42 ON : campo qtà 2 protetto ...\\
*  45-49  Significato dei valori T§SCM1-5 (solo sui formati di\\
*         gestione testate: V5DO0xxV).\\
*         45: T§SCM1 è il valore di T$V5D5 (solo se OFF)\\
*         46: T§SCM2 è il valore di T§SPIM (ON) o di T$V5D6 (OFF)\\
*         47: T§SCM3 è il valore di T§SPTR (ON) o di T$V5D7 (OFF)\\
*         48: T§SCM4 è il valore di T§SPBO (ON) o di T$V5D8 (OFF)\\
*         49: T§SCM5 è il valore di T§SPIN (ON) o di T$V5D9 (OFF)\\
*  60     Visualizza messaggio d'errore\\
*  61-99  Segnalazione errori singoli campi\\
\\
\\
****************************************************************\\
>>>   * TASTI FUNZIONE\\
****************************************************************\\
* Non è possibile aggiungere tasti funzione con comportamenti\\
* personalizzati in quanto sono già tutti utilizzati a standard.\\
* L'unica possibilità è utilizzare un campo a video che esegua quello\\
* che vogliamo faccia il comando, quindi ripulire il campo e\\
* riemettere il formato.\\