|
Objets et fonctions |
Scroll |
Calcul
Les opérateurs ci-dessous sont pris en charge dans les formules de calcul :
Opérateur |
Fonction |
+ |
Addition |
- |
Soustraction |
* |
Multiplication |
/ |
Division |
^ |
Élévation à la puissance |
() |
Parenthèses |
-a |
Moins unaire |
Fonctions globales |
Reportez-vous à « Fonctions globales » ci-dessous |
Propriétés de table |
Reportez-vous à « Propriétés de table » ci-dessous |
Propriétés des colonnes de table |
Reportez-vous à « Propriétés des colonnes de table » ci-dessous |
L'utilisation des opérateurs n'est pas limitée aux champs numériques et décimaux. Vous pouvez également effectuer les calculs suivants.
Type du champ |
Description |
Exemple d'utilisation |
Champ de date, champ de date et heure |
Une soustraction (-) permet de soustraire un champ de date d'un autre champ de date ou un champ de date et heure d'un autre champ de date et heure. •Il est impossible de mélanger les types de champ. •Le calcul renvoie la différence entre les deux champs en jours entiers (arrondis à l'unité inférieure). •Les résultats négatifs sont pris en charge. |
DateField1 = 2023.04.12 DateField2 = 2023.06.09
Calcul :
DateField2 - DateField1 = 58 |
Champ texte |
Vous pouvez utiliser le symbole d'addition (+) entre les chaînes. •Vous pouvez utiliser l'addition pour les champs texte et les littéraux. •La fonction toString permet de convertir d'autres types de champ en chaînes. |
"PATIENT-"+PatientFirstName+"-"+PatientLastName= PATIENT-John-Doe
"INV-"+ToString(BuyerID)+"-"+ToString(OrderNumber) = INV-112-11773360 |
Outre les opérateurs ci-dessus, la mise en forme conditionnelle prend en charge les opérateurs ci-dessous :
Opérateur |
Fonction |
Opérateurs relationnels |
|
< |
Inférieur à |
<= |
Inférieur ou égal à |
> |
Supérieur à |
>= |
Supérieur ou égal à |
Opérateurs de comparaison |
|
= |
Égal à |
!= |
Différent de |
Opérateurs logiques |
|
ET |
Et (ne respecte pas la casse) |
OU |
Ou (ne respecte pas la casse) |
PAS |
Pas (ne respecte pas la casse) |
Champs de catégorie
Vous pouvez utiliser les types de champs de données d'index ci-dessous dans une condition.
Fonction |
Peut être utilisée dans une condition |
Exemple d'utilisation |
Étiquette |
non |
- |
Image |
non |
- |
Texte |
oui |
Les chaînes doivent être entourées de guillemets : "chaîne". Entrez les nombres sans guillemets. Si les champs texte de la catégorie possèdent l'ID « company_name » et « company_zipcode » : company_name = "Moyaware" company_zipcode = 1160 |
Entier |
oui |
field_id = 1234 |
Décimal |
oui |
field_id = 14.36 |
Date |
oui |
field_id = d'YYYY-MM-DD' |
Date/heure |
oui |
Timestamp1 < d'YYYY-MM-DD HH:MM:SS' Timestamp1 < d'YYYY-MM-DD HH:MM' |
Case à cocher |
oui |
Checked: checkbox = 1 Unchecked: (NOT IsEmpty(checkbox)) AND checkbox = 0 Indeterminate: IsEmpty(checkbox) |
Compteur numérique |
non |
- |
Compteur formaté |
non |
- |
Mot clé unique |
oui |
Les chaînes doivent être entourées de guillemets : "chaîne". Entrez les nombres sans guillemets. Si l'ID du champ correspond à « single_keyword » : single_keyword = 2 ou single_keyword_Text = "keyword" Vous devez ajouter « Text » manuellement à l'ID du champ. |
Mot clé multiple |
non |
- |
Champ primaire/dépendant |
oui |
Le format de saisie varie selon le type du champ. Reportez-vous aux exemples d'utilisation ci-dessus. |
Contrôle d'onglet |
non |
- |
Onglet |
non |
- |
Table |
non |
- |
Texte dans table |
oui* |
Voir Texte |
Entier dans table |
oui* |
Voir Entier |
Décimal dans table |
oui* |
Voir Décimal |
Date dans table |
oui* |
Voir Date/heure |
Date/heure dans table |
oui* |
Voir Case à cocher |
Case à cocher dans table |
oui* |
Voir mot clé unique |
Mot clé unique dans table |
oui* |
Voir mot clé multiple |
Champ primaire/dépendant dans table |
oui* |
Voir Champ primaire/dépendant |
* Les valeurs de table ne peuvent être utilisées que si vous spécifiez une condition pour un champ au sein de la même table. Il est impossible de définir des conditions pour plusieurs tables.
Fonctions globales
Une fonction globale est une fonction standard qui n'est pas écrite en syntaxe. Exemples de fonctions disponibles :
Fonction |
Description |
Exemple d'utilisation |
Abs() |
Renvoie la valeur absolue |
Abs(Field) |
AddDays(dateValue, days) |
Ajout de jours (sous forme de nombres entiers) dans les champs de date et de date et heure. •L'argument « dateValue » se réfère à un champ de date ou de date et heure. •L'argument « days » se réfère à un champ numérique ou à un entier. •Le résultat correspond à un champ de date ou de date et heure, selon le premier entier. •Les nombres négatifs sont pris en charge. |
AddDays(DateField1, NumberField)= DateField2 |
IsEmpty() |
Renvoie la valeur true/false si le champ est vide |
IsEmpty(Field) |
Round(x,y) |
Arrondit un nombre décimal x à y décimales |
Round(3.4567,2) = 3.46 |
Search(x,y) |
Recherche une sous-chaîne spécifique dans une chaîne et renvoie true/false selon qu'elle a été détectée ou non. Les caractères génériques suivants vous sont proposés :  * correspond à n'importe quels caractères  ? correspond à un caractère unique |
Search("Hello", "*o") = true |
Convertit les valeurs de champs de données d'index en chaînes. •Le premier paramètre est obligatoire •Les types de champs suivants sont pris en charge : Numérique, Décimal, Date, Date et heure, Case à cocher (0, 1, vide), Mot clé (langue du serveur) •Le second paramètre est facultatif et permet de définir le format d'un champ décimal, de date ou de date et heure |
ToString(DecimalField1, "0.##") ToString(DateField1, "YYYY/MM/DD")
|
Macros
Macro |
Description |
Exemple d'utilisation |
WFTaskId |
Définissez une mise en forme conditionnelle ou définissez un champ obligatoire/désactivé en fonction d'une tâche de workflow. |
Si vous avez réglé l'ID de tâche de workflow sur « task_ID » : WFTaskId = "task_ID" L'ID de tâche est considéré comme une chaîne et doit donc être entouré de guillemets. |
Propriétés de table
Les propriétés de table sont réservées aux tables. Optez pour la syntaxe à base de membre pour les utiliser, sans parenthèses.
Fonction |
Description |
Exemple d'utilisation |
RowCount |
Renvoie le nombre de lignes actuel de la table |
« MyTable » doit correspondre au champ de la table en tant que tel MyTable.RowCount > 0 |
Propriétés des colonnes de table
Les propriétés des colonnes de table sont réservées aux colonnes de table. Optez pour la syntaxe à base de membre pour les utiliser, sans parenthèses.
Fonction |
Description |
Exemple d'utilisation |
Sum |
Renvoie la somme de toutes les lignes d'une colonne de table |
« TableIntCol » doit correspondre à un champ de colonne de table TableIntCol.Sum > 0 |
Précédence des opérateurs (ordre des opérations)
La précédence des opérateurs est définie comme suit. L'opérateur doté de la précédence la plus basse est exécuté en premier, l'opérateur doté de la précédence la plus élevée est exécuté en dernier.
1.Puissance (^)
2.Multiplication/Division (*, /)
3.Plus/Moins (+, -)
4.Opérateurs relationnels (<, <= , > , >=)
5.Opérateurs de comparaison (=, !=)
6.Opérateur logique Et
7.Opérateur logique Ou
À titre d'exemple, un opérateur « OU » est toujours exécuté en dernier et une multiplication est calculée avant une addition.
2 + 3 * 2 égale 8.
Si l'ordre de précédence ne vous convient pas, utilisez des parenthèses pour le modifier :
À titre d'exemple, (2 + 3) * 2 égale 10.
Lorsqu'un opérateur ou une fonction de formule renvoie une exception en cours d'évaluation (une division par zéro, par exemple), le résultat est vide. L'erreur est consignée dans le journal des événements et l'utilisateur n'en est pas averti.
De même, il est considéré comme acquis que la condition est réglée sur FALSE lorsqu'un opérateur ou une fonction de formule renvoie une exception en cours d'évaluation. L'erreur est consignée dans le journal des événements et l'utilisateur n'en est pas averti.
Sources de champ
Les formules peuvent utiliser différentes sources de champ selon le type de ce dernier. Un champ de données d'index standard peut utiliser les sources de champ suivantes :
• Toute source de champ de données d'index standard prise en charge (Numérique, Décimal, Champs dépendants de type Numérique ou Décimal)
• Propriétés de table (fonction RowCount, par exemple)
• Propriétés de colonne de table (fonction Sum, par exemple)
La source d'un champ standard ne peut pas correspondre à un champ de colonne de table (ou alors indirectement uniquement, par le biais d'une fonction RowCount/Sum). Un champ de données d'index de colonne de table peut utiliser les sources de champ suivantes :
• Toute source de champ standard prise en charge (Numérique, Décimal, Champs dépendants de type Numérique ou Décimal).
• Un autre champ de données d'index de colonne de table appartenant à la même table (une colonne issue d'une autre table ne peut pas être référencée).
• Les propriétés de colonne de table (fonction Sum, par exemple), à l'exception de la colonne actuellement utilisée. Par conséquent, si la colonne de table « X » est en cours d'utilisation, il est impossible d'utiliser la formule « X.Sum ».
Mot clé « This »
En mise en forme conditionnelle uniquement, le mot clé « this » (sans guillemets) peut être utilisé. Le mot clé fait référence au champ dans lequel se trouve actuellement l'utilisateur.
Si, par exemple, un utilisateur est dans le champ « Calc », une mise en forme conditionnelle serait de type :
Calc > 10
Le mot clé « this » permet également de référencer le champ :
this > 10
Le mot clé « this » fonctionne en mise en forme conditionnelle uniquement car un calcul ne peut pas faire référence à lui-même. Dans certains cas spéciaux, la catégorie comporte déjà un champ associé à la valeur FieldID « this ». Le mot clé « this » fait alors référence à l'autre champ et non à lui-même.
