Expressions calculées ADONIX 

Présentation

Dans un certain nombre d'écrans de paramétrage, on peut être amené à entrer des formules de calcul, encore appelées expressions adonix (le moteur d'exécution des progiciels en technologie X3 s'appelle en effet adonix). Ces expressions sont exprimées sous forme algébrique, et font partie d'un langage général. On trouvera ci-dessous une description générale des fonctions utilisables dans les expressions adonix.

De nombreuses aides existent lors de la saisie de formule, à la fois pour connaître les fonctions et les variables utilisables , mais aussi pour expliciter la signification de la formule. Ces aides sont accessibles par le biais de l'éditeur de formule.

Il est possible de tester une expression (dans laquelle ne figurent que des constantes et des variables accessibles dans le contexte) grâce à la calculette.

Type d'une expression ADONIX

Une expression adonix est de type alphanumérique, numérique, ou de type date. Selon l'endroit où est réalisé ce paramétrage, on peut avoir besoin de l'un ou l'autre de ces types (même si tous les types peuvent être utilisés dans une formule, des fonctions d'un type donné pouvant faire appel à des arguments d'un autre type). Il est à noter que la fonction type permet de tester le type d'une variable.

Comment bâtir une expression ADONIX

Une expression se compose de constantes, d'opérateurs, de variables, et de fonctions.

Constantes

Les constantes peuvent être :

*    de type alphanumérique : exprimées soit entre apostrophes ('), soit entre guillemets ("). Voici deux exemples de chaînes valides :

 

"C'est certain"

 

'une "chaîne" particulière'

*    de type numérique : exprimées avec un point décimal si nécessaire. Voici deux exemples de constantes numériques valides :

 

-2.5

 

123000

*    de type date : exprimées sous la forme [ jour / mois / année ]. Il est à noter que l'année doit obligatoirement être exprimée sur 4 chiffres. Voici deux exemples de constantes dates valides :

 

[15/3/2002]

 

[21/05/1819]

*    de type logique : elle se confond avec les constantes numériques : 1 (et par extension toute valeur non nulle) équivaut à Vrai, 0 équivaut à Faux.

Opérateurs

Les opérateurs valides sont les suivants :

 

+

addition de deux nombres, d'une date et d'un nombre de jours, ou concaténation de deux chaînes de caractères.

 

-

soustraction de deux nombres, d'une date et d'un nombre de jours, ou concaténation de deux chaînes de caractères en insérant un espace entre les deux chaînes.

 

*

multiplication de deux nombres

 

/

division de deux nombres

 

^

élévation à la puissance

 

<

<=

>

>=

<>

opérateurs de comparaison

 

 

and

or

xor

not

opérateurs logiques, qui peuvent aussi s'abrévier

&

|

?

!

On dispose par ailleurs de la possibilité d'utiliser des parenthèses avec un niveau d'imbrication illimité.

Variables

Une variable s'exprime de façon générale sous la forme :

 

[ classe ] nomvar ( indice )

Par exemple, on peut définir les variables suivantes  :

 

[F:BPC]BPCNAME

 

MA_VARIABLE

 

ELEMENT(33)

Le nom de la variable nomvar s'exprime sous la forme de lettres et/ou de chiffres, le premier caractère étant toujours une lettre et le caractère de soulignement étant également admis. La longueur significative d'un nom de variable est limitée à 12 caractères. Tous les noms sont autorisés, hormis certains mots-clés réservés au langage (File, Until, ou Commit font par exemple partie de ces mots-clés). Lorsqu'on tape un nom de variable en lettres minuscules, il est automatiquement transformé en lettre majuscules, sauf s'il s'agit d'un mot-clé.

Certaines variables peuvent être dimensionnées, c'est-à-dire correspondre à des tableaux d'éléments (de 1 à 4 dimensions sont possibles). Dans cas, on donne le ou les indices sous la forme d'expressions numériques, séparées par des virgules s'il y en a plusieurs, entre parenthèses (par exemple, M_TB(1,2,8) est une syntaxe valide).

Une classe correspond à un ensemble de variable liées à un contexte. Les classes les plus courantes sont les suivantes :

*    [V] : classe de variables globales. Une variable de ce type est liée à la session ADONIX. Une fois créée, elle reste accessible tant qu'elle n'a pas été détruite, ou tant que la session ADONIX ne s'arrête pas. Sa déclaration se fait à l'aide d'instructions dédiées (selon son type, on utilise les instructions Integer, Decimal, Char, Date, Libelle, Shortint, Float, Double).

*    [L] : classe de variables locales. Elle est liée à une imbrication de sous-programme (chaque instruction Call crée une nouvelle classe de variables locales qui cache la classe précédente). La déclaration de variables de ce type se fait de même que les variables précédentes, mais en faisant précéder la déclaration du mot-clé Local.

*    [C] : classe de variables de type compteur. Il s'agit de variables communes à tous les postes d'un dossier. Leur création se fait par une fonction de développement dédiée.

*    [F:abv] ou encore [abv] : il s'agit de la classe des variables liées à une table déclarée par l'instruction File. On y retrouve les valeurs de l'enregistrement courant.

*    [M:abv] ou encore [abv] : il s'agit de la classe des variables liées à un écran de saisie déclaré par l'instruction Mask. On y retrouve les valeurs ayant été saisies ou susceptibles d'être affichées (chaque onglet d'un écran est considéré comme un masque).

La classe n'est pas obligatoire, car des règles permettent de connaître la classe par défaut.

Il existe un ensemble de variables dites système, car gérées directement par adonix. Alors que les autres variables sont transformées, lors de la saisie, en majuscules, ces variables, qui font partie des mots-clés du langage, sont affichées en minuscules. Voici quelques variables système utilisables  (liste non exhaustive) :

Nom

Type

Définition

nomap

chaîne

nom du dossier courant

datesyst

date

date système modifiable

adxdir

chaîne

répertoire de base adonix

nolign

numérique

numéro de ligne courante

fstat

numérique

statut de retour après lecture ou écriture table

Fonctions définies dans le moteur

Une fonction s'exprime sous la forme fonction(liste d'arguments). De très nombreuses fonctions existent : traitement de chaînes de caractères, calculs sur dates, fonctions numériques classiques, fonctions de troncature et d'arrondi, fonctions statistiques…

Une liste des principales fonctions utilisables dans ADONIX se trouve ci-dessous. Dans le tableau des fonctions, les conventions d'écriture sont les suivantes :

*    v est un argument de type quelconque (idem pour v1,v2,v3...)

*    c est un argument de type chaîne de caractères

*    x est un argument de type numérique

*    n, p, q... sont des arguments de type entier

*    V est une variable

*    liste est une liste de variables ou d'expressions. Dans ce type de liste, une variable TABLO de type tableau peut être utilisée sous la forme TABLO(I) (on ne prend qu'un indice), TABLO (on parcourt tous les indices), ou TABLO(I..J) (on parcourt les indices I à J inclus).

Syntaxes

Type

Définition

date$

date

date courante

sin(x), cos(x), tan(x)

numérique

fonctions trigonométriques

asin(x),acos(x)...

numérique

fonctions trigonométriques inverses

log(x),exp(x),ln(x)

numérique

fonctions logarithmiques

abs(x), sgn(x)

numérique

valeur absolue, signe

ar2(x), arr(x,y)

numérique

arrondi à 2 décimales, arrondi de x à y près

int(x), mod(x,y)

numérique

partie entière, modulo

len(c)

numérique

longueur d'une chaîne

day(d),month(d),year(d)

numérique

extraction quantième, mois, année d'une date

dayn(d),week(d)

numérique

numéro du jour dans la semaine, no de la semaine

num$(x)

chaîne

convertit un nombre en une chaîne (représentation décimale)

space$(n), chr$(n)

chaîne

chaîne composée de n espaces, de 1 caractère de code interne n

string$(n,c), string$(n,x)

chaîne

chaîne composée de n caractères c

(ou n caractères de code x)

day$(d), month$(d)

chaîne

nom du jour, nom du mois

addmonth(d,n)

date

la date d auquel on a ajouté n mois

eomonth(d)

date

le dernier jour du mois correspondant à la date d

left$(c,n), right$(c,n)

chaîne

partie gauche/droite d'une chaîne sur n caractères

mid$(c,n,p), seg$(c,n,p)

chaîne

extraction de sous-chaînes d'une chaîne donnée

gdat$(n,p,q)

date

construction d'une date (n=jour,p=mois,q=année)

pat(c1,c2)

numérique

vérifie la conformité d'une chaîne c1 à un modèle c2 (1 si conforme, 0 sinon). Le modèle peut inclure les méta-caractères * (nombre quelconque de caractères quelconques), ? (un caractère quelconque), # (un chiffre quelconque).

min(liste), max(liste)

tous types

minimum ou maximum d'un ensemble de variables ou valeurs

sum(liste), prd(liste)

numérique

somme, produit d'un ensemble de variables ou valeurs

avg(liste), var(liste)

numérique

moyenne, variance d'un ensemble de variables ou valeurs

sum(liste)

chaîne

concaténation d'un ensemble de variables ou valeurs chaînes

uni(liste)

numérique

vérification d'unicité sur un ensemble de variables ou valeurs

find(v,liste)

numérique

recherche d'une valeur de type quelconque dans une liste

evalue(c)

tous types

evaluation d'une chaîne de caractère contenant une expression

format$(c,v)

chaîne

formattage d'une valeur avec un format donné c.

toupper(c),tolower(c)

chaîne

transformation en minuscules, en majuscules

sigma(V=v1,v2,v3)

numérique

somme (V variant de v1 à v2), de l'expression v3 fonction de V.

 Fonctions définies par les développeurs

Il existe également des fonctions définies par des développeurs et utilisables dans les expressions calculées, par la syntaxe suivante :

func TRAIT.FONCT(liste d'arguments)

TRAIT étant le nom du traitement, et FONCT le nom de la fonction concernée. Il est à noter que les fonctions utilisables sont documentées dans la table des sous-programmes.