Rapport sur les champs de fonction
Alors que les champs normaux stockent une valeur dans la base de données, un champ de fonction affiche les résultats d’une requête de base de données. Le champ de fonction génère la valeur en fonction des calculs d’autres champs et constantes. Vous pouvez utiliser ces champs dans les rapports comme vous le feriez avec d’autres champs.
La responsabilité de la création, de la modification et de la désactivation des champs de fonction incombe à l’utilisateur ayant le rôle function_field_admin. Lors de la mise à niveau, aucun utilisateur ne dispose de ce rôle. Un administrateur doit donner ce rôle à un utilisateur non administrateur. Reportez-vous à la section Créer un rôle.
Pour en savoir plus sur les champs de fonction, cliquez ici : Champ de fonction.
Opérations de champ de fonction
| Opération | Description | Exemple |
|---|---|---|
| ajouter() | Utilise deux champs de nombre comme entrée, les ajoute et renvoie les résultats comme valeur de champ. Cette fonction accepte également des valeurs numériques pour l’une ou l’autre entrée. Placez les valeurs numériques entre guillemets simples ou doubles. |
glidefunction :add(child_incidents, parent_incident) Renvoie la valeur 6 si l’incident comporte cinq incidents enfants et un incident parent. Types de retour possibles : Décimal, Nombre à virgule flottante, Grand nombre entier, Nombre entier |
| soustraire() | Utilise deux champs de nombre comme entrée, soustrait le second du premier et renvoie le résultat comme valeur de champ. Cette fonction accepte également des valeurs numériques pour l’une ou l’autre entrée. Placez les valeurs numériques entre guillemets simples ou doubles. |
glidefunction :soustraire(u_num1, u_num2) Renvoie 2 si num1 = 8 et num_2 = 6. Types de retour possibles : Décimal, Nombre à virgule flottante, Grand nombre entier, Nombre entier |
| multiply() | Utilise deux champs de nombre comme entrée, effectue la multiplication et renvoie les résultats comme valeur de champ. Cette fonction accepte également des valeurs numériques pour l’une ou l’autre entrée. Placez les valeurs numériques entre guillemets simples ou doubles. |
glidefunction :multiplier(u_num1, u_num2) Renvoie 48 si num1 = 8 et num_2 = 6. Types de retour possibles : Décimal, Nombre à virgule flottante, Grand nombre entier, Nombre entier |
| diviser() | Utilise deux champs de nombre comme entrée, divise le premier par le second et renvoie les résultats comme valeur de champ. Cette fonction accepte également des valeurs numériques pour l’une ou l’autre entrée. Placez les valeurs numériques entre guillemets simples ou doubles. |
glidefunction :divide(u_num2,u_num1) Renvoie 5 si num2 = 10 et num1 = 2. Types de retour possibles : Décimal, Nombre à virgule flottante, Grand nombre entier, Nombre entier |
| concat() | Utilise un nombre quelconque de champs et de constantes séparés par des virgules comme entrée, concatène l'entrée et renvoie une seule chaîne comme valeur de champ. | glidefunction :concat(incident_number, '/', short_description) Renvoie « INC0001 / Mon client a besoin d’un nouvel ordinateur portable » si la valeur du champ numérique est « INC0001 » et le short_description est « Mon client a besoin d’un nouvel ordinateur portable ». Type de retour : texte |
| datediff() | Utilise deux champs de date/heure comme entrée, calcule la différence entre les dates, en jours, en minutes et en secondes, et renvoie les résultats sous forme de valeur de champ de durée. | glidefunction :datediff(closed_at, sys_created_on) Renvoie la durée d’un incident de la date de création à la date de fermeture. Exemple de résultat : 10 jours, 8 heures 23 minutes 11 secondes Type de retour : Durée |
| jourdesemaine() | Utilise deux arguments : un champ de date et une constante correspondant à « 1 » (la semaine commence le dimanche) ou « 2 » (la semaine commence le lundi). Renvoie les résultats sous forme de valeur entière qui représente le jour de la semaine. La fonction dayofweek() utilise les dates UTC, mais ajuste les valeurs de comparaison en fonction du fuseau horaire de l’instance. |
glidefunction :dayofweek(resolved_at, '1'). Si resolved_at se produit un mercredi, renvoie 4 si le nombre entier est 1 et renvoie 3 si le nombre entier est 2. Type de retour : nombre entier |
| longueur() | Utilise un champ de chaîne comme entrée, calcule la longueur du champ en caractères et renvoie les résultats sous forme de valeur de champ. | glidefunction :longueur(short_description) Renvoie 37 if short_description = « Cette application effectue un test ». Type de retour : nombre entier |
| coalesce() | Utilise un nombre quelconque de champs séparés par des virgules comme entrée et renvoie la première valeur non vide. | glidefunction :coalesce(closed_at, resolved_at, sys_updated_on) Si la valeur de closed_at est vide, la fonction renvoie la valeur de resolved_at. Si la valeur de resolved_at est également vide, la fonction renvoie la valeur de sys_updated_on. Type de retour : texte |
| position() | Utilise deux champs de texte ou deux champs de texte et un nombre entier comme entrée. L’un des champs de texte ou les deux peuvent également être des chaînes.
Renvoie 0 si le premier champ de texte n’est pas présent dans le second (après la position du nombre entier si spécifié). |
Type de retour : nombre entier |
| sous-chaîne() | Utilise un champ de texte et deux nombres entiers comme entrée. Renvoie la première instance d’une chaîne qui commence à la position du premier nombre entier et est de la longueur du second. | glidefunction :substring(short_description, '7', '2') Si la valeur du champ short_description est « Nous allons au magasin », renvoie « Aller ». Type de retour : texte |