Créer un champ de fonction

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 2 minutes de lecture
  • Créez un champ de fonction pour pouvoir regrouper et empiler un rapport en fonction des résultats du calcul du champ.

    Avant de commencer

    Rôle requis : admin, function_field_admin

    Chaque champ de fonction nécessite une étiquette, un type de retour et une définition. La définition se compose de l’opération et d’un ou de plusieurs champs sur lesquels elle est exécutée.

    Remarque :
    Il n’est pas possible de modifier l’étiquette ou le type de retour après avoir enregistré un champ de fonction. Si nécessaire, désactivez le champ Fonction et recommencez.

    Procédure

    1. Effectuez l’une des actions suivantes :
      • Sur une instance mise à niveau qui n’a pas été entièrement migrée vers , accédez à Platform Analytics Tout > Rapports > Créer.
      • Sur une nouvelle instance ou une instance qui a été entièrement migrée vers , accédez à Platform Analytics Tout > Administration de Platform Analytics > Utilisation et gouvernance > Rapports et sélectionnez Nouveau.
    2. Sélectionnez le rapport auquel vous souhaitez ajouter un champ de fonction.
      Lorsque vous configurez un champ de fonction dans une table, il est disponible partout où vous utilisez la table sur la Now Platform, y compris tout rapport de la même table. Par exemple, un champ de fonction qui calcule l’âge des incidents ouverts est disponible pour tous les rapports de la table Incident.
    3. Ouvrez l’onglet Configurer , puis cliquez sur le champ de fonction Configurer.
    4. Facultatif : Entrez le nom du champ dans la barre de recherche pour voir si quelqu’un a déjà créé le champ de fonction.
      Pointez sur les résultats de la recherche pour afficher la définition de la fonction.
    5. Cliquez sur Créer.
      Il peut y avoir un maximum de 20 champs de fonction actifs sur la table sur laquelle le rapport est basé. Si la table comporte déjà 20 champs de fonction, le créateur de l’un des champs ou un platform_admin doit en désactiver ou en supprimer un.
    6. Spécifiez l’étiquette.
      L’étiquette correspond au nom que les utilisateurs peuvent voir lorsqu’ils regroupent ou empilent des données dans un rapport.
    7. Sélectionnez le type de retour.
      Le type de retour est le type d’information produite par la fonction. Par exemple, la fonction datediff() renvoie un type Duration car elle calcule la durée entre deux dates.
      Remarque :
      Vous ne voyez pas de message si votre type de retour n’est pas un résultat logique de la fonction.
    8. Sélectionnez l’opération.
      La zone de texte Syntaxe affiche le nom de la fonction précédé de glidefunction :.

      Créez une fenêtre de champ de fonction avec des légendes pour l’étiquette, le type de retour et Ajouter une opération. L’opération de soustraction est mise en surbrillance.

    9. Sélectionnez les champs sur lesquels la fonction fonctionne.
      Certaines fonctions ne nécessitent qu’un seul champ ; certains nécessitent deux ou trois champs. Consultez Rapport sur les champs de fonction. Assurez-vous de séparer les champs par des virgules.
    10. Lorsque la syntaxe est correcte, vous pouvez enregistrer le champ de fonction.
      Lorsque la syntaxe est incorrecte, le message suivant s’affiche : Erreur de syntaxe : expression non valide. Vous pouvez également voir d’autres messages.

      Créez une fenêtre de champ de fonction avec des légendes pour Ajouter un champ et le message Syntaxe est correct. Le champ Incidents enfants est mis en surbrillance.

    Résultats

    Les champs de fonction configurés apparaissent dans les listes Grouper par et Grouper par supplémentaire une fois que vous avez enregistré le rapport.

    Utilisez le champ de fonction créé dans la configuration de votre rapport. Pour plus d’informations sur l’utilisation des champs de fonction ailleurs sur le Now Platform, voir Champ de fonction.