ImportExport

2026-03-26T09:21:02Z

5.90.66.122:

Indicazioni per la gestione di un'importazione/esportazione.
Va creato un modello di import/export, dove verranno indicate le videate su cui andrà simulato l'inserimento dei dati.
In fase di importazione Sage si comporteà come se un utente scrivesse i dati a video, con tutti i controlli e comportamenti del caso. Bisogna quindi valutare attentamente la gestione delle varie situazioni di errore. E' possibile modificare il comportamento delle videate in fase di importazione utilizzando la variabile globale GIMPORT.
Per effettuare l'importazione o l' esportazione andare al menu '''''Utilizzo → Import/Export'''''.

== Caso semplice ==

Nel caso di importazione:

=== Oggetto ===

Da '''''Sviluppo → Dizionario programmi → Oggetti''''' ('''GESAOB'''):

selezionare l'[[Oggetto_in_Sage|oggetto]] di cui si vuole gestire l'importazione.
# Nel riquadro '''''Opzioni''''' della scheda '''''Generale''''' dell'oggetto spuntare la casella '''''Import''''', poi rivalidare
# Nella scheda '''''Ambiente''''', riquadro '''''Import''''', inserire le tabelle coinvolte in fase di importazione/esportazione con la relativa videata; la colonna '''''Riquadro''''' rimane vuota. Va inserita una riga per ogni coppia (tabella, videata) NB: in fase di importazione Sage simula l'inserimento dei dati nelle videate elencate, e scatena tutti i controlli e programmi come se l'inserimento fosse fatto in modo interattivo dall'utente; se non si riesce a inserire un dato nella videata anche la corrispondente importazione fallirà.

=== Modello ===

Da '''''Parametrizzazione → Utilizzo → Import/Export → Modelli Import/Export''''' ('''GESAOE'''):

In testata:

# creare un nuovo modello
# spuntare la casella '''''Attivo'''''

Nella scheda '''''Testata''''':

# impostare [[Codice_Attività|codice attività]]
# impostare l'oggetto da trattare nell'importazione/esportazione
# per un file CSV, nel riquadro '''''Struttura''''':
#* come tipo file mettere "Separatore record"
#* come separatore di campo mettere ";" o altro carattere necessario
#* come separatore record mettere <code>\013\010</code> (013=carriage return; 010=line feed o new line, corrispondenti a <code>\r\n</code> in c#)
# se il modello serve per esportare spuntare la casella ''Export'' nell'omonimo riquadro. Fare un'export è utile per vedere come deve essere il file da importare.
# Nel riquadro '''''Import'''''
#* spuntare la casella ''Import'' se il modello serve per importare;
#* spuntare la casella ''Aggiorn.Autorizzato'' se in fase di importazione si vuole permettere che i record siano aggiornati/sovrascritti.
# nel riquadro '''''Identificatori''''':
#* inserire il livello ( mettere "1" se i record da inserire corrispondono 1 a 1 con l'oggetto di riferimento del modello)
#* lasciare vuoto il campo '''''Flag'''''
#* inserire la tabella in cui i record andranno inseriti
#* inserire nella colonna chiave l'indice attraverso cui individuare i record (uno degli indici della tabella appena inserita)

Nella scheda '''''Campi''''':

# Inserire l'elenco dei campi gestiti nell'importazione/esportazione
# lasciare il campo '''''Flag''''' vuoto
# nel caso in fase di esportazione si voglia permettere di filtrare un intervallo in base ad un campo, impostare nella corrispondente colonna '''''Intervallo''''' il valore ''Inserito'' (vedi menu '''''Utilizzo → I/E → Export''''' )
# nel Riquadro '''''Generazione del file''''' indicare la locazione predefinita del file da iportare/esportare; per gestire un file su server:
#* impostare "Server"
#* specificare il percorso (per es. c:\SAGE\SAGEX3V6\InOutData\in\provaYCE.txt)
#* specificare il percorso dove verrà messo il file in caso di importazione riuscita

Pulsanti:
# utilizzare il pulsante '''''Export''''' per definire i valori di default dei filtri (saranno disponibili solo i campi in cui si è impostato il valore "Inserito" nella colonna '''''Intervallo'''''

== Caso testata/dettaglio ==

Procedere come nel caso semplice a differenza di:

=== Oggetto ===

Nella scheda ''Ambiente'', riquadro ''Import'' inserire una seconda riga con la tabella di dettaglio, in cui il valore nella colonna ''Riquadro'' sarà '''NBLIG'''

=== Modello ===

# nel riquadro ''Identificatori'' : andranno inserite due righe, una per ciascuna tabella:
#* inserire una prima riga per la testata: livello 1, un identificativo nel campo Flag (per es. "A"), nome tabella e indice come per il caso semplice
#* inserire una seconda riga per il dettaglio: livello 2, un identificativo nel campo Flag (per es. "B"), nome tabella dei dettagli e indice della tabella dettaglio
#* aggiungere alla riga del dettaglio il campo ''Legame'', in cui inserire la parte della chiave che lega la tabella di testata a quella di dettaglio; per esempio se l'indice del dettaglio è YID0=CAMPO1TESTATA;CAMPO2TESTATA;CAMPO3IDRIGADETTAGLIO, inserire "CAMPO1TESTATA;CAMPO2TESTATA"

Nella scheda ''Campi'':

# Inserire una prima riga con:
#* campo ''Flag'' pari al corrispondente valore Flag della tabella di '''testata'''
#* campo ''Tabella'' con valore la tabella di '''testata'''
#* campo ''Campo'' il valore "/" (senza apici)
# Per ciascun campo della tabella di '''testata''':
#* Inserire nel campo Flag il corrispondente valore Flag messo nel riquadro "Identificatori" della scheda "Testata" per la tabella di testata; NB: i valori chiave di testata, che sono presenti anche nella tabella di dettaglio, vanno riferiti alla tabella di testata e non alla tabella di dettaglio
#* tutti gli altri campi come nel caso semplice
# Inserire una riga con:
#* campo ''Flag'' pari al corrispondente valore Flag della tabella di '''dettaglio'''
#* campo ''Tabella'' con valore la tabella di '''dettaglio'''
#* campo ''Campo'' il valore "/" (senza apici)
# Per ciascun campo della tabella di '''dettaglio''':
#* Inserire nel campo Flag il corrispondente valore Flag messo nel riquadro "Identificatori" della scheda "Testata" per la tabella di dettaglio; NB: i valori chiave di testata, che sono presenti anche nella tabella di dettaglio, vanno riferiti alla tabella di testata e non alla tabella di dettaglio
#* tutti gli altri campi come nel caso semplice

== Programmazione ==
=== Modifica dell'import/export da codice ===
In caso di specifiche necessità è possibile specificare nel modello un programma in cui inserire gli interventi necessari in fase di importazione o esportazione.

Nominare il file con suffisso YIMP, per esempio YIMPYCE. Qui riportiamo l'elenco degli eventi utilizzabili, con un esempio di cancellazione di alcune tabelle appena prima dell'importazione.

Un esempio di programma di importazione già presente a livello X3 è IMPSOH.

<pre>
######################################################################
$ACTION
# Infbox ACTION
Case ACTION
When "IMP_COMPILE" : maxmem=max(maxmem/1024,5120)
When "IMP_TRTSUP" : Gosub YPROVA
When "IMP_OUVRE" : Gosub IMP_OUVRE # all'inizio dell'importazione
When "AP_IMPORT" : Gosub YPROVA
When "IMPORT" : Gosub YPROVA
When "IMP_ZONE" : Gosub IMP_ZONE # quando entra in un campo lista
When "IMP_TAB" : Gosub IMP_TAB # quando entra in un campo riquadro (tabella)
When "IMP_AVANT_MODFIC" : Gosub YPROVA
When "IMP_INICRE" : Gosub YPROVA
When "IMP_INIMOD" : Gosub YPROVA
When "INICRE_LIG" : Gosub YPROVA
When "INIMOD_LIG" : Gosub YPROVA
When "VALLIG" : Gosub YPROVA
When "IMP_FERME" : Gosub YPROVA
When "EXP_OUVRE" : Gosub YPROVA
When "EXPORT" : Gosub YPROVA
When "EXP_ZONE" : Gosub YPROVA

Endcase
Return

$IMP_OUVRE
#cancello la tabella YCC
If !clalev([F:YCC]) : Local File YCERTPRODT [YCC] : Endif
If !clalev([F:YCD]) : Local File YCERTPRODD [YCD] : Endif
Delete [F:YCD] Where 1 = 1
Delete [F:YCC] Where 1 = 1
Return
</pre>

E' possibile modificare il comportamento della simulazione dell'inserimento dei dati nelle videate utilizzando la [[Variabili_globali|variabile globale]] '''GIMPORT'''.

Inoltre, se nei campi del modello invece di un nome (nella colonna ''Campo'' della scheda '''Campi''') inseriamo <code>*1</code>, <code>*2</code> ... <code>*99</code>, nel programma potremo fare riferimento a tali campi con le [[Variabili_globali|variabili globali]] <code>GIMP(1)</code>, <code>GIMP(2)</code>...<code>GIMP(99)</code>.

Per le famiglie statistiche in ITM nella colonna ''Campo'' si scriverà TSICOD(0),TSICOD(1) ecc.

=== Esecuzione import tramite modello ===
Per eseguire un'importazione si usa la chiamata <code>Call IMPORTSIL(MODELLO,FILEDAIMPORTARE) FROM GIMPOBJ</code>.

Per un esempio concreto vedi il sorgente <code>YIMPDAS</code>.

<pre>
If (func XIMPORT(NOMEMODELLO,PATHFILE)) <= 0 OR XERR > 0
Call ECR_TRACE("ERRORI NELL'IMPORTAZIONE",0) From GESECRAN
Endif

Funprog XIMPORT(MODELLO,FILEIMP)
VALUE CHAR MODELLO, FILEIMP

Call IMPORTSIL(MODELLO,FILEDAIMPORTARE) FROM GIMPOBJ

#TESTO SE E' PRESENTE IL FILE DI ERRORE FILEDAIMPORTARE.ERR
If FILINFO(FILEDAIMPORTARE+".ERR", 1) <0 #SE L' IMPORT E' ANDATO A BUON FINE
End 1
Else
End 0
Endif

End
</pre>
=== Esecuzione export tramite modello ===
Per eseguire un'esportazione si può usare la chiamata <code>Call EXPORTSIL From GEXPOBJ</code>, preparando adeguatamente tutte le variabili e le maschere di cui necessita.

Per un esempio concreto vedi il sorgente <code>SPEPOH</code>, all'azione scatenata dal bottone <code>y</code>.

<pre>
If BOUT = "y" Then
Call OUVRE_TRACE("Estrazione file Ordine Diretto ODV") From LECFIC
Call ECR_TRACE ("Scritta di log1",0) From GESECRAN
Call ECR_TRACE ("Scritta di log2",0) From GESECRAN
Gosub OUVRE From GEXPOBJ
Local Mask EXPOBJ [DIA]
Local Integer STAT
# Imposto il modello di export e carico i valori dei parametri export definiti nel modello
[M:DIA]MODELE="YSOH"
Call CHARGE_MODELE ([M:DIA]MODELE,STAT) From GEXPOBJ
[M:DIA]=[M:EXP1]
[M:DIA]NOMEXP = "\\SAGEDEV.IT\XXX\odv\PPP123456.txt"
[M:DIA]BDEB(0) = [M:POH3]OCNNUM ## 1^ parametro di estrazione
[M:DIA]BFIN(0) = [M:POH3]OCNNUM
[M:DIA]CODDEB(0) = [M:POH3]OCNNUM
[M:DIA]CODFIN(0) = [M:POH3]OCNNUM
Call ECR_TRACE("Generazione File",0) From GESECRAN
[M:EXP2]=[M:DIA]
Call EXPORTSIL From GEXPOBJ
Call ECR_TRACE("Fine estrazione dati ",0) From GESECRAN
If !GSERVEUR
Call FERME_TRACE From LECFIC
Call LEC_TRACE From LECFIC
Endif
Endif
</pre>

=== Entry points ===
==== Import: Entry point FILTER_WR ====

Permette di evitare di scrivere un record: vedi help Entry Points > Modulo Supervisore > Script standard TRTIMPV3

==== Import: Entry point DELTRT_EXE/DELTRT_END ====

Ad ogni import viene generato un file sorgente WWIMP*.

Questi entry point permettono di evitare che venga cancellato: basta impostare GPE=1.

Uno alla fine di ogni file importato, l'altro alla fine di tutto l'import.

(vedi help Entry Points > Modulo Supervisore > Script standard TRTIMPOBJ )

==== Export: Entry point DELFIC ====

Questo Entry point (vedi help Entrypoint, Modulo supervisore, Script TRTEXPOBJ ) viene chiamato appena finito l'export; utile per esempio per cancellare il file se vuoto.

* FICDON nome del file generato
* NBEXP numero record esportati

==== Export: Entry point TRTX3IMP.IMPZONINV ====

Questo è un po' particolare, vedi help: Entry Points > Modulo Modulo base > Script standard TRTX3IMP

Dall'help: permette di importare dei campi specifici nascosti o visualizzati alimentando la classe [M].

== Batch di Import/Export ==

Vengono qui riportate a titolo di esempio le azioni svolte per gestire l'importazione schedulata delle certificazioni da As400 a Sage.

#Copiare eseguibile in cartella: \\serverX3\c$\SAGE\SAGEX3V6\scriputility\SyncX3As400_Cert
#Creare Concatenamento di import: Dal menu '''''Parametrizzazione → Utilizzo → Import/Export → Concatenamenti''''' (funzione '''GESAEN'''): Nuovo YCE ("Import Certificazioni") In ordine cronologico modello e nome file da importare
#Creo file batch (\\serverX3\c$\SAGE\SAGEX3V6\scriputility\SyncX3As400_Cert.cmd) che crea file da importare; (del file inserire anche <code>cd C:\SAGE\SAGEX3V6\scriputility\SyncX3As400_Certificazioni</code>
#Creo gruppo di jobs (GESABG): utilizzo SYNCANAG già esistente; ha due job: SYSTEME Comando sistema IMPENCH Concatenamento imports
#Gestione schedulazioni ('''GESABA'''): Mettere Attivo Nuovo UPDYCE Dossier SAAGEDEV gruppo SyNCANAG Impostare orari e giorni (NB: il server di batch è uno solo per tutti i dossier e può gestire al massimo 7 task alla volta, altrimenti non ha licenze sufficienti). Pulsante in basso a destra PARAMETRI, SYSTEME, inserisco: c:\SAGE\SAGEX3V6\scriputility\SyncX3As400_Certificazioni.cmd Pulsante in basso a destra PARAMETRI, IMPENCH, selezione: YCE

c:\SAGE\SAGEX3V6\InOutData\in\YCE.txt

== Export e crono ==
Se si schedula ('''GESABA''') il job EXPENCH (concatenamento report), nei parametri è possibile spuntare la voce "crono": tale impostazione permette di esportare solo le voci create o modificate dopo l'ultima esportazione; ma nelle tabelle deve esserci il campo EXPNUM.

SageDev KB - User contributions [en]

ImportExport