| At line 1 added 102 lines |
| %%(display:none) |
| {{{ |
| WikiUp |
| }}} |
| /% |
| [{TableOfContents }]\\ |
| !!! INTERFACCIA RIGHE DOCUMENTI\\ |
| Obiettivo |
| Gestire tramite le sue viste logiche ogni accesso al file V5RDOC0F. |
| !!! FUNZIONI\\ |
| - Indicano quale operazione si vuole eseguire. |
| - Le funzioni disponibili sono: |
| SL esegue una SETLL |
| SG " " SETGT |
| RD " " READ |
| RP " " READP |
| CHA " " CHAIN |
| RE " " READE |
| RPE " " REDPE |
| SLRE " " SETLL & READE |
| Esiste poi la funzione BLANK (' ') che, a partire da un Tipo |
| Documento, gestisce la ricerca (se richiesta tramite !/?) e la decodifica sia sul campo Nr. Documento che sulla Riga |
| Documento; esegue poi la lettura sulla vista logica principale V5RDOC0L, tramite CHAIN con chiavi Tipo documento - |
| Numero documento - Riga documento. |
| Oss. La funzione Blank NON ha metodi. |
| !!! METODI\\ |
| - Indicano quale vista logica si vuole utilizzare. |
| - I metodi disponibili sono i seguenti: |
| chiave composta da Tipo doc. - Nr. doc. - Nr. riga |
| 1L " " Tipo doc. - Nr. doc. - Tipo riga |
| 2L " " Tipo doc. - Nr. doc. - Tipo oggetto - |
| Cod. ogg. - Data consegna confermata(DTCC) |
| 3L " " Tipo doc. - Tipo riga - Tipo ente intest. |
| Cod. ente - Cod. magaz. - Codice ogg. |
| 4L " " Tipo doc. - Livello - Cod. Magaz. - |
| Tipo ogg. - Cod. ogg. - DTCC |
| 5L " " Tipo doc. - Livello - DTCC |
| 6L " " Tipo doc. - Tipo ente intest. - Cod. ente |
| - Livello - Cod. magaz. - Tipo ogg. - |
| Cod.ogg. - DTCC |
| 7L " " Tipo doc. - Nr. doc. - Livello |
| 8L " " Tipo doc. origine - Nr. doc. orig. - Nr. |
| riga doc. orig. - Flag 01 |
| 9L " " Tipo doc. - Tipo ente intest. - Cod. ente |
| - Livello - Cod. Magaz. - DTCC - Tipo ogg. - Cod. ogg. |
| AL " " Nr. ordine. prod. - Operazione - Livello |
| BL " " Tipo doc. - Nr. doc. - Tipo doc. origine |
| - Nr. doc. orig. - Nr. riga orig. - Nr. |
| riga |
| CL " " Tipo doc. - Livello - Commessa- Tipo ogg. |
| - Cod. ogg. - DTCC |
| DL " " Tipo doc. - Cod. magaz. - Tipo ogg. - |
| Cod. ogg. - Tipo ente intest. - Cod. ente |
| - DTCC |
| EL " " Tipo doc. - Nr. doc. - Nr. riga riferimento master - Nr. riga |
| FL " " Tipo doc. - Tipo ente spediz. - Cod. ente |
| - Livello - DTCC |
| !!! AMBIENTE\\ |
| - Non utilizzato. |
| !!! NR. CHIAVI\\ |
| - La £IDR è sensibile al numero di chiavi valorizzate (diverse da |
| BLANKS) che riceve; in particolare, in modo indipendente dalla funzione selezionata, utilizza per le sue operazioni |
| solo i campi realmente valorizzati. Si consideri ad es. il caso in cui viene utilizzata la funzione READE con il |
| metodo 0L. Il metodo è composto da 3 campi chiave: |
| . Tipo documento - Nr. documento - Nr. riga |
| Si consideri inoltre che il file oggetto dell'operazione contenga i seguenti dati: |
| OVE 000140 1 |
| OVE 000140 2 |
| OVE 000140 3 |
| OVE 000141 1 |
| OVE 000141 2 |
| Se nell'esecuzione della £IDR vengono valorizzati nel seguente modo ('OVE', '000140') solo il tipo ed il numero |
| documento, allora un ciclo " DO ... EXSR £IDR ... ENDDO " leggerà tutte le righe dell'ordine 000140. Si noti che se |
| venisse considerato il campo numero riga pari a BLANK la lettura non avrebbe buon fine. |
| Il campo Nr. Chiavi serve in quelle situazioni in cui si vuole che venga considerato anche il campo valorizzato con |
| BLANKS. Tramite il Nr. chiavi si indica appunto alla £IDR il numero di chiavi che essa deve utilizzare indipendente |
| dal fatto che siano valorizzate oppure BLANK. |
| Un caso d'esempio in cui valorizzare il numero di chiavi è il seguente. |
| Consideriamo la funzione CHAIN con il metodo 2L, composto dalle chiavi Tipo documento, nr. documento, tipo oggetto, |
| codice oggetto, data consegna confermata. Si consideri inoltre che il file oggetto dell'operazione contenga (a meno |
| dell'ordinamento) i seguenti dati: |
| . Tipo documento - Nr. documento - Tipo ogg. - Cod. ogg.- DTCC |
| OVE 000140 AR 001 |
| OVE 000140 X02 |
| OVE 000140 A/C AAA |
| OVE 000140 AR 002 |
| Se nell'esecuzione della £IDR vengono valorizzati nel seguente modo ('OVE', '000140') solo il tipo ed il numero |
| documento, ma viene specificato in numero chiavi £IDRNK = 3 allora la £IDR restituirà il secondo record, quello cioè |
| con il tipo oggetto a |
| BLANK. |
| OSS. In ogni caso, in assenza di un valore per numero chiavi, la £IDR determina il numero di chiavi da utilizzare |
| sulla base della posizione dell'ultima chiave valorizzata; in presenza di una serie di chiavi valorizzate nel seguente |
| modo (VALORE1, BLANKS, VALORE3, |
| BLANKS, VALORE-N, BLANKS, ... BLANKS) la £IDR utilizzerà N chiavi (e quindi anche quelle di valore BLANKS che |
| precedono l'N-esima chiave). |
| !!! NOTE SULLA EXSR £IDR (1)\\ |
| Se viene utilizzata la funzione BLANK (scansione e ricerca) devono essere valorizzati i parametri £IDRTD, £IDRND, |
| £IDRNR; per le altre funzioni devono invece essere valorizzati i campi della DS |
| V5RDOC (ad es. R§TDOC, R§COMM ...). In ogni caso dopo una lettura la £IDR valorizza in output sia la V5RDOC che i |
| campi £IDRTD, £IDRND, £IDRNR, £IDRDE. |
| !!! NOTE SULLA EXSR £IDR (2)\\ |
| Il numero chiavi (£IDRNK) non è un parametro della £IDR ma è una variabile messa a disposizione dalla £IDR stessa. |
