ARC005 - Gestione classi di documento
Intestazione
| Campo |
Valore |
| Programma |
ARC005 |
| Titolo |
Gestione classi di documento - Archiviazione ottica |
| Autore |
Andrea Parmeggiani - Eurosystem2000 |
| Posizione menu |
Sistema > Archiviazione documentale > Tabelle > Classi documento |
Scopo e logica generale
ARC005 gestisce le classi di documento utilizzate nel modulo di archiviazione documentale. Ogni classe definisce una tipologia di documento archiviabile (fatture, dossier CRM, attivita' CRM, matricole di assistenza, ecc.). Il programma supporta la gestione dell'archiviazione remota (cloud AWS) a livello di singola classe, con funzionalita' di verifica, conteggio e migrazione dei documenti.
Il programma opera in due modalita':
- Modalita' aggiornamento (A): standalone, permette CRUD completo sulle classi
- Modalita' selezione (S): chiamato da un altro programma, restituisce il codice classe selezionato
Flusso principale
- Inizializzazione: apertura file, caricamento configurazione e stringhe lingua, determinazione modalita' (selezione/aggiornamento)
- Caricamento dati: lettura COGARGDO (livello=1), popolamento griglia; auto-creazione classi predefinite di sistema se mancanti
- Interazione griglia: l'utente aggiunge/modifica/elimina classi; gestione tasti funzione (F3 salva, F5 sottoclassi, F6 esporta, F7 verifica, F8 verifica remoti)
- Salvataggio (F3): confronto riga per riga tra stato corrente e precedente → insert/update/delete su COGARGDO
- Chiusura: chiusura file, cancellazione file transito, uscita
File e tabelle acceduti
| File |
Record |
Modalita' |
Uso |
| COGARGDO |
arg-rec |
I-O |
Classi di documento (livello 1 = classi, livello 2 = sottoclassi) |
| COGIMAGE |
img-rec |
Input |
Documenti archiviati — conteggio documenti per classe |
| COGARIDX |
arx-rec |
I-O |
Indice documenti con flag locale/remoto e metadati |
| COGARSEC |
ars-rec |
Input |
Sezioni di archivio (locazioni fisiche); verifica stato online |
| ASNCHTES |
acht-rec |
Input |
Chiamate di assistenza — lookup cliente per esportazione remota |
| FEURTAB |
feurtab |
Input |
Parametri azienda e sistema |
| T-GRID-DET |
t-gor-r-rec |
I-O |
File transito temporaneo per gestione griglia |
Chiavi secondarie utilizzate
| Copybook |
Tabella |
Scopo |
cogimage.k02 |
COGIMAGE |
Ricerca documenti per tipo documento |
cogaridx.k02 |
COGARIDX |
Ricerca per flag remoto |
cogaridx.k03 |
COGARIDX |
Ricerca per progressivo documento |
Copybook inclusi
Screen Designer
| Copybook |
Contenuto |
arc005.select |
SELECT file |
arc005.fd |
File descriptors |
arc005.wrk |
Working storage |
arc005.tm |
Definizioni griglia |
arc005.prc |
Procedure Screen Designer |
arc005-01.scr |
Maschera principale |
arc005.decla |
Declaratives |
arc005.imppredf-wrk |
Filtri predefiniti WRK |
arc005.imppredf |
Filtri predefiniti |
Strutture dati
| Copybook |
Contenuto |
cogfiles.cpy |
Record FEURTAB |
cogargdo.CPY / cogargdo.K01 |
Struttura e chiave primaria COGARGDO |
costanti-arcott.cpy |
Costanti classi documento (codici predefiniti) |
k-personal.cpy |
Codici personalizzazione azienda |
Utility e interfacce
| Copybook |
Contenuto |
utilarc005.cpy |
Interfaccia linkage (caller/called) |
utilarc006.cpy |
Interfaccia per ARC006 (sottoclassi) |
utilcrms06.cpy |
Interfaccia CRMS06 (ricerca CRM) |
utildlg.cpy |
Interfaccia DIALOGS |
utilgdad.cpy / utilgridcol.cpy / utilgridfltr.cpy / utilgrideltr.cpy |
Gestione griglia |
utilgesstr.cpy |
Manipolazione stringhe |
utilgesdebug.cpy |
Framework di debug/logging |
wgrave.cpy / wnscr.cpy / wopenf.cpy / wstato.cpy / wgrid.cpy |
Working storage comuni |
Programmi chiamati (CALL)
| Programma |
Scopo |
| GRIDADMN |
Amministrazione griglia (preparazione, personalizzazione colonne) |
| ARC006 |
Gestione sottoclassi (F5) |
| COGU06 |
Esportazione documenti in cloud AWS |
| COPIAF |
Operazioni copia/cancellazione file .dat |
| DIALOGS |
Finestre di dialogo (selezione modalita' esportazione F6) |
| GESSTR |
Utility manipolazione stringhe |
| CRMS06 |
Ricerca documenti CRM (dossier/attivita') per esportazione |
| GESDEBUG |
Framework logging per verifica e esportazione |
| C$LIST-DIRECTORY |
Scansione directory sezioni archivio (ACU runtime) |
Tasti funzione
| Tasto |
Funzione |
Paragrafo |
| F1 |
Configurazione |
x-configurazione |
| F3 |
Salva modifiche |
b-aggiorna |
| F5 |
Gestione sottoclassi |
Chiama ARC006 |
| F6 |
Esportazione in remoto (cloud) |
e-esporta-documenti |
| F7 |
Verifica situazione migrazione |
d-verifica-classe |
| F8 |
Verifica documenti remoti in locale |
f-verifica-remoti |
| F9 |
Correzione errori dati (nascosto) |
g-verifica-errori-lanzi |
| Ctrl+A |
Nuova riga (nuova classe) |
Tramite GRIDADMN |
| Ctrl+E |
Elimina riga selezionata |
Con validazione |
| ESC |
Uscita |
fine |
Logica di business
Classi predefinite di sistema
Il programma auto-crea le classi predefinite all'apertura se non presenti in COGARGDO. I codici sono definiti in costanti-arcott.cpy:
- Fatture clienti
- Dossier CRM
- Attivita' CRM
- Matricole di assistenza
- Ordini laboratorio
- E altre classi predefinite
Verifica migrazione (F7 - d-verifica-classe)
- Interroga COGIMAGE per tutti i documenti della classe selezionata
- Per ogni documento: verifica in COGARIDX stato locale/remoto
- Calcola conteggi: totali, locali, remoti, da elaborare
- Corregge automaticamente incongruenze dati:
- Classe documento mancante/errata su COGARIDX
- Numero interno diverso tra COGIMAGE e COGARIDX
- Formato numerico dossier CRM (8 cifre → 5 cifre progressivo)
- Supporta filtro per anni (configurabile)
Esportazione in cloud (F6 - e-esporta-documenti)
- Dialogo scelta modalita': immediata, differita singola, differita continua
- Interroga COGARIDX per documenti con
arx-fl-remoto = "N" (locali)
- Per ogni documento: determina percorso remoto in base alla classe:
- Chiamate assistenza: estrae cliente da ASNCHTES
- Dossier CRM: costruisce chiave da logica CRM032
- Attivita' CRM: estrae codice attivita'
- Ordini laboratorio: estrae codice commessa
- Fatture/documenti: chiave vuota
- Chiama COGU06 per upload su AWS
- Marca documento come remoto (
arx-fl-remoto = "S")
Verifica documenti remoti in locale (F8 - f-verifica-remoti)
- Scansiona tutte le sezioni archivio online (COGARSEC)
- Per ogni sezione, elenca file
.dat
- Se il documento risulta remoto su COGARIDX: cancella il file locale tramite COPIAF
Validazione cancellazione
- Non si puo' eliminare una classe con archiviazione remota attiva
- Non si possono inserire/eliminare righe con filtro attivo sulla griglia
Pattern architetturali
- File transito (T-GRID-DET): disaccoppia modifiche UI da scritture su database; le modifiche vengono applicate solo su F3
- Griglia modificabile: AcuCOBOL Screen Designer con gestione eventi tastiera
- Dual-mode: supporto modalita' selezione (chiamato) e aggiornamento (standalone) tramite interfaccia linkage
- Debug logging: integrato con GESDEBUG per audit trail di tutte le operazioni di verifica/esportazione