Modelli di import/export: allegato tecnico

Il programma di import e le azioni associate

L'import e l'export di oggetto è realizzato tramite un programma creato partendo dalla compilazione del modello. Questo programma temporaneo ha come nome WWINNNNNN o WWENNNNNN (dove NNNNNN è un numero progressivo).

Nel caso dell'export, il programma estrae solo dei dati (filtrandoli secondo le abilitazioni degli utenti). Nel caso dell'import, il programma contiene le istruzioni di decodifica del flusso di dati e richiama le diverse funzioni collegate all'oggetto da importare, emulandone in qualche modo l'inserimento. Così, le etichette standard dei programmi SUBXXX e SPEXXX, che permettono di gestire gli Oggetti, sono richiamate normalmente.

Ma si richiamano inoltre delle etichette supplementari specifiche all'import, definite nel programma IMPXXX, se questo esiste (e nel programma specifico definito nel modello, che permette di elaborare i casi specifici). Le cronologie che seguono descrivono precisamente il modo in cui si svolge un import nel caso dei diversi tipi di oggetto (per maggiori dettagli, si farà riferimento alla documentazione sulla gestione di oggetto). Nel riquadro che segue, le azioni dell'Oggetto standard sono indicate in corsivo, quelle legate all'import in grassetto.

La colonna Azioni indica delle azioni realizzate subito dopo l'operazione indicata nel contesto: per esempio, nel caso dell'oggetto semplice, se si guarda il riquadro 8.2:

• vengono realizzate le azioni VERIF_MOD e IMP_VERIF_MOD
• si locca il record, poi si realizzano le azioni AVANT_MODFIC e IMP_AVANT_MODFIC
• si alimentano le variabili della classe [F], poi si realizzano le azioni INIMOD e IMP_INIMOD.
• si riscrive, poi si realizzano le azioni MODIF e IMP_MODIF.
• si esegue l'operazione di fine transazione (Commit), poi si realizzano le azioni APRES_MOD e IMP_APRES_MOD.
• si sblocca, poi si eseguono le azioni DEVERROU e IMP_DEVERROU.

Si noti che le azioni contenute nel programma specifico di import sono effettuate prima di quelle del programma standard di import; se il programma specifico di import alimenta la variabile GPE a 1, l'azione del programma standard di import viene inibita.

Oggetto semplice

(*) Le azioni MODIF et IMP_MODIF sono utilizzate in principio per gestire la registrazione delle righe (MODIF è utilizzato in standard dalla gestione di oggetto, IMP_MODIF permette di gestire delle azioni supplementari). L'azione IMP_DEFTRT permette di riassegnare, se necessario, la variabile TRTMSK, che definisce il nome del programma automatico definito nel dizionario delle videate.

L’azione IMP_SETBOUT è utilizzata per completare le opzioni di gestione dell'oggetto: è possibile che si debba fare una Call VIREBOUT in import per vietare ad esempio la creazione, ed agire generalmente sulla variabile CHAINE che contiene tutte le opzioni.

Oggetto combinato

Oggetto riquadro

Le azioni del programma IMPxxx

Tutte le azioni IMPxxx hanno lo stesso contesto di quelle di SUBxxx e vengono richiamate dopo.

Le azioni seguenti sono particolari.

l’azione IMPORT

L'azione IMPORT è richiamata dopo ciascuna lettura di record.

La variabile IMPFIC contiene l'abbreviazione del file importato. La classe corrispondente è disponibile (per le informazioni effettivamente importate).

Nel caso di un riquadro, la variabile nolign è inizializzata a 0, e sarà utilizzata in uscita per sapere quale riga viene inserita. Se nolign è lasciata a zero, sarà creata una nuova riga.

l’azione IMP_TAB

L'azione IMPORT è utilizzata per gestire i campi di una tabella secondaria raggruppati in un riquadro (la pagina 3 dell'oggetto definisce a questo scopo le tabelle secondarie, le videate e le variabili di fondo riquadro corrispondenti). Questo permette di distinguere i campi non indicizzati che devono essere posizionati in un riquadro degli altri campi. Questa azione è utilizzata solo per gli import di oggetto di tipo normale.

Azione IMP_ZONE

L'azione IMP_ZONE è richiamata al posto dell'inserimento di un campo, essa permette di recuperare un valore in una videata che nel file avrebbe un nome diverso (es: caso dei campi dimensionati in una tabella che corrisponde a più colonne di un riquadro):

• La variabile IMPFIC contiene l’abbreviazione del file che ha provocato l'inserimento.
• La variabile IMPMSK contiene il nome della videata in corso di inserimento.
• La variabile IMPZON contiene il nome del campo in corso di inserimento.
• La variabile IMPMOD, preposizionata a 0 permette di attivare l'azione di après_modif.
• La variabile OK, inizializzata a 1 permette o meno di attivare l'azione standard.

Azione MOD_IMPORT

L’azione MOD_IMPORT serve solo in import di un oggetto riquadro (per vietare eventualmente questo import).

Il programma di import specifico

Questo programma di import bypassa (in generale per ragioni di prestazioni) la gestione standard d'oggetto e include solo un numero limitato di label richiamate da Gosub dalla funzione di import. Queste label sono definite qui di seguito:

Si consiglia di realizzare questa modalità di import solo se si pongono dei particolari problemi di prestazioni. Infatti, anche se è più pesante, l'import "standard" d'oggetto permette di ottenere un controllo automatico includendo tutto ciò che è descritto nella logica d'oggetto, mentre il programma di import specifico necessita di ricodificare tutto a mano, richiamando eventualmente dei componenti esistenti.

File di trascodifica

Principio della trascodifica

Nel modello di import o di un export, ADONIX X3 riceve un flusso di dati in in set di caratteri che non è obbligatoriamente il set di caratteri interno (corrispondente al set di caratteri WE8ISO8951P1 in oracle). E' necessario essere in grado di trascodificarlo. Attenzione, si parlerà in questa documentazione solo di trascodifica di caratteri memorizzati su un byte corrispondenti in generale a caratteri accentati o specifici di alcune lingue occidentali. Questi caratteri sono normalmente codificati in un byte con valori compresi tra 160 e 250. Qui di seguito, si troveranno le corrispondenze tra questi caratteri ed i codici ascii del set standard utilizzati da ADONIX X3 (visualizzati con un font di tipo Arial).

Ciò si fa per mezzo del campo Set di caratteri nel riquadro di trascodifica. Il campo in questione assume dei valori definiti dal menù locale 9. Questo menù locale non è parametrizzabile di default, ma è possibile aggiungervi dei valori in sviluppo, per gestire nuovi set di caratteri esterni.

A ciascun valore di questo menù locale corrisponde un file esterno, installato sul server, che definisce le trascodifiche da realizzare. Questo file si trova nella directory SYS del dossier X3, e ha come nome TRANS#.cnv, dove # corrisponde al numero del menù locale (1, 2, 3…). Il file TRANS0.cnv contiene dei commenti che spiegano (in inglese) il modo di procedere:

• Si definiscono innanzitutto due righe sulle quali si indica:

adonix="stringa1"
output="stringa2"

stringa1 e stringa2 sono prefissi su 3 caratteri che definiscono il codice del set che si vuole definire. Ad esempio, si potrà usare ado per la stringa 1, e set per il secondo set di caratteri.

• In seguito, si definiscono innanzitutto delle righe per definire ciascun carattere attribuendogli una mnemonica identica (che sarà prefissata da stringa1 o stringa2), seguito da un segno di uguaglianza e dal codice del carattere. Ad esempio, se si definisce con eacuta la e accento acuto, immaginiamo che questo carattere sia trascodificato nel set di caratteri finale set con il codice decimale 238 (è codificato 233 nel set ado). Verranno allora scritte le due righe seguenti:

adoeacuta="238"
seteacuta="233"

E' importante osservare che:

• i doppi apici non sono obbligatori (si sarebbe potuto scrivere adoeacuta=238).
• i codici possono anche essere forniti in formato ottale sotto forma di \nnn, ed in formato esadecimale sotto forma di Hxx.
• l'ordine in cui le righe sono presentate ha poca importanza (si può innanzitutto definire la totalità dei caratteri di un set, poi quella del set seguente, oppure abbinare i caratteri due a due, o usare qualsiasi altro ordine).
• i caratteri non descritti (o descritti in un set senza esserlo nell'altro) non saranno trascodificati.
• possono essere liberamente inserite o aggiunte delle righe di commento, purchè siano precedute dal carattere #.

Esempio di file: TRANS0.cnv

Si troverà qui di seguito il contenuto del file TRANS0.cnv, che spiega in inglese come usarlo:

#
########################################################################
#
# trans0.cnv
#
# Transcodification file used for ADONIX X3 import/export
#
# Each line (except the comments prefixed by # ) must have the following format
#
# adoxxxxx = value1 or extxxxxx = value2
#
# (ado for adonix internal code, ext for "external" file code
#
# xxxxx is an identifier used to associate external & internal code together
#

# values can be defined in following formats :
#
# nnn or "nnn"         value in decimal
# \nnn or "\nnn"       value in octal
# Hnnn or "Hnnn"       value in hexadecimal
#
# Author : Bertrand YVINEC   
# Translated by Dominique BOPP
#
# Copyright (c) ADONIX 1992-2001
#
########################################################################
#
# Identifier definition (default is ado and ext)
#
adonix = "iso"
output = "ibm"

Esempio di file: TRANS2.cnv

Questo file permette di trascodificare nel set IBM PC. Il file è stato ripulito dalla maggior parte delle righe di commento.

#
########################################################################
# trans2.cnv
# Copyright (c) ADONIX 1992-2001
########################################################################
adonix = "iso"
output = "ibm"
#
# ISO code first
isoagr="\340"    # a grave
isoeai="\351"    # e acute
isoegr="\350"    # e grave
isocce="\347"    # c cedilla
isougr="\371"    # u grave
isodeg="\260"    # degree
isoali="\247"    # alinea
isoaci="\342"    # a circumflex
isoeci="\352"    # e circumflex
isoici="\356"    # i circumflex
isooci="\364"    # o circumflex
isouci="\373"    # u circumflex
isoatr="\344"    # a dieresis
isoetr="\353"    # e dieresis
isoitr="\357"    # i dieresis
isootr="\366"    # o dieresis
isoutr="\374"    # u dieresis
isopou="\243"    # pound
#
# Ensuite en code PC
ibmagr="\205"    # a grave
ibmeai="\202"    # e acute
ibmegr="\212"    # e grave
ibmcce="\207"    # c cedilla
ibmugr="\227"    # u grave
ibmdeg="\370"    # degree
ibmali="\365"    # alinea (CP 850)
ibmaci="\203"    # a circumflex
ibmeci="\210"    # e circumflex
ibmici="\214"    # i circumflex
ibmoci="\223"    # o circumflex
ibmuci="\226"    # u circumflex
ibmatr="\204"    # a dieresis
ibmetr="\211"    # e dieresis
ibmitr="\213"    # i dieresis
ibmotr="\224"    # o dieresis
ibmutr="\201"    # u dieresis
ibmpou="\234"    # pound

Import silenziosi

Principio della chiamata

Se si desidera attivare direttamente un import in un programma, è possibile procedere inserendo le seguenti righe:

If !GSERVEUR
    Call OUVRE_TRACE(TIT) From LECFIC
Endif
Call IMPORTSIL([L]COD_MODELE,[L]NOM_FICHIER)from GIMPOBJ
If !GSERVEUR
    Call FERME_TRACE From LECFIC
Endif

 Dove

• [L]COD_MODELE=Variabile contenente il codice del modello di import
• [L]NOM_FICHIER=Variabile contenente il nome completo del file da importare

Variabili interessate

Le variabili passate in argomento sono le seguenti:

• [L]COD_MODELE=Variabile contenente il codice del modello di import
• [L]NOM_FICHIER=Variabile contenente il nome completo del file da importare

Lo stato di fine dell'import è contenuto nel campo [M:IMP2]STAT
E' possibile avere il testo esteso del messaggio legato all'errore chiamando il seguente sotto-programma:

Call ERR_IMPORT([M:IMP2]STAT,MESSAGE) From GIMPOBJ