Les champs de formule permettent de calculer différents types de valeurs, notamment des valeurs numériques, des valeurs texte, des valeurs de date, etc. Les champs de formule et leur valeur de retour associée disposent de types de données spécifiques, et certains opérateurs peuvent être utilisés pour chaque type de données. Il est nécessaire de comprendre le type de champs requis pour créer des champs de formule ainsi que la compatibilité entre les types de données et les opérateurs. Par exemple, l'opérateur « * » (pour la multiplication) s'utilise sur les valeurs numériques et non sur les valeurs texte.
Le tableau suivant vous aide à comprendre le type d'arguments requis pour les fonctions numériques ainsi que le type de syntaxe à utiliser.
|
Fonction |
Description |
Utilisation |
Exemples |
|
Abs |
Renvoie la valeur absolue du nombre. |
Abs(nombre) |
Abs(-42) renvoie 42 ; Abs(+33) renvoie 33 |
|
Ceil |
Renvoie le plus petit nombre entier supérieur ou égal au nombre saisi. |
Ceil(nombre) |
Ceil(3,4) renvoie 4 ; Ceil(-3,4) renvoie -3 |
|
Floor |
Renvoie le plus grand nombre entier inférieur ou égal au nombre saisi. |
Floor(nombre) |
Floor(3,8) renvoie 3 ; Floor(-3,4) renvoie -4 |
|
Naturallog |
Renvoie le logarithme naturel d'un nombre |
Naturallog(nombre) |
Naturallog(1) renvoie 0,69 |
|
Base10log |
Renvoie le logarithme en base 10 du nombre saisi |
Base10log(nombre) |
Base10log(10) renvoie 1,0 |
|
Max |
Renvoie la valeur maximale de la liste spécifiée de types de données compatibles. |
Max(valeur1, valeur2,...) |
Max(3,1,5,2) renvoie 5 ; Max(0,-4,-3,2) renvoie 2 |
|
Min |
Renvoie la valeur minimale de la liste spécifiée de types de données compatibles. |
Min(valeur1, valeur2,...) |
Min(5,-3,0,1) renvoie -3 ; Min(5,0,.01,0,5) renvoie 0,0 |
|
Sqrt |
Renvoie la racine carrée du nombre saisi. |
Sqrt(nombre) |
Sqrt(4) renvoie 2 ; Sqrt(9) renvoie 3 |
|
FromTimestamp |
Crée une date et une heure à partir d'un timestamp |
FromTimestamp(nombre) |
FromTimestamp(1581066895) donne le résultat 7 février 2020 14:44 Remarque : L'exemple ci-dessus concerne le fuseau horaire IST. Les valeurs changeront en fonction du fuseau horaire de l'utilisateur. |
|
IsPositive |
Vérifie si le nombre est positif |
IsPositive(nombre) |
IsPositive(-345) donne le résultat faux |
|
IsNegative |
Vérifie si le nombre est négatif |
IsNegative(nombre) |
IsNegative(-345) donne le résultat vrai |
|
Round |
Arrondit le nombre à la valeur la plus proche selon la précision spécifiée. |
Round(nombre) ; Round(nombre,nombre) |
Round(3,8) donne le résultat 4 ; Round(-3,5) donne le résultat -3 ; Round(3,417,2) donne le résultat 3,42 |
Pour créer des champs de formule de type numérique
Le tableau suivant vous aide à comprendre le type d'arguments requis pour les fonctions de formule ainsi que le type de syntaxe à utiliser.
| Fonction | Description | Utilisation |
Exemples
|
| Len | Retourne le nombre de caractères dans une chaîne de texte spécifiée. | Len(chaîne) | Len('abc') retourne 3 ; Len(' abc ') retourne 5 |
| Find | Retourne la nième occurrence de la chaîne de texte. | Find('chaîne','chaîne de recherche',nombre) | Find('greenery','n',1) retourne 5 |
| Concat | Retourne la concaténation de toutes les chaînes. | Concat('chaîne','chaîne',...) | Concat('FirstName',' ','LastName') retourne FirstName LastName |
| Contains | Retourne true si la chaîne de recherche se trouve dans l'autre chaîne, sinon retourne false. | Contains('chaîne','chaîne de recherche') | Contains('abcdef','cd') retourne true |
| Startswith | Retourne true si la chaîne commence par la chaîne de recherche, sinon retourne false. | Startswith('chaîne','chaîne de recherche') | Startswith('abcdef','cd') retourne false Startswith('abcdef','abc') retourne true |
| Endswith | Retourne true si la chaîne se termine par la chaîne de recherche, sinon retourne false. | Endswith('chaîne','chaîne de recherche') | Endswith('abcdef','ab') retourne false Endswith('abcdef','ef') retourne true |
| Lower | Convertit tous les caractères d'une chaîne en minuscules. | Lower('string') | Lower('APPLES') retourne "apples" Lower('Apples') retourne "apples" |
| Upper | Convertit tous les caractères d'une chaîne en majuscules. | Upper('string') | Upper('apples') retourne "APPLES" Upper('APPles') retourne "APPLES" |
| Trim | Retourne une chaîne avec les espaces de début et de fin supprimés. | Trim('string') | Trim(' abcd ') retourne "abcd" |
| Substring | Retourne une portion d'une chaîne d'entrée, depuis une position de départ dans la chaîne jusqu'à la longueur spécifiée. | Substring('string',n1,n2) | Substring('abcdefg',4,7) retourne "defg" |
| Replace | Remplace chaque occurrence de la chaîne recherchée dans la chaîne d'entrée par la chaîne de remplacement correspondante. | Replace('string','search string','replace string') | Replace('abcdefg','abc','xyz') retourne "xyzdefg" |
| Tostring | Convertit tout argument en type de données chaîne. | Tostring(generic argument) | Tostring(3.4) retourne "3.4" Tostring('') retourne < empty > |
|
CaseInsensitiveEquals |
Compare deux chaînes de manière insensible à la casse.
|
CaseInsensitiveEquals(string,string) |
CaseInsensitiveEquals('asdf','AsDf') retourne true ; CaseInsensitiveEquals('asdf','AsDg') retourne false |
|
IsEmpty |
Vérifie si la valeur est vide ou non. |
IsEmpty(generic) |
IsEmpty('') retourne true ; IsEmpty('asdf') retourne false ; IsEmpty(${Customer.Score}) retourne true si Score n'est pas saisi. |
|
DateBetween |
Retourne le délai entre deux dates, l'unité pouvant être des années, des mois, des semaines, des jours, des heures ou des minutes. |
DateBetween(date-time,date-time,string) |
DateBetween(Newdate(2022,02,10,11,30,'AM'), Newdate(2023,02,19,11,30,'AM'),'years') retourne 1 |
Pour créer des champs de formule de type String
Le tableau ci-dessous vous aide à comprendre le type d'arguments requis pour les fonctions DateTime ainsi que le type de syntaxe à former.
| Fonction | Description | Utilisation | Exemples |
| Newdate | Crée une date à partir de l'année, du mois, du jour et de l'heure. | Newdate(year,month,day, hour,minute,'string') | Newdate(2007,12,21,06,30,'AM') returns quot;21/12/2007 06:30 AM"1 |
| Datepart | Retourne la valeur de date pour l'expression de date/heure. | Datepart(datetime argument) | Datepart(Newdate(2007,12,21,06,30,'AM')) returns "21/12/2007"1 |
| Timepart | Retourne la valeur d'heure pour l'expression de date/heure. | Timepart(datetime argument) | Timepart(Newdate(2007,12,21,06,30,'AM')) returns "06.30 AM" |
| Adddate | Retourne la date obtenue en ajoutant n (year/day/month/hour/min) à la date donnée. | Adddate(datetime,number, 'string') | Adddate(Newdate(2007,12,21,06,30,'AM'),2,'YEAR' returns "21/12/2009 06:30 AM"2 |
| Subdate | Retourne la date obtenue en soustrayant n (year/day/month/hour/min) de la date donnée. | Subdate(datetime,number, 'string') | Subdate (Newdate(2007,12,21,06,30,'AM'),2,'YEAR' returns "21/12/2005 06:30 AM"2 |
| Now | Retourne une date/heure représentant le moment actuel. | Now() | Now() returns "19/05/2009 10:52 AM" |
| Datecomp | Compare deux dates et retourne la différence en minutes. | Datecomp(Datetime, Datetime) | Datecomp(Newdate(2009,05,19,11,30,'AM'), Newdate(2009,05,19,12,30,'AM')) returns 660.0 3 |
| Dayofmonth | Retourne le jour du mois pour la date donnée. | Dayofmonth(Datetime) | Dayofmonth(Newdate(2009,05,19,11,30,'AM')) returns "19.0" |
| Hour | Retourne l'heure correspondant à la date donnée. | Hour(Datetime) | Hour(Newdate(2009,05,19,11,30,'AM')) returns "11.0" |
| Minute | Retourne la minute correspondant à la date donnée. | Minute(Datetime) | Minute(Newdate(2009,05,19,11,30,'AM')) returns "30.0" |
| Month | Retourne le mois correspondant à la date donnée. | Month(Datetime) | Month(Newdate(2009,05,19,11,30,'AM')) returns "5.0" |
| Year | Retourne l'année correspondant à la date donnée | Year(Datetime) | Year(Newdate(2009,05,19,11,30,'AM')) renvoie « 2009.0 » |
| Weekday | Renvoie le jour de la semaine (1-7) correspondant à la date saisie, où 1 est dimanche, 2 est lundi, et ainsi de suite. | Weekday(Datetime) | Weekday(Newdate(2009,05,19,11,30,'AM')) renvoie « 3.0 ». (Cela s'explique par le fait que le 19 mai est un mardi)4 |
|
Dayofweek |
Renvoie le jour de la semaine pour la date donnée. |
Dayofweek(date-time) |
Le 5 avril 2023 renvoie « wednesday » |
|
Dayofmonth |
Renvoie le chiffre correspondant au jour du mois pour la date donnée. |
Dayofmonth(date-time) |
Le 5 avril renvoie « 5 » |
|
Dayofyear |
Renvoie le chiffre correspondant au jour de l'année pour la date donnée. |
Dayofyear(date-time) |
Le 5 avril 2023 renvoie « 95 » |
|
Timestamp |
Renvoie l'horodatage de la valeur |
Timestamp(date-time) |
Timestamp(Newdate(2022,02,10,11,30,'AM')) donne le résultat 1 171 107 000 Remarque : L'exemple ci-dessus concerne le fuseau horaire IST. Les valeurs changeront selon le fuseau horaire de l'utilisateur. |
Pour créer des champs de formule de type date-heure
Remarque : pour garantir la précision et l'actualité de la durée, veuillez actualiser l'enregistrement manuellement avant de soumettre la valeur du champ de formule à vos processus.
|
ToNumber
|
NewDate |
|
Max
|
Dayofweek
|
|
Min
|
And
|
|
Base10log
|
Dayofyear
|
|
Naturallog
|
CaseInsensitiveEquals
|
|
Find
|
IsPositive
|
| Contains |
IsNegative
|
|
Startswith
|
DateBetween
|
|
Endswith
|
Timestamp |
|
Substring
|
FromTimestamp
|
|
Replace
|
ToString
|
|
Or
|
|
Si vous souhaitez arrêter ce calcul basé sur le temps en fonction d'un événement, vous pouvez choisir de spécifier une condition pour arrêter la mise à jour de la valeur de formule. Si vous cochez cette case, un espace de travail de formule s'ouvre pour vous permettre de fournir la syntaxe des conditions. Si un enregistrement respecte la condition spécifiée, le champ de formule arrêtera le minuteur à ce moment et affichera la valeur la plus récente.
Le tableau suivant vous aide à comprendre le type d'arguments requis pour les fonctions booléennes ainsi que le type de syntaxe à former.
| Fonction | Description | Utilisation | Exemples |
| If | Retourne l'une de deux valeurs, selon la valeur d'une condition logique donnée. Si le test booléen est vrai, If() retourne la valeur vraie ; sinon, il retourne la valeur fausse. | If(Boolean,Generic, Generic)* | If(8>7,1,0) retourne « 1.0 » If(8>7,'True','False') retourne « True » |
| And | Retourne une réponse vraie si toutes les expressions sont vraies ; retourne une valeur fausse même si l'une des expressions est fausse. | And(boolean,boolean ...) | And(2>1,5>3,7<8) retourne « true » And(2>1,5>3,7>8) retourne « false » |
| Or | Retourne vrai si une expression est vraie. Retourne faux si toutes les expressions sont fausses. | Or(boolean,...) | Or(2>1,3>5,7>8) retourne « true » Or(1>2,3>5,7>8) retourne « false » |
| Not | Retourne la négation logique de l'expression donnée (si l'expression est vraie, retourne faux). | Not(boolean) | Not(false) retourne « true » Not(true) retourne « false » |
* Generic implique n'importe quel type de données : Nombre, Chaîne, Datetime (y compris la date normale) ou Booléen. Le type de retour dépend du type de données sélectionné. Par exemple, si le type de données générique est un nombre, le type de retour doit être Numérique et non chaîne ou booléen.
Pour créer des champs de formule de type booléen
Le tableau suivant affiche la référence fonctionnelle pour créer des formules ainsi que leurs arguments disponibles.
| Nom de la fonction | Nombre d'arguments requis | Type de données de l'argument | Type de retour |
| Abs | 1 | Nombre | Nombre |
| Ceil | 1 | Nombre | nombre |
| Floor | 1 | Nombre | Nombre |
| Naturallog | 1 | Nombre | Nombre |
| Base10log | 1 | Nombre | Nombre |
| Maximum | Multiple | Tous les nombres | Nombre |
| Minimum | Multiple | Tous les nombres | Nombre |
| Racine carrée | 1 | Nombre | Nombre |
| Nom de la fonction | Nombre d'arguments obligatoires | Type de données de l'argument | >Type de retour |
| Longueur | 1 | Chaîne | Nombre |
| Rechercher | 3 | Chaîne : Chaîne : Nombre | Nombre |
| Concaténer | Multiple | Toutes les chaînes | Chaîne |
| Contient | 2 | Chaîne : Chaîne | Booléen |
| Commence par | 2 | Chaîne : Chaîne | Booléen |
| Se termine par | 2 | Chaîne : Chaîne | Booléen |
| Minuscules | 1 | Chaîne | Chaîne |
| Majuscules | 1 | Chaîne | Chaîne |
| Supprimer les espaces | 1 | Chaîne | Chaîne |
| Sous-chaîne | 3 | Chaîne : Nombre : Nombre | Chaîne |
| Remplacer | 3 | Chaîne : Chaîne : Chaîne | Chaîne |
| Convertir en chaîne | 1 | Tout type de données | Chaîne |
| Nom de la fonction | Nombre d'arguments obligatoires | Type de données de l'argument | Type de retour |
| Nouvelle date | 6 | Nombre : Nombre : Nombre : Nombre : Nombre : Chaîne | Datetime |
| Datepart | 1 | Datetime | String |
| Timepart | 1 | Datetime | String |
| Adddate | 3 | Datetime : Nombre : String | Datetime |
| Subdate | 3 | Datetime : Nombre : String | Datetime |
| Now | 0 | - | Datetime |
| Datecomp | 2 | Datetime : Datetime | Nombre |
| Dayofmonth | 1 | Datetime | Nombre |
| Hour | 1 | Datetime | Nombre |
| Minute | 1 | Datetime | Nombre |
| Month | 1 | Datetime | Nombre |
| Year | 1 | Datetime | Nombre |
| Weekday | 1 | Datetime | Nombre |
| Nom de la fonction | Nombre d'arguments requis | Type de données de l'argument | Type de retour |
| If | 3 | Booléen : Générique : Générique | Générique |
| And | Plusieurs | Tous booléens | Booléen |
| Or | Plusieurs | Tous booléens | Booléen |
| Not | 1 | Booléen | Booléen |
