COGU06 - gestione archiviazione¶
Posizione nel menu Programma non a menu Linkage section Da completare Logica generale Raccolta di funzioni necessarie per la gestione dell'archiviazione documentale Maschera del programma Nessuna maschera. Elaborazione L'elaborazione cambia a seconda dell'operazione richiesta.
Operazione: INSERISCI-FILE¶
Descrizione Permette l'archiviazione in background di un determinato file Chiamata standard
| Tipo | Dato | Contenuto |
|---|---|---|
| INPUT | U06-OPE | "Inserisci-file" |
| U06-FILE | In percorso completo del file da archiviare, in formato server | |
| U06-FL-INTERNO | Come deve essere creata la chiave di raccordo tra il documento e l'oggetto del gestionale a cui fa riferimento; può essere: |
|
| U06-TIP-DOC | Dipende da cosa si vuole archiviare; ad esempio "BU" per archiviare bolle di uscita. Vedi COGIMAGE.CPY |
|
| U06-DOC-COGE | Chiave di raccordo tra l'oggetto del gestionale e il documento da archiviare Ad esempio, in caso di bolla uscita: "1/2014/I/000123" |
|
| U06-DO-TIP-DOC | Breve descrizione del tipo documento; ad esempio "B.USCITA" Max 10 caratteri |
|
| U06-DO-NUM-INT | Come U06-DOC-COGE | |
| U06-DO-DATA | Data documento gestionale | |
| U06-DO-NUM-EST | Riferimento documento "esterno": è significativo per i documenti passivi; ad esempio archiviando una fattura fornitore, questo campo conterrà il numero fattura del fornitore | |
| U06-DO-DATA-EST | Data del documento esterno | |
| U06-DO-ANA-TIP | Tipo anagrafico di riferimento del documento | |
| U06-DO-ANA-COD | Codice anagrafico di riferimento del documento | |
| U06-DO-ANA-DES | Ragione sociale dell'anagrafica di riferimento | |
| U06-RIMUOVI-FILE | Se vale "S" il file richiesto sarà rimosso dopo l'archiviazione Default=N |
|
| U06-FILE-ESTESO (in u06-altri-dati) |
Percorso completo del file da archiviare, in formato server, alternativo a U06-FILE (è lungo 160 caratteri quindi non ci sono problemi nell'acquisizione del nome, mentre in alcuni casi gli 80 caratteri di U06-FILE non sono sufficienti) | |
| OUTPUT | U06-ESITO | Esito dell'operazione |
Operazione: ESTRAI-CARTELLA¶
Descrizione Permette di estrarre dall'archiviazione una "cartella": quindi l'insieme dei documenti associati ad un oggetto gestionale. Chiamata standard
| Tipo | Dato | Contenuto |
|---|---|---|
| INPUT | U06-OPE | "ESTRAI-CARTELLA" |
| U06-FL-INTERNO | Come deve essere cercata la chiave di raccordo tra il documento e l'oggetto del gestionale a cui fa riferimento; può essere: |
|
| U06-TIP-DOC | Tipo di documento da estrarre Vedi COGIMAGE.CPY |
|
| U06-DOC-COGE | Chiave di raccordo tra l'oggetto del gestionale e il documento, escluso il progressivo di immagine | |
| U06-SILENT-MODE | Se vale "S" non saranno emessi messaggi bloccanti durante l'elaborazione | |
| U06-OGGETTO | Descrizione della sottocartella in cui inserire i files estratti | |
| OUTPUT | U06-ESITO | Esito dell'operazione |
| U06-N-FILES-ESTRATTI | Numero di files estratti |
Operazione: ESTRAI-DA-DOC¶
Descrizione Permette di estrarre dall'archiviazione un determinato documento. Chiamata standard
| Tipo | Dato | Contenuto |
|---|---|---|
| INPUT | U06-OPE | "Estrai-da-doc" |
| U06-FL-INTERNO | Come deve essere cercata la chiave di raccordo tra il documento e l'oggetto del gestionale a cui fa riferimento; può essere: |
|
| U06-TIP-DOC | Tipo di documento da estrarre Vedi COGIMAGE.CPY |
|
| U06-DOC-COGE | Chiave di raccordo tra l'oggetto del gestionale e il documento Ad esempio, in caso di bolla uscita: "1/2014/I/000123" |
|
| U06-SILENT-MODE | Se vale "S" non saranno emessi messaggi bloccanti durante l'elaborazione | |
| U06-DO-ALTRI-DATI | Permette usare la parte "altri dati" della linkage Impostare sempre "S" |
|
| OUTPUT | U06-ESITO | Esito dell'operazione |
| U06-FILE | Nome del file estratto, senza percorso Il percorso è sempre EXT-TMP-DIR |
|
| U06-N-FILES-ESTRATTI | Numero di files estratti (dovrebbe essere sempre 1) | |
| U06-PROGRESSIVO | Il progressivo estratto | |
| U06-PROTOCOLLO-OUTPUT | Il protocollo estratto | |
| U06-DOC-CLASSE | Classe/sottoclasse del documento estratto | |
| U06-DOC-SUBCLASSE | ||
| U06-DO-OGGETTO | Descrizione del documento estratto | |
| U06-DO-NUM-INT | ARX-NUMERO-INTERNO |
Operazione: ESPORTA-SU-WEB¶
| Tipo | Dato | Contenuto |
|---|---|---|
| INPUT | U06-OPE | "ESPORTA-SU-WEB" |
| U06-PROGRESSIVO | Progressivo di documento da esportare | |
| U06-DO-OGGETTO | Se significativo, permette di esportare una descrizione personalizzata | |
| OUTPUT | U06-ESITO | Esito dell'operazione |
Elaborazione Funzione che può essere eseguita in una situazione di archiviazione locale, per l'esportazione del documento sul Db Master KPN.
Operazione: ACQ-PROVV-REMOTO¶
| Tipo | Dato | Contenuto |
|---|---|---|
| INPUT | U06-OPE | "ACQ-PROVV-REMOTO" |
| U06-ID-DISPOSITIVO | Id dispositivo trovato sul documento remoto (A_ARX_ID_DISPOSITIVO) | |
| U06-IDD-PROG | Progressivo su dispositivo trovato sul documento remoto (A_ARX_IDD_PROG) | |
| U06-PATH-ORIGINE | Eventuale percorso di documento AWS dove è presente il documento da acquisire Se diverso da quello che si aspetta la routine (cioè quello che verrà memorizzato in ARP-FILE-NAME), l'oggetto verrà spostato U06-PATH-ORIGINE -> nuovo percorso Vedi SWN117 |
|
| OUTPUT | U06-ESITO | Esito dell'operazione |
| U06-PROGRESSIVO | Numero progressivo attribuito al documento | |
| U06-PROTOCOLLO | Protocollo attribuito al documento | |
| U06-PROG-DOCUMENTO | "Progressivo documento" attribuito durante il processo di acquisizione |
Elaborazione Funzione che permette di fare diventare "definitivo" un documento archiviato in modalità "remota" su Areagate/APP. Per ora usata solo in: * SWN011 * SWN117 Per il momento questa elaborazione è limitata ad alcune classi: * k-arcott-classe-anagrafiche-cf * k-arcott-classe-matricole-assistenza * k-arcott-classe-lod-progetto Partendo dal record di APCOGARIDX identificato dai dat in input, viene creata la struttura di indici interna per il documento: * COGIMAGE * COGARIDX * COGARPAG In questa fase vengono assegnati gli identificativi ufficiali: - ARX-PROGRESSIVO - ARX-PROTOCOLLO Dopodichè: 1. Crea un nuovo indice remoto APCOGARIDX per il documento ufficiale 2. Imposta la cancellazione logica sul record APCOGARIDX provvisorio Modifiche per SWN117 Viene usata anche in questo programma per acquisire i documenti creati sulla prescrizione che viene acquisita e diventa commessa. In questa circostanza gli scenari pero' possono essere diversi dall'uso in SWN117, dove le classi gestite nascono come "remote" e rimangono tali. Qui potrebbe esserci la situazione che un'utenza non ha configurato l'archiviazione remota.
Quindi in questo caso, potrebbe essere necessario effettuare alcune operazioni aggiuntive: * Il documento gestionale non viene marcato come "remoto" * Viene attribuita la sezione ed effettuata la copia del documento da AWS alla cartella locale
Operazione: ACQ-CHIMG-INS¶
| Tipo | Dato | Contenuto |
|---|---|---|
| INPUT | U06-OPE | "ACQ-CHIMG-INS" |
| U06-DO-TIP-DOC | Tipo documento da acquisire Per ora limitato a K-ARCOTT-CLASSE-CHIAMATE-ASSISTENZA |
|
| U06-DO-DOC-COGE | Chiave del documento da archiviare, in base al tipo documento | |
| OUTPUT | U06-ESITO | Esito dell'operazione |
| U06-PROGRESSIVO | Numero progressivo attribuito al documento | |
| U06-PROTOCOLLO | Protocollo attribuito al documento |
Elaborazione Funzione che permette di fare diventare "definitivo" un documento archiviato in modalità "remota" su Areagate/APP. Partendo dal record di ARPCHIMG identificato dai dat in input, viene creata la struttura di indici interna per il documento: * COGIMAGE * COGARIDX * COGARPAG Non è necessario effettuare altre operazioni su ARPCHIMG
Operazione: ACQ-APCRMATTAL-INS¶
| Tipo | Dato | Contenuto |
|---|---|---|
| INPUT | U06-OPE | "ACQ-APCRMATTAL-INS" |
| U06-DO-TIP-DOC | Tipo documento da acquisire Per ora limitato a K-ARCOTT-CLASSE-ATTIVITA-CRM |
|
| U06-DO-DOC-COGE | Chiave del documento da archiviare, in base al tipo documento | |
| OUTPUT | U06-ESITO | Esito dell'operazione |
| U06-PROGRESSIVO | Numero progressivo attribuito al documento | |
| U06-PROTOCOLLO | Protocollo attribuito al documento |
Elaborazione Funzione che permette di fare diventare "definitivo" un documento archiviato in modalità "remota" su Areagate/APP. Partendo dal record di APCRMATTAL identificato dai dati in input, come prima cosa si verifica se l'allegato è cancellato (A-CRL-FL-CANC = "C"); in questo caso verifica se è cancellato; se si, si effettua la cancellazione degli indici locali; altrimenti viene creata la struttura di indici interna per il documento: * COGIMAGE * COGARIDX * COGARPAG Qui verrà anche "completato" il record di APCRMATTAL:
| Dato | Contenuto |
|---|---|
| A-CRL-ARX-PROGRESSIVO | Progressivo creato |
| A-CRL-AGG-APP | "N" |
| A-CRL-AGG-GEST | "S" |
Nome documento Il nome del documento rimane come in originale, per evitare di dovere effettuare operazioni su AWS, come nel caso dell'acquisizione nuovo allegato (ma in questo caso comunque si effettua una operazione perchè deve essere spostato su una nuova cartella di archiviazione).
Operazione: ACQ-ARPSKDATF-INS¶
| Tipo | Dato | Contenuto |
|---|---|---|
| INPUT | U06-OPE | "ACQ-ARPSKDATF-INS" |
| U06-DO-TIP-DOC | Tipo documento da acquisire Per ora limitato a K-ARCOTT-CLASSE-FASCICOLI-CRM |
|
| U06-DO-DOC-COGE | Chiave del documento da archiviare, in base al tipo documento | |
| OUTPUT | U06-ESITO | Esito dell'operazione |
| U06-PROGRESSIVO | Numero progressivo attribuito al documento | |
| U06-PROTOCOLLO | Protocollo attribuito al documento |
Elaborazione Funzione che permette di fare diventare "definitivo" un documento archiviato in modalità "remota" su Areagate/APP. Partendo dal record di ARPSKDATF identificato dai dati in input, come prima cosa si verifica se l'allegato è cancellato (A-SKDF-FL-CANC = "C"); in questo caso verifica se è cancellato; se si, si effettua la cancellazione degli indici locali; altrimenti viene creata la struttura di indici interna per il documento: * COGIMAGE * COGARIDX * COGARPAG *qui Qui verrà anche "completato" il record di APCRMATTAL:
| Dato | Contenuto |
|---|---|
| A-CRL-ARX-PROGRESSIVO | Progressivo creato |
| A-CRL-AGG-APP | "N" |
| A-CRL-AGG-GEST | "S" |
Nome documento Il nome del documento rimane come in originale, per evitare di dovere effettuare operazioni su AWS, come nel caso dell'acquisizione nuovo allegato (ma in questo caso comunque si effettua una operazione perchè deve essere spostato su una nuova cartella di archiviazione).
Operazione: ACQ-CANC-REMOTO¶
| Tipo | Dato | Contenuto |
|---|---|---|
| INPUT | U06-OPE | "ACQ-CANC-REMOTO" |
| U06-PROGRESSIVO | Progressivo di documento di cui effettuare la cancellazione locale | |
| OUTPUT | U06-ESITO | Esito dell'operazione |
Elaborazione Questa funzione effettua la cancellazione locale della parte indici per un documento "definitivo" che è stato cancellato da remoto. Partendo dal record di APCOGARIDX identificato dai dati in input, viene cancellata la struttura di indici interna per il documento: * COGIMAGE * COGARIDX * COGARPAG Dopodichè aggiorna il record APCOGARIDX:
| Dato | Contenuto |
|---|---|
| A-ARX-AGG-APP | " " |
| A-ARX-ID-SINCRO | Ultimo id sincro + 1 |
Operazione: VISUALIZZA-DA-DOC¶
Descrizione Recupera un documento archiviato e innesca la visualizzazione Esiste un caso particolare, descritto oltre, per la consultazione delle fatture clienti e fornitori Chiamata standard
| Tipo | Dato | Contenuto |
|---|---|---|
| INPUT | U06-OPE | "Visualizza-da-doc" |
| U06-FL-INTERNO | Come deves: essere cercata la chiave di raccordo tra il documento e l'oggetto del gestionale a cui fa riferimento; può essere: |
|
| U06-TIP-DOC | Tipo di documento da estrarre Vedi COGIMAGE.CPY |
|
| U06-DOC-COGE | Chiave di raccordo tra l'oggetto del gestionale e il documento Ad esempio, in caso di bolla uscita: "1/2014/I/000123" |
|
| U06-SILENT-MODE | Se vale "S" non saranno emessi messaggi bloccanti durante l'elaborazione | |
| OUTPUT | U06-ESITO | Esito dell'operazione |
Elaborazione A - Elaborazione per fatture clienti e fornitori Se si richiede di visualizzare una fattura clienti o una fattura fornitori, quindi per le classi: * k-arcott-classe-fatture-clienti * k-arcott-classe-fatture-fornitori il programma effettuerà una procedura particolare se la fattura è "elettronica": in pratica non si dovrà semplicemente richiamare e visualizzare il documento, ma passarlo a WORDMDL con una operazione particolare allo scopo di produrre il report "Fattura".
A.1 -Verifico se la fattura è "Elettronica" Si effettua una ricerca sulla tabella COGFTETS con chiave FTETS-CHIA6: se il record esiste allora la fattura potrà essere considerata "Elettronica". In questo caso si prosegue con il procedimento A.2 - Download documento Si effettua il download come nel caso della visualizzazione normale Il file ottenuto dovrebbe essere un XML contenente la fattura elettronica. A.3 - Produzione report Si passa il file XML a WORDMDL, richiamato attraverso l'operazione "ESEGUI"
| Dato | Contenuto |
|---|---|
| WORDMDL-OPE | "Esegui" |
| WORDMDL-MODELLO | " " |
| WORDMDL-MODELLO-LOC | " " |
| WORDMDL-INFO | Il nome del file XML (in formato server) |
| WORDMDL-FL-STAMPA | "S" |
| WORDMDL-PERIFERICA | 0 |
| WORDMDL-FL-CHIUDI | "S" |
| WORDMDL-PRG-ID | k-program-id |
| WORDMDL-ATTENDI-ESITO | "S" |
| WORDMDL-MDC-PROG | L'id modello configurato in a seconda della classe documento |
| WORDMDL-TIPO-MODELLO | COGMODST.MDC-TIPO-MOD-JASPER |
| WORDMDL-DRIVER | "J" |
| WORDMDL-PROCESSO | "COGP41" |
Estratto da documentazione interna ClickUp