GlideElementDescriptor : dans le champ d’application, global

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 4 minutes de lecture

    • L’API GlideElementDescriptor fournit des informations sur les champs individuels d’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 dans 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
    Aucun
    Tableau 2. Renvoie
    Type Description
    Chaîne Le 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
    Aucun
    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 interne de l’élément.

    Tableau 5. Paramètres
    Nom Type Description
    Aucun
    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
    Aucun
    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
    Aucun
    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
    Aucun
    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
    Aucun
    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 true 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
    Aucun
    Tableau 16. Renvoie
    Type Description
    Booléen Renvoie la valeur true 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 true si l’élément est un champ généré automatiquement ou par le système.

    Les champs générés automatiquement et les champs 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
    Aucun
    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 true si l’élément est défini comme 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
    Aucun
    Tableau 20. Renvoie
    Type Description
    Booléen Renvoie la valeur true si l’élément est défini comme un choix de liste déroulante. Renvoie la valeur true même s’il n’y a aucune entrée définie dans la table d’options. Le dernier type de choix, suggestion, ne renvoie pas la valeur vrai. 
    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 true 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
    Aucun
    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 : isMandatory()

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

    Tableau 23. Paramètres
    Nom Type Description
    Aucun
    Tableau 24. 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 de 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 la valeur 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 25. Paramètres
    Nom Type Description
    Aucun
    Tableau 26. Renvoie
    Type Description
    Booléen Renvoie la valeur 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