Diverse modalità di Accesso ai dati e di Importazione
(creato in data 03-09-2006)
(aggiornato in data 07-09-2007)
(aggiornato in data 16-12-2008)

Note generali sull'importazione

Se la tabella sorgente contiene caratteri particolari questi verranno sostituiti dal segno "_".
Sono ammessi solo i numeri, le lettere, il segno "_" e il segno "£" .

Se il nome della tabella sorgente è più lungo di 8 caratteri questo verrà troncato. Nella descrizione del file creato su AS400 verrà riportata il nome della tabella sorgente per esteso, privato dei caratteri con codice ascii minore di 32 o maggiore di 122.

http://www.asciitable.it

Accedere o importare da CSV

Cos'è il formato CSV?

E' un formato di file testuale (visualizzabile anche tramite un semplice editor di testo) utilizzato solitamente per lo scambio di dati fra fogli di calcolo(per esempio Excel) o database. I singoli campi di dati sono separati da una carattere definito a priori (a volte la virgola, a volte il punto e virgola, a volte il simbolo di pipe...).

Come oggettizzare le colonne

NOTA: Questo paragrafo è valido anche per l'accesso a file Excel
Per facilitare la consultazione dei dati è possibile oggettizzarli, cioè definire a quale oggetto SmeUp corrispondono.
Questa operazione consiste nel definire, nella prima riga del file le caratteristiche della colonna.
La sintassi da utilizzare è la seguente:
Descrizione_colonna(codice_colonna|oggetto|lunghezza)
esempi:

• Cod.Ogg. master(XXCDMA|XXTPMA|15) definisce una colonna con codice XXCDMA, con descrizione Cod.Ogg. master di tipo XXTPMA e lunga 15
  
• Tempo esecuzione(F2TEAS|NR|11;0) definisce una colonna con codice _F2TEAS_, con descrizione _h_Tempo esecuzion_n_ di tipo _h_NR_n_ con 11 cifre di cui 0 decimali
  

NOTA: Questa sintassi che segue è obsoleta anche se il componente la sà riconoscere

Nome_colonna | Oggetto_SmeUp | Numero_caratteri | DescrizioneColonna.

• CodCli|CNCLI|15|Clienti definisce una colonna con codice CodCli, di oggetti CN CLI, lungai 15 caratteri
  
• XXPREZ|NR|21-6|Prezzo Unitariodefinisce una colonnacon codice XXPREZ, numerica, composta da 21 cifre di cui 6 decimali
  

• Sono ammesse tutte le combinazioni, con l'accortezza che se una caratteristica non viene specificata bisogna mantenere il separatore:
  
  • Se ad esempio si desidera definire il codice e la lunghezza la sintassi da usare è la seguente: Testo||30000
    
  • Se ad esempio si desidera definire il codice e la descrizione la sintassi da usare è la seguente: Testo|||Testo libero
    
  • Se indico solo il codice posso utilizzare la segunte sintassi: Codice
    

Come accedere ad un file CSV

1. Aprire il file CSV tramite un editor di testo per individuare il carattere di separazione tra le colonne ( in futuro sarà forse possibile visualizzare un anteprima in Looc.Up) e se il file contiene una prima riga con i nomi delle intestazioni dei campi.
   
2. Selezionare il file CSV
   
3. Indicare il carattere separatore csv (di default viene preso il punto e virgola)
   
4. se presente la riga con le intestazioni segnare il campo Nomi colonne in prima riga.
   
   1. se si desidera oggettizzare le colonne modificare la prima riga se contiene i nomi delle colonne o ggiungerla rispettando la sintassi espressa al capitolo Come oggettizzare le colonne
      
5. Modificare la ampiezza campi destinazione (E' consigliato portarla ad un valore che tenga conto della dimensione delle colonne per evitare che i campi vengano troncati). Questo valore viene usato nel caso in cui non sia stata definita la larghezza della colonna nell'intestazione.
   
6. Utilizzare la funzione F(EXB;JA_00_19;MAT.CSV) 1(J1;PATHFILE;path_file_csv_da_importare) P(da definire in funzione delle caratteristiche del file).
   

La funzione creata va posta in una sezione o subsezione di tipo EXB.

NOTA: per la creazione della funzione da utilizzare esiste un apposito wizard.

Esempio di accesso ad un file CSV

Per testare l'accesso ai dati di un file in formato CSV, copiare le ter righe seguenti in un file di testo e salvarlo con estensione CSV.

---

Dopo aver creato il file secondo la sintassi espressa sopra utilizzare la seguente funzione, inserendola in una apposita scheda:

F(EXB;JA_00_19;MAT.CSV) P(FILE(C:\TEMP\NOME_DEL_FILE.CSV) SEPA(PunVir) HEAD(1) NMAXROW(-1) )

TERMINARE
Aprire la scheda del servizio JA_00_19 e selezionare la sottoscheda esempi
Vedi LOOC.up - Servizio di importazione (V3ASE-JA_00_19)

Come importare un file CSV?

L'importazione condivide con l'accesso ai dati i primi 5 punti.
Compiute tali operazioni si procede con le seguenti:

1. Creare (se necessario) una libreria su AS in cui verranno salvati i file creati durante l'importazione
   
2. Indicare nel tab Destinazione_AS400 il nome della libreria di destinazione dei file
   
3. Avviare la procedura di Import tramite il tasto OK
   

NOTA: Utilizzando il servizio JA_00_19 la procedura di importazione avviene in modo batch. Va in questo caso configurata appositamente la chiamata al servizio.

Accedere o importare da un file file Excel

L'accesso ad un file in formato Excel può avvenire sia direttamente, sia mediante il salvataggio in uno o più file in formato CSV.

Come oggettizzare le colonne

In maniera analoga al formato CSV si possono oggettizzare le colonne del floglio Excel da importare.
Riferirsi al paragrafo Comme oggettizzare le colonne del capitolo Accedere o importare da CSV.

Accesso diretto al file.

Mediante i metodi MAT.XLS o EXP.XLS si accede direttamente al file.
Per creare una matrice è necessario fornire il nome del file ed il foglio da cui attingere i dati.
L'esportazione invece necessita di definire il file e la destinazione su AS400. La mancanza del foglio porta all'esportazione su AS400 di tutti i fogli.

Salvataggio del file in formato CSV

Prima di importare i dati da un file excel è necessario salvare i dati in CSV. Per far ciò si apra il foglio EXCEL e tra le opzioni possibili nella voce di menù SALVA CON NOME c'è il salvataggio come CSV. Non preoccuparsi di eventuali messaggi di warning e salvare il file in una cartella che poi sia facile da ricordare per indicarla nel campo Singolo File o Tutti i file nella directory del componente DBM.

Come importare un file CSV partendo da un file Excel con più fogli di lavoro

La procedura da utilizzare per importare un file excel con più fogli di lavoro inclusi è uguale alla precedente con la particolarità che per ogni foglio
presente è necessario salvarlo con un nome CSV differente spostandosi man mano sul foglio da esportare. Se tutti i fogli vengono salvati nella stessa cartella è possibile poi importarli facilmente con un singolo comando indicando non più il singolo file CSV da importare ma tutta la cartella specificandola nel campo Tutti i file nella directory del componente.

Problematiche note

Esistono varie problematiche legate a BUG dei driver ODBC-JDBC:

1. le colonne che contengono valori di tipo diverso, ad esempio numerici e alfanumerici, non restituiscono correttamente uno o più tipi. Se ad esempio nella colonna sono presenti in maggioranza valori alfanumerici non vengono restituiti i valori numerici. La soluzione è di esportare il foglio in formato CSV e poi di importarlo. NOTA: forzare le colonne di tipo solo testo non ha alcun effetto.
   
2. non è possibile accedere a documenti protetti da password se non sono aperti in Excel.
   
3. durante il processo di esportazione non è possibile apportare modifiche al foglio excel
   
4. la prima riga è sempre considerata di intestazione
   
5. le celle contenenti formule non vengono valutate correttamente: salvare il foglio in formato CSV e importarlo.
   
6. le celle contenenti valori numerici senza virgola possono venire restituiti come numeri terminanti con ".0". Salvare il foglio in CSV e poi importarlo.
   
7. Non è possibile accedere a fogli con nomi contenenti i seguenti caratteri:
   
   1. " - apice doppio
      
   2. ! - punto eclamativo
      
   3. - parentesi quadra aperta\\ ## - parentesi quadra chiusa
      
   4. { - parentesi graffa aperta
      
   5. } - parentesi graffa chiusa
      

NOTA1: l'apice singolo, il ?, il | (pipe), la / e la \ non sono ammessi come nomi dei fogli.

NOTA2: è consigliato limitare il set dei caratteri a lettere, numeri e "_".

Maggiori dettagli nel documento seguente (in inglese)
Vedi (J1PATHFILE-http://support)

Accesso o importazione di dati da database ORACLE

DA FARE

Accesso o importazione di dati da database ACCESS

Mediante i metodi MAT.ACC o EXP.ACC si accede direttamente al file.

• iil percorso del file di access, indicandolo o nell'oggetto 1 (J1-PATHFILE-nome_file.MDB) o nel parametro FILE.
  
• il nome della tabella a cui accedere.
  

Accesso o importazione da database che supportano l'ODBC

DA FARE

Accesso o importazione da database che supportano il JDBC

Per debug, ci sono funzioni che permettono di

1. visulizzare l'elenco delle tabelle
   

F(EXB;JA_00_19;INF.JDB) P(TPIMP(02) JDBCDRV(<driver>) JDBCCON(j<jdbc-url>) JDBCUSR(<user>) JDBCPWD(<pass>) JDBCALLTAB(1) LIB(W_SCM) INFOT(TABLES)) SS(Context(JA_00_19/MDB) CGr(EXB) )

1. visualizzare il contenuto di una tabella in matrice:
   

F(EXB;JA_00_19;MAT.JDB) P(JDBCDRV(<driver>) JDBCCON(<jdbc-url>) USER(<user>) PASS(<pass>) TAB(<tabella>) NMAXROW(100)) SS(Context(JA_00_19/MDB) CGr(EXB))