GlideElementDescriptor : champ d’application, global

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 6 minutes de lecture

    • L’API GlideElementDescriptor fournit des informations sur les champs individuels dans un enregistrement Glide.

    Il n’existe aucun constructeur pour cette classe. Utilisez la méthode GlideElement ou GlideRecord getED() pour obtenir un objet GlideElementDescriptor.

    GlideElementDescriptor : getAttachmentEncryptionType()

    Renvoie le type de chiffrement utilisé pour les pièces jointes de la table de l’élément.

    Cette méthode est à utiliser avec le module d’extension Chiffrement Edge .

    Tableau 1. Paramètres
    Nom Type Description
    Néant
    Tableau 2. Renvoie
    Type Description
    Chaîne Type de chiffrement utilisé sur les pièces jointes. Renvoie null si les pièces jointes de la table de l’élément ne sont pas chiffrées. 
    var grInc = new GlideRecord('incident');
grInc.query('priority', '1');

var field = grInc.getElement('priority');
var ed = field.getED();

var isEdge = ed.getAttachmentEncryptionType();
gs.info(isEdge);

    Sortie :

    null

    GlideElementDescriptor : getEncryptionType()

    Renvoie le type de chiffrement de l’élément.

    Cette méthode est à utiliser avec le module d’extension Chiffrement Edge .

    Tableau 3. Paramètres
    Nom Type Description
    Néant
    Tableau 4. Renvoie
    Type Description
    Chaîne Type de chiffrement de l’élément. Renvoie null si l’élément n’est pas chiffré. 
    var grInc = new GlideRecord('incident');
grInc.query('priority', '1');

var field = grInc.getElement('priority');
var ed = field.getED();

sEdge = ed.getEncryptionType();
gs.info(isEdge);

    Sortie :

    null

    GlideElementDescriptor : getInternalType()

    Renvoie le type de données internes de l’élément.

    Tableau 5. Paramètres
    Nom Type Description
    Néant
    Tableau 6. Renvoie
    Type Description
    Chaîne Type de données interne de l’élément.
    Valeurs possibles :
    • booléen
    • caractère
    • collection
    • conditions
    • date
    • décimal
    • documentation_field
    • domain_id
    • due_date
    • e-mail
    • field_name
    • file_attachment
    • flottant
    • glide_date
    • glide_date_time
    • glide_duration
    • glide_list
    • GUID
    • HTML
    • image
    • entier
    • long
    • longint
    • multi_two_lines
    • Journal
    • journal_input
    • numérique
    • order_index
    • mot de passe
    • ph_number
    • référence
    • script
    • script_plain
    • chaîne
    • sys_class_name
    • table_name
    • template_value
    • minuteur
    • translated_field
    • URL
    • user_image
    • user_input
    • user_roles
    • vidéo
    • workflow
    		 
    var grInc = new GlideRecord('incident');
grInc.query('priority', '1');
 
var field = grInc.getElement('priority');
var ed = field.getED();
 
var isEdge = ed.getInternalType();
gs.info(isEdge);
    Sortie : 
    integer

    GlideElementDescriptor : getLabel()

    Renvoie l’étiquette de l’élément.

    Tableau 7. Paramètres
    Nom Type Description
    Néant
    Tableau 8. Renvoie
    Type Description
    Chaîne Étiquette de l’élément. 
    var grInc = new GlideRecord('incident');
grInc.query('priority', '1');
 
var field = grInc.getElement('priority');
var ed = field.getED();
 
var isEdge = ed.getLabel();
gs.info(isEdge);

    Sortie :

    Priority

    GlideElementDescriptor : getLength()

    Renvoie la longueur de l’élément.

    Tableau 9. Paramètres
    Nom Type Description
    Néant
    Tableau 10. Renvoie
    Type Description
    Numéro La taille de l’élément. 
    var grInc = new GlideRecord('incident');
grInc.query('priority', '1');
 
var field = grInc.getElement('priority');
var ed = field.getED();
 
var isEdge = ed.getLength();
gs.info(isEdge);

    Sortie :

    40

    GlideElementDescriptor : getName()

    Renvoie le nom de l’élément.

    Tableau 11. Paramètres
    Nom Type Description
    Néant
    Tableau 12. Renvoie
    Type Description
    Chaîne Nom de l’élément. 
    var grInc = new GlideRecord('incident');
grInc.query('priority', '1');
 
var field = grInc.getElement('priority');
var ed = field.getED();
 
var isEdge = ed.getName();
gs.info(isEdge);

    Sortie :

    priority

    GlideElementDescriptor : getPlural()

    Renvoie l’étiquette pluriel de l’élément.

    Tableau 13. Paramètres
    Nom Type Description
    Néant
    Tableau 14. Renvoie
    Type Description
    Chaîne Étiquette pluriel de l’élément. 
    var now_GR = new GlideRecord('incident');
now_GR.query();
var ed = now_GR.getED();
gs.info(ed.getPlural());

    Sortie :

    Incidents

    GlideElementDescriptor : hasAttachmentsEncrypted()

    Renvoie la valeur vrai si une pièce jointe chiffrée a été ajoutée à la table.

    Cette méthode est à utiliser avec le module d’extension Chiffrement Edge .

    Tableau 15. Paramètres
    Nom Type Description
    Néant
    Tableau 16. Renvoie
    Type Description
    Booléen Renvoie la valeur vrai si une pièce jointe chiffrée a été ajoutée à la table. 
    var grInc = new GlideRecord('incident');
grInc.query('priority', '1');

var field = grInc.getElement('priority');
var ed = field.getED();

var isEdge = ed.hasAttachmentsEncrypted();
gs.info(isEdge);

    Sortie :

    false

    GlideElementDescriptor : isAutoOrSysID()

    Renvoie la valeur vrai si l’élément est un champ généré automatiquement ou un champ système.

    Les champs générés automatiquement et système ne peuvent pas être chiffrés. Cette méthode est à utiliser avec le module d’extension Chiffrement Edge .

    Tableau 17. Paramètres
    Nom Type Description
    Néant
    Tableau 18. Renvoie
    Type Description
    Booléen Vrai si l’élément est généré automatiquement ou s’il s’agit d’un champ système. 
    var grInc = new GlideRecord('incident');
grInc.query('priority', '1');
var field = grInc.getElement('priority');
var ed = field.getED();

isEdge = ed.isAutoOrSysID();
gs.info(isEdge);

    Sortie :

    false

    GlideElementDescriptor : isChoiceTable()

    Renvoie la valeur vrai si l’élément est défini comme un choix de liste déroulante dans sa définition de dictionnaire.

    Les champs de choix ne peuvent pas être chiffrés.

    Tableau 19. Paramètres
    Nom Type Description
    Néant
    Tableau 20. Renvoie
    Type Description
    Booléen Renvoie vrai si l’élément est défini comme un choix de liste déroulante. Renvoie la valeur true même si aucune entrée n’est définie dans la table d’choix. Le dernier type de choix, suggestion, ne renvoie pas la valeur vraie. 
    var grInc = new GlideRecord('incident');
grInc.query('priority', '1');

var field = grInc.getElement('priority');
var ed = field.getED();

var isChoiceTable = ed.isChoiceTable();
gs.info(isChoiceTable);

    Sortie :

    true

    GlideElementDescriptor : isEdgeEncrypted()

    Renvoie la valeur vrai si un élément est chiffré.

    Cette méthode est à utiliser avec le module d’extension Chiffrement Edge .

    Tableau 21. Paramètres
    Nom Type Description
    Néant
    Tableau 22. Renvoie
    Type Description
    Booléen Renvoie la valeur Vrai si l’élément est chiffré et Faux dans les autres cas. 
    var grInc = new GlideRecord('incident');
grInc.query('priority', '1');

var field = grInc.getElement('priority');
var ed = field.getED();

var isEdge = ed.isEdgeEncrypted();
gs.info(isEdge)

    Sortie :

    false

    GlideElementDescriptor : isEncrypted()

    Indique si le champ représenté par ce descripteur est configuré pour le chiffrement de champ.

    Utilisez cette méthode pour détecter par programmation les champs chiffrés avant de lire ou d’écrire des données sensibles, ou pour appliquer des politiques d’accès en fonction de l’état de chiffrement d’un champ.

    Modules d’extension requis : Field Encryption Starter (com.glide.field.encryption.starter). Sans ce plugin, isEncrypted() renvoie false.

    Tableau 23. Paramètres
    Nom Type Description
    Néant
    Tableau 24. Renvoie
    Type Description
    Booléen

    Marqueur indiquant si le champ est configuré pour le chiffrement de champ.

    Valeurs valides :
    • vrai : le champ est configuré pour le chiffrement de champ.
    • false : le champ n’est pas chiffré ou le module d’extension Démarrage de chiffrement de champ (com.glide.field.encryption.starter) n’est pas actif.
    Le script côté serveur suivant utilise isEncrypted() pour vérifier si le champ short_description de la table Incident est chiffré avant d’enregistrer sa valeur. Copiez ceci dans un script en arrière-plan ou une règle métier sur votre instance à tester.
    Remarque :
    Utilisez la GlideRecord : getED() méthode ou GlideElement dans le champ d’application : getED() pour obtenir un objet GlideElementDescriptor.
    // Retrieve a sample Incident record
var gr = new GlideRecord('incident');
gr.setLimit(1);
gr.query();

if (gr.next()) {
    // Get the GlideElement for the field you want to inspect
    var element = gr.getElement('short_description');

    // Retrieve the descriptor from the element
    var descriptor = element.getED();

    // Check whether the field is configured for Field Encryption
    if (descriptor.isEncrypted()) {
        gs.info('short_description is encrypted. Value: ' + element.getDisplayValue());
    } else {
        gs.info('short_description is NOT encrypted. Value: ' + gr.getValue('short_description'));
    }
}
    Sortie (non chiffrée) :
    short_description is NOT encrypted. Value: Unable to connect to network
    Sortie (chiffrement activé sur le champ) :
    short_description is encrypted. Value: Unable to connect to network

    GlideElementDescriptor : isMandatory()

    Détermine si l’élément est obligatoire et doit contenir une valeur avant de pouvoir enregistrer l’enregistrement.

    Tableau 25. Paramètres
    Nom Type Description
    Néant
    Tableau 26. Renvoie
    Type Description
    Booléen Marqueur indiquant si l’élément associé est obligatoire et doit contenir une valeur avant de pouvoir enregistrer l’enregistrement qui contient l’élément.

    Valeurs possibles :

    • vrai : l’élément doit contenir une valeur ; champ obligatoire
    • Faux : l’élément ne doit pas nécessairement contenir de valeur

    Cet exemple montre comment vérifier si le champ Nom est obligatoire.

    var isRecordValid;
var now_GR = new GlideRecord('my_table');
var field = now_GR.getElement('name');
var elementDescriptor = field.getED();
now_GR.query();
while (now_GR.next()) {
if (elementDescriptor.isMandatory() && !now_GR.name) {
       isRecordValid = false;
  }
}

    GlideElementDescriptor : isVirtual()

    Renvoie vrai si l’élément est un élément virtuel.

    Un élément virtuel est un champ calculé tel que défini par la définition du dictionnaire du champ. Les champs virtuels ne peuvent pas être chiffrés.

    Tableau 27. Paramètres
    Nom Type Description
    Néant
    Tableau 28. Renvoie
    Type Description
    Booléen Renvoie vrai si l’élément est un élément virtuel. 
    var grInc = new GlideRecord('incident');
grInc.query('priority', '1');

var field = grInc.getElement('priority');
var ed = field.getED();

var isVirtual = ed.isVirtual();
gs.info(isVirtual);

    Sortie :

    false