Vai al contenuto

CRM06C - Esportazione fascicoli CRM

Funzione

Esportazione (scaricamento sul client) dei fascicoli CRM di uno o piu' nominativi. Per ciascun nominativo il programma scorre l'archivio ottico dei documenti di classe "fascicoli CRM", estrae ogni documento dall'archiviazione remota tramite COGU06 e lo copia in una cartella locale del client, organizzata per nominativo e per informazione/fascicolo, con nome file costruito a partire dalla descrizione dell'informazione e dall'oggetto del documento. A differenza di CRM06B, qui non si produce un file dati per COGPA9: l'esportazione consiste nel solo trasferimento dei documenti allegati.

  • CRM > Utilita' > Esportazione fascicoli

Tabelle e file principali

Tabella/File Descrizione Accesso
FEURTAB Tabella file aziendali Lettura (rd-azi)
CRMANAGR Anagrafica nominativi CRM Lettura (rd/st/rdnxt)
COGIMAGE Indice archivio ottico Lettura per chiave 2 (documenti fascicoli del nominativo)
CRMANANF Informazioni/note nominativo CRM Lettura per chiave 3 (specie I)
CRMINFOR Anagrafica informazioni CRM Lettura (rd-crminfor) per descrizione informazione

Copybook e sottoprogrammi

Elemento Tipo Ruolo
crm06c.select / .fd / .wrk / .prc / .decla / -01.scr Screen Definizioni file, working, screen
k-personal.cpy Copybook Costanti personalizzazione
costanti-arcott.cpy Copybook Costanti archivio ottico (classe documento)
utildlg.cpy Copybook Dialog conferma pulizia cartella (DIALOGS)
utilncnf.cpy Copybook Lettura configurazioni RNEWCONF
utilcrms02.cpy Copybook Aiuto/selezione nominativo CRM (CRMS02)
utilu06.cpy Copybook Estrazione documento da archivio ottico remoto (COGU06)
l-copiaf.cpy, u-copiaf.cpy Copybook Copia/spostamento file server-client (COPIAF)
utilgesstr.cpy Copybook Normalizzazione testo (GESSTR)
cogimage.k02, crmananf.k03 Copybook chiavi Chiavi secondarie
CRMS02 Sottoprogramma Ricerca/selezione nominativo CRM
COGU06 Sottoprogramma Estrazione file documento (archiviazione remota)
COPIAF Sottoprogramma Spostamento allegati server->client e pulizia cartella
GESSTR Sottoprogramma Normalizzazione testo (conversione export, trim spazi)
DIALOGS Sottoprogramma Dialog di conferma pulizia cartella
RNEWCONF Sottoprogramma Lettura configurazione path locale

Configurazioni RNEWCONF

x99-confi legge la chiave ARC-OTT / PATH-APRI-FILE (tm-cfg-path-locale): percorso base sul client dove viene creata la sottocartella fascicoli.

Logica principale

  1. Apri: init, lettura configurazione path locale, open files. Tasti funzione F1 (configura), F3 (conferma), F8 (aiuto), F9 (ricerca avanzata).
  2. Filtro: accept di un unico campo, il nominativo CRM (via CRMS02). Se lasciato a zero l'elaborazione riguarda tutti i nominativi.
  3. Esportazione (F3 -> e-esporta-dettaglio):
  4. Pulizia cartella: DIALOGS chiede se azzerare la cartella fascicoli sul client; su conferma esegue rd /S/Q via COPIAF (shell).
  5. Ricerca dati (ricerca-dati): se e' indicato un nominativo lo legge direttamente su CRMANAGR, altrimenti scorre tutta l'anagrafica nominativi.
  6. Per ogni nominativo: scorre COGIMAGE per la classe k-arcott-classe-fascicoli-crm e il codice nominativo; per ogni documento ricava la chiave fascicolo (img-dc-pf-key -> nominativo + informazione).
  7. Risoluzione pagina/prog remoti: legge CRMANANF (specie "I", informazione, nominativo) per ottenere pagina e progressivo necessari all'archiviazione remota; se non trovati salta il documento (i fascicoli CRM richiedono tali riferimenti).
  8. Estrazione: chiama COGU06 (fl-interno "D", chiave archiviazione remota) per estrarre il file; legge CRMINFOR per la descrizione dell'informazione.
  9. Costruzione nome e copia: normalizza descrizione informazione e oggetto documento con GESSTR (rimozione CR/LF, sostituzione di /, \, :, trim) e copia il file sul client via COPIAF in path-locale\fascicoli\<nominativo>\<inf>-<descr>\<prog>-<oggetto>.<ext>. Il progressivo allegato riparte ad ogni cambio di informazione.
  10. Fine: messaggio "elaborazione terminata" e ritorno.

Note tecniche

  • Rispetto a CRM06B non c'e' esportazione dati verso COGPA9: il modulo esporta fisicamente i soli file allegati (fascicoli) sul client.
  • L'estrazione COGU06 usa il ramo "D" con chiave di archiviazione remota (u06-arc-remota-key = nominativo + pagina + prog + prog-doc), quindi il reperimento del documento dipende dalla presenza dei riferimenti in CRMANANF.
  • Il nome del file di destinazione include la descrizione dell'informazione e l'oggetto del documento, ripuliti dai caratteri non validi per il filesystem.
  • Gli allegati sono trasferiti con operazione "move" (spostamento del temporaneo lato server) da server a client.
  • Presenza di PERFORM ... THRU e GO TO (stile legacy): non usare come modello per nuovi sviluppi.
  • Il codice contiene tracce commentate di un uso "called" (linkage utilcrm06c.cpy) non attivo: il programma e' oggi solo standalone da menu.