Quand vous commencerez à créer vos propres mesures et attributs, vous utiliserez beaucoup les fonctions pour vous aider à effectuer des comparaisons, des calculs et des manipulations de vos informations commerciales.
Explore propose de nombreuses fonctions pour vous aider à travailler avec, par exemple, des dates, des chaînes de texte, des calculs, etc. Utilisez cet article comme référence pour découvrir les fonctions disponibles et comment les utiliser.
Cet article aborde les sujets suivants :
Mise en route
Vous pouvez rechercher et sélectionner des fonctions quand vous créez une mesure ou un attribut calculé standard. Dans la fenêtre de modification de formule, vous pouvez commencer à taper le nom d’une fonction ou cliquer sur Ajouter sous Fonctions et choisir une fonction dans la liste.
Quand la fonction est ajoutée à la formule, elle s’affiche avec des valeurs standard. Vous devez les remplacer par les valeurs que vous souhaitez utiliser dans votre formule. Dans cet exemple, vous voulez uniquement renvoyer les tickets avec une ligne de sujet commençant par « [Flagged] ».
- Dans le menu Calculs (), cliquez sur Attribut calculé standard.
- Donnez un nom à votre attribut calculé. Cet exemple utilise Subject begins with [Flagged].
- Sous Fonctions, cliquez sur Ajouter.
- Dans la fenêtre de formule, tapez IF.
- Sous Fonctions, cliquez sur Ajouter.
- Recherchez LEFTPART. Vous pouvez utiliser le champ de recherche, cliquer sur Filtrer pour limiter les valeurs à la catégorie Texte ou faire défiler la liste jusqu’à ce que vous trouviez la fonction de votre choix.
- En regard de LEFTPART, cliquez sur +.
- Vous voyez maintenant la formule IF LEFTPART(_text,_number). Remplacez le paramètre _text par l’attribut Sujet du ticket. Vous pouvez soit mettre _text en surbrillance puis choisir Sujet du ticket dans le menu Champs, soit modifier la formule manuellement pour y ajouter l’attribut.
Vous voyez maintenant la formule IF LEFTPART([Sujet du ticket],_number)
- Remplacez text_number par le nombre de caractères que vous voulez comparer. [Flagged] contient neuf caractères, saisissez donc 9.
Vous voyez maintenant la formule IF LEFTPART([Sujet du ticket],9)
- Enfin, ajoutez la condition que nous recherchons, ici le texte « [Flagged] ». La formule finale est la suivante :
IF LEFTPART([Sujet du ticket],9)="[Flagged]" THEN [ID du ticket] ENDIF
Maintenant, quand vous utilisez cet attribut dans votre rapport, il ne renverra que les tickets avec une ligne de sujet commençant par « [Flagged] ».
Pour plus d’aide et d’exemples, consultez Création de formules Explore.
Opérateurs mathématiques élémentaires
En plus des fonctions ci-dessus, vous pouvez aussi utiliser des opérateurs mathématiques élémentaires suivants pour effectuer des calculs et connecter du texte.
Opérateur | Description |
+ | Additionner deux valeurs numériques ou joindre deux chaînes de texte. |
- | Soustraire une valeur d’une autre valeur. |
* | Multiplier deux valeurs |
/ | Diviser une valeur par une autre valeur |
= | Tester si une valeur est égale à une autre |
!= | Tester si une valeur n’est pas égale à une autre |
> |
Tester si la première valeur est supérieure à la valeur suivante (x>y) |
< |
Tester si la première valeur est inférieure à la valeur suivante (x<y) |
>= |
Tester si la première valeur est supérieure ou égale à la valeur suivante (x>=y) |
<= |
Tester si la première valeur est inférieure ou égale à la valeur suivante (x<=y) |
% | Calculer le reste après la division d’une valeur par une autre. Exemple : 5%2 renvoie 1, 20%3 renvoie 2 |
Fonctions logiques
Ces fonctions vous offrent une grande souplesse d’analyse et de présentation de vos informations.
Fonction | Description |
Expression conditionnelle IF THEN ELSE | Vous permet d’évaluer des valeurs logiques. Format : IF (condition) THEN (valeur si vrai) ELSE (valeur si faux) ENDIF Pour des informations détaillées au sujet de cette fonction, consultez Utilisation de la fonction IF THEN ELSE. |
ET | Renvoie TRUE si les deux expressions fournies sont VRAIES. Exemple : IF ([Canal du ticket]="E-mail") AND ([E-mail de l’envoyeur]="fred@fredco.com") THEN [ID du ticket] ENDIF Renvoie tous les tickets reçus par e-mail de l’adresse fred@freedco.com. |
OU | Renvoie TRUE si au moins l’une des deux expressions fournies est VRAIE. Exemple : IF ([Canal du ticket]="E-mail") OR ([Canal du ticket]="Centre d’appels") THEN [ID du ticket] ENDIF Renvoie tous les tickets reçus par les canaux E-mail ou Centre d’appels. |
NOT | Inverse la valeur logique de l’expression fournie. Exemple : IF NOT([Canal du ticket]="E-mail") THEN [ID du ticket] ENDIF Renvoie tous les tickets qui n’ont pas été reçus par e-mail. |
TRUE | Renvoie la valeur logique TRUE. |
FALSE | Renvoie la valeur logique FALSE. |
IN(_param,_array) | Renvoie TRUE si le premier paramètre saisi se trouve dans le tableau spécifié dans le deuxième paramètre. Exemples : IN(200,ARRAY(100,200,300,400)) renvoie TRUE IN(250,ARRAY(20,40,60,80)) renvoie FALSE |
Expression conditionnelle SWITCH | SWITCH est une alternative plus simple aux déclarations IF THEN ELSE à plusieurs branches. SWITCH (_tested_element) { CASE _value1 : _return_value CASE _value2 : _return_value DEFAULT : _default_return_value } Pour des informations détaillées au sujet de cette fonction, consultez Ajout de plusieurs expressions conditionnelles avec SWITCH. |
Fonctions d’attributs
Ces fonctions vous permettent d’effectuer des opérations élémentaires pour quantifier le nombre d’attributs renvoyés par votre rapport. Vous pouvez aussi effectuer des opérations plus complexes pour « verrouiller » ou élargir le niveau d’agrégation de vos calculs.
Fonction | Description |
COUNT_VALUES(_attribute) | Compte le nombre de valeurs de l’attribut que vous fournissez. Les valeurs répétées sont incluses. Peut être utilisée comme condition dans les mesures et les attributs calculés, mais pas dans la clause THEN d’une mesure calculée. Exemple : IF COUNT_VALUES([ID du ticket])>30 THEN 1 ELSE 0 ENDIF L’exemple ci-dessus renvoie 1 quand il y a plus de 30 tickets et 0 quand il y en a moins de 30.
Conseil – si vous voulez créer une mesure qui compte le nombre de valeurs d’un attribut, la formule de la mesure doit simplement être [Attribut]. Vous pouvez alors appliquer l’agrégateur COUNT comme à l’accoutumée.
|
DCOUNT_VALUES(_attribute) | Compte le nombre distinct de valeurs différentes de l’attribut que vous fournissez. Peut être utilisée comme condition dans les mesures et les attributs calculés, mais pas dans la clause THEN d’une mesure calculée. Exemple : IF COUNT_VALUES([Nom de l’organisation])>100 THEN 1 ELSE 0 ENDIF L’exemple ci-dessus renvoie 1 quand il y a plus de 100 organisations distinctes et 0 quand il y en a moins de 100.
Conseil – si vous voulez créer une mesure qui compte le nombre de valeurs distinctes d’un attribut, la formule de la mesure doit simplement être [Attribut]. Vous pouvez alors appliquer l’agrégateur D_COUNT comme à l’accoutumée.
|
ATTRIBUTE_FIX(aggregator(metric name), attribute1, attribute2) |
Renvoie la valeur de aggregator(metric name) agrégée par les attributs que vous spécifiez (dans cet exemple, attribute1 et attribute2). Aucun autre attribut ne peut affecter les résultats de cette mesure. Les attributs calculés ne peuvent pas être utilisés dans une fonction ATTRIBUTE_FIX. Exemple : ATTRIBUTE_FIX(MED(Délai avant première réponse - min), [Ticket créé - Année], [Ticket créé - Mois]) Pour plus d’aide et des exemples, consultez Utilisation des fonctions de niveau d’agrégation. |
ATTRIBUTE_ADD(aggregator(metric name), attribute1, attribute2) |
Renvoie la valeur de aggregator(metric name) agrégée par tous les attributs dans le rapport en plus de attribute1 et attribute2). Les attributs calculés ne peuvent pas être utilisés dans une fonction ATTRIBUTE_ADD. Exemple : ATTRIBUTE_ADD(MED(Délai avant première réponse - min), [Ticket créé - Année], [Ticket créé - Mois]) Pour plus d’aide et des exemples, consultez Utilisation des fonctions de niveau d’agrégation. |
Fonctions de marqueurs
Ces fonctions vous aident à chercher la présence ou l’absence de marqueurs. Cela peut inclure les marqueurs de ticket, les marqueurs d’appel ou n’importe quoi d’autre qui utilise des marqueurs.
Fonction | Description |
INCLUDES_ALL([tag attribute], "tag1", "tag2") | Renvoie TRUE si tous les marqueurs spécifiés sont inclus dans l’attribut du marqueur. Exemples : INCLUDES_ALL([Marqueurs de ticket], "Londres", "Milan") renvoie TRUE si un ticket contient les marqueurs "Londres" et "Milan". NOT INCLUDES_ALL([Marqueurs de ticket], "Londres", "Milan") renvoie TRUE si un ticket ne contient pas les deux marqueurs "Londres" et "Milan". Pour en savoir plus au sujet de l’utilisation de cette fonction, consultez Utilisation des marqueurs dans les rapports. |
INCLUDES_ANY([tag attribute], "tag1", "tag2") | Renvoie TRUE si un des marqueurs spécifiés est inclus dans l’attribut du marqueur. Exemples : INCLUDES_ANY([Marqueurs de ticket], "Londres", "Milan") renvoie TRUE si un ticket contient le marqueur "Londres" ou le marqueur "Milan". NOT INCLUDES_ANY([Marqueurs de ticket], "Londres", "Milan") renvoie TRUE si un ticket ne contient ni le marqueur "Londres" ni le marqueur "Milan". Pour en savoir plus au sujet de l’utilisation de cette fonction, consultez Utilisation des marqueurs dans les rapports. |
Fonctions de texte
Ces fonctions vous permettent d’effectuer des opérations qui recherchent et évaluent du texte. Vous pouvez aussi modifier le texte en utilisant des formules et des schémas que vous créez.
Pour des exemples d’utilisation des fonctions texte (comme CONTAINS, LEFTPART, SUBSTR, FIND et LENGTH), consultez Recette Explore : Rapports sur les champs déroulants imbriqués.
Fonction | Description |
CONTAINS(_text,_text_to_search) | Renvoie TRUE si le premier paramètre saisi contient le deuxième comme sous-chaîne. Exemple : CONTAINS([Nom de l’envoyeur],"Sally")
|
ENDSWITH(_text,_text_to_search) | Renvoie TRUE si le premier texte fourni se termine par le deuxième. Exemple : ENDSWITH([État américain],"ippi") renvoie TRUE pour Mississippi, mais FALSE pour Delaware. |
FIND(_text,_text_to_find,_number_start_index) |
Renvoie l’index, dans le premier texte saisi, de la première instance du deuxième texte saisi, à partir de l’index de départ saisi. Renvoie -1 si le deuxième texte saisi est introuvable. L’index du premier caractère d’une chaîne est 0. Exemples : Si [Mode de livraison]="Urgent" alors FIND([ShipMode","Norm",0) renvoie -1 Si [Mode de livraison]="Normal" alors FIND([ShipMode","ma",0) renvoie 3 Si [Mode de livraison]="Urgent" alors FIND([ShipMode","ge",2) renvoie 0 |
LEFTPART(_text,_number) | Renvoie le nombre (_number) de caractères les plus à gauche dans le texte fourni. Exemple : Si [Service]="Documentation technique" alors LEFTPART([Service],9) renvoie "Documenta" |
LENGTH(_text) | Renvoie la longueur (nombre de caractères) du texte fourni. Exemple : LENGTH([Catégorie de produits]) renvoie la longueur de chaque valeur de l’attribut Catégorie de produits. |
LOWERCASE(_text) | Convertit et renvoie le texte fourni en minuscules. |
LTRIM(_text) | Renvoie la valeur de l’attribut fourni avec tous les espaces blancs à gauche supprimés. Exemple : LTRIM([Nom]) renvoie " Peter" si [Nom] est " Peter " |
REPLACE(_text,_text_to_replace,_text_to_replace_with) | Renvoie une copie de _text dans laquelle toutes les instances de _text_to_replace ont été remplacées par _text_to_replace_with. Exemple : Si [État américain]="new York" alors REPLACE([État américain],"n","N") renvoie "New York" |
RIGHTPART(_text,_number) | Renvoie le nombre (_number) de caractères les plus à droite dans le texte fourni. Exemple : Si [Service]="Documentation technique" alors RIGHTPART([Service],13) renvoie "ion technique" |
RTRIM(_text) | Renvoie la valeur de l’attribut fourni avec tous les espaces blancs à droite supprimés. Exemple : RTRIM([Nom]) renvoie " Peter" si [Nom] est " Peter " |
STARTSWITH(_text,_text_to_search) | Renvoie TRUE si le premier texte fourni commence par le deuxième. Exemple : STARTSWITH([État américain],"Miss") renvoie TRUE pour Mississippi, mais FALSE pour Delaware. |
IS_POSITIVE(_text) | Renvoie TRUE pour Positif ou FALSE pour Négatif d’après l’analyse du texte. |
SUBSTR(_text,_number_start_index,_number_end_index) |
Renvoie une partie de _text composée du caractère spécifié par l’index de départ (le premier entier saisi) et tous les caractères jusqu’à l’index-1 de fin (le deuxième entier saisi). Exemple : SUBSTR("Web marketing",0,3) renvoie "Web" |
TRIM(_text) | Renvoie la valeur de l’attribut fourni avec tous les espaces blancs à gauche et à droite supprimés. Exemple : RTRIM([Nom]) renvoie "Peter" si [Nom] est " Peter |
UPPERCASE(_text) | Convertit et renvoie le texte fourni en majuscules. |
STRING(_number) | Convertit le nombre fourni en chaîne. |
LPAD(_text,_length,_pad) | Ajoute un écart de remplissage sur la gauche de _text en utilisant _pad jusqu’à ce que la chaîne atteigne la longueur _length. Exemple : LPAD("1",7,"?") renvoie "??????1" |
RPAD(_text,_length,_pad) | Ajoute un écart de remplissage sur la droite de _text en utilisant _pad jusqu’à ce que la chaîne atteigne la longueur _length. Exemple : RPAD("1",7,"?") renvoie "1??????" |
LINK(_url,_label) | Renvoie un lien HTML pointant vers l’URL fournie. Pour un exemple, consultez Recette Explore : configuration de liens cliquables vers les tickets. |
Fonctions d’expressions régulières
Une expression régulière (parfois appelée regex ou regexp) est une séquence de caractères définissant un schéma de recherche. Explore prend en charge l’utilisation des expressions régulières pour effectuer les calculs suivants dans vos formules :
Fonction | Description |
REGEXP_MATCH(_text,_regexp) | Renvoie TRUE si le texte correspond à l’expression régulière. |
REGEXP_EXTRACT(_text,_regexp) | Renvoie la partie du texte qui correspond au groupe de capture dans l’expression régulière. Pour un exemple d’utilisation de cette fonction, consultez Puis-je créer des rapports sur le domaine de messagerie des utilisateurs dans Explore ? |
REGEXP_REPLACE(_text,_regexp,_replace_text) | Renvoie une chaîne où toute sous-chaîne de texte qui correspond à l’expression régulière est remplacée par replace_text. Exemple : REGEXP_REPLACE("Hello","lo","p") renvoie "Help" |
Pour en savoir plus au sujet des expressions régulières, consultez cette page Wikipedia.
Fonctions de dates
Explore vous permet de créer, comparer et effectuer des calculs sur les dates et les heures. Ces fonctions sont particulièrement utiles, car il est probable que vous passiez beaucoup de temps à analyser les informations de votre entreprise pour une période donnée.
Fonction | Description |
DATE(_text) | Convertit le texte fourni en date avec un horodatage UTC. Le texte peut être spécifié dans des formats différents, mais doit au moins inclure le mois, la date et l’année. Exemples :
|
DATE_EQUAL(_date,_date) | Renvoie TRUE si les deux dates spécifiées sont égales. Exemple : IF DATE_EQUAL([Ticket créé - Mois],[Ticket résolu - Mois]) THEN [ID du ticket] ENDIF Renvoie tous les tickets qui ont été résolus le mois de leur création. L’année n’est pas incluse dans cet exemple, donc un ticket créé en juin 2018 et résolu en juin 2020 serait renvoyé par cet exemple. |
DATE_NOT_EQUAL(_date,_date) | Renvoie TRUE si les deux dates saisies ne sont pas égales. Exemple : IF DATE_EQUAL([Ticket créé - Mois],[Ticket résolu - Mois]) THEN [ID du ticket] ENDIF Renvoie tous les tickets qui n’ont pas été résolus le mois de leur création. |
DATE_LESS(_date,_date) | Renvoie TRUE si la première date est plus ancienne que la seconde date. Exemple : IF DATE_LESS([Ticket affecté - Date],[Échéance du ticket - Date - Date]) THEN [ID du ticket] ENDIF Renvoie tous les tickets affectés avant leur date d’échéance. |
DATE_LESS_OR_EQUAL(_date,_date) | Renvoie TRUE si la première date est plus ancienne ou la même que la seconde date. Exemple : IF DATE_LESS_OR_EQUAL([Ticket affecté - Date],[Échéance du ticket - Date - Date]) THEN [ID du ticket] ENDIF Renvoie tous les tickets affectés avant ou le jour de leur date d’échéance. |
DATE_GREATER(_date,_date) | Renvoie TRUE si la première date est ultérieure à la seconde date. Exemple : IF DATE_GREATER([Ticket affecté - Date],[Échéance du ticket - Date - Date]) THEN [ID du ticket] ENDIF Renvoie tous les tickets affectés après leur date d’échéance. |
DATE_GREATER_OR_EQUAL(_date,_date) | Renvoie TRUE si la première date ultérieure ou égale à la seconde date. Exemple : IF DATE_GREATER_OR_EQUAL([Ticket affecté - Date],[Échéance du ticket - Date - Date]) THEN [ID du ticket] ENDIF Renvoie tous les tickets affectés le jour de leur date d’échéance ou plus tard. |
DATE_ADD(_date,_date_part,_increment) |
Renvoie la date donnée dans le fuseau horaire de l’utilisateur, mise à jour en fonction de l’incrément saisi. Le paramètre _date_part pourrait être par exemple year, quarter, month, day, hour, etc. L’incrément spécifié doit être une valeur entière, mais il peut être négatif. |
DATE_DIFF(_date,_date,_date_part) | Renvoie la différence relative ou exacte entre deux dates dans le format de votre choix. Dans la fonction, _date_part peut être l’une des mesures suivantes : Pour les différences relatives (nombres entiers) :
Pour les valeurs exactes :
Exemples : DATE_DIFF("2011/10/22","2008/01/06","year") renvoie 3 (2011-2008) DATE_DIFF("2011/10/22","2008/01/06","nb_of_years") renvoie 4 (nombre d’années réel) DATE_DIFF("2019/03/06","2019/03/05","day") renvoie 1 DATE_DIFF("2019/03/06","2017/03/05","nb_of_days") renvoie 731 |
DATE_FORMAT(_date,_format) | Renvoie la date saisie dans le fuseau horaire de l’utilisateur et dans le format fourni. Pour la liste des formats que vous pouvez utiliser, consultez Mise en forme des dates. |
TODAY() | Renvoie la date du jour dans le fuseau horaire de l’utilisateur. |
NOW() | Renvoie la date et l’heure (c’est-à-dire heures, minutes, secondes) actuelles dans le fuseau horaire de l’utilisateur. |
CURRENT_YEAR() | Renvoie l’année en cours. |
CURRENT_HALFYEAR() | Renvoie le semestre en cours sous forme de texte (H1 ou H2). |
CURRENT_QUARTER() | Renvoie le trimestre en cours sous forme de texte (Q1, Q2, Q3 ou Q4). |
CURRENT_MONTH() | Renvoie le mois en cours, par exemple « January », « February ». |
CURRENT_MONTH_NUMERIC() | Renvoie le mois en cours sous forme d’un nombre (1 pour janvier, 2 pour février, etc.). |
CURRENT_DAY() | Renvoie le jour actuel sous forme de nombre. |
CURRENT_WEEKDAY() | Renvoie le jour de la semaine actuel sous forme de texte, par exemple « Monday », « Tuesday ». |
CURRENT_WEEKDAY_NUMERIC() | Renvoie le jour de la semaine actuel sous forme d’un nombre (0 pour dimanche, 1 pour lundi, etc.). |
CURRENT_HOUR() | Renvoie l’heure actuelle dans le fuseau horaire de l’utilisateur sous la forme d’un nombre. |
CURRENT_MINUTE() | Renvoie la minute actuelle dans le fuseau horaire de l’utilisateur sous la forme d’un nombre. |
CURRENT_SECOND() | Renvoie la seconde actuelle dans le fuseau horaire de l’utilisateur sous la forme d’un nombre. |
YEAR(_date) | Renvoie l’année de la date fournie. |
MONTH(_date) | Renvoie le mois de la date fournie sous forme de texte, par exemple « January », « February ». |
MONTH_NUMERIC(_date) | Renvoie le mois de la date fournie sous forme d’un nombre (1 pour janvier, 2 pour février, etc.). |
DAY(_date) | Renvoie le jour de la date fournie. |
WEEKDAY(_date) | Renvoie le jour de la date fournie sous forme de texte, par exemple « Monday », « Tuesday ». |
WEEKDAY_NUMERIC(_date) | Renvoie le jour de la date fournie sous forme d’un nombre (1 pour dimanche, 2 pour lundi, etc.). |
HOURS(_date) | Renvoie l’heure de la date fournie. |
MINUTES(_date) | Renvoie les minutes de la date fournie. |
SECONDS(_date) | Renvoie les secondes de la date fournie. |
WEEK_NUMBER(_date) | Renvoie le numéro de semaine associé à la date fournie. Consultez Impact du début de la semaine sur les numéros des semaines. |
WEEK_NUMBER_MONDAY(_date) | Renvoie le numéro de semaine associé à la date fournie commençant le lundi. |
WEEK_NUMBER_FRIDAY(_date) | Renvoie le numéro de semaine associé à la date fournie commençant le vendredi. |
WEEK_NUMBER_SATURDAY(_date) | Renvoie le numéro de semaine associé à la date fournie commençant le samedi. |
WEEK_NUMBER_SUNDAY(_date) | Renvoie le numéro de semaine associé à la date fournie commençant le dimanche. |
START_OF_QUARTER(_date) | Renvoie le début du trimestre pour la date fournie. |
END_OF_QUARTER(_date) | Renvoie la fin du trimestre pour la date fournie. |
START_OF_MONTH(_date) | Renvoie le début du mois pour la date fournie. |
END_OF_MONTH(_date) | Renvoie la fin du mois pour la date fournie. |
START_OF_WEEK(_date) | Renvoie le début de la semaine pour la date fournie. Consultez Configuration du début de la semaine pour les rapports et les filtres. |
END_OF_WEEK(_date) | Renvoie la fin de la semaine pour la date fournie. Consultez Configuration du début de la semaine pour les rapports et les filtres. |
START_OF_WEEK_MONDAY(_date) | Renvoie le début de la semaine correspondant à la date fournie, avec des semaines commençant le lundi. |
END_OF_WEEK_MONDAY(_date) | Renvoie la fin de la semaine correspondant à la date fournie, avec des semaines commençant le lundi. |
START_OF_WEEK_FRIDAY(_date) | Renvoie le début de la semaine correspondant à la date fournie, avec des semaines commençant le vendredi. |
END_OF_WEEK_FRIDAY(_date) | Renvoie la fin de la semaine correspondant à la date fournie, avec des semaines commençant le vendredi. |
START_OF_WEEK_SATURDAY(_date) | Renvoie le début de la semaine correspondant à la date fournie, avec des semaines commençant le samedi. |
END_OF_WEEK_SATURDAY(_date) | Renvoie la fin de la semaine correspondant à la date fournie, avec des semaines commençant le samedi. |
START_OF_WEEK_SUNDAY(_date) | Renvoie le début de la semaine correspondant à la date fournie, avec des semaines commençant le dimanche. |
END_OF_WEEK_SUNDAY(_date) | Renvoie la fin de la semaine correspondant à la date fournie, avec des semaines commençant le dimanche. |
DATE_FROM_ISO | Renvoie un horodatage si le paramètre est une chaîne d’horodatage standard ISO. Suppose que l’horodatage a un fuseau horaire, mais les horodatages sans informations de fuseau horaire peuvent être analysés en définissant le paramètre facultatif Ignorer le fuseau horaire sur TRUE. Exemples : DATE_FROM_ISO("2020-07-24T13:42:00Z") DATE_FROM_ISO("2020-07-24T13:42EST") DATE_FROM_ISO("2020-07-24T13:42+05") DATE_FROM_ISO("2020-07-24T13:42," TRUE) |
DATE_FROM_TIMESTAMP(_timestamp) | Renvoie une date à partir d’un horodatage UNIX fourni en secondes. |
DATE_FROM_MILLI_TIMESTAMP(_timestamp) | Renvoie une date à partir d’un horodatage UNIX fourni en millisecondes. |
DATE_TO_TIMESTAMP(_date) | Renvoie un horodatage UNIX dans le fuseau horaire de l’utilisateur à partir d’une date fournie. |
DATE_TO_MILLI_TIMESTAMP(_date) | Renvoie un horodatage UNIX en millisecondes à partir d’une date fournie. |
SECONDS_TO_TIME(_time) | Convertit une durée en secondes au format HH:MM:SS. |
FISCAL_YEAR(_date,_start_month) | Renvoie l’année fiscale en fonction de la date fournie et du mois de début. Le paramètre month doit être le nom complet du mois (par exemple, « février », et non « fév. »). |
FISCAL_QUARTER(_date,_start_month) | Renvoie le trimestre fiscal en fonction de la date fournie et du mois de début. Le paramètre month doit être le nom complet du mois (par exemple, « février », et non « fév. »). |
FISCAL_WEEK_NUMBER(_date,_start_month) | Renvoie le numéro de la semaine fiscale en fonction de la date fournie et du mois de début. Le paramètre month doit être le nom complet du mois (par exemple, « février », et non « fév. »). |
WEEKYEAR(_date) | Renvoie l’année du numéro de semaine associé à la date fournie. |
DATE_FIRST(time attribute) |
Renvoie la date ou l’horodatage les plus anciens d’après les attributs ajoutés au rapport et est affecté par tous les filtres appliqués. Exemple : DATE_FIRST([Mise à jour - Horodatage]) Renvoie l’horodatage de la mise à jour la plus ancienne d’après tous les attributs ajoutés au rapport. Pour plus d’aide et des exemples, consultez Utilisation des fonctions de date la plus ancienne et date la plus récente. |
DATE_LAST(time attribute) |
Renvoie la date ou l’horodatage les plus récents d’après les attributs ajoutés au rapport et est affecté par tous les filtres appliqués. Exemple : DATE_LAST([Mise à jour - Horodatage]) Renvoie l’horodatage de la mise à jour la plus récente d’après tous les attributs ajoutés au rapport. Pour plus d’aide et des exemples, consultez Utilisation des fonctions de date la plus ancienne et date la plus récente. |
DATE_FIRST_FIX(time attribute, attribute1, attribute2, ...) |
Renvoie la date ou l’horodatage les plus anciens d’après les attributs spécifiés dans la fonction. Les attributs ajoutés au rapport n’affectent pas le calcul, mais tous les filtres appliqués sont pris en compte. Exemple : DATE_FIRST_FIX([Mise à jour - Horodatage], [ID de la mise à jour du ticket]) Renvoie l’horodatage de la mise à jour la plus ancienne par ticket, quels que soient les attributs du rapport. Pour plus d’aide et des exemples, consultez Utilisation des fonctions de date la plus ancienne et date la plus récente. |
DATE_LAST_FIX(time attribute, attribute1, attribute2, ...) |
Renvoie la date ou l’horodatage les plus récents d’après les attributs spécifiés dans la fonction. Les attributs ajoutés au rapport n’affectent pas le calcul, mais tous les filtres appliqués sont pris en compte. Exemple : DATE_LAST_FIX([Mise à jour - Horodatage], [ID de la mise à jour du ticket]) Renvoie l’horodatage de la mise à jour la plus récente par ticket, quels que soient les attributs du rapport. Pour plus d’aide et des exemples, consultez Utilisation des fonctions de date la plus ancienne et date la plus récente. |
Mise en forme des dates
La fonction DATE_FORMAT rend les horodatages complets sous la forme de différents types de dates. Chaque format est représenté par une lettre différente. Vous saisissez la lettre associée dans la partie format de la fonction DATE_FORMAT. Les lettres doivent être saisies entre "guillemets doubles". Vous pouvez combiner les composants de date et d’heure pour afficher plus d’informations au sujet d’une date.
Par exemple, pour remplacer le format par défaut (2015-01-27T13:21:10) de l’attribut Ticket créé - Horodatage en format américain (Jan 27, 2015 01:21 PM), utilisez cette formule :
DATE_FORMAT([Ticket created - Timestamp],"Mon DD, YYYY hh:MI AM")
Le tableau montre les formats que vous pouvez utiliser. L’exemple utilise l’horodatage 2017-11-03T15:18:25.
Composant de date ou d’heure | Lettre | Exemple utilisant 2017-11-03T15:18:25 |
Année | AAAA | 2017 |
Année | AA | 17 |
Trimestre | T | T4 |
Numéro du mois | MM | 11 |
Nom du mois | moi | nov. |
Nom du mois | mois | novembre |
Semaine de l’année (1-53) | WW | 44 |
Semaine du mois (1-5) | S | 1 |
Numéro du jour de l’année (01-366) | JJJ | 307 |
Numéro du mois de l’année (01-31) | JJ | 3 |
Nom du jour de la semaine | Jour | vendredi |
Nom du jour de la semaine | J | Ven |
Heure de la journée (01-12) | hh | 3 |
Heure de la journée (1-23) | HH | 15 |
Minutes | MI | 18 |
Secondes | SS | 25 |
Milliseconde (000-999) | MS | 0 |
AM/PM | AM | PM |
Fonctions numériques
Ces fonctions vous permettent d’effectuer une vaste gamme de calculs mathématiques sur les informations de vos rapports.
Fonction | Description |
ABS(_number) | Renvoie la valeur absolue du nombre fourni.
Exemples : La valeur absolue de 1 est 1 La valeur absolue de -7,3 est 7,3 |
BETWEEN(_number,_number,_number) | Renvoie TRUE si le premier nombre fourni se trouve entre les deux autres nombres. Exemple : BETWEEN(SUM(Profit),500,1500) renvoie TRUE si SUM(Profit) est égale à, ou se trouve entre 500 et 1500. |
CEIL(_number) | Renvoie le plafond du nombre fourni. Le plafond d’un nombre est le nombre entier le plus proche qui est supérieur ou égal au nombre. Exemples : Le plafond de 125,4 est 126 Le plafond de -63,2 est -63 CEILING(SUM(Délai avant première résolution (min))) renvoie le nombre entier le plus proche supérieur à chaque délai avant première résolution stocké dans l’attribut. |
EXP(_number) | Renvoie la valeur de la base du logarithme naturel (e), à la puissance de l’exposant fourni. Exemple : EXP(SUM(Prix unitaire)) renvoie le logarithme naturel de chaque valeur de la mesure SUM(Prix unitaire). |
FLOOR(_number) | Renvoie la valeur plancher du nombre fourni. Le plancher d’un nombre est le nombre entier le plus proche qui est inférieur ou égal au nombre spécifié. Exemples : Le plancher de 125,4 est 125 Le plancher de -63,2 est -64 FLOOR(SUM(Délai avant première résolution (min))) renvoie le nombre entier le plus proche inférieur à chaque délai avant première résolution stocké dans l’attribut. |
INTEGER(_param) | Renvoie la valeur entière du nombre non entier fourni. Exemple : INTEGER(1,56) renvoie 1 |
IS_NUMBER(_param) | Renvoie TRUE si le paramètre donné est un nombre (entier ou décimal) et FALSE dans le cas contraire. Exemples :
|
MAXIMUM(_number,_number) | Renvoie le plus grand des deux nombres fournis. MAXIMUM(SUM(Chiffre d’affaires),SUM(Dépenses)) renvoie la plus grande valeur entre Chiffre d’affaires et Dépenses. |
MINIMUM(_number,_number) | Renvoie le plus petit des deux nombres fournis. MINIMUM(SUM(Chiffre d’affaires),SUM(Dépenses)) renvoie la plus petite valeur entre Chiffre d’affaires et Dépenses. |
NUMBER(_param) |
Renvoie la représentation numérique d’un paramètre donné ou NaN (pas un nombre) quand il ne peut pas être affiché numériquement. Exemples : NUMBER("3,14116") renvoie 3,14116 NUMBER ([Catégorie de caisse]) renvoie la représentation chiffrée de la valeur actuelle de l’attribut Catégorie de caisse. |
PI() |
Renvoie la constante mathématique pour le rapport de la circonférence et du diamètre d’un cercle, appelée Pi. La valeur est 3,141592653589793. |
POWER(_number,_number) | Calcule et renvoie le premier nombre fourni à la puissance du deuxième nombre fourni. Exemple : Si SUM(Prix unitaire) = 2 alors POWER(SUM(prix unitaire),3) renvoie 8 |
RANDOM() |
Renvoie un nombre pseudo-aléatoire n, où 0 <= n <1. Si vous avez besoin d’une valeur aléatoire entière, utilisez Round(Random()*100). |
ROUND(_number) |
Arrondit la valeur du nombre fourni, vers le haut ou le bas, à l’entier le plus proche. En cas d’équidistance, la valeur est arrondie vers le haut. |
SIGN(_number) |
Renvoie -1 si le nombre est négatif, 0 s’il est égal à zéro et 1 s’il est positif. |
SQRT(_number) | Calcule et renvoie la racine carrée du nombre fourni. |
SQUARE(_number) | Calcule et renvoie le carré du nombre fourni. |
LN(_number) | Renvoie le logarithme naturel du nombre fourni. |
LOG10(_number) | Renvoie le logarithme en base 10 du nombre fourni. |
LOG2(_number) | Renvoie le logarithme en base 2 du nombre fourni. |
LOG(_base,_number) | Renvoie le logarithme du nombre fourni dans la base fournie. |
Fonctions trigonométriques
Ces fonctions vous aident à créer des formules avancées pour mesurer les angles et les distances.
Fonction | Description |
ACOS(_number) | Calcule l’arc cosinus du nombre saisi, en radians. |
ASIN(_number) | Calcule l’arc sinus du nombre saisi, en radians. |
ATAN(_number) | Renvoie la valeur, en radians, de l’angle dont la tangente est spécifiée dans le paramètre. La valeur renvoyée se trouve entre Pi/2 négatif et Pi/2 positif. |
ATAN2(_number,_number) | Renvoie l’angle du point Y/X en radians, quand mesuré dans le sens inverse des aiguilles d’une montre à partir de l’axe X d’un cercle (où 0,0 représente le centre du cercle). La valeur renvoyée se trouve entre Pi positif et Pi négatif. Saisissez la coordonnée Y comme premier paramètre. |
COS(_number) | Calcule le cosinus du nombre saisi, en radians. |
DEGREES(_number) | Convertit le nombre donné de radians en degrés. |
RADIANS(_number) | Convertit le nombre donné de degrés en radians. |
SIN(_number) | Calcule le sinus du nombre saisi, en radians. |
TAN(_number) | Renvoie la tangente de l’angle spécifié. |