GlideElementDescriptor : champ d’application, global

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 5 minutes de lecture

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

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

    GlideElementDescriptor inclus dans le périmètre : 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
    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 inclus dans le périmètre : 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 inclus dans le périmètre : 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
    • Flotteur
    • glide_date
    • glide_date_time
    • glide_duration
    • glide_list
    • GUID
    • html
    • image
    • entier
    • long
    • Entier long
    • 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
    • Minuterie
    • 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 inclus dans l’étendue : 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 : Priorité

    GlideElementDescriptor inclus dans le périmètre : getLength()

    Renvoie la longueur de l’élément.

    Tableau 9. Paramètres
    Nom Type Description
    Aucun
    Tableau 10. Renvoie
    Type Description
    Numéro 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 inclus dans le périmètre : 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 : priorité

    GlideElementDescriptor inclus dans le périmètre : 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 inclus dans le périmètre : 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 inclus dans le périmètre : isAutoOrSysID()

    Renvoie la valeur true si l’élément est un champ généré automatiquement ou un champ 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 inclus dans le champ d’application : isChoiceTable()

    Renvoie la valeur true si l’élément est défini en tant que 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 en tant que choix de liste déroulante. Renvoie la valeur true même si aucune entrée n’est définie dans la table de choix. 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 inclus dans le périmètre : 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 true si l’élément est chiffré et false 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 inclus dans le champ d’application : isMandatory()

    Détermine si l’élément est obligatoire et doit contenir une valeur pour 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 que l’enregistrement contenant l’élément puisse être enregistré.

    Valeurs valides :

    • true : l’élément doit contenir une valeur ; Champ obligatoire
    • false : l’élément n’a pas besoin de contenir une 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 inclus dans le périmètre : isVirtual()

    Renvoie la valeur true 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 true 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