Spécifier une valeur de champ par défaut

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 2 minutes de lecture
  • Une valeur par défaut renseigne une valeur dans un champ lorsqu’un nouvel enregistrement est créé.

    Avant de commencer

    Rôle requis : personalize_dictionary

    Pourquoi et quand exécuter cette tâche

    La valeur par défaut remplit le champ du formulaire vide pour un nouvel enregistrement, ainsi que lorsque le nouvel enregistrement est soumis si le champ est vide. Les valeurs par défaut peuvent être spécifiées comme constantes ou générées via un script.

    Procédure

    1. Cliquez avec le bouton droit sur l’étiquette du champ dans le formulaire et sélectionnez Configurer le dictionnaire.
    2. Entrez la valeur par défaut dans le champ Valeur par défaut .
      Pour définir une valeur constante, saisissez-la dans le champ Zone de texte Valeur par défaut . Pour affecter une valeur par défaut à l’aide d’une formule plus complexe, utilisez JavaScript pour générer une valeur par défaut.
      Remarque :
      La valeur par défaut doit être la valeur sous-jacente qui serait présente dans le champ, et non l’étiquette. Par exemple, dans un champ de liste de choix, utilisez la valeur du choix comme valeur par défaut, et non le nom du choix.

    Exemples de valeurs de champ par défaut

    Examinez les exemples suivants sur la spécification des valeurs de champ par défaut.

    Valeurs par défaut constantes

    Voici un exemple qui définit une valeur par défaut pour le champ Priorité .
    Figure 1. Constante de valeur par défaut

    Valeurs par défaut JavaScript

    Pour afficher des exemples prêts à l’emploi de valeurs par défaut JavaScript, accédez à Définition du système > Dictionnaire et entrez ce filtre : [Valeur par défaut] [commence par] [javascript]. Ouvrez certains enregistrements et affichez les entrées javascript de valeur par défaut.

    Définir une valeur par défaut pour assignment_group

    L’exemple suivant définit une valeur par défaut dans un champ de référence [sys_user_group] en obtenant l’ID à partir du nom d’un groupe.
    javascript:GetIDValue('sys_user_group', 'Development');

    Définir une valeur par défaut pour assigned_to si l’utilisateur a le rôle itil

    Cet exemple pour la table Tâche [task] décrit comment configurer la valeur par défaut de l’utilisateur [assigned_to] égale à l’ID d’utilisateur actuel si l’utilisateur a un rôle ITIL.
    • Étiquette de colonne : Affecté à
    • Nom de colonne : [assigned_to]
    • Section Spécification de référence
      • Référence : utilisateur [sys_user]
      • Condition de qualificatif de référence : [Roles] [is] [itil]
    • Script de valeur par défaut :
      javascript:if (gs.hasRole("itil"))current.assigned_to = gs.getUserID();

    Définir une valeur par défaut pour un champ de durée

    Pour définir une valeur par défaut pour un champ de durée, utilisez ce qui suit dans le champ Valeur par défaut de l’entrée de dictionnaire du champ de durée :
    javascript:current.duration_field.setDisplayValue('3 04:30:14');

    Évitez de coder en dur une date/heure particulière. Si le format de date/heure du système change, la valeur devient non valide. Au lieu de cela, cochez la case Utiliser la valeur dynamique par défaut et attribuez une option de filtre dynamique. Pour plus d’informations sur les filtres dynamiques, reportez-vous à la section Créer une option de filtre dynamique .