|
 |  |  |  |
 | |||
Impostazione Import/Export | |||
Nome programma: BSIEMPTB.DLL Questo programma consente di definire tutte le caratteristiche delle operazioni da compiere per ogni profilo di Import/Export. In particolare sarà possibile far corrispondere una tabella di Business con una, di tipo esterno, dalla quale importare o sulla quale esportare i dati; per ognuna di queste corrispondenze sarà possibile far corrispondere i campi di Business con quelli esterni oppure determinare un valore da attribuire in uscita secondo diverse metodologie. Corrispondenze tabelle:
Mediante questa scheda è possibile far corrispondere una tabella di Business con una tabella; per ogni profilo non è possibile più avere più volte la stessa corrispondenza Tabelle Business – Tabella esterna. Indica il codice del profilo al quale appartiene questa corrispondenza tabelle; questo campo non è mai modificabile in quanto si riferisce sempre al codice del profilo aperto selezionato mediante la casella a discesa 'Profilo', che indica, tra l'altro, il tipo di profilo (importazione o esportazione). Esegue una rilettura dei profili dall'elenco contenuto nella tabella 'Profili di import/export'. Questa funzione è abilitata solo se si è posizionati in 'Corrispondenza campi'. Esegue un collegamento automatico tra nome campo di Business e nome campo esterno a parità di nome. In questo campo si indica il nome di una tabella di Business (max 30 caratteri), selezionandola eventualmente aprendo la lista tabelle abilitata su questo campo, dalla esportare se si tratta di profilo di esportazione, o su cui importare se si tratta di profilo di importazione. L'indicazione di questo campo è obbligatoria. In questo campo va indicato il nome di una tabella esterna (max 30 caratteri), precedentemente creata con il programma di 'Definizione schema tabelle' (richiamabile anche da questa finestra mediante il pulsante 'Definizione schema tabelle'). L'indicazione di questo campo è obbligatoria. Rappresenta la descrizione (max 40 caratteri) del tipo di operazione che compie il processo di Import/Export indicato in questa riga; è un dato non obbligatorio ma utile per distingue i vari processi in fase di esecuzione. è un dato obbligatorio, rappresentato da un numero, che indica l'ordine di questa corrispondenza rispetto le altre; all'interno dello stesso profilo il numero di ordinamento deve essere univoco. è un indicatore che specifica se questa 'Corrispondenza tabella' può essere avviata singolarmente (primaria e visibile all'esterno) oppure è una corrispondenza di relazione (secondaria e invisibile all'esterno) che non può essere eseguita da sola, ma verrà automaticamente trattata quando vengono analizzate le relazioni fra 'Corrispondente tabelle'; ad esempio quando si esportano documenti di magazzino (D.D.T.) , essendo costituiti da testate e righe, si dovranno inserire 2 'Corrispondenze tabelle': testmag - Testmag.dat di tipo primario ed un'altra movmag - Movmag.dat secondaria, poste in relazione. è una colonna che può assumere 4 valori:
è possibile utilizzare il filtro esteso o il filtro Data/ora solamente se la corrispondenza tabelle è di tipo primario. Questo campo può essere utilizzato solo se il tipo filtro assume valore 'Usa filtro predefinito' o 'Usa filtro data'. In questa colonna si deve utilizzare la sintassi della clausola WHERE dell'SQL; nel caso di esportazione si dovranno indicare i campi della tabella di Business, mentre per le importazioni dovranno essere indicati i campi della tabella esterna. Per esempio per esportare le anagrafiche articoli appartenenti al gruppo 1, si dovrà indicare 'ar_gruppo = 1', per esportare testate di DDT si dovrà indicare 'tm_tipork' = 'B'. Per questo campo non ci sono limiti nel numero di caratteri. Questo campo (normalmente non visibile) contiene la lista dei campi da estrarre dall'origine; normalmente assume il valore '*' (asterisco) per indicare tutti i campi della/e tabelle di origine. è utile per specificare campi che sono il risultato di funzioni di aggregazione SQL come Sum(), Cout(*), First(), Min(), Max(), ecc, che necessitano l'uso di un alias per essere referenziati, oppure per specificare la lista dei campi quando la query di estrazione dati (SELECT) usa un collegamento tra 2 o più tabelle (JOIN) la cui somma dei campi supera i 256. Per questo campo non ci sono limiti nel numero di caratteri. Questo campo (normalmente non visibile) può contenere la clausola FROM della query di estrazione dei dati dall'origine; se non utilizzata verrà indicata la sola tabella di origine (Business e esterna). Per questo campo non ci sono limiti nel numero di caratteri. Qualora si stia impostando una importazione da foglio di Microsoft Excel, occorrerà impostare in questa colonna il nome del foglio seguito dall'area contente i dati da importare. Ad esempio, se dovessimo importare un listino dal file Prova.xls, cartella Listini e i dati fossero contenuti nelle colonne da A a D, fino alla riga 50, scriveremmo: [Listini$A1:D100] (in realtà al posto di 100 si sarebbe potuto scrivere 50, ma se in una successiva importazione ci fossero state più di 50 righe, quelle oltre la cinquantesima sarebbero state scartate!) Questo campo (normalmente non visibile) può contenere la clausola ORDER BY della query di estrazione dei dati dall'origine; se non utilizzata i record verranno selezionati nell'ordine in cui sono conservati nella tabella di origine (Business e esterna). Questo campo è limitato ad un massimo di 50 caratteri. Questo campo (normalmente non visibile) può contenere la clausola GROUP BY della query di estrazione dei dati dall'origine; se non utilizzata i record non verranno raggruppati. Questo campo è limitato ad un massimo di 50 caratteri. Questo campo (normalmente non visibile) può contenere la clausola HAVING della query di estrazione dei dati dall'origine solamente se è stato specificato una raggruppamento nella colonna precedente; se non utilizzata tutti i record di gruppo verranno selezionati. Questo campo è limitato ad un massimo di 50 caratteri. è un indicatore che specifica se viene trattato solo il primo record selezionato dalla tabella di origine; può essere indicato solo nei profili di importazione. Si può abilitare, ad esempio, nella corrispondenza tabella secondaria, quando si importano documenti di magazzino per creare l'anagrafica dell'articolo se mancante prima di scrivere il movimento di magazzino, come nell'esempio sotto riportato: Tab. BusinessTab. EsternaPrimariaSolo primo recordTipo di operazione TestmagTestmag.datSNAggiungi solo MovmagMovmag.datNNAggiungi solo ArticoMovmag.datNSAggiungi solo Relazione tabelle: Ordine rel.Tab. Business. 1Tab. esterna 1Tab. Business 2Tab. esterna2 1TestmagTestmag.datMovmagMovmag.dat 2MovmagMovmag.datArticoMovmag.dat Relazione campi: Ordine rel.Campo origine 1Campo origine 2 1test_tiporkriga_tipork 1test_annoriga_anno 1test_serieriga_serie 1test_numdocriga_numdoc 2riga_codartriga_codart L'opzione 'Solo primo record' abilitata sulla corrispondenza Artico – Movmag.dat assicura che, quando vengono selezionati i record dei movimenti di un determinato articolo, venga trattato solo il primo record (quello significativo) migliorando i tempi di importazione. è un campo che può assumere uno dei seguenti valori:
Questa colonna contiene l'indicazione del tipo di database Business su cui operare con l'importazione o l'esportazione; può essere indicato l'archivio procedura (contenente l'elenco ABI-CAB, l'elenco dei codici TARIC per l'Intrastat, le stampe parametriche, ecc.) oppure l'archivio azienda correntemente aperta. Questo indicatore fa si che il programma analizzi o meno le relazioni esistenti fra le corrispondenze tabelle; è aggiunto per ragioni di prestazioni, per evitare che vengano attivati i meccanismi di controllo su tutti i livelli di relazioni, anche se non necessari. Specifica se questa corrispondenza tabelle, utilizza o meno routine personalizzate da far eseguire allo Script Engine sia a livello di tabella che a livello di campo; è obbligatorio abilitare l'opzione quando è indicato uno o più codici di procedura da eseguire. L'uso di questa impostazione agisce sensibilmente sulle prestazioni dell'Import/Export a causa delle operazioni aggiuntive che il motore compie durante tutte le fasi del processo (precarica nello Script Engine di tutte le funzioni da caricare all'avvio, esposizione, record per record, delle variabili contenenti i valori dei campi di origine e quelli, in seguito alla valutazione, dei campi di destinazione). Indica se segnalare o meno la mancanza di record da selezionare dall'origine; normalmente questa opzione è abilitata allo scopo di segnalare nel log file (o a video se si tratta di relazione primaria) l'assenza di record, si disabilita quando è possibile che sull'origine non siano presenti record: per esempio esportano o importando documenti di magazzino che trattano articoli gestiti a matricole e non, quando vengono selezionate le matricole per riga di documento, evita il messaggio quando esporta o importa articoli che non prevedono le matricole. Può indicare il codice della routine che il programma di Import/Export (mediante lo Script Engine) eseguirà prima di creare il file esterno. Il codice che si indica deve riferirsi ad una routine esistente. è obbligatorio che l'opzione 'Usa ScriptEngine' sia abilitata prima di inserire un codice. Questa routine viene lanciata solo su tabelle primarie di livello 1. Può indicare il codice della routine che il programma di Import/Export (mediante lo Script Engine) eseguirà prima di trattare il primo record di questa corrispondenza tabelle. Il codice che si indica deve riferirsi ad una routine esistente. è obbligatorio che l'opzione 'Usa ScriptEngine' sia abilitata prima di inserire un codice. Può indicare il codice della routine che il programma di Import/Export (mediante lo Script Engine) eseguirà prima di inserire ogni record di questa corrispondenza tabelle. Il codice che si indica deve riferirsi ad una routine esistente. è obbligatorio che l'opzione 'Usa ScriptEngine' sia abilitata prima di inserire un codice. Può indicare il codice della routine che il programma di Import/Export (mediante lo Script Engine) eseguirà prima di aggiornare ogni record, già esistente sulla tabella di destinazione, di questa corrispondenza tabelle. Il codice che si indica deve riferirsi ad una routine esistente. è obbligatorio che l'opzione 'Usa ScriptEngine' sia abilitata prima di inserire un codice. Può indicare il codice della routine che il programma di Import/Export (mediante lo Script Engine) eseguirà prima di inserire ogni record (ma dopo aver analizzato le relazioni che hanno indicato, come 'Tempo di valutazione', il valore 'Prima della scrittura del record'), di questa corrispondenza tabelle. Il codice che si indica deve riferirsi ad una routine esistente. è obbligatorio che l'opzione 'Usa ScriptEngine' sia abilitata prima di inserire un codice. Può indicare il codice della routine che il programma di Import/Export (mediante lo Script Engine) eseguirà prima di aggiornare ogni record (ma dopo aver analizzato le relazioni che hanno indicato, come 'Tempo di valutazione', il valore 'Prima della scrittura del record'), già esistente sulla tabella di destinazione, di questa corrispondenza tabelle. Il codice che si indica deve riferirsi ad una routine esistente. è obbligatorio che l'opzione 'Usa ScriptEngine' sia abilitata prima di inserire un codice. Può indicare il codice della routine che il programma di Import/Export (mediante lo Script Engine) eseguirà dopo l'inserimento di ogni record, con esito positivo, di questa corrispondenza tabelle. Il codice che si indica deve riferirsi ad una routine esistente. è obbligatorio che l'opzione 'Usa ScriptEngine' sia abilitata prima di inserire un codice. Può indicare il codice della routine che il programma di Import/Export (mediante lo Script Engine) eseguirà dopo l'aggiornamento di ogni record, con esito positivo, già esistente sulla tabella di destinazione, di questa corrispondenza tabelle. Il codice che si indica deve riferirsi ad una routine esistente. è obbligatorio che l'opzione 'Usa ScriptEngine' sia abilitata prima di inserire un codice. Può indicare il codice della routine che il programma di Import/Export (mediante lo Script Engine) eseguirà dopo l'inserimento di ogni record, con esito positivo, (ma dopo aver analizzato le relazioni che hanno indicato, come 'Tempo di valutazione', il valore 'Dopo la scrittura del record'), di questa corrispondenza tabelle. Il codice che si indica deve riferirsi ad una routine esistente. è obbligatorio che l'opzione 'Usa ScriptEngine' sia abilitata prima di inserire un codice. Può indicare il codice della routine che il programma di Import/Export (mediante lo Script Engine) eseguirà dopo l'aggiornamento di ogni record, con esisto positivo, (ma dopo aver analizzato le relazioni che hanno indicato, come 'Tempo di valutazione', il valore 'Dopo la scrittura del record'), già esistente sulla tabella di destinazione, di questa corrispondenza tabelle. Il codice che si indica deve riferirsi ad una routine esistente. è obbligatorio che l'opzione 'Usa ScriptEngine' sia abilitata prima di inserire un codice. Può indicare il codice della routine che il programma di Import/Export (mediante lo Script Engine) eseguirà dopo aver trattato l'ultimo record di questa corrispondenza tabelle. Il codice che si indica deve riferirsi ad una routine esistente. è obbligatorio che l'opzione 'Usa ScriptEngine' sia abilitata prima di inserire un codice. Può indicare il codice della routine che il programma di Import/Export (mediante lo Script Engine) eseguirà dopo aver salvato e chiuso il file esterno (ad esempio per inviarlo tramite e-mail oppure spostarlo in un'altra cartella). Il codice che si indica deve riferirsi ad una routine esistente. è obbligatorio che l'opzione 'Usa ScriptEngine' sia abilitata prima di inserire un codice. Questa routine viene lanciata solo su tabelle primarie di livello 1. Se si seleziona questa voce nel momento in cui viene eseguito il programma 'Strumento di import/export' le tabelle avranno già la spunta per essere eseguite. Filtri estesi:
I filtri estesi vengono impostati solamente se la colonna 'Tipo filtro' è impostata a 'Usa filtri estesi'; si attiva quando si è posizionati sulla riga di corrispondenza tabelle col menu Record|Imposta filtri estesi oppure col tasto di scelta rapida Ctrl+I. Mediante questa finestra è possibile indicare al massimo 10 filtri sui campi della tabella di origine selezionabili mediante la casella a discesa; dopo la selezione di un campo di Business automaticamente verrà indicata la descrizione, e il tipo del campo. Il valore predefinito impostato è quello che l'utente avrà già preimpostato, ma comunque modificabile, al momento della esecuzione del processo di Import/Export. Qualora necessiti come valore è possibile specificare anche il valore nullo indicando la scritta 'Null' possibile solo con operatore uguale '=' o diverso '<>'. All'interno del campo 'Valore predefinito' è obbligatorio indicare valori congruenti con il tipo di campo (es. un campo di tipo numerico potrà accettare solo cifre e non lettere).
Una volta indicati tutti i filtri occorre metterli in relazione utilizzando i pulsanti al fianco di ogni filtro seguiti dagli operatori di legame (AND, OR o NOT) ed eventualmente dai livelli di parentesi; i marcatori '{Val0} – {Val9} saranno sostituiti con i valori che l'operatore indicherà in fase di esecuzione. Il pulsante 'Elimina' cancella il contenuto della relazione filtri; col pulsante 'Rimuovi tutto', invece si cancellano le impostazioni di tutti i filtri per reinserirli. Corrispondenza campi: In questa sezione viene impostato il modo in cui viene attribuito un valore da inserire sul campo della tabella di destinazione. Nei profili di esportazione i campi di destinazione sono quelli elencati nella colonna 'Nome campo esterno', viceversa nelle esportazioni sono quelli indicati nella colonna 'Nome campo Business'. Ai campi viene impostato un valore seguendo queste priorità:
Resta inteso che, qualora, in seguito a queste valutazioni, il valore attribuito risulta essere nullo (anche in seguito a errore di conversione di dati non omogenei), il programma attribuisce, segnalando nel log degli eventi questa situazione, al campo di destinazione il valore predefinito, qualora sia rilevabile (come nel caso di importazione), oppure un valore predefinito specifico per tipo di campo di destinazione (per l'esportazione, ad esempio, su file ASCII, il programma attribuisce caratteri spazio per i campi testo o data, 0 (zeri) per i caratteri numerici). Come regola generale, nell'importazione, non è obbligatorio inserire una corrispondenza campi per ogni campo di Business, in quando su quelli non eventualmente ridefiniti sarà il gestore del database ad attribuirgli il valore predefinito se esistente; è comunque obbligatorio almeno definire i campi della chiave primaria. è obbligatorio invece ridefinire tutti i campi di destinazione nel caso di esportazione.
è l'ordine con cui i campi vengono trattati durante il processo di Import/Export. è un campo numerico, univoco all'interno di ogni corrispondenza tabelle, che assume particolare importanza quando si utilizza lo Script Engine, e in particolare le variabili che contengono, record per record, il contenuto dei campi da attribuire alla destinazione: nell'immagine sopra indicata, ad esempio, durante la fase di attribuzione del valore al campo di ordine 9 ('mm_colli' destinazione Business, 'quant' origine file ascii Movmag.dat) si ha già a disposizione nello ScriptEngine la variabile 'IeOu2mm_unmis', precedente di ordine 8, ma non la variabile 'IeOu2mm_prezzo' successiva di ordine 12; questa variabile sarà ancora Empty se si tratta del primo record, oppure conterrà il valore del campo 'mm_prezzo' attribuito nel record precedente e quindi non attendibile. è il nome del campo Business (max 30 caratteri) selezionabile dalla casella a discesa, che rappresenta la destinazione nel caso di importazione, l'origine in caso di esportazione. è una dato sempre obbligatorio. Qualora, nell'esportazione, non sia necessario un campo di origine, indicare il valore '(Nessuno)'. è il nome del campo esterno (max 30 caratteri) selezionabile dalla casella a discesa, che rappresenta l'origine nel caso di importazione, la destinazione in caso di esportazione. è una dato sempre obbligatorio. Qualora, nell'importazione, non sia necessario un campo di origine, indicare il valore '(Nessuno)'. è un campo, di massimi 50 caratteri, che può contenere un valore fisso da attribuire al campo di destinazione durante il processo di Import/Export. Ha priorità 2 come indicato sopra nelle note generali. è obbligatorio che in questo campo venga indicato un valore congruente con il tipo di dato della destinazione per evitare segnalazioni di errori di conversione di tipi durante l'esecuzione. Può indicare il codice di una routine funzione (che restituisce quindi un valore) o una istruzione VBScript, che il programma eseguirà per restituire il valore da attribuire al campo di destinazione. Ha priorità 3 come indicato nelle note generali. Il risultato di questa funzione o istruzione sia congruente con il tipo di dato della destinazione per evitare segnalazioni di errori di conversione di tipi durante l'esecuzione. è obbligatorio che l'opzione 'Usa ScriptEngine', sulla corrispondenza tabelle a cui questa impostazione di campo appartiene, sia abilitata. è una opzione, utilizzabile solo nell'importazione da tabelle di tipo 'Jet ISAM Text' o 'ASCII Text file', che abilita la conversione del valore nullo dell'origine in un carattere spazio, questo a causa del fatto che in un file di testo a campi a lunghezza fissa, caratteri spazio vengono interpretati come valore nullo; in alcune circostanza, come ad esempio per la serie dei documenti di magazzini, è necessario operare questa conversione. Rappresenta un campo di testo, di massimi 50 caratteri, che contiene la stringa di formattazione (secondo la sintassi della funzione Format() del Visual Basic for Application, rilevabile in qualsiasi guida di un programma che implementa questo linguaggio quale Microsoft Access, Microsoft Excel, ecc.) utilizzabile solamente nelle esportazioni su tabelle esterne di tipo 'ASCII Text file'. Se omessa, per i campi numerici interi (long, single) il valore viene comunque arrotondato all'intero; per i campi che prevedono valori decimali (double, currency) il valore viene arrotondato al secondo decimale. è un numero che, se diverso da 0, può indicare un multiplo o sottomultiplo di 10 per consentire di trattare, in fase di esportazione o importazione i campi numerici non interi senza l'utilizzo del separatore decimale: se il programma legge dal campo di origine il valore numerico 10050006 e come coefficiente di divisione è indicato 100, alla destinazione il programma attribuirà il valore 10.050,06. L'uso di questo coefficiente è possibile solo sui campi numerici e se esiste l'indicazione del campo di origine. è un'opzione che indica se il campo di origine deve essere o meno trascodificato, facendo corrispondere ad un valore di origine, un altro per la destinazione. Se questa opzione è abilitata, è obbligatorio indicare un codice trascodifica esistente nella colonna successiva. L'abilitazione di questa opzione è possibile solo se esiste l'indicazione del campo di origine. è un campo che contiene il codice trascodifica riferita al campo di origine di questa corrispondenza campi. Durante la fase di esecuzione, se il valore di un campo che si riceve in origine non è tra quelli previsti, il programma può, a seconda di come impostata la trascodifica, chiede all'utente il valore di destinazione o procedere attribuendo il valore predefinito del campo di destinazione, se rilevabile, oppure il valore nullo segnalando comunque l'operazione compiuta nel log file. I valori che l'utente inserisce, verranno salvati e saranno utilizzati dal programma automaticamente dal quel momento in poi. Relazioni tabelle: Mediante queste scheda vengono messe in relazione più corrispondenze tabelle. L'uso di queste relazioni fa si che quando il programma di Import/Export tratta un record analizzi, prima e dopo la scrittura del record, tutte le tabelle in relazione: questo allo scopo, ad esempio, di trattare i documenti di magazzino, che sono costituiti da testate e righe, e tutti gli altri casi in cui devono essere considerati unicamente, per vincoli di integrità referenziale sul database, dati localizzati su tabelle diverse ma comunque legati. Allo stato è possibile solo al massimo utilizzare 4 livelli di relazione; durante l'imputazione delle relazione il programma non controlla questo limite; sarà solo in fase di esecuzione che segnalerà il raggiungimento del 4 livello di relazione, causato spesso da riferimenti circolari non consentiti. Non c'è limite al numero di relazioni per ogni livello. Un altro vincolo sulle relazioni tabelle è dato dal fatto che tutte le tabelle esterne della relazione primaria e di tutti i livelli sottostanti, devono essere dello stesso tipo (attualmente o Jet ISAM Text o ASCII Text file). Corrispondenze tabelle poste in relazione devono appartenere allo stesso profilo.
è il codice del profilo della corrispondenza tabella posta in relazione. Non è mai editabile sia sull'inserimento che in modifica. è il nome della tabella di Business esistente posta in relazione (max 30 caratteri). è il nome della tabella di Business esistente posta in relazione (max 30 caratteri). I 3 campi sopra elencati devono appartenere ad una Corrispondenza tabelle già definitiva per il profilo. è la sequenza con cui vengono analizzate le relazioni dal programma. Questo numero deve essere univoco all'interno di ogni corrispondenza tabella primaria a parità di Tempo di valutazione. è un campo che può assumere due valori: Dopo la scrittura del record dove la relazione viene eseguita dopo aver inserito o modificato, con esito positivo, il record sulla tabella di destinazione primaria; Prima della scrittura del record dove la relazione viene eseguita prima di aver inserito o modificato, con esito positivo il record. Questa opzione, normalmente non abilitata, forza l'esclusione dell'analisi della relazione corrente. Può essere utilizzata soprattutto in fase di test di un profilo di Import/Export. Questo campo contiene la condizione necessarie per rendere valido il legame di relazione corrente. Può assumere il valore Solo in inserimento dove la relazione viene considerata solo se il record, sulla tabella di destinazione primaria, è stato aggiunto; Solo in aggiornamento dove la relazione viene considerata solo se il record è stato aggiornato; Sempre la relazione viene sempre eseguita. Relazione campi: Con questa scheda vengono messi in relazione i campi fra le tabelle poste in relazione in precedenza. I nomi dei campi sono sempre riferiti alle tabelle di origine.
è un numero che indica l'ordine del campo posto in relazione. Deve essere univoco per ogni tabella posta in relazione. è il nome del campo (max 30 caratteri) della tabella di origine primaria selezionabile mediante la casella a discesa. è il nome del campo (max 30 caratteri) della tabella di origine secondaria selezionabile mediante la casella a discesa. Sarà cura dell'utente far si che il tipo dei campi posti in relazione sia uguale al fine di evitare segnalazioni di errore durante l'esecuzione. Funzioni di toolbar: Tramite questa funzione è possibile compilare più velocemente (ove possibile) la griglia della corrispondenza campi, questa funzione aggiunge nella griglia tutti i campi della tabella esterna che hanno lo stesso nome nella tabella di business.
Tramite questa funzione è possibile compilare più velocemente la griglia della corrispondenza campi, a seconda che il profilo si tratti di un import o di un export nella griglia verranno esplosi rispoettivamente tutti i campi della tabella di business o della tabella esterna. Successivamente l'utente andrà a definire come devono essere valorizzati suddetti campi.
|
 |  |  |  |  |  |
 |  |  |  |  |  |
 | |||||
