EVA - VARIABILI (Lato SERVER)

Obiettivo

Questo documento vuole definire un quadro chiaro sugli oggetti variabili lato Server di SmeUp/LoocUp e sulla loro gestione. Vuole rispondere alle seguenti domande: come si crea, come si utilizza, come può essere visionata e quali operazioni si possono fare su una variabile.
Oltre che illustrare i vantaggi del loro utilizzo.

Definizioni e Generalità

Occorre innanzi tutto precisare che le variabili Server sono oggetti di tipo V3EVA. Come tutte le istanze possono essere quindi visionate con i comandi UP FUN e UP OAV per conoscerne attributi, funzioni.


Esiste una categorizzazione delle variabili in base a chi le crea, alla visibilità o allo scopo e tale categorizzazione si traduce nel codice che identifica la variabile tramite un prefisso.

Categoria	Prefisso
Sistema B§V	_&_
Ambiente	_&_AM.
Contesto	_&_CO.
Istanza	_&_KI.
Configurazione Upp	_&_KU.
Data	_&_D8.
Variabili lunghe	_&_G00.
Oggetto	_&_OG.
Parametri	_&_PA.
Workflow	_&_AWF.
Sistema	_&_SY.
Collegamento	_&_CL.
Collegamento ambiente test	_&_CLT.

E' possibile inoltre fare le seguenti affermazioni:

• Fatta eccezione per le variabili di categoria Data e Variabili Lunghe, ogni variabile risiede in uno specifico contesto.
  
• Ad ogni variabile può essere assegnato un valore e il relativo oggetto di appartenenza.
  
• Una variabile può essere un alias di un'altra variabile o risolta attraverso il richiamo di un servizio.
  
• Ogni variabile inizia con _&_
  
• La variabile si intende chiusa quando incontra uno dei seguenti caratteri:
  
  • Spazio
    
  • ; Punto e virgola
    
  • ( Parentesi aperta
    
  • ) Parentesi chiusa
    
  • " Doppio apice
    
  • ' Apice
    
  • \ Barra rovesciata
    
  • = Uguale
    
  • < Minore
    
  • > Maggiore
    
  • _ Sottolineatura
    
  • | Pipe
    

Consideriamo la prima delle affermazioni fatte qua sopra:
Per ciascuna di queste categorizzazioni esiste un contesto associato...

Contesti

Il contesto è un'aggregazione logica di variabili, che permettono la condivisione delle stesse.

1. Nome
   
2. Descrizione
   
3. Attributi
   
4. Default
   
5. Oggetto
   
6. Libero
   

Il contestoDefaultpossiede e condivide con tutti gli altri contesti le variabili di ambientee di sistema che possono avere solo questo contesto; è riservato e non possiede attributi.
Il contestoOggettogestisce l'univocità fra oggetto e contesto impedendo una replicazione di variabili per lo stesso oggetto, è un contesto che possiede solo l'attributo OG.
Il contestoLiberogestisce tutte le altre casistiche, possiede attributi liberi definiti dall'utente.

In fase di sostituzione del valore delle variabili la ricerca viene fatta nel contesto specificato quindi nel contesto di default.

I lavori all'interno del nostro JOB possono accedere ai vari contesti risalendo per scansione di attributi, se trovati più contesti la ricerca fallisce.

Categorie

_&_ Sistema B§V

Queste variabili sono definite tramite la tabella B§V e non posseggono un oggetto di riferimento.

_&_AM. Ambiente

1. UT Utente (UP)
   
2. AZ Azienda (CNAZI)
   
3. DT Data sistema (D8*YYMD)
   
4. DF Data sistema formattata (D8*DMYY)
   
5. HR Ora sistema (I2D)
   

_&_CO. Contesto

Sono definite dal contesto in cui si usano. Possono possedere un oggetto e avere un contenuto di 256 caratteri e un nome di 26 caratteri.

_&_KI. Istanza

Sono variabili definite su un'istanza di un oggetto, non necessitano di essere dichiarate in quanto sono autoreferenziate.

Identificativo	Separatore	Oggetto	Separatore	Istanza	Separatore	Attributo	Separatore	Attributo
_&_KI	.	TABRA	.	ART	%	I/01	%	I/02
Obbligatorio	Obbligatorio	Obbligatorio	Obbligatorio	Obbligatorio	Facoltativo	Facoltativo	Facoltativo	Facoltativo

_&_KU. Configurazione Upp

Sono variabili definite sulla configurazione di una Upp, non necessitano di essere dichiarate in quanto sono autoreferenziate. Per la definizione della configurazione di un Upp si rimanda alla scheda dell'Upp (Oggetto SU).

Codice Upp	Separatore	Codice Campo Configuratore
_&_KU	.	A£_000	%	D01
Obbligatorio	Obbligatorio	Obbligatorio

_&_AWF. Workflow

1. NWF Numero ordine
   
2. TMS Tipo Oggetto master ordine
   
3. PMS Parametro Oggetto master ordine
   
4. OMS Oggetto master ordine
   
5. OOW Oggetto owner ordine
   
6. PRO Processo
   
7. SCP Script utilizzato
   
8. IMP Impegno (+ codice per definire la transazione)
   

_&_SY.Sistema

Sono variabili utilizzate per ritornare valori del sistema operativo

Identificativo	Separatore	Oggetto	Separatore	Oggetto	Separatore	Attributo	Separatore	Attributo	Nota
_&_SY.LIB	;	<File>	;	<Membro>	%	I/01	%	I/02	Ritorna la libreria dell'oggetto specificato
Obbligatorio	Obbligatorio	Obbligatorio	Facoltativo	Facoltativo	Facoltativo	Facoltativo	Facoltativo	Facoltativo

_&_CL.Collegamento

Sono le variabili definite nello script di collegamento (SCP_CLO)

_&_CLT.Collegamento ambiente di test

Sono le variabili definite nello script di collegamento (SCP_CLO).
Se in un ambiente normale coincidono con quelle di collegamento.
Se in un ambiente di test vengono restituite solo le variabili presenti negli script che terminano
con i caratterei '_T'

_&_D8. Data variabile

Sono date calcolate dinamicamente al momento dell'utilizzo.

1. U Def.utente (Pgm B£DAT8S_U)
   
2. O Da oggi +/- giorni/sett./mesi
   
3. C Da periodo contabile
   
4. Z Da segno zodiacale
   
5. T Da tabella date particolari (B£4)
   
6. S Settimana (Giorno/Anno scost.)
   

E' possibile definire il formato di output attraverso i seguenti valori

Codice	Formato	Esempio
.Y	YYYY/MM/DD	2009/05/18
.y	YYYYMMDD	20090518
.D	DD/MM/YYYY	18/05/2009
.d	DDMMYYYY	18052009

se non impostato viene assunto il valore .D.

_&_G00. Variabile Lunga

Le variabili lunghe permettono di gestire fino a 30000 caratteri, il limite di tutte le altre variabili è di 256 caratteri. Essendo più lunga del campo previsto per le altre variabili (£G91TV) è possibile impostarla tramite la funzione.metodo VAR.G00 inserendo il valore nel campo £G91SI, ma non è possibile utilizzarla negli altri metodi della funzione VAR, pertanto è possibile utilizzarla solo come traduzioni di stringa con output nel campo £G91SO, ma per esempio non è disponibile la lettura del suo contenuto tramite la funzione.metodo VAR.LET.
Le variabili lunghe sono utilizzabili anche nelle funzioni CND, con il limite di 256 caratteri, il resto del contenuto della variabile lunga viene ignorato.
Avendo la funzione.metodo specifica VAR.G00 non è necessario definirla come _&_G00.nomevariabile, pertanto la variabile pippo, non cominciando per _&_G00, viene comunque automaticamente tradotta in _&_G00.pippo.
Non sono variabili di contesto, pertanto se si necessita di eventuali aggregazioni logiche si consiglia attribuire l'aggregazione ai nomi delle variabili, per esempio _&_G00.contesto.variabile1, _&_G00.contesto.variabile2 ecc..
La gestione di queste variabili avviene tramite la G00, pertanto i relativi dati sono memorizzati temporaneamente nel B£MEDE0F, cancellati poi alla chiusura del lavoro.

_&_OG. Oggetto

1. FU Funzione
   
2. ME Metodo
   
3. CO Componente (J1GRA)
   
4. PA Stringa del parametro
   
5. Tx Tipo oggetto x (OG)
   
6. Px Parametro oggetto x (_&_OG.Tx)
   
7. Ex Tipo/Parametro oggetto x (OG)
   
8. Kx Codice Oggetto x (_&_OG.Tx_&_OG.Px)
   
9. Dx Sigificato Oggetto x
   

Assumiamo che il programma conosca tutte le variabili di una funzione nella forma F(programma;funzione;metodo) ecc.
Sono memorizzati fino a 6 oggetti quindi x assume i valori da 1 a 6.

_&_PA. Parametri

Una funzione può contenere una stringa che chiamiamo "parametro". All'interno del parametro possono essere definite delle variabili nella forma "Variabile(Valore)". Nello SCRIPT potremo riferirci alla singola variabile chiamandola _&_PA.Variabile

Gestione delle variabili

Attributi, variabile e espressione

Data una variabile, a cui è assegnato un oggetto, è possibile attraverso il carattere % accedere agli attributi dell'oggetto.
Poichè l'attributo è a sua volta un oggetto, è ammessa la ricorsione continuando la successione di definizioni tramite il carattere %.

Struttura di un'espressione

V%RA%RA%RA...%RA

Nome della Variabile	Separatore	Tipo di risposta	Attributo
V	%	R	A
Obbligatorio	Obbligatorio	Facoltativo	Obbligatorio se Tipo risorsa diverso da OV.

La definizione dell'attributo può continuare fino ad arrivare alla definizione richiesta.

1. OI. Intestazione
   
2. OA. Valore è il default e può essere omesso
   
3. EA. Elenco di tutti i valori
   
4. OD. Significato
   
5. ED. Elenco di tutti i significati
   
6. OT. Tipo oggetto
   
7. OP. Parametro oggetto
   
8. OO. Tipo e parametro oggetto
   
9. OV. Oggetto della variabile
   

All'elenco può essere attribuito un formato di ritorno, se non impostato assume una lista numerata.

1. 1 Separato da ;
   
2. Numerato x)
   

Assegnazione variabile

Utilizzando operatore "Doppiouguale" è possibile assegnare un valore ad una variabile; naturalmente il formato della variabile deve rispettare quanto definito in precedenza

Struttura libera

N d= O;V:S|A

• Nome della variabile N Obbligatorio
  
• Operatore Doppio uguale d= Facoltativo
  
• Oggetto in forma Tipo e parametro O Obbligatorio se definito Oggetto
  
• Separatore ; Obbligatorio
  
• Valore V Obbligatorio
  
• Separatore : Facoltativo
  
• Significato S Facoltativo
  
• Separatore (Pipe) "|" Facoltativo
  
• Alias A Facoltativo
  

Struttura tramite tag "VAR"

1. Tip Oggetto
   
2. Des Significato
   
3. Ali Alias
   
4. Name Nome
   
5. Val Valore
   
6. Pgm Funzione con cui risolviamo il valore
   

Se si utilizza un alias, da questo oltre al suo valore viene derivato anche l'oggetto a cui si riferisce e il suo significato.
Se si utilizza una funzione, questa restituisce solo il valore e non l'oggetto a cui si riferisce.

Esempi

Assumiano di avere nell'oggetto 1 il cliente e di voler recuperare l'aggregazione di appartenenza della propria nazione; possiamo utilizzare i seguenti metodi.

1. & OG.K1%I/15%I/T$V§NB "Attraverso gli attributi della variabile"
   
2. & CO.AG "Definendo come alias la variabile & OG.K1%I/15%I/T$V§NB"
   
3. & CO.AG%I/T$ELEM "Utilizzo l'alias per accedere all'attributo dell'aggregazione"
   

Variabili (Lato SERVER) - Esempio

Test/Simulazione

Nella scheda V3EVA è possibile eseguire delle simulazioni e dei test sull'assegnazione e la valutazione di variabili
Vedi Variabile (Lato server) (MBSCP_SCH-V3EVA)

Analisi dei contesti

In questa sottoscheda sono elencati tutti i contesti creati e le rispettive variabili

Assegnazione di una variabile a un contesto

La sottoscheda permette di creare un contesto assegnando un gruppo di variabili, estratte da una qualunque FUN
Contesto - Inserire un contesto nuovo o esistente
Funzione - Inserire una funzione: gli oggetti della funzione e tutti i paramentri e l'input verranno inseriti nel contesto

Creazione di una variabile

La sottoscheda permette di creare una variablile in un contesto, assegnando nome e valore
Contesto - Inserire un contesto esistente
Variabile - Inserire il nome della variabile
Valore - Inserire il valore da assegnare alla variabile

Risoluzione di una variabile

Dato un contesto, viene estratta un/a variabile del contesto
Contesto - Inserire un contesto esistente
Variabile - Inserire una variabile nella notazione & NOMEVARIABILE

Valutazione di espressioni

Dato un contesto, viene valutata un'espressione (anche detta "stringa")
Contesto - Inserire un contesto esistente
Espressione - Inserire una variabile nella notazione & NOMEVARIABILE%ATTRIBUTO%ATTRIBUTO%ATTRIBUTO