GlideRecordUtil : global

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

    • L’include de script GlideRecordUtil est une classe utilitaire permettant d’utiliser GlideRecords.

    Cet include de script est disponible dans les scripts côté serveur. Pour les cas d’utilisation, consultez Utilisation des includes de script de détection.

    GlideRecordUtil : getCIGR(chaîne sys_id)

    Renvoie l’objet GlideRecord pour l’élément de configuration (CI) spécifié en utilisant uniquement le sys_id du CI.

    Utilisez cette méthode pour obtenir rapidement un CI spécifique sans connaître sa classe/table associée.

    Tableau 1. Paramètres
    Nom Type Description
    sys_id Chaîne Sys_id du CI souhaité.
    Tableau 2. Renvoie
    Type Description
    GlideRecord Objet GlideRecord du CI spécifié.

    L’exemple suivant renvoie l’objet GlideRecord pour le CI spécifié en utilisant uniquement la sys_id du CI.

    var now_GR = new GlideRecordUtil().getCIGR("2dfd7c8437201000deeabfc8bcbe5d56");

    GlideRecordUtil : getFields(GlideRecord gr)

    Renvoie un tableau de tous les champs dans le GlideRecord spécifié.

    Remarque :
    Si un nom de champ est le même que le nom de la table, la méthode getFields() ne renvoie pas la valeur du champ.
    Tableau 3. Paramètres
    Nom Type Description
    gr GlideRecord Instance GlideRecord positionnée sur un enregistrement valide.
    Tableau 4. Renvoie
    Type Description
    Tableau Noms de champs pour le GlideRecord spécifié. 
    var queryString = "priority=1^ORpriority=2";
var now_GR = new GlideRecord('incident');
now_GR.addEncodedQuery(queryString);
now_GR.query();
now_GR.next();

var gRU = new GlideRecordUtil();
var fieldList = gRU.getFields(now_GR);
gs.info(fieldList);
    Sortie : Sauts de ligne ajoutés pour la présentation.
    sys_id,skills,closed_by,assigned_to,contract,category,escalation,state,reassignment_count,location,
time_worked,order,due_date,number,upon_approval,sys_tags,sla_due,follow_up,reopen_count,notify,business_stc,
caused_by,rejection_goto,assignment_group,comments_and_work_notes,incident_state,opened_at,parent_incident,
business_service,wf_activity,calendar_duration,group_list,caller_id,comments,priority,sys_updated_by,
variables,delivery_task,resolved_at,sys_updated_on,parent,active,opened_by,expected_start,watch_list,
company,upon_reject,work_notes,sys_created_by,additional_assignee_list,approval_set,cmdb_ci,user_input,
sys_created_on,close_code,contact_type,resolved_by,rfc,approval_history,activity_due,severity,child_incidents,
,subcategory,work_end,closed_at,close_notes,variables,business_duration,knowledge,approval,sys_domain_path,
sys_mod_count,problem_id,calendar_stc,work_start,sys_domain,correlation_id,sys_class_name,short_description,
impact,description,correlation_display,urgency,made_sla,delivery_plan,work_notes_list

    GlideRecordUtil : getGR(String baseTable, String sys_id)

    Retourne une instance GlideRecord pour la table donnée, positionnée sur le sys_id donné et de la classe appropriée (table).

    Cette méthode est utile lorsque vous devez charger un GlideRecord à partir d’un sys_id, mais que vous ne savez pas quelle est la table réelle (car elle peut être étendue à partir de la table de base). Cette méthode renvoie toujours un GlideRecord du type correct base_table : le nom de la table de base dans laquelle se trouve le sys_id spécifié.

    Tableau 5. Paramètres
    Nom Type Description
    Table de base Chaîne Nom de la table de base contenant le sys_id.
    sys_id Chaîne Le sys_id de l’enregistrement souhaité.
    Tableau 6. Renvoie
    Type Description
    GlideRecord GlideRecord pour le sys_id spécifié. 
    var now_GR = new GlideRecordUtil().getGR("cmdb_ci_computer", "2dfd7c8437201000deeabfc8bcbe5d56");

    GlideRecordUtil : getTables(String tableName)

    Renvoie une liste de tableaux Java des ancêtres du nom de table spécifié.

    Par exemple, étant donné cmdb_ci_linux_server, renvoie cmdb_ci_linux_server, cmdb_ci_server, cmdb_ci_computer, cmdb_ci_hardware, cmdb_ci et cmdbr.

    Tableau 7. Paramètres
    Nom Type Description
    tableName Chaîne Nom de la table.
    Tableau 8. Renvoie
    Type Description
    Tableau de liste Liste des ancêtres de la table spécifiée.

    L’exemple suivant montre les ancêtres de la table cmdb_ci_linux_server.

    var tables = new GlideRecordUtil().getTables("cmdb_ci_linux_server");
gs.info("Tables returned: " + tables);

    Sortie :

    Tables returned: [cmdb_ci_linux_server, cmdb_ci_server, cmdb_ci_computer, cmdb_ci_hardware, cmdb_ci, cmdb]

    GlideRecordUtil : mergeToGR(Object hashMap, GlideRecord now_GR, Object ignore)

    Définit les champs dans le GlideRecord spécifié avec les valeurs de champ contenues dans la carte de hachage spécifiée, sauf si ce nom de champ se trouve dans la carte de hachage ignorer.

    Tableau 9. Paramètres
    Nom Type Description
    Carte de hachage Objet Instance d’objet (utilisée comme carte de hachage), avec des propriétés nommées d’après des champs et contenant la valeur des champs.
    GlideRecord GR Instance GlideRecord qui doit recevoir les valeurs de champ.
    ignorer Objet Une carte de hachage facultative de noms de champs à ignorer.
    Tableau 10. Renvoie
    Type Description
    nul

    Cet exemple met à jour les champs de nom et de système d’exploitation d’un enregistrement d’ordinateur, mais ne met pas à jour le champ sys_created_by :

    var now_GR = new GlideRecordUtil().getGR("cmdb_ci_computer", "2dfd7c8437201000deeabfc8bcbe5d56");   
var obj = {"name": "xyz", "os": "windows 2000", "sys_created_by", "aleck.lin"};
var ignore = {"sys_created_by": true};
new GlideRecordUtil().mergeToGR(obj, now_GR, ignore);
now_GR.update();

    GlideRecordUtil : populateFromGR(Object hashMap, GlideRecord now_GR, Object ignore)

    Remplit la carte de hachage donnée à partir de l’instance GlideRecord donnée. Chaque champ de GlideRecord devient une propriété dans la carte de hachage.

    Tableau 11. Paramètres
    Nom Type Description
    Carte de hachage Objet Objet utilisé comme carte de hachage.
    now_GR GlideRecord Une instance GlideRecord positionnée sur un enregistrement valide.
    ignorer Objet Une carte de hachage facultative des noms de fichiers à ne pas renseigner.
    Tableau 12. Renvoie
    Type Description
    nul 
    var objectToPopulate = {};
var now_GR = new GlideRecordUtil().getGR("cmdb_ci_computer", "2dfd7c8437201000deeabfc8bcbe5d56");
var ignore = {"sys_created_on": true, "sys_updated_by": true};
new GlideRecordUtil().populateFromGR(objectToPopulate, now_GR, ignore);
// Now the objectToPopulate contains field/value pairs from the computer GlideRecord