Formules et fonctions

Vous pouvez ajouter des fonctions à votre table afin d'exécuter des calculs par exemple. Selon que vous éditez un modèle du type Table, une table de résultats d'une requête ou d'une analyse ad hoc, différentes formules sont à votre disposition.

ET

Et logique.

ET requiert au moins un argument. Vous pouvez utiliser des arguments uniques et/ou des arguments d'étendue.

Exemple

Valeur 1

Valeur 2

ET

FALSE

FALSE

FALSE

FALSE

TRUE

FALSE

TRUE

FALSE

FALSE

TRUE

TRUE

TRUE

=ET (TRUE;TRUE) renvoie l'information suivante :

ET

=ET(A1>100;A2>100) renvoie TRUE.

ET

ATTRIBUT_ARIS

Affiche un attribut.

ATTRIBUT_ARIS a besoin comme donnée d'entrée d'un nom API d'un attribut et affiche le nom de l'attribut dans la cellule.

Exemple

La formule suivante sort le nom du Nom d'attribut ARIS. L'entrée nécessaire est le nom API.

=ATTRIBUT_ARIS("AT_NAME")

ATTRIBUT_ARIS

Pour les tables de résultats des requêtes ou les analyses ad hoc, veuillez remplacer la portion de formule ARIS par REQUÊTE ou ANALYSE.

VALEURATTRIBUT_ARIS

Affiche une valeur d'attribut.

VALEURATTRIBUT_ARIS requiert un élément ARIS et un attribut comme donnée d'entrée. Vous pouvez utiliser des arguments uniques et/ou des arguments d'étendue.

Exemple

Pour un modèle du type Table, la formule suivante affiche la valeur de l'élément ARIS possédant une valeur dans la cellule A2 et dont l'attribut Nom est géré dans la cellule B2.

=VALEURATTRIBUT_ARIS(A2;B2)

=VALEURATTRIBUT_ARIS(ARIS_ELEMENT("GUID");ARIS_ATTRIBUTE("Nom API de l'attribut"))

Fonction ARISATTRVALUE

Pour les tables de résultats des requêtes ou les analyses ad hoc, veuillez remplacer la portion de formule ARIS par REQUÊTE ou ANALYSE.

ELEMENT_ARIS

Indique un élément ARIS.

Un élément peut être :

  • un modèle ARIS

  • un objet ARIS

  • une liaison ARIS

ELEMENT_ARIS a besoin d'un GUID avec des guillemets comme argument. La saisie s'effectue sous la forme suivante :

=ELEMENT_ARIS("GUID")

Exemple

Pour un modèle du type Table, la formule suivante affiche le nom de l'élément ARIS et le symbole associé.

La cellule de la liaison est sélectionnée. La formule indique le nom et le symbole de liaison.

=ELEMENT_ARIS("ff14b3a1-438e-11e2-2aa2-e33baa0a29cc")

Élément ARIS

Pour les tables de résultats des requêtes ou les analyses ad hoc, veuillez remplacer la portion de formule ARIS par REQUÊTE ou ANALYSE.

ARIS_ELEMENT_API_NOM

Retourne le nom API d'un élément ARIS.

Un élément peut être :

  • un modèle ARIS

  • un objet ARIS

  • une liaison ARIS

ARIS_ITEM_API_NAME nécessite un élément ARIS comme argument.

Exemple

Dans cet exemple, le nom API de l'élément dans la cellule A1 est sorti dans la cellule B1.

=ARIS_ITEM_API_NAME(A1)

s_tc_item_api_name.gif

Pour les tables de résultats des requêtes ou les analyses ad hoc, veuillez remplacer la portion de formule ARIS par REQUÊTE ou ANALYSE.

ARIS_ELEMENT_DEF_SYMBOLE

Retourne le nom du symbole standard pour un objet ARIS.

ARIS_ITEM_DEF_SYMBOL nécessite un élément ARIS comme argument.

Exemple

Dans cet exemple, les noms de symbole par défaut pour les éléments des cellules A1 et A2 sont affichés dans les cellules B1 et B2.

=ARIS_ITEM_DEF_SYMBOL(A1)

=ARIS_ITEM_DEF_SYMBOL(A2)

ARIS_ELEMENT_DEF_SYMBOLE

Pour les tables de résultats des requêtes ou les analyses ad hoc, veuillez remplacer la portion de formule ARIS par REQUÊTE ou ANALYSE.

ARIS_ELEMENT_GUID

Fournit le GUID de l'élément ARIS.

ARIS_ELEMENT_GUID requiert comme entrée un élément ARIS. Il peut s'agir d'une cellule contenant un élément ARIS ou bien du résultat d'un calcul qui fournit un élément ARIS.

Exemple

Pour un modèle du type Table, la formule suivante affiche le GUID de l'élément ARIS qui possède une valeur dans la cellule A1.

=ARIS_ELEMENT_GUID(A1)

ARIS-ITEM_GUID

Pour les tables de résultats des requêtes ou les analyses ad hoc, veuillez remplacer la portion de formule ARIS par REQUÊTE ou ANALYSE.

ARIS_ELEMENT_CHEMIN

Fournit le chemin vers un élément ARIS.

ARIS_ITEM_PATH requiert comme entrée un élément ARIS.

Exemple

Pour un modèle du type Table, la formule suivante affiche le chemin de l'élément ARIS de la cellule A1.

=ARIS_ITEM_PATH(A1)

ARIS_ELEMENT_CHEMIN

Pour les tables de résultats des requêtes ou les analyses ad hoc, veuillez remplacer la portion de formule ARIS par REQUÊTE ou ANALYSE.

ARIS_ELEMENT_TYPE

Fournit le type d'un élément ARIS.

ARIS_ITEM_TYPE requiert comme entrée un élément ARIS.

Exemple

Pour un modèle du type Table, la formule suivante affiche le type d'un élément ARIS de la cellule A1.

=ARIS_ITEM_TYPE(A1)

ARIS_ELEMENT_TYPE

Pour les tables de résultats des requêtes ou les analyses ad hoc, veuillez remplacer la portion de formule ARIS par REQUÊTE ou ANALYSE.

ARIS_ELEMENT_TYPE_NUM

Fournit le numéro de type d'un élément ARIS.

ARIS_ITEM_TYPE_NUM requiert comme entrée un élément ARIS.

Exemple

Pour un modèle du type Table, la formule suivante affiche le numéro type de l'élément ARIS de la cellule A1.

ARIS_ITEM_TYPE_NUM=(A1)

ARIS_ELEMENT_TYPE_NUM

Pour les tables de résultats des requêtes ou les analyses ad hoc, veuillez remplacer la portion de formule ARIS par REQUÊTE ou ANALYSE.

ARIS_LOCKED_BY_USER

Indique si un élément ARIS est verrouillé ou non par un utilisateur. L'utilisateur est affiché dans le modèle de type tableur.

Un élément peut être :

  • un modèle ARIS

  • un objet ARIS

ARIS_LOCKED_BY_USER nécessite une référence de cellule des modèles ou des objets comme argument. La saisie s'effectue sous la forme suivante :

=ARIS_LOCKED_BY_USER(référence de cellule)

Exemple

Pour un modèle du type tableur, la formule affiche le nom de l'utilisateur qui a verrouillé les modèles ou les objets. La cellule de l'objet est sélectionnée.

=ARIS_LOCKED_BY_USER(A2)

ARIS_LOCKED_BY_USER

ARIS_ATTRIBUT_ECRIRE_VALEUR

Permet de gérer la valeur d'attribut d'un objet.

ARIS_ECRIRE_VALEUR_ATTRIBUT requiert comme donnée d'entrée un élément ARIS, un attribut et la valeur que doit avoir l'attribut. Vous pouvez utiliser des arguments uniques et/ou des arguments d'étendue.

Exemple

Pour un modèle du type Table, la formule suivante définit la valeur acceptable pour la valeur d'attribut de l'élément ARIS possédant une valeur dans la cellule A1 et dont l'attribut est indiqué dans la cellule B1.

=ARIS_ATTRIBUT_ECRIRE_VALEUR(A1;B1;"acceptable")

Pour les tables de résultats des requêtes ou les analyses ad hoc, veuillez remplacer la portion de formule ARIS par REQUÊTE ou ANALYSE.

GERER_ATTRIBUT_ARIS

MOYENNE

Représente la valeur moyenne.

MOYENNE a besoin d'au moins un argument. Vous pouvez utiliser des arguments uniques et/ou des arguments d'étendue.

Exemple

MOYENNE(A1:A5) représente la valeur moyenne des valeurs enregistrées dans les cellules A1 à A5.

CHOISIR

Indique une valeur grâce à une indexation.

L'indexation est la position d'un élément dans une liste. Si on a par exemple une liste contenant les valeurs 1,3,5,7,13, l'élément situé en position trois possède la valeur cinq.

CHOISIR requiert au moins deux arguments. Le premier argument représente l'index de la quantité de valeurs à partir de laquelle l'élément correspondant est sélectionné.

Saisie : CHOISIR(position de l'élément , élément1..élément2)

Exemple

CHOISIR(1;2;4;6;8;19) renvoie 2

CHOISIR(3;2;4;6;8;19) renvoie 6

CONNECTER

Connecte des suites de caractères qui étaient séparées par un point-virgule.

CONNECTER

NB

Calcule le nombre d'arguments contenus. Vous pouvez utiliser des arguments uniques et/ou des arguments d'étendue.

Exemple

=NB(A1;12;5) renvoie 3 car trois arguments sont transmis.

=NB(A1:A3;"Texte") renvoie 4 car quatre arguments sont transmis.

=NB(A1:A5) renvoie 5.

DATE

Convertit trois arguments numériques en une date.

La saisie des arguments s'effectue sous la forme suivante : =DATE(année;mois;jour), aussi =DATE(AAAA;MM;JJ)

Exemple

=DATE(2012;12;5) renvoie la date 5.12.2012.

Fonction DATE

JOURS

Calcule le nombre de jours entre deux saisies de date.

La date ne peut pas être saisie directement comme argument, elle doit exister dans les cellules ou être calculée au moyen d'une formule qui renvoie une valeur du type Date. Deux arguments sont nécessaires.

La saisie des arguments s'effectue sous la forme suivante : =JOURS(Date;Date).

Exemple

=JOURS(A1;A2) renvoie 22 jours.

Jours

SI

Vérifie une condition et renvoie une valeur selon le résultat.

SI a besoin de trois arguments. La saisie s'effectue sous la forme suivante :

SI(condition;condition satisfaite;condition non satisfaite).

Exemple

La saisie de =SI(A1>A2;1;0) renvoie TRUE.

La saisie de =SI(A1>A2;TRUE;FALSE) renvoie l'information suivante :

SI

La saisie de =SI(A1>10;"rouge";SI(A1>5;"jaune";SI(A1>2;"vert";"noir"))) renvoie l'information suivante :

SI

EST_RELIE_PAR

Fournit la suite de caractères donnée si l'objet source et l'objet cible sont reliés par le type de liaison respectif.

EST_RELIE_PAR a besoin comme donnée d'entrée d'au moins un objet source ARIS, d'un objet cible ARIS, du nom API du type de liaison et de la suite de caractères qui doit s'afficher si cette relation existe au niveau de la définition. Vous pouvez utiliser des arguments uniques et/ou des arguments d'étendue.

Exemple

La formule suivante affichera la suite de caractères OK, si l'objet source et l'objet cible sont reliés via la liaison active portant le nom API CT_ACTIV_1.

=EST_RELIE_PAR(A1;B1;"CT_ACTIV_1";"OK")

EST_RELIE_PAR

MAX

Indique la valeur maximale des arguments saisis. MAX a besoin d'au moins un argument. Vous pouvez utiliser des arguments uniques et/ou des arguments d'étendue.

Exemple

=MAX(A1;A4:A6) renvoie 123.

MAX

MIN

Indique la valeur minimale des arguments saisis. MIN a besoin d'au moins un argument. Vous pouvez utiliser des arguments uniques et/ou des arguments d'étendue.

Exemple

=MIN(A1;A4:A6) renvoie 7.

MIN

NB.JOURS.OUVRES

Calcule le nombre de jours ouvrés entre deux dates indiquées.

NB.JOURS.OUVRES requiert deux arguments et calcule le nombre de jours ouvrés à condition que samedi et dimanche soient des jours chômés.

Exemple

JOURS OUVRÉS

NON

Inversion logique.

NON a besoin de l'argument True ou False.

NON(TRUE) ou NON(1) renvoie FALSE et NON(FALSE) ou NON(0) renvoie TRUE.

Exemple

NON(TRUE)

NOT(TRUE)

NON(FALSE)

NOT(TRUE)

MAINTENANT

Indique l'heure actuelle.

MAINTENANT n'a besoin d'aucun argument.

La saisie s'effectue sous la forme suivante :

=MAINTENANT()

Pour chaque nouveau calcul dans la feuille de calcul, la fonction MAINTENANT() met l'heure à jour.

OU

Opération OU logique.

OU a besoin d'au moins un argument.

Exemple

Valeur 1

Valeur 2

OU

FALSE

FALSE

FALSE

FALSE

TRUE

TRUE

TRUE

FALSE

TRUE

TRUE

TRUE

TRUE

RACINE

Calcule la racine carrée d'un nombre.

RACINE a besoin d'un argument.

Exemple

=RACINE(4) renvoie deux.

CENTREE.REDUITE

Normalise à 100 %.

CENTREE.REDUITE a besoin de trois arguments et normalise une valeur située entre une valeur minimale et une valeur maximale. Le calcul s'effectue comme suit :

Le premier argument représente la valeur, la différence des deux arguments suivants représente la plage normalisée à 100%.

(Valeur - Minimum) / (Maximum - Minimum)

La fonction CENTREE.REDUITE est principalement utilisée pour une cellule ayant un formatage conditionnel pour mettre en évidence la valeur maximale atteinte. La cellule peut ainsi être coloriée partiellement, entièrement ou pas du tout.

Exemple

CENTREE.REDUITE(2;0;10) correspond à (2-0)/(10-0) et donne donc 0,2

CENTREE.REDUITE(7;3;10) correspond à (7-3)/(10-3) et donne donc 0,571

SOMME

Renvoie la somme des valeurs des arguments.

SOMME a besoin d'au moins un argument.

Exemple

=SOMME(2;3) renvoie cinq.

SWITCH

Vérifie une condition et réagit en conséquence des conditions définies.

SWITCH a besoin d'au moins trois arguments : une condition et une valeur affichée lorsque la condition est satisfaite et une valeur par défaut affichée lorsque qu'aucune des conditions indiquées n'est satisfaite.

Cette connexion de conditions pourrait également être établie avec la formule SI. On aurait alors une expression plus longue.

Exemple

=SWITCH(A1>10;"rouge";A1>5;"jaune";A1>2;"vert";"noir")

SWITCH

L'expression en utilisant SI serait la suivante :

=SI(A1>10;"rouge";SI(A1>5;"jaune";SI(A1>2;"vert";"noir")))

TEMPS

Renvoie une heure.

TEMPS a besoin de trois arguments.

La saisie s'effectue sous la forme suivante :

=TEMPS(heure;minute;seconde)

Exemple

=TEMPS(2;23;59) renvoie 2:23:59

TEMPS

La saisie de =TEMPS(25;23;59) renvoie 1:23:59.

La saisie de =TEMPS(2;23;61) renvoie 02:24:01.

AUJOURDHUI

Renvoie la date actuelle.

AUJOURDHUI n'a besoin d'aucun argument.

La saisie s'effectue sous la forme suivante :

=AUJOURDHUI()

Pour chaque nouveau calcul dans la feuille de calcul, la fonction AUJOURDHUI() met la date à jour.

XOR

Opération XOR logique.

XOR a besoin d'au moins un argument.

Exemple

A1

A2

XOR

FALSE

FALSE

FALSE

FALSE

TRUE

TRUE

TRUE

FALSE

TRUE

TRUE

TRUE

FALSE