SWN097 - Magazzini¶

Nome programma SWN097 Linkage section UTILAGPRG - Linkage comune Id processo: 97 Nome processo:MAGAZZINI Tabelle principali gestite

AREA	AREAGATE	Direzione
COGMAGAZ COGMAGAG	APCOGMAGAZ	------> <------
COGMAGPE	APCOGMAGAZ	------> <------

Logica generale Sincronizzazione della tabella "Magazzini" Esportazione Esportazione di tutti i record effettivamente modificati (con dati variati). Importazione Le applicazioni WEB potranno inserire, modificare o cancellare logicamente nuovi record Configurazioni possibili

Gruppo	Parametro	Note
abilita	attiva-areaapp
areaapp	cod-azienda
areaapp	db-conn-string
areaapp	agg-postgres-online

Elaborazione Tipi di segnalazione: Vedi Tipi di segnalazione A - Controllo di esecuzione Vedi Controllo di esecuzione A.1 - Aggiornamento KEEP-ALIVE Per il momento non lo eseguiamo: il keep-alive viene tenuto aggiornato dal thread autonomo di aglancio; se il programma venisse chiamato in "tempo reale" dal programma di gestione, non necessita comunque del keep-alive. A.2 - Apertura A.2.1 Apertura tabelle Tentare l'apertura della tabella da sincronizzare: APCOGMAGAZ Se fallita inviare una Segnalazione critica e chiudere. C - Importazione aggiornamenti Effettuare una query per estrarre tutti gli elementi aggiornati su APP: SELECT * FROM APCOGMAGAZ WHERE a_magz_azi = azienda AND (a_magz_agg_app = 'A') Gli elementi potranno essere: * Cancellati: se A-MAGZ-FL-CANC = "C" * oInseriti o aggiornati: se A-MAGZ-FL-CANC <> "C" o Quindi se A-MAGZ-TIPO: * "M" -> C.1 - Importazione magazzino principale * "E" -> C.2 - Importazione magazzino secondario "esterno" C.1 - Importazione magazzino principale In COGMAGAZ per il momento non viene gestita la cancellazione logica (nonostante sia presente MAGZ-VAL) quindi si dovrà differenziare il giro di importazione. C.1.1 - Importazione elemento nuovo o aggiornato Fare una ricerca su COGMAGAZ impostando:

Dato	Contenuto
MAGZ-TIPO	"M"
MAGZ-COD	A-MAGZ-COD

Se l'elemento non esiste, inserirlo. Quindi proseguire con l'aggiornamento di COGMAGAZ.

Dato	Contenuto
MAGZ-NOME	A-MAGZ-NOME
MAGZ-FL-TIP	A-MAGZ-FL-TIP
MAGG-LATITUDINE	A-MAGZ-LATITUDINE
MAGG-LONGITUDINE	A-MAGZ-LONGITUDINE
MAGG-FL-LUNEDI	A-MAGZ-FL-LUNEDI
MAGG-FL-MARTEDI	A-MAGZ-FL-MARTEDI
MAGG-FL-MERCOLEDI	A-MAGZ-FL-MERCOLEDI
MAGG-FL-GIOVEDI	A-MAGZ-FL-GIOVEDI
MAGG-FL-VENERDI	A-MAGZ-FL-VENERDI
MAGG-FL-SABATO	A-MAGZ-FL-SABATO
MAGG-FL-DOMENICA	A-MAGZ-FL-DOMENICA

C.1.2 - Importazione elemento cancellato Fare una ricerca su COGMAGAZ impostando:

Dato	Contenuto
MAGZ-TIPO	"M"
MAGZ-COD	A-MAGZ-COD

Se esiste, eseguire la cancellazione fisica del record. C.2 - Importazione magazzino secondario "esterno" In COGMAGPE è presente MGP-FL-CLOSE che ha la funzione di "magazzino cancellato". C.2.1 - Importazione elemento nuovo o aggiornato Fare una ricerca su COGMAGPE impostando:

Dato	Contenuto
MGP-TIP	A-MAGZ-TIPO
MGP-COD	A-MAGZ-COD

Se l'elemento non esiste, inserirlo. Quindi proseguire con l'aggiornamento di COGMAGPE.

Dato	Contenuto
MGP-NOME	A-MAGZ-NOME
MGP-FL-CLOSE	A-MAGZ-FL-CANC

C.2.2 - Importazione elemento cancellato Dato che questa tabella gestisce una sorta di flag di cancellazione, non è necessario differenziare l'elaborazione. B - Esportazione informazioni aggiornate * ID SINCRO: gestito * Esportazione differenziale: gestita e ottimizzata, attraverso una data specifica collegata a data/ora aggiornamento * Cancellazione logica: non gestita In questa fase si dovrà tenere conto di * Limite record * Limite errori * "Esporta tutto" B.1 - Stato sincronizzazione Sulla tabella APSTATOSYN, leggere il record relativo alla tabella/oggetto da sincronizzare "COGMAGAZ"; se il record non esiste, crearlo impostando

Dato	Contenuto
A-SYN-AZIENDA	Codice azienda
A-SYN-TABELLA	"COGMAGAZ"
A-SYN-DA-GES-DATA	0
A-SYN-DA-GES-ORA	0
A-SYN-DA-ID-SINCRO	1
A-SYN-VERSIONE	2

Qui otterremo due informazioni importanti: * Data/ora ultima esportazione da gestionale a postgres (A-SYN-DA-GES-DATA e A-SY-DA-GES-ORA) -> Necessario solo per COGMAGPE. * Prossimo ID sincronizzazione da memorizzare sulla tabella (A-SYN-ID-SINCRO) B.2 - Ricerca record da esportare

Tipo di elaborazione	Condizione	Cosa fare
Singolo record	AGPRG-KEY <> " "
Esportazione totale	AGPRG-ESPORTA-TUTTO = "S"
Esportazione standard
Pulizia	AGPRG-OPE = "PULIZIA"	Eseguire solo il giro di cancellazione logica B.3 quindi uscire

B.2.1 Esportazione magazzini principali (COGMAGAZ) Filtri Si considerano solo i record con MAGZ-TIPO = "M" Per ciascun record valido si cercano tutti i record collegati: - COGMAGAG B.2.1.1 Verifica ed esportazione record Dopodichè si effettua la ricerca dell'informazione su APCOGMAGAZ

Dato	Contenuto
A-MAGZ-AZI	Codice azienda
A-MAGZ-TIPO	"M"
A-MAGZ-COD	MAGZ-COD

Se non esiste, inserirlo. Se esiste, aggiornarlo l'aggiornamento del record deve avvenire solo se almeno un dato tra quelli da modificare è diverso. NB: se è stata richiesta l'esportazione completa (AGPRG-ESPORTA-TUTTO = "S") allora il record dovrà essere esportato a prescindere dal confronto Suggerimento Invece di popolare direttamente i dati del record di destinazione, portarli su delle copie in w/s. Al termine confrontare i dati sulla destinazione con la copia in w/s. B.2.1.2 - Aggiornamento da COGMAGAZ Attenzione: se A-MAGZ-FL-TIP = 'v' ("V" minuscola) significa che un altro processo sta effettuando un'elaborazione su alcune informazioni del magazzino, quindi NON aggiornare questa informazione.

Dato	Contenuto	Confronto?
A-MAGZ-AZI	Codice azienda
A-MAGZ-TIPO	MAGZ-TIPO
A-MAGZ-COD	MAGZ-COD

A-MAGZ-NOME	MAGZ-NOME	Si
A-MAGZ-FL-TIP	MAGZ-FL-TIP	Si
A-MAGZ-LATITUDINE	MAGG-LATITUDINE	Si
A-MAGZ-LONGITUDINE	MAGG-LONGITUDINE	Si
A-MAGZ-FL-LUNEDI	MAGG-FL-LUNEDI	Si
A-MAGZ-FL-MARTEDI	MAGG-FL-MARTEDI	Si
A-MAGZ-FL-MERCOLEDI	MAGG-FL-MERCOLEDI	Si
A-MAGZ-FL-GIOVEDI	MAGG-FL-GIOVEDI	Si
A-MAGZ-FL-VENERDI	MAGG-FL-VENERDI	Si
A-MAGZ-FL-SABATO	MAGG-FL-SABATO	Si
A-MAGZ-FL-DOMENICA	MAGG-FL-DOMENICA	Si
A-MAGZ-FL-SEDE	~~MAGZ-FL-SEDE~~ `MAGG-FL-SEDE-OPERATIVA` (TASK-4553, 07/04/2026)	Si
A-MAGZ-SEDE	MAGZ-SEDE	Si

A-MAGZ-AGG-APP	" "
A-MAGZ-ID-SINCRO	Id-sincro + 1
A-MAGZ-FL-CANC	" "	Si

In questa fase tenere memoria di data+ora dell'ultimo record di input considerato. B.2.2 Esportazione magazzini principali (COGMAGPE tipo "E") Filtri Si considerano solo i record con MGP-TIP = "E" Per ciascun record valido si cercano tutti i record collegati (in questo caso non ce ne sono) B.2.2.1 Verifica ed esportazione record Dopodichè si effettua la ricerca dell'informazione su APCOGMAGAZ

Dato	Contenuto
A-MAGZ-AZI	Codice azienda
A-MAGZ-TIPO	MGP-TIP
A-MAGZ-COD	MGP-COD

Se non esiste, inserirlo. Se esiste, aggiornarlo l'aggiornamento del record deve avvenire solo se almeno un dato tra quelli da modificare è diverso. NB: se è stata richiesta l'esportazione completa (AGPRG-ESPORTA-TUTTO = "S") allora il record dovrà essere esportato a prescindere dal confronto Suggerimento Invece di popolare direttamente i dati del record di destinazione, portarli su delle copie in w/s. Al termine confrontare i dati sulla destinazione con la copia in w/s. B.2.2.2 - Aggiornamento da COGMAGPE

Dato	Contenuto	Confronto?
A-MAGZ-AZI	Codice azienda
A-MAGZ-TIPO	MGP-TIP
A-MAGZ-COD	MGP-COD

A-MAGZ-NOME	MGP-NOME	Si
A-MAGZ-FL-TIP	MGP-FL-UBICAZIONE	Si
A-MAGZ-LATITUDINE	0	Si
A-MAGZ-LONGITUDINE	0	Si
A-MAGZ-FL-SEDE	"N"	Si
A-MAGZ-SEDE	" "	Si

A-MAGZ-AGG-APP	" "
A-MAGZ-ID-SINCRO	Id-sincro + 1
A-MAGZ-FL-CANC	Se MGP-FL-CLOSE:	Si

In questa fase tenere memoria di data+ora dell'ultimo record di input considerato. B.3 Verifica record cancellati Questa sezione vale solo per COGMAGAZ Sulla tabella di origine COGMAGAZ esiste il flag di cancellazione logica ma non è gestito. Quindi per esportare l'informazione relativa ai record cancellati si opererà come segue: 1. Scorrere tutti i record di APCOGMAGAZ per l'azienda 2. Ricerca, per ciascuno, del corrispondente record su COGMAGAZ A questo punto la situazione potrebbe essere la seguente:

COGMAGAZ trovato?	A-MAGZ-FL-CANC	Cosa fare
Si	"C"	Aggiornare APCOGMAGAZ impostando
Si	" "	Nessuna operazione
No	"C"	Nessuna operazione
No	" "	Aggiornare APCOGMAGAZ impostando

B.9 - Aggiornamento id syncro Al termine dell'elaborazione, aggiornare il record APSTATOSYN:

Dato	Contenuto
A-SYN-AZIENDA	Codice azienda
A-SYN-TABELLA	"COGMAGAZ"
A-SYN-DA-GES-DATA	Data/ora dell'ultimo record aggiornato (non necessario in questo programma)
A-SYN-DA-GES-ORA
A-SYN-DA-ID-SINCRO	Ultimo id sincro + 1
A-SYN-VERSIONE	2

Storico modifiche¶

Data	Descrizione
2026-04-07 (TASK-4553)	Campo A-MAGZ-FL-SEDE ora esportato da `magg-fl-sede-operativa` (tabella COGMAGAG) anziche' da `magz-fl-sede` (COGMAGAZ). Il vecchio campo era stato disattivato da TASK-1157; il nuovo campo "sede operativa" permette di distinguere i magazzini sede in modo indipendente dalla struttura magazzini.

Estratto da documentazione interna ClickUp