READDBOPTION
Permette di leggere le variabili di programma all'interno di una tabella della base dati, precedentemente scritta attraverso una @SAVEDBOPTION.
La specifica è stata realizzata per non perdere eventuali dati salvati con la @SAVEOPTION: se l'opzione non è presente sulla base dati, verrà ricercata su file system e convertita automaticamente su db.
Parametri
| Parametro | Definizione | I/O | Versione traduttore | SMP | |
|---|---|---|---|---|---|
| NOME | Stringa | ||||
| OPCFG | Intero | ||||
| VAR | Stringa | ||||
| DIR | Stringa | ||||
| GRUPPO | Intero | ||||
| OPERATORE | Intero | ||||
| STAZIONE | Intero | ||||
| DITTA | Intero | ||||
| PROFILO | Intero | ||||
| CODICEGRUPPO | Stringa | ||||
| CODICEDITTA | Intero | 31.2 | |||
| CODICEPROFILO | Stringa | ||||
| CODICEOPERATORE | Stringa | ||||
| OPZIONI | Collezione di SIOPZPROG | ||||
| PERPOSIZIONE | Intero | ||||
| ERRORE | Intero |
NOME
Permette d'indicare il nome del blocco di opzioni memorizzate su database.
Il parametro nome partecipa all'identificazione univoca delle opzioni su database.
Se non indicato, è obbligatorio indicare il parametro OPZIONI per ottenere la collezione di opzioni presenti su DB.
Dalla versione 25.3 può essere utilizzato insieme al parametro OPZIONI con una maschera, facendo uso del carattere '%' nell'attributo NOME per cercare opzioni che iniziano/contengono finiscono con una sequenza di caratteri.
OPCFG
Attivando il parametro verrà abilitata la possibilità d'inserire il gruppo e la ditta (all'interno dell'identificazione univoca delle opzioni su database), in base ai parametri impostati all'interno del SISMENU.
VAR
Identifica una delle variabili da leggere all'interno del singolo record su database.
Il parametro VAR potrà essere ripetuto a seconda di quante variabili si voglia leggere.
Dalla versione 24.5 è possibile utilizzare anche i campi di un oggetto. Però, qualora le opzioni da leggere provenissero da un unico oggetto, è consigliato utilizzare i metodi SERIALIZE/DESERIALIZE degli oggetti e poi indicare nel parametro VAR il blob ottenuto.
Per utilizzare un tipo dato oppure per usare la sintassi <oggetto>.<campo> nel parametro VAR, è necessario che l'oggetto o il tipo dato siano stati precedentemente inizializzati (ad es. tramite CLEAR()).
DIR
Il parametro partecipa all'identificazione univoca delle opzioni su database.
Dalla versione 26.0 può essere utilizzato insieme al parametro OPZIONI con una maschera, facendo uso del carattere '%' nell'attributo DIR per cercare opzioni che iniziano/contengono o finiscono con una sequenza di caratteri.
La lunghezza massima per il parametro DIR è di 128 caratteri.
GRUPPO
Attivando il parametro verrà inserito all'interno dell'identificazione univoca delle opzioni su database il gruppo corrente.
L'utilizzo del parametro esclude l'utilizzo del parametro CODICEGRUPPO
OPERATORE
Attivando il parametro verrà inserito all'interno dell'identificazione univoca delle opzioni su database l'operatore corrente.
L'utilizzo del parametro esclude l'utilizzo del parametro CODICEOPERATORE
STAZIONE
Attivando il parametro verrà inserita all'interno dell'identificazione univoca delle opzioni su database la stazione corrente.
DITTA
Attivando il parametro verrà inserita all'interno dell'identificazione univoca delle opzioni su database la ditta corrente.
L'utilizzo del parametro esclude l'utilizzo del parametro CODICEDITTA
PROFILO
Utilizzando il parametro verrà inserito all'interno dell'identificazione univoca delle opzioni su database il profilo corrente.
L'utilizzo del parametro esclude l'utilizzo del parametro CODICEPROFILO
CODICEGRUPPO
Utilizzando il parametro verrà inserito all'interno dell'identificazione univoca delle opzioni su database il gruppo indicato.
CODICEDITTA
Utilizzando il parametro verrà inserito all'interno dell'identificazione univoca delle opzioni su database il codice della ditta indicata.
CODICEPROFILO
Utilizzando il parametro verrà inserito all'interno dell'identificazione univoca delle opzioni su database il profilo indicato.
CODICEOPERATORE
Utilizzando il parametro verrà inserito all'interno dell'identificazione univoca delle opzioni su database l'operatore indicato.
OPZIONI
Permette di reperire un elenco di opzioni salvate sul database, utilizzando gli altri parametri come filtri di ricerca. Il parametro esclude l'utilizzo del parametro VAR.
Viene restituita una collezione di tipo SIOPZPROG contenente un elenco di oggetti che rappresentano le singole opzioni salvate su DB.
Dalla versione 25.3 può essere utilizzato insieme al parametro NOME con una maschera, facendo uso del carattere '%' nel NOME per cercare opzioni che iniziano/contengono o finiscono con una sequenza di caratteri.
Dalla versione 26.0 può essere utilizzato insieme al parametro DIR con una maschera, facendo uso del carattere '%' nel DIR per cercare opzioni che iniziano/contengono o finiscono con una sequenza di caratteri.
L'utilizzo del parametro esclude l'utilizzo del parametro VAR
PERPOSIZIONE
Permette di impostare la modalità di acquisizione delle variabili salvate sul database.
Se il parametro non viene specificato l'acquisizione delle variabili avviene per nome, ovvero ogni singola variabile specificata nei parametro VAR viene ricercata per nome.
Se invece il parametro viene specificato, la specifica non esegue controlli tra i nomi delle variabili salvate sul database e i nomi delle variabili di programma in cui tenta di inserire il valore, ma fa riferimento esclusivamente alla loro posizione.
ERRORE
Consente al programma di intercettare e gestire l'errore restituito dalla funzione.
Utilizzare uno dei metodi GetLastError*() della classe BCContextInfo per ottenere le informazioni dell'errore.
Errori
| Codice | Descrizione |
|---|---|
| 88 | Tipi non coerenti tra variabili lette e quelle specificate nei parametri VAR |
| 26010 | Il numero di variabili del file opzioni è diverso dal numero di variabili dei parametri VAR |
| 26011 | I parametri VAR contengono delle variabili che non si trovano sul file |
| 26014 | Record non presente all'interno della base dati, e file xml di conversione non presente |
Esempi
Definizione con maschera sul parametro NOME
' Collezione di opzioni
DIM OpzColl[CLASSE[SIOPZPROG] COLLEZIONE]
' Lettura delle opzioni con maschera (%) sul nome dell'opzione
'@READDBOPTION NOME["<NomeOpzione>%"] DIR["<NomeDirectory>"] OPZIONI[OpzColl]
Definizione con maschera sul parametro DIR
' Collezione di opzioni
DIM OpzColl[CLASSE[SIOPZPROG] COLLEZIONE]
' Lettura delle opzioni con maschera (%) sulla directory dell'opzione
'@READDBOPTION NOME["<NomeOpzione>"] DIR["<NomeDirectory>%"] OPZIONI[OpzColl]