Funzioni generiche

Funzione

Significato

CASE(Exp,Val1,a,Val2,b,,,,n)

Corrisponde al costrutto:

CASE WHEN Exp=Val1 THEN a WHEN Exp=Val2 THEN b ... ELSE n

CASE2(Exp1,a,Exp2,b,,,,n)

Corrisponde al costrutto:

CASE WHEN (Exp1) THEN a WHEN (Exp2) THEN b ... ELSE n

dove l'espressione ExpN corrisponde a:

<NomeCampo> <operatore di confronto> <Valore>

CEIL(numeric)

Restituisce il più piccolo intero maggiore o uguale del numero indicato.

COMPANYCODE()

Restituisce il codice dell'azienda (carattere di 10).

CURRENTDATE()

Restituisce la data corrente.

CURRENTDATETIME()

Restituisce la data e ora corrente.

FLOOR(numeric)

Restituisce il più grande intero minore o uguale del numero indicato.

GLOBALVAR(gVar)

Restituisce il valore della variabile globale gVar.

LEN(Exp)

Ritorna la lunghezza di Exp.

MACRO(?Par)

Effettua la macro sostituzione del parametro <Par> nel punto dove viene inserita. Ad esempio possiamo creare una query parametrica in cui il nome della tabella su cui lavorare non è preso dalla lista; per fare una cosa del genere possiamo creare un parametro "NomeTabella" e nella lista delle tabelle, in "Table name", inseriamo [MACRO(?NomeTabella)]. Quando eseguiamo la query alla richiesta del parametro è necessario specificare il nome di una tabella esistente al fine di ottenere il risultato desiderato. La macro sostituzione può essere effettuata ovunque si utilizzino i nomi dei campi e/o il nome di una tabella.

NOTEMPTYDATE(d)

Verifica se d è una data vuota.

NOTEMPTYNUM(nExp)

Verifica se nExp è nullo.

NOTEMPTYSTR(cExp)

Verifica se cExp è una stringa vuota.

NVL(Exp1,Exp2)

Restituisce il primo argomento non NULL (da sinistra a destra); ammette solo due argomenti.

RANDOM()

Restituisce un numero casuale compreso tra 0 e 1 diverso per ogni record ritornato.

SPACE0

Restituisce una costante stringa vuota indipendentemente dal database.

SPACES(n)

Restituisce una stringa di n spazi.

T(fieldname)

Nel caso siano presenti dei campi multilingua, seleziona il campo fieldname nella lingua dell'utente corrente.

T2(fieldname)

Nel caso siano presenti dei campi multilingua, seleziona il campo fieldname nella lingua dell'utente corrente. Nel caso il campo non sia presente nella lingua dell'utente corrente, ritorna null.

T!(fieldname,fieldlanguage)

Nel caso siano presenti dei campi multilingua, seleziona il campo fieldname nella lingua specificata in fieldlanguage. Nel caso il campo non sia presente nella lingua selezionata, ritorna null.

Translate(Expr)

Traduce Expr, applicando la traduzione impostata per il valore passato come parametro nel Translation Manager di SITEPAINTER INFINITY.

USERCODE()

Restituisce il codice utente (numerico di 4).

USERGROUPS()

Restituisce una stringa con l'elenco dei codici dei gruppi, separato da virgola, a cui appartiene l'utente loggato. Se l'utente non ha gruppi associati oppure non è loggato, la funzione restituisce la stringa "-1" (gruppo non valido).

USERROLES()

Restituisce una stringa con l'elenco delle descrizioni dei ruoli, separato da virgola, assegnati all'utente loggato. Se l'utente non ha ruoli assegnati oppure non è loggato, la funzione restituisce la stringa vuota "" (ruolo non valido).

Esempi sull'utilizzo di CASE e CASE2

Esempio sull'utilizzo di MACRO(?Par)

Esempio sull'utilizzo di T(fieldName)

Esempio sull'utilizzo di Translate(Expr)

Funzione	Significato
CASE(Exp,Val1,a,Val2,b,,,,n)	Corrisponde al costrutto: CASE WHEN Exp=Val1 THEN a WHEN Exp=Val2 THEN b ... ELSE n
CASE2(Exp1,a,Exp2,b,,,,n)	Corrisponde al costrutto: CASE WHEN (Exp1) THEN a WHEN (Exp2) THEN b ... ELSE n dove l'espressione ExpN corrisponde a: <NomeCampo> <operatore di confronto> <Valore>
CEIL(numeric)	Restituisce il più piccolo intero maggiore o uguale del numero indicato.
COMPANYCODE()	Restituisce il codice dell'azienda (carattere di 10).
CURRENTDATE()	Restituisce la data corrente.
CURRENTDATETIME()	Restituisce la data e ora corrente.
FLOOR(numeric)	Restituisce il più grande intero minore o uguale del numero indicato.
GLOBALVAR(gVar)	Restituisce il valore della variabile globale gVar.
LEN(Exp)	Ritorna la lunghezza di Exp.
MACRO(?Par)	Effettua la macro sostituzione del parametro <Par> nel punto dove viene inserita. Ad esempio possiamo creare una query parametrica in cui il nome della tabella su cui lavorare non è preso dalla lista; per fare una cosa del genere possiamo creare un parametro "NomeTabella" e nella lista delle tabelle, in "Table name", inseriamo [MACRO(?NomeTabella)]. Quando eseguiamo la query alla richiesta del parametro è necessario specificare il nome di una tabella esistente al fine di ottenere il risultato desiderato. La macro sostituzione può essere effettuata ovunque si utilizzino i nomi dei campi e/o il nome di una tabella.
NOTEMPTYDATE(d)	Verifica se d è una data vuota.
NOTEMPTYNUM(nExp)	Verifica se nExp è nullo.
NOTEMPTYSTR(cExp)	Verifica se cExp è una stringa vuota.
NVL(Exp1,Exp2)	Restituisce il primo argomento non NULL (da sinistra a destra); ammette solo due argomenti.
RANDOM()	Restituisce un numero casuale compreso tra 0 e 1 diverso per ogni record ritornato.
SPACE0	Restituisce una costante stringa vuota indipendentemente dal database.
SPACES(n)	Restituisce una stringa di n spazi.
T(fieldname)	Nel caso siano presenti dei campi multilingua, seleziona il campo fieldname nella lingua dell'utente corrente.
T2(fieldname)	Nel caso siano presenti dei campi multilingua, seleziona il campo fieldname nella lingua dell'utente corrente. Nel caso il campo non sia presente nella lingua dell'utente corrente, ritorna null.
T!(fieldname,fieldlanguage)	Nel caso siano presenti dei campi multilingua, seleziona il campo fieldname nella lingua specificata in fieldlanguage. Nel caso il campo non sia presente nella lingua selezionata, ritorna null.
Translate(Expr)	Traduce Expr, applicando la traduzione impostata per il valore passato come parametro nel Translation Manager di SITEPAINTER INFINITY.
USERCODE()	Restituisce il codice utente (numerico di 4).
USERGROUPS()	Restituisce una stringa con l'elenco dei codici dei gruppi, separato da virgola, a cui appartiene l'utente loggato. Se l'utente non ha gruppi associati oppure non è loggato, la funzione restituisce la stringa "-1" (gruppo non valido).
USERROLES()	Restituisce una stringa con l'elenco delle descrizioni dei ruoli, separato da virgola, assegnati all'utente loggato. Se l'utente non ha ruoli assegnati oppure non è loggato, la funzione restituisce la stringa vuota "" (ruolo non valido).