%%(display:none)
{{{
WikiUp
}}}
/%
[{TableOfContents }]\\
::HEA RESP(FF) STAT(80) USAG(FF) DTAG(20160615) ORAG(105800)\\
!!! OBIETTIVI\\
__Lettura e importazione dati su AS400, leggendoli da:__\\
* File in formato CSV\\
* File di Excell\\
* Database Oracle\\
* Database mediante utilizzo di driver\\
** ODBC\\
** JDBC\\
__Aggiornamento di DB non SmeUp__\\
E' possibile inoltre aggiornare DB non SmeUp, leggendoli da SmeUp ERP.\\
\\
NOTA:\\
l'accesso a database di tipo ACCESS è possibile solo impostandolo come fonte dati ODBC.\\
\\
!!! DBM vs JA_00_19\\
Il componente DBM fornisce un'accesso guidato alla procedura di importazione, facilitando l'approccio di utenti poco esperti, mentre il servizio JA_00_19 si propone come interfaccia a tutte le funzioni di accesso ai dati, di importazione e di aggiornamento di DB non SmeUp. L'uso del servizio JA_00_19 è quindi per sviluppatori/utenti esperti.\\
\\
La documentazione generale del componente DBM si trova in\\
[Aspetti generali|MBDOC-LOCDBM_01]\\
\\
\\
!!! Procedure di importazione\\
Per il dettaglio delle procedure di importazione si rimanda alla documentazione del componente DBM:\\
[Accesso ai dati - Importazione|MBDOC-LOCDBM_02]\\
\\
\\
!!! FUNZIONI/METODI\\
La sintassi per richiamare la funzione/metodo che interessa è la seguente __funzione.metodo__\\
\\
!! Azioni di importazione da una sorgente dati esterna\\
# IMP Importazione di dati da una sorgente esterna su AS400\\
## CSV: Importazione leggendo da file in formato CSV\\
## XLS: Importazione leggendo da un file Excell\\
## ACC: Importazione leggendo da un database Access\\
## JDB: Importazione leggendo mediante driver JDBC\\
## ODB: Importazione leggendo da fonte dati ODBC\\
## ORA: Importazione leggendo da un database ORACLE\\
## ANT: Metodo in disuso. Forniva l'anteprima file CSV. Sostituito dal metodo MAT\\
\\
QUESTI METODI SONO SOSTITUITI DAI METODI IMP.xxx CHE importano i dati dal DB esterno sull'AS400.\\
# EXP (OLD) sono sostituiti dagli IMP. Il termine esportazione era visto dal database origine dei dati che li esportava verso l'AS400.\\
## CSV: importazione leggendo da file in formato CSV - OLD\\
## XLS: importazione leggendo da un file Excell - OLD\\
## JDB: importazione leggendo mediante driver JDBC - OLD\\
## ODB: importazione leggendo da fonte dati ODBC - OLD\\
## ORA: importazione leggendo da un database ORACLE - OLD\\
## ANT: Metodo in disuso. Forniva l'anteprima file CSV. Sostituito dal metodo MAT.xxx\\
\\
# EXP.JDB - comprende varie modalità di trasferire i dati.\\
## drop/create/insert\\
## creat/insert\\
## update\\
\\
# JDBCCON: url connessione jdbc (Obb)\\
## per MYSQL: jdbc:mysql:{nome server/ip}/{catalogo/nome database}\\
## per POSTGRE: jdbc:postgresql:{nome server/ip}/{catalogo/nome database}\\
## per MSSQL: jdbc:jtds:sqlserver:{nome server/ip}/{catalogo/nome database}\\
## per CSV: jdbc:relique:csv:{nome file}\\
## per DB2400: jdbc:as400:{nome server/ip}/{catalogo/nome database};date format=iso;database name={2}; VEDI NOTA 2\\
## per HSQL: jdbc:hsqldb:hsql://{nome server/ip}/{catalogo/nome database}\\
## ODBC jdbc:odbc://{nome server/ip} - SUPPORTATO FINO ALLA JDK 1.7\\
# JDBCDRV: driver jdbc (Obb)\\
## per MYSQL: com.mysql.jdbc.Driver,\\
## per POSTGRE:  org.postgresql.Driver\\
## per MSSQL: net.sourceforge.jtds.jdbc.Driver\\
## per CSV: org.relique.jdbc.csv.CsvDriver\\
## per DB2400: com.ibm.as400.access.AS400JDBCDriver, create alias {0}{1}{2} for {3} {4})),\\
## per HSQL: org.hsqldb.jdbcDriver\\
## per ODBC: sun.jdbc.odbc.JdbcOdbcDriver, create alias {0}{1}{2} for {3} {4})); - SUPPORTATO FINO ALLA JDK 1.7\\
\\
# DBMUSER: utente di connessione al DB\\
# DBMPWD: password\\
# JDBCDBTYPE: (opzionale)  tipo di database. valori possibili\\
## MYSQL\\
## POSTGRE\\
## MSSQL\\
## DB2400\\
## HSQL\\
## ODBC\\
# DBMDEST: nome tabella destinazione\\
# DESTKEYS: chiavi da usare per l'update, separate da ",".\\
# EXCLKEYS: campi chiave su cui non deve essere fatto l'update\\
# DBMSRV: server destinazione\\
# DBMCAT: catalogo server destinazione\\
# DBMUPD: tipo di update. valori possibili:\\
## se non definito vale il parametro DBMWMODE.\\
## se vale 1 eseguo create e update\\
## se vale 0 eseguo drop, create e insert\\
# DBMWMODE: modalità scrittura. Valori possibili:\\
## non definito / DCU= Drop, Create, insert\\
## CU = Create / Update: se la tabella esiste, viene eseguito solo l'update\\
## I = Insert : viene eseguito l'insert. se ci sono record con chiave duplicati va in errore\\
## CI = Create e Insert: crea la tabella se manca e poi la insert\\
# DBMLENGTHMAXCOL: metodo di calcolo della larghezza della colonna. valori possibili:\\
## D: viene calcolato la larghezza max di ogni colonna sui dati\\
## DH: max tra descrizione dell'header e dati\\
## DHG: max tra descrizione dell'header, dati e griglia\\
## G: viene utilizzata solo la definizione presente nella Griglia\\
# DBMNONULL: Gestione valori nulli. Valori possibili:\\
## non definito: inserisco i null in campi numerici e date\\
## ALL: non inserire valori nulli pèer date e numeri\\
## DATE: non inserire nulli per le date\\
## NUMERIC: non inserire numeri nulli\\
# DBMFILE: path file S01 da cui leggere i dati, alternativo al K1. Vedi Nota 1\\
# RESMSG: Messaggio di corretta esecuzione. Se vale *NONE non viene mostrato nessun messaggio. Se non definito viene mostrato il messaggio "Importazione DB eseguita con successo"\\
# DBMSETUSE: forza utilizzo nodo setup per lettura parametri in alternativa a quelli della fun\\
## Yes: usa nodo setup.\\
## No: usa parametri fun\\
# IASP:nome IASP da utilizzare (SOLO PER DB2)\\
\\
\\
NOTA 1:\\
Il campo INPUT viene utilizzato se manca il K1 e DBMFILE è vuoto.\\
Può contenere\\
# L'xml della matrice da scrivere\\
# una fun che verrà richiamata dal JA_00_19 per avere la matrice da scrivere su AS400\\
# il parametro DBMXMLFUN per indicare la fun da richiamare\\
\\
\\
NOTA 2:\\
Esiste la proprietà database name che consente di specificare il nome del database. Vedi:\\
http://pic.dhe.ibm.com/infocenter/hodhelp/v11r0/index.jsp?topic=%2Fcom.ibm.hod.doc%2Fhelp%2Fdb_url.html\\
in release post V5R2 posso avere più database sullo stesso iSeries\\
\\
\\
\\
\\
!! Azioni di anteprima leggendo una sorgente dati esterna\\
# MAT: crea una matrice leggendo i dati dalla fonte indicata\\
## CSV: Creazione di una matrice leggendo da file in formato CSV\\
## XLS: Creazione di una matrice leggendo da un file Excell\\
## JDB: Creazione di una matrice leggendo mediante driver JDBC\\
## ODB: Creazione di una matrice leggendo da fonte dati ODBC\\
## ORA: Creazione di una matrice leggendo da un database ORACLE\\
\\
!! Azioni lettura metatadi leggendo una sorgente dati esterna\\
# INF: crea una matrice con le meta informazioni\\
## XLS: Meta informazioni di un file Excell\\
## JDB: Meta informazioni di una fonte dati JDBC\\
## ODB: Meta informazioni di una fonte dati ODBC\\
## ORA: Meta informazioni di un database ORACLE\\
\\
!! Azioni di aggiornamento della fonte dati esterna\\
# UPD: esecuzione update su DB esterno\\
## JDB: Esegui funzione di update su DB esterno JDBC\\
\\
# EXP\\
## CSV: Esportazione di una matrice in un file formato CSV -\\
## XLS: Esportazione di una matrice in un file Excell -\\
## JDB: Esportazione di una matrice in un DB collegato tramite JDBC -\\
## ODB: Esportazione di una matrice in una fonte dati ODBC -\\
## ORA: Esportazione di una matrice in un database ORACLE -\\
\\
\\
Per i dettagli vedi la sezione dei parametri.\\
\\
\\
!! Significato dei parametri\\
Metodo|Parametro|Valore|Significato\\
IMP.CSV|SEPA|PunVir|Punto e virgola\\
IMP.CSV|SEPA|Vir|Virgola\\
IMP.CSV|SEPA|Tab|Tabulazione\\
IMP.CSV|SEPA|Spc|Spazio\\
MAT.CSV|SEPA|PunVir|Punto e virgola\\
MAT.CSV|SEPA|Vir|Virgola\\
MAT.CSV|SEPA|Tab|Tabulazione\\
MAT.CSV|SEPA|Spc|Spazio\\
\\
\\
\\
!! Significato dei parametri EXP.JDB\\
EXP.JDB|DBTYPE|DB2400|DB2 400\\
EXP.JDB|DBTYPE|MYSQL|My Sql\\
EXP.JDB|DBTYPE|HSQL|Hypersonic Sql\\
EXP.JDB|DBTYPE|MSSQL|Microsoft Sql Server\\
EXP.JDB|DBTYPE|POSTGRE|Postgre Sql\\
\\
\\
!! Significato dei parametri EXP OLD\\
EXP_O.CSV|SEPA|PunVir|Punto e virgola\\
EXP_O.CSV|SEPA|Vir|Virgola\\
EXP_O.CSV|SEPA|Tab|Tabulazione\\
EXP_O.CSV|SEPA|Spc|Spazio\\
EXP_O.ANT|SEPA|PunVir|Punto e virgola\\
EXP_O.ANT|SEPA|Vir|Virgola\\
EXP_O.ANT|SEPA|Tab|Tabulazione\\
EXP_O.ANT|SEPA|Spc|Spazio\\
\\
\\
\\
\\
\\
\\
\\
\\
\\
\\
\\
\\
\\
\\
\\
\\
\\
\\
\\
\\
\\
\\
\\
\\
\\
\\
\\
\\
\\
PRO.SER Cod="EXP_O.CSV.18" Tit="Azioni per Importazione (OLD). Import. leggendo da file  CSV (OLD)" Fun="F(EXB;JA_00_19;EXP_O.CSV)" Ref="IMP.CSV.1"\\
\\
PRO.SER Cod="EXP_O.XLS.19" Tit="Azioni per Importazione (OLD). Import. leggendo da file Excell (OLD)" Fun="F(EXB;JA_00_19;EXP_O.XLS)" Ref="IMP.XLS.2"\\
\\
PRO.SER Cod="EXP_O.ACC.20" Tit="Azioni per Importazione (OLD). Import. leggendo da file Access (OLD)" Fun="F(EXB;JA_00_19;EXP_O.ACC)" Ref="IMP.XLS.2"\\
\\
PRO.SER Cod="EXP_O.JDB.21" Tit="Azioni per Importazione (OLD). Import. leggendo mediante driver JDBC (O" Fun="F(EXB;JA_00_19;EXP_O.JDB)" Ref="IMP.JDB.4"\\
\\
PRO.SER Cod="EXP_O.ODB.22" Tit="Azioni per Importazione (OLD). Import. leggendo da fonte dati ODBC  (OL" Fun="F(EXB;JA_00_19;EXP_O.ODB)" Ref="IMP.ODB.5"\\
\\
PRO.SER Cod="EXP_O.ORA.23" Tit="Azioni per Importazione (OLD). Import. leggendo da un database ORACLE (" Fun="F(EXB;JA_00_19;EXP_O.ORA)" Ref="IMP.ORA.6"\\
\\
PRO.SER Cod="EXP_O.ANT.24" Tit="Azioni per Importazione (OLD). Creazione matrice di anteprima (OLD)" Fun="F(EXB;JA_00_19;EXP_O.ANT)" Ref="IMP.CSV.1"\\
\\
\\
\\
\\
\\
\\
\\
\\
\\
\\
\\
\\
\\