Negli esempi precedenti abbiamo utilizzato delle variabili assegnando direttamente dei valori, ad esempio:
In uno script reale, però, normalmente non interessa utilizzare valori fissi. È molto più utile recuperare le informazioni direttamente da Ready Pro, in modo che il risultato cambi in base all'articolo, al cliente o all'elemento che il programma sta elaborando.
Come è possibile recuperare questi valori?
Ready Pro mette a disposizione degli script degli oggetti.
CodiceArticolo = "ART001"
Descrizione = "Stampante laser a colori"
In uno script reale, però, normalmente non interessa utilizzare valori fissi. È molto più utile recuperare le informazioni direttamente da Ready Pro, in modo che il risultato cambi in base all'articolo, al cliente o all'elemento che il programma sta elaborando.
Come è possibile recuperare questi valori?
Ready Pro mette a disposizione degli script degli oggetti.
Che cos'è un oggetto
Un oggetto rappresenta, all'interno dello script, un elemento gestito da Ready Pro.
Ad esempio:
Product rappresenta un articolo;
Anag rappresenta un'anagrafica, ad esempio un cliente o un fornitore.
Doc rappresenta un documento, come un ordine cliente o una fattura
Repair rappresenta una scheda di riparazione
e così via.
L'oggetto identifica quindi l'elemento sul quale si sta operando.
Per recuperare una specifica informazione relativa a quell'elemento si utilizzano invece le proprietà.
Un oggetto rappresenta, all'interno dello script, un elemento gestito da Ready Pro.
Ad esempio:
Product rappresenta un articolo;
Anag rappresenta un'anagrafica, ad esempio un cliente o un fornitore.
Doc rappresenta un documento, come un ordine cliente o una fattura
Repair rappresenta una scheda di riparazione
e così via.
L'oggetto identifica quindi l'elemento sul quale si sta operando.
Per recuperare una specifica informazione relativa a quell'elemento si utilizzano invece le proprietà.
Che cos'è una proprietà
Una proprietà permette di recuperare una specifica informazione da un oggetto.
Ad esempio, l'oggetto Product dispone della proprietà Code, che restituisce il codice dell'articolo, e scriveremo
per visualizzare o stampare il valore corrispondente
Il carattere punto separa il nome dell'oggetto dal nome della proprietà.
L'espressione:
può quindi essere letta come: "la proprietà Code dell'oggetto Product"
Ogni oggetto mette a disposizione numerose proprietà.
Alcuni esempi possono essere.
Product.Name che corrisponde alla descrizione principale dell'articolo
Product.Description e' la descrizione estesa
Product.QtyAvailable e' la quantità disponibile
ecc.
Una proprietà permette di recuperare una specifica informazione da un oggetto.
Ad esempio, l'oggetto Product dispone della proprietà Code, che restituisce il codice dell'articolo, e scriveremo
Response.Write( Product.Code )per visualizzare o stampare il valore corrispondente
Il carattere punto separa il nome dell'oggetto dal nome della proprietà.
L'espressione:
Product.Code
può quindi essere letta come: "la proprietà Code dell'oggetto Product"
Ogni oggetto mette a disposizione numerose proprietà.
Alcuni esempi possono essere.
Product.Name che corrisponde alla descrizione principale dell'articolo
Product.Description e' la descrizione estesa
Product.QtyAvailable e' la quantità disponibile
ecc.
Esempio sulla lista articoli
Riprendiamo l'esempio utilizzato nelle sezioni precedenti.
Invece di assegnare direttamente un codice e una descrizione:
possiamo recuperare questi valori dall'articolo che Ready Pro sta elaborando:
Se questo script viene utilizzato in un campo script della lista articoli, l'oggetto Product conterra per ogni singola riga i valori dell'articolo corrispondente
Di conseguenza:
restituisce il codice dell'articolo, mentre:
ne restituisce la descrizione principale.
Il risultato dello script sarà quindi diverso per ogni riga della lista, perché i valori vengono recuperati direttamente dall'articolo elaborato da Ready Pro.
Riprendiamo l'esempio utilizzato nelle sezioni precedenti.
Invece di assegnare direttamente un codice e una descrizione:
CodiceArticolo = "ART001"
Descrizione = "Stampante laser a colori"
possiamo recuperare questi valori dall'articolo che Ready Pro sta elaborando:
Option Explicit
Dim CodiceArticolo
Dim Descrizione
CodiceArticolo = Product.Code
Descrizione = Product.Name
Response.Write(CodiceArticolo & " - " & Descrizione)
Se questo script viene utilizzato in un campo script della lista articoli, l'oggetto Product conterra per ogni singola riga i valori dell'articolo corrispondente
Di conseguenza:
Product.Code
restituisce il codice dell'articolo, mentre:
Product.Name
ne restituisce la descrizione principale.
Il risultato dello script sarà quindi diverso per ogni riga della lista, perché i valori vengono recuperati direttamente dall'articolo elaborato da Ready Pro.
Esempio sulla lista clienti
Il funzionamento è lo stesso quando si lavora con altri tipi di dati.
Ad esempio, sulla lista clienti è possibile utilizzare l'oggetto Anag, che rappresenta l'anagrafica della riga elaborata.
La proprietà Name ovvero
permette di recuperare la ragione sociale dell'anagrafica:
Mentre ad esempio, la proprietà EmailAddress dell'oggetto Anag, ovvero
permette di recuperarne l'indirizzo email
È quindi possibile creare, ad esempio, uno script che visualizzi ragione sociale e indirizzo email concatenati
Anche in questo caso lo script è sempre lo stesso, ma il risultato cambia per ogni riga perché Anag rappresenta di volta in volta l'anagrafica che Ready Pro sta elaborando.
Il funzionamento è lo stesso quando si lavora con altri tipi di dati.
Ad esempio, sulla lista clienti è possibile utilizzare l'oggetto Anag, che rappresenta l'anagrafica della riga elaborata.
La proprietà Name ovvero
Anag.Name
permette di recuperare la ragione sociale dell'anagrafica:
Mentre ad esempio, la proprietà EmailAddress dell'oggetto Anag, ovvero
Anag.EmailAddress
permette di recuperarne l'indirizzo email
È quindi possibile creare, ad esempio, uno script che visualizzi ragione sociale e indirizzo email concatenati
Option Explicit
Dim RagioneSociale
Dim Email
RagioneSociale = Anag.Name
Email = Anag.EmailAddress
Response.Write(RagioneSociale & " - " & Email)
Anche in questo caso lo script è sempre lo stesso, ma il risultato cambia per ogni riga perché Anag rappresenta di volta in volta l'anagrafica che Ready Pro sta elaborando.
Oggetto e proprietà lavorano insieme
Il meccanismo utilizzato negli esempi precedenti può essere rappresentato in forma generale come:
L'oggetto identifica con quale elemento si vuole lavorare, mentre la proprietà identifica quale informazione si vuole recuperare da quell'elemento.
Ad esempio:
indica il codice dell'articolo rappresentato da Product, mentre:
indica l'indirizzo email dell'anagrafica rappresentata da Anag.
Oggetti diversi mettono a disposizione proprietà diverse, in base alle informazioni che possono essere recuperate dall'elemento rappresentato.
A questo punto nasce però una nuova domanda: è possibile utilizzare Product, Anag e gli altri oggetti in qualsiasi script?
La risposta è NO.
Gli oggetti disponibili dipendono dalla procedura e dal punto di Ready Pro nel quale lo script viene eseguito.
Per comprendere quali oggetti possono essere utilizzati è quindi necessario introdurre un altro concetto fondamentale: il contesto dello script.
Il meccanismo utilizzato negli esempi precedenti può essere rappresentato in forma generale come:
Oggetto.ProprietàL'oggetto identifica con quale elemento si vuole lavorare, mentre la proprietà identifica quale informazione si vuole recuperare da quell'elemento.
Ad esempio:
Product.Code
indica il codice dell'articolo rappresentato da Product, mentre:
Anag.EmailAddress
indica l'indirizzo email dell'anagrafica rappresentata da Anag.
Oggetti diversi mettono a disposizione proprietà diverse, in base alle informazioni che possono essere recuperate dall'elemento rappresentato.
A questo punto nasce però una nuova domanda: è possibile utilizzare Product, Anag e gli altri oggetti in qualsiasi script?
La risposta è NO.
Gli oggetti disponibili dipendono dalla procedura e dal punto di Ready Pro nel quale lo script viene eseguito.
Per comprendere quali oggetti possono essere utilizzati è quindi necessario introdurre un altro concetto fondamentale: il contesto dello script.
