Modelli import/export

• Modello (campo EXT)

Codice che identifica il modello di import-export.

• Descrizione (campo INTIT)

Permette di definire una descrizione associata ad ogni scheda.

• Attivo (campo ENAFLG)

Questa casella da contrassegnare permette di attivare o disattivare la scheda corrente senza tuttavia perderne il contenuto.
Una scheda disattivata non potrà venire utilizzata (richiamandone il codice) in altre schede (documenti, parametrizzazioni, ecc.), o durante elaborazioni di massa.
Le abilitazioni su una determinata funzione possono vietare la creazione di una scheda attiva. In questo caso, la casella viene disattivata di default e non è modificabile se non da un utente autorizzato, o attraverso un circuito di firma definito tramite Workflow.

• Blocco di preimpostazioni (campo AFACTORYOW)

• Oggetto (campo OBJ)

Definisce il codice dell'oggetto da importare o esportare. Nel caso dell'export, questo campo è facoltativo; il nome della tabella principale da esportare è indicato nel blocco degli identificatori.

• Funzione (campo FONCTION)

Permette di inizializzare il contesto (generalmente se uno stesso oggetto èutilizzato per più funzioni) e di verificare i diritti d'accesso. Infatti, gli utenti devono avere i diritti di accesso idonei alla funzione per poter servirsi del modello.

Questo campo è obbligatorio.

• Modulo (campo MODULE)

Modulo di appartenenza della parametrizzazione. Questo campo permette di precisare se la videata deve essere creata nel database del dossier. Lo è se il modulo al quale è collegata la videata è attivo per il dossier.

• Codice attività (campo CODACT)

Un codice attività permette:

• di rendere opzionale un elemento del dizionario se il valore associato al codice attività è nullo.
• di approvare gli elementi specifici da quando sono evidenziati da un codice che inizia per X, Y o Z.
• di dimensionare un numero di righe massimo quando il codice attività evidenzia degli elementi di un riquadro.

Così, se il codice attività non è attivo, l'elemento evidenziato non sarà utilizzabile, e il codice associato (se ne ha) non verrà generato né sarà attivabile.

• Codice accesso (campo ACS)

Questo codice di accesso permette di limitare l'accesso alla scheda corrente ad alcuni utenti.
Se il campo viene indicato, solo gli utenti che dispongono di questo codice di accesso nel loro profilo possono visualizzare e modificare questa scheda.

Il diritto di esecuzione collegato ad un codice utente è trattato in modo particolare nel caso dei modelli di import-export: se un utente non ha il diritto di esecuzione, non potrà utilizzare il modello per importare o esportare dei dati.

• Script standard (campo TRTIMP)

Definisce il programma standard nel quale si trovano le etichette delle azioni che vengono richiamate nei programmi di import-export.

Questi programmi permettono di effettuare delle inizializzazioni, dei controlli complementari e degli aggiornamenti se necessario. In allegato tecnico, si troverà la struttura di un tale programma. Si noti che diversi programmi standard chiamati in generale IMPXXX, dove XXX è il codice dell'import, vengono forniti per un certo numero di import.

Per maggiori informazioni su queste azioni, si veda la documentazione allegata corrispondente.

• Script specifico (campo SPEIMP)

Definisce il programma specifico, richiamato prima del programma standard, che permette di realizzare le stesse azioni disattivando se necessario ciò che esegue il programma standard.

Le azioni possibili sono generalmente delle inizializzazioni, dei controlli complementari, e degli aggiornamenti se necessario.

Per maggiori informazioni su tali azioni, vedere la documentazione allegata corrispondente.

• Tipo file (campo TYPFIL)

Definisce la struttura utilizzata per gestire i dati nel file da importare o esportare. Per maggiorni informazioni, si veda il corrispondente paragrafo.

• Separatore di campo (campo SEPFLD)

Definisce il separatore tra due campi.

Per inserire un carattere non stampabile, occorre inserire un '\' (backslash) seguito da 3 cifre che rappresentano il codice ascii del carattere su base decimale.

• Separatore record (campo SEPREC)

Definisce il separatore tra due record (gruppi di dati).

Per inserire un carattere non stampabile, occorre inserire un '\' (backslash) seguito da 3 cifre che rappresentano il codice ascii del carattere su base decimale.

Spesso si utilizza:

• il carattere line feed (\010), che corrisponde alla fine della riga nei file di testo sotto Unix
• la combinazione dei due caratteri carriage return, line feed (\013\010) che corrispondono alla fine della riga nei file di testo Windows.

• Delimitatore di campo (campo FLDLIM)

Il delimitatore di campo (generalmente il carattere ") viene aggiunto in prima ed ultima posizione dei campi di tipo alfanumerico. I campi numerici e le date non sono interessati da tale delimitatore.

Si tratta spesso di uno dei seguenti caratteri:

• 'singolo apice'
• "doppio apice"

• Formato file (campo CODDBA)

Definisce il formato dei caratteri utilizzati nel file:

• ascii è il formato classico dove un carattere equivale ad un byte nel file. Questo tipo di formato permette di elaborare i caratteri occidentali classici, con diversi set di caratteri possibili, definiti nel campo corrispondente.
• utf8 corrisponde ad un formato UNICODE dove il numero di caratteri è variabile (da 1 a 4, dove 1 corrisponde al set di caratteri latini non accentati). Questo formato permette di gestire tutti i tipi di caratteri, e generalmente i caratteri cinesi.
• ucs2 corrisponde ad un formato standard Microsoft, nel quale i caratteri sono sistematicamente memorizzati su 2 byte.

• Export (campo EXPORT)

Se questo campo è contrassegnato, sarà possibile utilizzare questo modello in Export di dati.

• Crono export (campo CHRNUM)

Questo campo, soltanto visualizzato, memorizza il valore del numero crono di quando è avvenuto l'ultimo export. Ciò permette, quando si realizzano degli export cronologici, di elaborare soltanto ciò che è stato modificato da quando è avvenuto l'ultimo export.

• Set di caratteri (campo OPTCHA)

Quando si utilizza il set di caratteri ascii, è possibile utilizzare diversi formati standardizzati:

• Il codice ISO 8859 (che è inoltre il set interno di Sage quando si lavora in ascii)
• Il codice IBM PC
• Il codice ASCII 7 bit (senza accenti: le lettere accentate sono convertite nella minuscola corrispondente).

• Separatore decimale (campo SEPDEC)

Definisce il separatore decimale utilizzato per le cifre. Se questo campo è vuoto, si considererà che il separatore decimale è il '.' (punto).

• Formato date (campo OPTDAT)

Definisce il modo in cui sono codificati i campi di tipo data (ordine e numero di caratteri per l'anno). 

E' possibile specificare soltanto l'ordine delle cifre ed il numero di caratteri dell'anno. All'import, vengono filtrati eventuali caratteri di separazione tra campi; così vengono decodificate correttamente delle date nel formato 29-05-59 o 09/04/1991.

Il sotto-programma di decodifica considera la variabile adxdcs del motore, indicata dal parametro DCS che si trova nei parametri generali per definire il modo in cui viene decodificato un anno su due cifre. DCS rappresenta l'anno "pilota" che definisce il cambio di secolo.

Ad esempio, se DCS vale 1940, ogni anno su due cifre inferiore o uguale a 40 verrà considerato come facente parte del ventunesimo secolo, e ogni anno maggiore verrà considerato come facente parte del ventesimo secolo. Si sarà così in grado di esprimere gli anni tra 1940 e 2039 su due cifre.

Il formato AAAA-MM-GG è riservato agli export di tipo XML.

• campo LIBDAT

Descrizione associata al codice precedente.

• Formato menu locali (campo OPTMNL)

I campi di tipo "menù locale" vengono memorizzati nel formato di un numero che rappresenta la loro posizione nella tabella.

A seconda del valore di tale campo il modello esporterà (o attende di trovarsi in import):

• 0 : in questo caso, si scrive la scelta nel formato di una cifra che indica la posizione del menù nella tabella: 1 per la prima scelta, 2 per la seconda, ecc. Ciò corrisponde al formato interno sotto il quale il menù locale viene memorizzato nel database.
• 1 : si scrive la scelta utilizzando il codice (su un carattere) associato ad ogni scelta di menù locale. Questo codice non è visibile nella gestione dei menù locali. Può essere definito nelle funzioni di sviluppo, nella gestione dei messaggi: si ha la possibilità di inserire questo codice interno (che serve solo a tale scopo, non è più, come in vecchie versioni caratteri, un acceleratore di inserimento).
• n: (n>1) i primi n caratteri della descrizione visualizzata in inserimento. Quando si utilizza tale opzione, l'algoritmo di riconoscimento ricerca sul primo carattere, poi sul secondo e così di seguito, fino a quando non corrisponde una sola descrizione. Così, se si cerca di riconoscere ASS in un menù locale le cui descrizioni sono Contanti, Giroconto, Assegno, Tratta, Carta di Credito, l'algoritmo riconoscerà Assegno (solo la descrizione le cui prime due lettere corrispondono).

Tenuto conto del fatto che le descrizioni del menù locale sono semplicemente delle descrizioni utilizzate in visualizzazione, poiché il valore memorizzato nel database è il range nella tabella, è assolutamente possibile cambiare la descrizione dei menù locali il tempo di un import, affinché l'algoritmo di riconoscimento funzioni correttamente. Attenzione tuttavia, il fatto di cambiare delle descrizioni di menù locali può essere effettuato solo in modalità mono-utente, e ciò è sconsigliato in trasferimenti regolari o automatizzati.

• campo LIBMNL

Descrizione associata al codice precedente.

• Import (campo IMPORT)

Se questo campo è contrassegnato, sarà possibile utilizzare questo modello nell'Import di dati.

• Aggiorn. autorizzato (campo OPTUPD)

Permette di autorizzare la modifica di un record esistente durante l'import

• Transito (campo AOWSTA)

Quando questo check-box è contrassegnato, l'import di dati alimenta il transito import-export con i dati errati. Il fatto di alimentare il transito non impedisce di creare un file di errore.

• Import speciale (campo OPTSPE)

Segnala che l'integrazione dei dati nel database si effettua utilizzando delle azioni specifiche definite nel programma il cui nome viene fornito nel campo Programma di import. Questo programma specifico possiede un numero ristretto di entry point e necessita quindi di scrivere un programma che includa tutti i controlli che si intendono effettuare.

Il suo interesse risiede nel fatto che è possibile così raggruppare dei controlli al fine di ottimizzare il programma di import. La struttura dei programmi di import specifici è descritta in allegato. Si dovranno generalmente trovare le seguenti azioni:

• un'etichetta $RAZCRE che è richiamata direttamente dall'import.
• un'etichetta $SAIMSK che è richiamata direttamente dall'import ad ogni record letto e sostituisce la Call SAIMSK standard (assegnazione e controllo dei campi della videata a partire dalla classe [F])

• Workflow (campo ENAWRK)

Se questa casella non è contrassegnata, gli eventi di workflow relativi alle operazioni elementari (creazione, modifica in gestione di oggetto) non vengono più chiamati. Così, se si lanciano import comportanti aggiornamenti di massa, si evita l'attivazione di una moltitudine di eventi di questo tipo, il che può degradare le performance dell'import e provocare l'invio di messaggi in massa.

Tuttavia, gli eventi di workflow relativi all'attivazione dell'import non sono disattivati.

• N° (campo NUMFLG)

Riga corrente del riquadro

• Livello (campo FLGLEV)

Definisce il livello del gruppo. Il livello 1 è il livello principale, un livello N+1 definisce un sotto-dettaglio del livello N che lo precede.

• Flag (campo FLGREC)

Identifica il gruppo da un codice di massimo 5 caratteri, codice che sarà ripreso nel riquadro dei campi del folder successivo, e nello stesso file, come testata del gruppo.

• Tabella (campo FLGFIL)

Questo riquadro degli indicatori definisce la struttura dei gruppi di record. Vedere il relativo paragrafo.

• Chiave (campo FLGKEY)

Definisce la chiave della tabella collegata utilizzata per accedere al dettaglio dei record del gruppo, a partire dai valori dei campi delle tabelle di livello superiore utilizzate nell'espressione di legame.

• Legame (campo FLGLNK)

Definisce l'espressione di legame, ovvero una serie di valori, separati da un punto e virgola, che fornisce i valori di chiave che legano la tabella di dettaglio al record di testata.

• Lunghezza (campo RECLEN)

Nel caso di un tipo di file di lunghezza fissa, occorre indicare il numero di caratteri di ogni record.

• N° (campo NUMLIG)

Riga corrente del riquadro

• Flag (campo TYP)

Questo campo viene inserito soltanto se non è vuoto il riquadro degli identificatori di gruppi del folder precedente. Permette di collegare l'informazione da esportare o importare ad un gruppo di dati.

• Tabella (campo FIL)

Definisce il riquadro del database in cui viene definito il dato da importare o esportare. Si noti che:

• Questo campo è obbligatorio anche se non serve necessariamente (se si è in un modello di export e se si definisce un'espressione calcolata, questa può far riferimento a dei campi provenienti da più tabelle).
• La tabella in oggetto non è necessariamente la tabella principale associata al gruppo, ma può essere una tabella collegata alla tabella principale di questo gruppo o di uno dei gruppi precedenti di livello superiore. Se non è stato trovato alcun legame, viene visualizzato un messaggio di avvertimento: Legame automatico non gestito. Ciò significa che dipende dal programma di import o d'export (inserito nel primo folder) realizzare questo legame manualmente (dichiarando per esempio la tabella nell'azione IMP_OUVRE, e la lettura della tabella nell’azione IMP_LIENS).

• Campo (campo FLD)

Permette di indicare il nome del campo della tabella da importare o esportare. Sono possibili diverse sintassi per definire le informazioni da estrarre o integrare:

• Il carattere / (slash) significa che un indicatore di gruppo è scritto nell'export o ricercato durante l’import. In un modello che permette l’import, quando esistono più gruppi, questo separatore è obbligatorio per ogni gruppo. Si presume che il separatore di gruppo sia un campo normale (incorniciato da separatori di campi e dei delimitatori se si utilizza un modello di tipo Delimitato).
• La sintassi più semplice è CAMPO(indice), quando un campo dalla tabella dichiarata nella colonna precedente è importato o esportato. Una finestra di selezione permette di far apparire i campi possibili.
• Se si inserisce qui una costante stringa di caratteri tra doppi apici ("), il campo sarà scritto tale e quale nel file in export ed ignorato in import.
• Se non si inserisce nulla, significa che ci sarà un campo vuoto nel file esportato (tra delimitatori di campo se il modello è di tipo Delimitato). In import, significa che il campo corrispondente deve essere ignorato.
• E' inoltre possibile la sintassi *N, dove N è un numero compreso tra 1 e 99. Questo permette di alimentare (in import) o di leggere (in export) la variabile GIMP(N). GIMP è una variabile globale, di tipo stringa di caratteri, di lunghezza massima uguale a 100, che dovrà essere alimentata in un programma specifico associato all'import o all'export.
• L'ultima possibilità, utilizzabile esclusivamente in export, consiste nel definire un'espressione calcolata qualsiasi, preceduta dal segno uguale (=). Questa espressione, che può richiamare delle costanti, delle funzioni, delle variabili, degli operatori e dei campi di tabelle in linea, viene verificata sintatticamente all'inserimento (il controllo del contesto, in particolare il fatto che le variabili esistano, non può ovviamente essere verificato).

• Descrizione (campo COM)

Indicare un commento per facilitare la comprensione della parametrizzazione.

• Intervallo (campo SEL)

Sono possibili tre scelte in questo campo:

• Non inseritosignifica che per tale campo non verrà inserito alcun intervallo di inizio-fine al lancio dell'export.
• Inseritosignifica che per tale campo potrà essere inserito un intervallo di inizio-fine al lancio dell'export.
• Non trasferitosignifica che per tale campo potrà essere inserito soltanto un intervallo di inizio-fine al lancio dell'export, ma che il campo non verrà trasferito durante un import o un export.

• Posizione (campo LOC)

Questa colonna è utile solo nel caso di un formato in lunghezza fissa; in questo caso, la posizione fornisce lo slittamento rispetto all'inizio del blocco o del record (posizioni fornite in numero di byte, dove 1 significa che ci si trova all'inizio del blocco o del record). Le posizioni devono essere compatibili con la dimensione del record.

• Lunghezza (campo LNG)

Questo campo determina la lungheza del campo sul file sequenziale.

• Formato (campo FMT)

Questa colonna viene inserita soltanto se il formato è in lunghezza fissa. Per gli importi numerici, il formato inserito viene definito nel formato nnn o nnn.mmm, sapendo che queste cifre possono essere prefissate da < o > (allineamento a destra o a sinistra completato da zeri, formattazione a destra utilizzata di default), prefissate o post-fissate dal carattere + (segno obbligatorio prima/dopo la cifra), e prefissato dal carattere * (il separatore decimale non deve apparire). Il riquadro sottostante mostra degli esempi di formattazione per un determinato importo (gli spazi sono qui sostituiti da #):

Per un formato alfanumerico, le uniche direttive di formattazione possibili sono < o > (allineamento a destra o a sinistra, sapendo che le stringhe di caratteri sono completate da spazi).

• Pattern (campo PATTERN)

Questo campo viene utilizzato quando si effettuano degli import/export in formato XML.

Infatti, quando viene creato un file XML, si ha bisogno di informazioni iniziali, in particolare per poter creare un file XSD che descriva la struttura del file XML e controllare così la sua validità con strumenti di verifica di sintassi integrati ai vari software ETL.

Questo campo definisce se un modello deve essere associato alla descrizione fatta nella descrizione XSD.

Se questo campo viene valorizzato, il file XSD conterrà uno specifica di tipo:

pattern value="valore_inserito_nel_campo_pattern"

Nei tutorial on line (come questo) sono disponibili le sintassi che è possibile utilizzare per i pattern.

• Tag (campo BAL)

Questo campo viene utilizzato quando si effettuano degli import/export in formato XML.

Infatti, quando viene creato un file XML, si ha bisogno di informazioni iniziali, in particolare per poter creare un file XSD che descriva la struttura del file XML e controllare così la sua validità con strumenti di verifica di sintassi integrati ai vari software ETL.

Questo campo definisce il codice del tag che descrive il campo esportato nel modello, così come apparirà nel file XML.

• Obbligatoria (campo OBL)

Questo campo viene utilizzato quando si effettuano degli import/export in formato XML.

Infatti, quando viene creato un file XML, si ha bisogno di informazioni iniziali, in particolare per poter creare un file XSD che descriva la struttura del file XML e controllare così la sua validità con strumenti di verifica di sintassi integrati ai vari software ETL.

Questo campo definisce se il campo è obbligatorio o meno. Se il suo valore è uguale a Si, il file XSL conterrà una specifica di tipo minOccurs="1"

• N. tabella (campo NUMTAB)

Questo numero, se esiste, fa riferimento ad una tabella di trascodifica utilizzabile per trascodificare il campo letto e renderlo conforme al formato atteso.

• campo TYPEXP

• Archivio di dati (campo FILEXT)

Permette di definire il percorso di un file di dati di default che verrà proposto durante il lancio dell'import o dell'export (e utilizzato in modo automatico in caso di lancio di un concatenamento di import o di export). Se il percorso file è relativo, la directory di base considerata è quella di base d'installazione del software.

Il percorso può integrare il carattere #. Se questo è il caso, vi sarà una gestione dei numeri sequenziali:

• In import, significa che si ricercheranno tutti i file il cui modello corrisponde al percorso, sapendo che # che rappresenta 5 cifre (si integrano questi file in ordine crescente dei numeri)
• In export, significa che si crea un file che integra il valore formattato del contatore [C]EXPORT su 5 cifre. Normalmente ciò accompagna la contrassegnazione della casella Gestione crono durante il lancio della funzione di export.

Ad esempio, se il chrono export è uguale a 156, /u/tmp/fic# permette di generare il file /u/tmp/fic00156.

• Directory finale (campo REPFIN)

Permette di imporre una directory finale nella quale il file verrà trasferito dopo essere stato importato. In assenza di valore, si utilizza la directory indicata nei parametri generali dell'import/export.