Definizione Procedure

Nome programma: BSIEPROC.DLL
Moduli richiesti: Qualsiasi

Le procedure sono delle porzioni di codice Visual Basic Script che l'utente può impostare, allo scopo di eseguire delle operazioni sui dati non previste o particolari. Possono avere 2 funzionalità:

• attribuire un valore ad un campo, in questo caso la procedura sarà una funzione che restituirà un dato del tipo che il campo di destinazione accetta;
• eseguire operazioni particolari prima o dopo aver scritto tutti i record, prima o dopo l'entrata in una relazione fra tabelle oppure prima o dopo la scrittura di un record.

Esistono 4 differenti tipi di procedure, le quali hanno diverse modalità di definizione e impiego:

1. Function: sono procedure, racchiuese fra le parole chiave Function - End Function, devono restituire in uscita un valore.
2. Sub: sono procedure, racchiuse fra le parole chiave Sub - End Sub, che non restituiscono valori ma eseguono solo delle operazioni.
3. Expression: è una espressione che, in seguito alla valutazione, restituisce un risultato il cui tipo è lo stesso di quello dei componenti la espressione.
4. SQL Query: è una istruzione SQL di comando (UPDATE, INSERT o DELETE) che viene fatta eseguire sul database di destinazione; non utilizza lo Script Engine.

Funzioni e espressioni possono essere utilizzate nella corrispondenza campi per attribuire un valore ad un campo in fase di impostazione di un profilo di import/export.

Le variabili utilizzabili all'interno delle procedure

Esistono delle variabili, oggetto e non, che possono essere utilizzate all'interno delle procedure. Queste variabili sono valide in qualsiasi momento:

• gstrDir: una stringa contenente il percorso dove è presente il database dell'azienda;
• gstrRptDir: una stringa contenente il percorso dove sono presenti i report di Business;
• gstrOfficeDir: una stringa contenente il percorso dove sono contenuti i file di Microsoft Office;
• gstrPrcDir: una stringa contenente il percorso del database di procedura (ARCPROC) di Business;
• gstrCmdDir: una stringa contenente il percorso del database di servizio COMBO;
• gstrPrcConnect: una stringa contenente la stringa di connessione al database di procedura;
• gstrPrcDataType: una stringa contenente il tipo di database di procedura (solitamente "Access");
• gstrPrcSubDataType: una stringa contenente il sottotipo del database di procedura ARCPROC;
• gstrCmbDataType: una stringa contenente il tipo di database COMBO;
• gstrCmbSubDataType: una stringa contenente il sottotipo del database COMBO;
• gstrOpNome: una stringa contenete il nome dell'operatore che è entrato in Business;
• gstrPasswd: una stringa contenete la password d'ingresso dell'operatore;
• gstrCodazi: una stringa contenente il codice dell'azienda correntemente aperta;
• gstrExt: una stringa contenente l'estensione del database dell'azienda aperta;
• gstrPrefix: una stringa contenente il prefisso delle tabelle dell'azienda aperta;
• gstrConnect: una stringa contenente la stringa di connessione per accedere al database dell'azienda;
• gstrDataType: una stringa contenente il tipo di database dell'azienda corrente;
• gstrSubDataType: una stringa contenente il sottotipo del database dell'azienda aperta;
• gstrDirCodazi: una stringa che assume i valore "LIT" o "EUR" che indica quale unità di conto monetaria è corrente nell'azienda aperta (Lire italiane o Euro);
• gwsJet: è una variabile oggetto di tipo DAO.Workspace che referenzia l'area di lavoro del motore Jet;
• gwsODBC: è una variabile oggetto di tipo DAO.Workspace che referenzia l'area di lavoro del motore Jet relativa alle connessioni ODBCDirect;
• gdbCmb: è una variabile oggetto di tipo DAO.Database che referenzia il database aperto COMBO presente nell'area di lavoro gwsJet;
• gdbAP: è una variabile oggetto di tipo DAO.Database che referenzia il database procedura aperto ARCPROC presente nell'area di lavoro gwsJet;
• gcnAP: è una variabile oggetto di tipo DAO.Connection che referenzia la connessione eventualmente aperta al database procedura ARCPROC presente nell'area di lavoro gwsODBC, è impostata solamente se la variabile gstrPrcSubDatatype è diversa da "(Nessuno)";
• gdb: è una variabile oggetto di tipo DAO.Database che referenzia il database dell'azienda aperto, presente nell'area di lavoro gwsJet;
• gcn: è una variabile oggetto di tipo DAO.Connection che referenzia la connessione eventualmente aperta al database dell'azienda, presente nell'area di lavoro gwsODBC, è impostata solamente se la variabile gstrSubDatatype è diversa da "(Nessuno)";
• objStd: è una variabile oggetto di tipo BS—STD.CLS—STD che referenzia l'oggetto di Business contenete tutte le più comuni proprietà e metodi utilizzati dal programma;
• IenDbExt: è una variabile oggetto di tipo DAO.Database che referenzia il database esterno aperto in import o export; n è il numero di livello;
• IenNomeDbExt: è una variabile stringa contenente il nome del database esterno utilizzato per l'import/export; la stringa contiene il nome del database con l'estensione e la path; ; n è il numero di livello;
• IenNomeFileExt: è una variabile stringa contenente il nome del file ASCII esterno utilizzato per l'import/export; la stringa contiene il nome del file con l'estensione e la path; ; n è il numero di livello;
• glProfilo: è una variabile contenente il numero del profilo in esecuzione
• IenNomeTabIn: è una variabile contenente il nome della tabella da cui leggere i dati; n è il numero di livello;
• IenNomeTabOu: è una variabile contenente il nome della tabella in cui scrivere i dati; n è il numero di livello;
• IenSqlWhere: è una variabile contenente la clausola where quando il tipo filtro impostato per il processo è di tipo "esteso"; n è il numero di livello;
• IECancelRow: è una variabile usata in BeforeInsert e BeforeUpdate: se impostata = true, la riga che si sta trattando non verrà salvata nel database;
• IECancelRel: è una variabile usata in BeforeInsert e BeforeUpdate: se impostata = true, la relazione tra la tabella in analisi e quelle in 'relazioni tabelle' non viene applicata: (ex: relazione testmag -> movmag: non apre il processo di scrittura di movmag);
• IECancelAll: è una variabile che se in una routine viene impostata = true, al termine della routine l'importazione termina;

Un'altra categoria di variabili, utilizzabili all'interno delle procedure, sono quelle che contengono i valori dei campi del record di origine e quelle che contengono i valori dei campi di destinazione, mano a mano che vengono calcolati. Particolare attenzione è da prestare alla validità dei dati contenuti in questi variabili, soprattutto quelle che contengono i valori di destinazione. Queste variabili sono utili per eseguire operazioni particolare mediante le procedure, effettuare dei calcoli fra campi, ecc.

Le variabili che contengono i valori dei campi di origine, sono definite con il nome IeIn(Livello relazione)(Nome campo) dove (Livello relazione) è un numero che identifica il livello di relazione fra le corrispondenze tabelle (da 1 a 6 possibili livelli di relazione) e (Nome campo) è il nome del campo del record di origine. Le variabili che contengono i valori dei campi di destinazione, sono definite con il nome IeOu(Livello relazione)(Nome campo) dove (Livello relazione) è un numero che identifica il livello di relazione fra le corrispondenze tabelle e (Nome campo) è il nome del campo di destinazione; ad esempio la variabile contenente il codice del cliente di Business, durante l'esportazione di un documento di magazzino, sarà IeIn1tm_conto, la variabile che contiene il codice dell'articolo di Business sarà IeIn2mm_codart mentre la variabile che contiene lo stesso codice articolo, ma sulla destinazione, sarà IeOu2articolo.

Le variabili oggetto contenenti il nome del database esterno (Solo per tabelle esterne di tipo MSAccess) sono definite come Ie(Livello relazione)DbExt dove (Livello relazione) è un numero che identifica il livello di relazione fra le corrispondenze tabelle (da 1 a 6 possibili livelli di relazione); ad esempio il primo database esterno aperto per un export sarà Ei1DbExt.

La variabile Ie(n)SqlWhere (dove -n- è il numero del livello di releazione) contiene la clausola where quando il tipo filtro impostato per il processo è di tipo "esteso", fornito cioè dell'utente. La variabile di tipo stringa è modificabile unicamente all'interno dello script associato all'evento "Initialize" per sovrascrivere l'ventuale filtro fonito dal cliente. la variabile vale "" (stringa vuota) quando la tipologia di filtro della corrispondenza tabella è diversa da "filtro esteso".

Validità delle variabili IeIn... e IeOu...

Le variabili di nome IeInnNomeCampo vengono impostate prima di trattare ogni record di origine e sono valide fino a quando non si passa al record successivo. Le variabili IeOunNomecampo vengono impostate dopo le precedenti, nell'ordine indicato nella 'Corrispondenza campi'. Esempio di esportazione documenti di magazzino:

NomeCampo (ValoreCampo) VariabileIe...NomeCampo (ValoreCampo) VariabileIe...

ORIGINEDESTINAZIONE

(1° record – livello di relazione 1)

1. Tipo docum. ("B") IeIn1tm_tiporkTipo docum. ("B") IeOu1tipo

2. Anno docum. (1998) IeIn1tm_annoAnno docum. (1998) IeOu1anno

3. Numero docum. (156) IeIn1tm_numdocNumero docum. (156) IeOu1numero

......

(1° record livello di relazione 2)

1. Riga (1) IeIn2mm_rigaRiga (1) IeOu2riga

2. Codice articolo ("A152") IeIn2mm_codartCodice articolo ("PRN34") IeOu2codice

3. Descr. articolo ("Stamp. HP") IeIn2mm_descrDescr. articolo ("Stamp. HP") IeOu2descr

4. Quantià (10) IeIn2mm_quantQuantità (10) IeOu2quant (*)

5. Sconto 1 (8,50) IeIn2mm_scont1Sconto (8,50) IeOu2sconto

......

(2° record livello di relazione 2)

1. Riga (2) IeIn2mm_rigaRiga (2) IeOu2riga

2. Codice articolo ("B153") IeIn2mm_codartCodice articolo ("MOU20") IeOu2codice

3. Descr. articolo ("Mouse GH") IeIn2mm_descrDescr. articolo ("Mouse GH") IeOu2descr

4. Quantià (19) IeIn2mm_quantQuantità (19) IeOu2quant (**)

5. Sconto 1 (5) IeIn2mm_scont1Sconto (5) IeOu2sconto

......

...

Il flusso del programma, va dall'alto al basso, da destra verso sinistra; nel momento in cui il programma determina il valore di destinazione del campo quantità del primo record (*), tutte le variabili IeOu1.. (i campi testata) sono impostate come del resto le variabili IeOu2riga, IeOu2codice e IeOu2descr, la variabile IeOu2sconto NON è ancora impostata perché successiva; in questo momento la variabile ha valore Empty. Nel momento (**), invece, le variabile IeOu2sconto contiene un dato inattendibile perché si riferisce allo sconto attribuito nella riga precedente.

A seguire sono indicate alcune restrizioni note imposte al linguaggio VBA per l'uso nello Script Engine:

• le procedure che si creano non devono possedere argomenti di tipo Optional o ParamArray.
• non si possono dichiarare funzioni di DLL esterne (Declare), Property Get, Property Let, Property Set.
• non si possono dichiarare variabili Static o variabili oggetto con New.
• non è possibile dichiarare tipi dati utente mediante Type ... End Type.
• non è possibile utilizzare #Const, #If ... Then ... #Else ... #End If.
• non è possibile utilizzare Option Base per dichiarare il 1° elemento degli array; tutte gli array dichiarati hanno, come primo indice, 0 (zero); Deftype, Option Compare, Option Private Module.
• non è possibile utilizzare le istruzioni Date, Time e Timer.
• nei costrutti Select Case non è possibile utilizzare la parola chiave Is, ogni altro operatore di confronto oppure una espressione contenete un range di valori utilizzando la parola chiave To.
• non è possibile utilizzare tutte le funzioni e i metodi del DDE: LinkExecute, LinkPoke, LinkRequest, LinkSend.
• non è possibile utilizzare Debug.Print, Debug.Assert, End, Stop.
• le variabili sono implicitamente dichiarate.
• le variabili, sia oggetto che non, possono essere dichiarate solo di tipo Variant.
• non è possibile utilizzare le funzioni VB tipizzate (Left$(), Rigth$(), ecc.), utilizzare le corrispondenti non tipizzate (Left(), Rigth(), ecc.)
• non si possono utilizzare le funzioni Cvar, CVDate, Str, Val, Lset, Rset, Mid, StrConv, stringhe a lunghezza fissa.
• non è possibile utilizzare le costanti enumerate (vbDefault, dbOpenSnapshot, ecc.) utilizzare i valori corrispondenti.
• non è possibile intercettare gli eventi che gli oggetti eventualmente lanciano.
• non è possibile utilizzare salti incondizionati Goto, GoSub ... Return, On Error GoTo, On ... GoSub, On ... GoTo, numeratori di linea, etichette di linea (Label), With ... End With.
• Per la gestione errore non è possibile utilizzare: Erl, Error, On Error ... Resume, Resume, Resume Next.
• non è possibile utilizzare tutte le funzioni di I/O sui file (Open, Write, ecc.)
• non è possibile utilizzare tutte le funzioni finanziarie.
• non è possibile utilizzare l'operatore Like, l'oggetto Clipboard, l'oggetto Collection, e la parola chiave TypeOf.
• gli elementi di una collezione possono essere referenziati non con il ! ma con il nome della chiave; per i Recordset si può utilizzare snaTmp("nome_campo") e non snaTmp!nome_campo.

Elenco procedure

Codice

è un campo numerico univoco che identifica una procedura. I codici compresi tra 1 e 1000 sono riservati NTS per l'introduzione di profili standard di importazione/esportazione futuri; codici superiori a 1000 sono disponibili all'utente.

Descrizione

Rappresenta la descrizione della procedura (di max 50 caratteri) Come il codice, anche la descrizione della procedura deve essere univoca.

Tipo procedura

è il tipo della procedura. Può assumere 4 valori:

• Function: sono procedure, racchiuese fra le parole chiave Function - End Function, devono restituire in uscita un valore.
• Sub: sono procedure, racchiuse fra le parole chiave Sub - End Sub, che non restituiscono valori ma eseguono solo delle operazioni.
• Expression: è una espressione che, in seguito alla valutazione, restituisce un risultato il cui tipo è lo stesso di quello dei componenti la espressione.
• SQL Query: è una istruzione SQL di comando (UPDATE, INSERT o DELETE) che viene fatta eseguire sul database di destinazione; non utilizza lo Script Engine.

Solo procedure di tipo Sub o Function sono precaricabili all'avvio.

Precarica

è un flag che indica se precaricare la procedura all'avvio del processo di Import/Export oppure caricare la procedura nello Script Engine immediatamente prima dell'uso. Procedure che hanno un uso frequente è consigliabile precericarle.

Proc. in Vb.Net

Indicare con tale spunta se la procedura è definita in linguaggio VBScript o VB.NET. Tale spunta è molto importante in quanto i profili che utilizzano il motore NET possono usare solo procedure VB.NET, mentre i profili in Classic Start solo procedure in VBScript. Inoltre con questa spunta ora le procedure da eseguire per gli alert scritti in .NET possono essere anche all'interno dell'archivio procedura (anzichè su script), come erano le procedure in VBScript di Classic Start, l'importante è che abbiano la spunta su Proc. in Vb.Net. La sintassi da utilizzare è la stessa di quella delle procedure per import/export in VB.NET mentre la funzione che deve essere eseguita deve avere i parametri come le funzioni che erano presenti nel file esterno, per esempio: Function ProvaAlert(byref oApp as CLE__APP, byval strCodditt as string, byref dttMsgOutParam as DataTable) as boolean

Il flag Proc. in Vb.Net è corretto impostarlo solo per procedure di tipo Sub o Function in quanto il profilo se fa uso del motore NET tratta solo queste.

Negli script, per aggiungere degli 'Imports' e/o dei 'Reference' occore utilizzare la seguente sintassi (devono essere scritti fuori dalle function/sub):

	<reference assembly="BN__STD.dll" />

	Imports NTSInformatica.CLN__STD

Gli imports passati per default dal framework di busnet sono:

	Imports Microsoft.visualbasic
	Imports System
	Imports System.Collections
	Imports System.Data
	Imports NTSInformatica
	Imports NTSInformatica.CLN__STD

L'oggetto script di net (oScrIe) ha come variabile globale:

• 'DATAIN' (di tipo dataset) che contiene i datatable da importare/esportare
• 'DATAOU' (di tipo dataset) che contiene la tabella/file che dovrà essere scritta in fase di export o la tabella di business in fase di import
• 'VARS' (di tipo hastable) che contiene le variabili globali (quelle che in bsieimex sono BsIeIn1Profilo, BsIeIn1CancelAll, ...) si accede alle variabili con il comando VARS!BsIeIn1Profilo, VARS!BsIeIn1CancelAll

Gli oggetti/variabili pubblici sempre disponibili in tutti gli script in .NET sono:

	oApp
	oMenu
	oCleComm
	DATAIN
	DATAOU
	VARS
	oCleImex

Gli oggetti/variabili pubblici disponibili SOLO nella routine TERMINATE in tutti gli script in .NET sono:

• glRigheTot = righe da elaborare considerando anche le relazioni
• glRigheElab = righe elaborateper considerando anche le relazioni
• glRigheIns = righe inserite considerando anche le relazioni
• glRigheUpd = righe aggiornate considerando anche le relazioni
• glRigheSalt = righe saltate considerando anche le relazioni
• glRigheErr = righe con errori considerando anche le relazioni
• lRigheTot = righe da elaborare per singolo livello
• lRigheElab = righe elaborateper singolo livello
• lRigheIns = righe inserite per singolo livello
• lRigheUpd = righe aggiornate per singolo livello
• lRigheSalt = righe saltate per singolo livello
• lRigheErr = righe con errori per singolo livello

Visto che in NET non si può utilizzare il componente AGDO, BEIEIMEX carica tra le procedure la RicalcolaOrd e la RicalcolaDoc. Che non fanno altro che istanziare beveboll/beorgsor e chiamare la funzione nuovodaimportexport. Esempio di come realizzare una chiamata tramite le nuove funzioni:

Corpo procedura

Normalmente l'editor delle procedure è disabilitato; per abilitarlo premere sul pulsante 'Modifica'. Terminata la modifica o l'inserimento della nuova procedura è possibile salvare o ripristinare il tutto; il pulsante controlla, se abilitato, consente di controllare la sintassi solo per procedure di tipo Sub, Function o Expression.