Créer un champ de fonction pour exécuter une fonction de base de données

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 3 minutes de lecture
  • Créez un champ de fonction qui affiche les résultats d’une fonction de base de données, telle qu’une opération mathématique, un calcul de longueur de champ ou un calcul du jour de la semaine.

    Avant de commencer

    Rôle requis : administrateur

    Vous pouvez sélectionner un champ de fonction à partir d’une table physique ou créer un champ de fonction directement dans la vue de base de données.

    Si vous créez un champ de fonction directement sur la vue de base de données, vous devez utiliser les préfixes variables de la vue de base de données dans la définition de fonction pour identifier les colonnes. Avant de créer le champ de fonction, notez les préfixes de variable dans la vue de base de données.

    Par exemple, si le préfixe de variable de la table Incidents est inc2 et que vous souhaitez renvoyer la longueur du champ de description, la définition de la fonction serait glidefunction :length(inc2_description). Si le préfixe de variable de la table d’instances de mesures est mi et que vous souhaitez concaténer les champs Définition et Valeur, la définition de la fonction serait glidefunction :concat(mi_definition.name,' ',mi_value).

    Pour plus d’informations sur les fonctions prises en charge, reportez-vous à la section Report on function fields.

    Procédure

    1. Accédez à la Tout > Définition du système > Dictionnaire.
    2. Sélectionnez Nouveau.
    3. Sélectionnez le champ de fonction.
    4. Renseignez les champs du formulaire.
      Tableau 1. Formulaire Champs de fonction
      Champ Description
      Table Vue de table ou de base de données à laquelle le champ de fonction est ajouté.

      Si vous sélectionnez une vue de base de données, vous devez inclure les préfixes variables de la vue de base de données dans le champ Définition de la fonction .

      Type Type de champ : chaîne, numéro, date, etc.
      Étiquette de colonne Étiquette de la colonne.
      Nom de colonne Nom de la colonne. Ce champ est automatiquement défini sur la valeur du champ Étiquette de colonne .
      Longueur max. La longueur maximale de la valeur de retour.
      Champ de la fonction Si cette option est sélectionnée, un champ est créé qui affiche les résultats d’une fonction de base de données, telle qu’une opération mathématique, un calcul de longueur de champ ou un calcul du jour de la semaine.

      Une fois le nouvel enregistrement de fonction enregistré, vous ne pouvez pas décocher la case pour faire du champ un champ normal.

      Définition de la fonction Fonction exécutée par le champ.

      Le format des fonctions commence par glidefunction :, suivi de l’opération à effectuer (par exemple, concat), suivi des paramètres de fonction. Les constantes doivent être placées entre guillemets simples.

      Important :
      Si vous créez le champ de fonction dans une vue de base de données et non dans une table physique, vous devez inclure les préfixes variables de la vue de base de données dans le champ Définition de fonction .
    5. Sélectionnez Soumettre.

    Créer un champ Fonction dans la vue de la base de données Mesure d’incident

    Dans cet exemple, un nouveau champ de fonction, CallerDesc, est ajouté à la vue de base de données Mesure d’incident. Le champ concatène le nom de l’appelant, un trait d’union et la brève description.

    Champ Fonction de la vue de la base de données Mesure d’incident

    Le préfixe variable inc est inclus car le champ de fonction est défini dans la vue de la base de données Métrique d’incident et non dans une table physique. Le préfixe est nécessaire pour distinguer les colonnes short_description et caller_id à utiliser des tables qui font partie de la vue de base de données.

    Que faire ensuite

    Afficher les résultats de la fonction dans une vue de base de données