CRMS10 - Operazioni su dossier CRM

Posizione nel menu Programma non a menu Linkage section

Tipo	Dato	Formato	Contenuto
INPUT	CRMS10-OPE	x(20)	Operazione da eseguire Vedi argomenti successivi
	CRMS10-ANA		Riferimento anagrafico interessato all'operazione
		x(01)
		9(05)
	CRMS10-NOM	9(08)	Riferimento nominativo interessato all'operazione E' in alternativa a CRMS10-ANA
	CRMS10-TDO	x(03)	TIpologia dossier
	CRMS10-ID	x(30)	ID dossier
	CRMS10-STATO	x(200)	Esito dell'operazione; se " " operazione ok, altrimenti contiene la descrizione dell'errore
	CRMS10-DES	x(80)	Descrizione breve del dossier
	CRMS10/TESTO	x(2000)	Descrizione estesa del dossier
	CRMS10-DATA-APE	9(08)	Data apertura del dossier
	CRMS10-DSR-CHIA1		Chiave dossier
		x(03)
		9(12)
	CRMS10-NODO-DES	x(60)	Descrizione nodo da creare/a cui agganciare un documento
	CRMS10-NODO-PADRE-DES	x(60)	Descrizione nodo padre (in caso di creazione nodo) Se " " il gruppo va creato sul nodo principale
	CRMS10-CONTIENE-DOC	x(01)	Qui devo indicare se il nodo e' un gruppo finale di documenti ("S") se e' un nodo che raccoglie altri gruppi ("N")
	CRMS10-ALLEGATO	x(256)	Nome documento da allegare
	CRMS10-ALL-DES	x(60)	Descrizione da attribuire al documento
	CRMS10-ALL-CS	x(01)	Locazione dell'allegato:
	CRMS10-SE-DOC-ESISTE	x(01)	* Comportamento da tenere se nel dossier esiste gia' un documento con la stessa descrizione
	CRMS10-ALL-ID	x(10)	Id del documento da allegare
	CRMS10-LNK-TIP	x(01)	Link a documento: tipo Vedi IMG-LNG-TIP
	CRMS10-LNK-KEY		Link a documento: chiave documento Vedi IMG-LNK-KEY
		x(02)
		x(25)
	CRMS10-ATT	9(12)	Id attività da allegare
	CRMS10-NOM-2	9(08)	Secondo nominativo da agganciare al dossier
	CRMS10-FL-CREA-NODO	x(01)	Indicare se nel caso in cui il nodo non esiste deve essere creato (S/N)
	CRMS10-LKG-TIP	x(04)	Tipo di documento gestionale da collegare al dossier
	CRMS10-LKG-DOC	x(40)	Chiave documento gestionale da collegare al dossier
OUTPUT	CRMS10-DSR-CHIA1		Chiave dossier restituita al programma chiamante
		x(03)
		9(12)
	CRMS10-IMG-DOC-TIP	x(02)	Corrispondono al riferimento: del documento archiviato che è stato linkato o aggiunto
	CRMS10-IMG-DOC-COGE	x(25)
	CRMS10-ESITO	x(01)	Esito dell'operazione - "S": Operazione effettuata con successo - "N": Operazione non conclusa
	CRMS10-CODICE-ERRORE	9(04)	Eventuale codice errore restituito
	CRMS10-MSG	x(120)	Messaggio restituito
	FILLER	x(755)

Logica generale Questa routine permette la gestione di varie operazioni sui dossier CRM. * Inserimento * Aggancio di un documento * ....

Operazione: "CERCA-CHIAVE"

Descrizione Questa operazione restituisce la chiave primaria di un dossier, ricevendo in input l'ID Evita di definire in un programma l'apertura del file CRMDOSSR diretta. Utile soprattutto quando CRMS10 è già usato dal programma chiamante. Chiamata standard

Dato	Contenuto
CRMS10-OPE	CERCA-CHIAVE
CRMS10-ID	Id dossier da cercare

Elaborazione Ricerca diretta su CRMDOSSR di un dossier il cui ID è quello passato in input, con una ricerca attraverso DSA-CHIA2. Sarà restituita la chiave DSA-CHIA1 per il primo dossier esistente con l'ID richiesto. Il dossier sarà restituito in CRMS10-DSR-CHIA1

Operazione "COLLEGA-ATT"

Descrizione Questa operazione permette di collegare una attività esistente ad un dossier esistente. Chiamata standard

Dato	Contenuto
CRMS10-OPE	COLLEGA-ATT
CRMS10-ID	Id dossier da cercare
CRMS10-DSR-CHIA1	Chiave dossier da cercare, in alternativa a CRMS10-ID
CRMS10-ATT	Attività da collegare

Elaborazione Se il dossier risulta già abbinato all'attività richiesta, sarà restituita una segnalazione, altrimenti si procede a scrivere un record su CRMDOSAT

Nome campo	Note
DSV-DOS-KEY-TDO	CRMS10-DSR-KEY-TDO
DSV-NUM	CRMS10-DSR-NUM
DSV-ATT	CRMS10-ATT
DSV-DATA-ESE	CRT-DATA-ESE
DSV-ATT-TIP	CRT'TIP
DSV-NOM	Il nominativo principale collegato all'attività

Operazione "ALLEGA-DOC" / "COLLEGA-DOC"

Descrizione Questa operazione permette di allegare un documento non ancora archiviato ad un dossier (ALLEGA-DOC), o di collegare un documento già archiviato (COLLEGA-DOC), eventualmente all'interno di una determinata cartella Chiamata standard

Dato	Contenuto
CRMS10-OPE	ALLEGA-DOC / COLLEGA-DOC
CRMS10-ID	Id dossier da cercare
CRMS10-DSR-CHIA1	Chiave dossier da cercare, in alternativa a CRMS10-ID
CRMS10-NODO-DES	Descrizione del nodo al di sotto del quale archiviare il documento
CRMS10-ALL-ID	Id del documento da archiviare
CRMS10-ALL-DES	Descrizione del documento (come viene vista sul dossier)
CRMS10-SE-DOC-ESISTE	Comportamento da tenere se nel dossier esiste gia' un documento con lo stesso ID
CRMS10-ALLEGATO	Il nome del file da archiviare (ALLEGA-DOC)
CRMS10-ALL-CS	Indica se l'allegato e' in modalità (ALLEGA-DOC)
CRMS10-LNK-TIP	Tipo e chiave link a documento: vedi IMG-LNK-TIP e IMG-LNK-KEY (COLLEGA-DOC)
CRMS10-LNK-KEY

Elaborazione Se viene richiesto di archiviare il documento sotto ad un nodo (una cartella), se questo nodo non esiste si richiederà di crearlo: se confermato verrà creato al di sotto dei nodi esistenti. All'interno di un nodo, i documenti vengono identificati dal loro ID (CRMS10-ALL-ID): quindi se si richiede di archiviare un documento, con lo stesso ID di un documento già esistente, per il sottoprogramma questo è lo stesso documento. Quindi, se il documento non esiste verrà archiviato direttamente, altrimenti a seconda di CRMS10-SE-DOC-ESISTE, il programma effettuerà l'elaborazione descritta nei vari casi. NB: il caso "S" (Sovrascrivi) elimina il documento esistente, e lo archivia nuovamente; quindi nei casi in cui si preveda questa operazione, è bene non effettuare l'operazione di collegamento, altrimenti si potrebbe avere un documento archiviato non collegato a nulla. Poi l'elaborazione prosegue con: 1. Inserimento CRMDSAAD (se il documento è nuovo) 2. Se l'operazione è: 1. "ALLEGA-DOC": Archiviazione documento con COGU06 2. "COLLEGA-DOC": viene raccordato al dossier il documento passato in input in CRMS10-LNG-TIP/KEY 3. Il nuovo protocollo viene salvato su CRMDSAAD

Operazione "SCRIVI"

Descrizione Con questa creazione possiamo eseguire la creazione della testata di un dossier. Chiamata standard

Tipo	Dato	Contenuto
INPUT	CRMS10-OPE	"SCRIVI"
	CRMS10-ANA	Riferimento anagrafico interessato all'operazione
	CRMS10-NOM	Riferimento nominativo interessato all'operazione E' in alternativa a CRMS10-ANA
	CRMS10-TDO	TIpologia dossier
	CRMS10-ID	ID dossier
	CRMS10-STATO	Esito dell'operazione; se " " operazione ok, altrimenti contiene la descrizione dell'errore
	CRMS10-DES	Descrizione breve del dossier
	CRMS10-TESTO	Descrizione estesa del dossier
	CRMS10-DATA-APE	Data apertura del dossier
	CRMS1-NOM-2	Eventuale nominativo secondario da agganciare
OUTPUT	CRMS10-DSR-CHIA1	Chiave dossier restituita al programma chiamante

Elaborazione Il programma eseguirà la creazione del dossier usando i dati passati in input. Se nel tipo documento è presente una struttura di cartelle documenti, questa struttura sarà replicata sul dossier appena creato. Il dossier creato sarà restituito in CRMS10-DSR-CHIA1 Logiche di attribuzione numero La numerazione di un dossier può dipendere da 2 configurazioni: * pratica-attr-numerazione: se vale * "P": Viene effettuata una ricerca di numerazione progressiva: l'ultimo dossier + 1 * "R": Viene attribuita una numerazione random * pratica-tipo-numerazione: influenza se la numerazione, cercata come spiegata sopra, dipende dal tipo dossier o e è assoluta; se vale * "T": Dipende dal tipo dossier -> In questo caso nella chiave primaria sarà presente anche il tipo dossier * "U": Unica per tutti i dossier Sincronizzazione e logiche di attribuzione numero Nel caso in cui sia attiva la sincronizzazione con KPN, e sia già abilitata la nuova sincronizzazione con AGLANCIO, si richiede che la numerazione venga creata in modo ufficiale sulla tabella WEB, ovvero APCRMDOSSR. Quindi, se: * attiva-areaapp = "S" * aglancio-attivo = "S" si potranno inserire dossier solo se agg-postgres-online = "S" Questo perchè è necessario avere la connessione con il db per poter attribuire un numero valido. In questo caso, dopo aver eseguito la ricerca standard "interna", la validazione del numero dossier sarà demandata a SWN056 tramite una chiamata con: * AGPRG-OPE = "OCCUPA-KEY" * AGPRG-KEY = DSA-CHIA1 "ufficioso" Se la chiamata effettua il suo lavoro completamente: * Verrà creato un dossier su APCRMDOSSR * Verrà restituito AGPRG-ESITO = "S" Quindi si potrà procedere con l'inserimento. Se invece l'esito è "N", si deve ripetere il giro di attribuzione numero e ritentare. Per non rischiare un loop infinito, limitamo il numero di tentativi a 10, dopodichè si interrompe l'elaborazione con un errore.

Operazione LKG-COLLEGA-DOC

Descrizione Questa operazione appartiene alla serie "LKG-..." che raggruppa le operazioni che permettono di gestire il raccordo tra un dossier e altri documenti gestionali attraverso una tabella solo web: APCRMDOSLK In partticolare questa operazione permette di collegare un documento gestionale al dossier Chiamata standard

Dato	Contenuto
CRMS10-OPE	"LKG-COLLEGA-DOC"
CRMS10-ID	Id dossier interessato
CRMS10-DSR-CHIA1	Chiave dossier interessato, in alternativa a CRMS10-ID
CRMS10-LKG-TIP	Tipo di documento gestionale da collegare I valori potrebbero essere quelli presenti in costanti-tipi-documento.cpy
CRMS10-LKG-DOC	Chiave documento. Il contenuto dipende da CRMS10-LKG-TIP

Restituisce:

Dato	Contenuto
CRMS10-ESITO
CRMS10-CODICE-ERRORE
CRMS10-MSG

Elaborazione Questa operazione permette di collegare un dossier ad un documento gestionale. Viene effettuato un tentativo di inserimento del collegamento.

Dato	Contenuto
A-DLK-AZIENDA	Codice azienda
A-DLK-KEY-TDO	CRMS10-DSR-KEY-TDO
A-DLK-DOS-NUM	CRMS10-DSR-NUM
A-DLK-TIPO-RACCORDO	CRMS10-LKG-TIP
A-DLK-DOCUMENTO	CRMS10-LKG-DOC

Il record potrebbe risultare già presente ma cancellato logicamente, in questo caso si ripristina. Se il tentativo non riesce, verrà restituito esito "N", un messaggio opportuno e un eventuale codice errore

Operazione LKG-SCOLLEGA-DOC

Descrizione Questa operazione appartiene alla serie "LKG-..." che raggruppa le operazioni che permettono di gestire il raccordo tra un dossier e altri documenti gestionali attraverso una tabella solo web: APCRMDOSLK In partticolare questa operazione permette di scollegare un documento gestionale dal dossier Chiamata standard

Dato	Contenuto
CRMS10-OPE	"LKG-SCOLLEGA-DOC"
CRMS10-ID	Id dossier interessato
CRMS10-DSR-CHIA1	Chiave dossier interessato, in alternativa a CRMS10-ID Se il dossier non è indicato, saranno scollegati tutti i dossier dal documento indicato
CRMS10-LKG-TIP	Tipo di documento gestionale da scollegare I valori potrebbero essere quelli presenti in costanti-tipi-documento.cpy
CRMS10-LKG-DOC	Chiave documento. Il contenuto dipende da CRMS10-LKG-TIP

Restituisce:

Dato	Contenuto
CRMS10-ESITO
CRMS10-CODICE-ERRORE
CRMS10-MSG

Elaborazione Questa operazione permette di scollegare un dossier da un documento gestionale, o tutti i dossier dal documento gestionale Cancellazione singolo raccordo Si ricerca il raccordo con i dati forniti

Dato	Contenuto
A-DLK-AZIENDA	Codice azienda
A-DLK-KEY-TDO	CRMS10-DSR-KEY-TDO
A-DLK-DOS-NUM	CRMS10-DSR-NUM
A-DLK-TIPO-RACCORDO	CRMS10-LKG-TIP
A-DLK-DOCUMENTO	CRMS10-LKG-DOC

Se presente, viene effettuata la cancellazione logica Se il tentativo non riesce, verrà restituito esito "N", un messaggio opportuno e un eventuale codice errore Cancellazione di tutti i raccordi da un documento Si ricercano i raccordi con i dati forniti

Dato	Contenuto
A-DLK-AZIENDA	Codice azienda
A-DLK-TIPO-RACCORDO	CRMS10-LKG-TIP
A-DLK-DOCUMENTO	CRMS10-LKG-DOC

Se presenti, viene effettuata la cancellazione logica per ciascun raccordo trovato Se il tentativo non riesce, verrà restituito esito "N", un messaggio opportuno e un eventuale codice errore

Operazione: LKG-RICERCA

Descrizione Questa operazione appartiene alla serie "LKG-..." che raggruppa le operazioni che permettono di gestire il raccordo tra un dossier e altri documenti gestionali attraverso una tabella solo web: APCRMDOSLK In particolare questa operazione permette di cercare e restituire il raccordo tra un dossier e uno o più documenti raccordati, o viceversa, in base allo schema di sotto riportato. Chiamata standard

Dato	Contenuto
CRMS10-OPE	"LKG-RICERCA"
CRMS10-ID	Id dossier interessato
CRMS10-DSR-CHIA1	Chiave dossier interessato, in alternativa a CRMS10-ID
CRMS10-LKG-TIP	Tipo di documento gestionale da cercare I valori potrebbero essere quelli presenti in costanti-tipi-documento.cpy
CRMS10-LKG-DOC	Chiave documento. Il contenuto dipende da CRMS10-LKG-TIP

Restituisce:

Dato	Contenuto
CRMS10-ESITO
CRMS10-CODICE-ERRORE
CRMS10-MSG

In base ai dati forniti in input restituisce il raccordo "controparte". Una chiamata successiva con Operazione: LKG-RICERCA-NEXT con gli stessi parametri permette di "scorrere" i raccordi dello stesso tipo. Elaborazione Qui di seguito un riepilogo delle modalità di ricerca raccordo che è possibile effettuare

ID / DSR-CHIA1	LKG-TIP	LKG-DOC	Risultato
Indicato	Indicato	Indicato	Restituisce
Indicato	Indicato	/	Ad ogni chiamata restituisce CRMS10-ESITO = "S" se viene trovato il raccordo tra il dossier indicato e un documento del tipo richiesto. Verrà restituito "N" quando non sono disponibili altri raccordi
Indicato	/	/	Ad ogni chiamata restituisce CRMS10-ESITO = "S" se viene trovato il raccordo tra il dossier indicato e un qualsiasi documento di qualsiasi tipo Verrà restituito "N" quando non sono disponibili altri raccordi
/	Indicato	Indicato	Ad ogni chiamata restituisce CRMS10-ESITO = "S" se viene trovato un dossier collegato al documento indicato. Verrà restituito "N" quando non sono disponibili altri raccordi

Qualunque altra combinazione di parametri passati verrà considerata errata e non restituirà esito positivo.

Operazione: LKG-RICERCA-NEXT

Descrizione Questa operazione appartiene alla serie "LKG-..." che raggruppa le operazioni che permettono di gestire il raccordo tra un dossier e altri documenti gestionali attraverso una tabella solo web: APCRMDOSLK In particolare questa operazione permette di cercare e restituire il raccordi successivi tra un dossier e uno o più documenti raccordati, o viceversa, in base allo schema di sotto riportato. Chiamata standard

Dato	Contenuto
CRMS10-OPE	"LKG-RICERCA-NEXT"
CRMS10-ID	Id dossier interessato
CRMS10-DSR-CHIA1	Chiave dossier interessato, in alternativa a CRMS10-ID
CRMS10-LKG-TIP	Tipo di documento gestionale da cercare I valori potrebbero essere quelli presenti in costanti-tipi-documento.cpy
CRMS10-LKG-DOC	Chiave documento. Il contenuto dipende da CRMS10-LKG-TIP

Restituisce:

Dato	Contenuto
CRMS10-ESITO
CRMS10-CODICE-ERRORE
CRMS10-MSG

Elaborazione Questa operazione viene chiamata successivamente a Operazione: LKG-RICERCA per cercare i collegamenti successivi rispetto agli stessi parametri di ricerca impostati in precedenza. Se i parametri impostati permettono una ricerca diretta del raccordo, questa operazione diventa equivalente all'altra.

CRMS10: codici errore

Codice	Messaggio	Descrizione
0	Elaborazione terminata con successo
1	Connessione db non attiva	Il db Postgres non è connesso: Configurazione attiva-areaapp non attiva
2	Connessione online non attiva	La connessione in tempo reale ad db non è attiva; quindi potrebbe essere stato disattivato momentaneamente il db Configurazione agg-postgres-online non attivap
3	Errore durante la connessione al DB	Durante l'operazione "SQL-INIT" è stato restituito un errore
4	LKG-RICERCA: nessun parametro di ricerca	Durante l'operazione LKG-RICERCA non è stato passato nessun parametro di ricerca valido, vedi Operazione: LKG-RICERCA

---

Estratto da documentazione interna ClickUp