TableUtils : global

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

    • L’API TableUtils est une classe de raccourcis permettant d’accéder aux informations relatives aux tables.

    Cette classe est disponible pour les scripts côté serveur.

    TableUtils : tableExists()

    Vérifie si une table existe.

    Tableau 1. Paramètres
    Nom Type Description
    Aucun
    Tableau 2. Renvoie
    Type Description
    Booléen Vrai si la table existe. 
    var table = new TableUtils("my_table");
gs.print("Does 'my_table' exist? " + table.tableExists());

    Sortie : existe-t-il « my_table » ? Faux

    TableUtils - drop(String tableName)

    Supprime une table de base de données.

    Remarque :
    À utiliser avec une extrême prudence. Supprimer une table supprime définitivement la table et toutes ses données. Si la table est étendue, utilisez dropTableAndExtensions.
    Tableau 3. Paramètres
    Nom Type Description
    tableName Chaîne Nom de la table à abandonner
    Tableau 4. Renvoie
    Type Description
    nul 
    var tu = new TableUtils();
tu.drop("table_that_will_be_lost_forever");
    Sortie : 
    dropping table table_that_will_be_lost_forever
Starting cache flush
Cache flush complete
TABLE DROP: admin dropped table table_that_will_be_lost_forever

    TableUtils : dropAndClean(String tableName)

    Supprime une table de base de données et nettoie les références à la table.

    Remarque :
    À utiliser avec une extrême prudence. La suppression d’une table de base de données supprime définitivement la table et toutes ses données. Si la table est étendue, utilisez dropTableAndExtensions.
    Tableau 5. Paramètres
    Nom Type Description
    tableName Chaîne Nom de la table à abandonner
    Tableau 6. Renvoie
    Type Description
    nul 
    var tu = new TableUtils();
tu.dropAndClean("table_that_will_be_lost_forever");
    Sortie : 
    dropping table table_that_will_be_lost_forever
Starting cache flush
Cache flush complete
TABLE DROP: admin dropped table table_that_will_be_lost_forever
*** Script: removing gauges for table_that_will_be_lost_forever
*** Script: removing forms for table_that_will_be_lost_forever
*** Script: removing styles for table_that_will_be_lost_forever
*** Script: removing forms sections for table_that_will_be_lost_forever
*** Script: removing lists for table_that_will_be_lost_forever
*** Script: removing related lists for table_that_will_be_lost_forever
*** Script: removing references to table_that_will_be_lost_forever
*** Script: removing dictionary entries for table_that_will_be_lost_forever
Background message, type:info, message: Table deleted

    TableUtils : dropTableAndExtensions(String tableName)

    Supprime une table de base de données, toutes ses tables étendues, et nettoie les références aux tables.

    Remarque :
    À utiliser avec une extrême prudence. La suppression d’une table de base de données supprime définitivement la table et toutes ses données.
    Tableau 7. Paramètres
    Nom Type Description
    tableName Chaîne Table à abandonner
    Tableau 8. Renvoie
    Type Description
    nul 
    var tu = new TableUtils();
tu.dropTableAndExtensions("table_that_will_be_lost_forever");
    Sortie : 
    dropping table parent_table_that_will_be_lost_forever
Starting cache flush
Cache flush complete
TABLE DROP: admin dropped table ext_table_that_will_be_lost_forever
removing gauges for ext_table_that_will_be_lost_forever
removing forms for ext_table_that_will_be_lost_forever
removing styles for ext_table_that_will_be_lost_forever
removing forms sections for ext_table_that_will_be_lost_forever
removing lists for ext_table_that_will_be_lost_forever
removing related lists for ext_table_that_will_be_lost_forever
removing references to ext_table_that_will_be_lost_forever
removing dictionary entries for ext_table_that_will_be_lost_forever
Background message, type:info, message: Table deleted
dropping table parent_table_that_will_be_lost_forever
Starting cache flush
Cache flush complete
TABLE DROP: admin dropped table parent_table_that_will_be_lost_forever
removing gauges for parent_table_that_will_be_lost_forever
removing forms for parent_table_that_will_be_lost_forever
removing styles for parent_table_that_will_be_lost_forever
removing forms sections for parent_table_that_will_be_lost_forever
removing lists for parent_table_that_will_be_lost_forever
removing related lists for parent_table_that_will_be_lost_forever
removing references to parent_table_that_will_be_lost_forever
removing dictionary entries for parent_table_that_will_be_lost_forever
Background message, type:info, message: Table deleted

    TableUtils : getAbsoluteBase()

    Renvoie le nom de la table de base à partir de laquelle la table a été étendue.

    Remarque :
    Pour toutes les tables de la hiérarchie cmdb_ci, cette méthode renvoie cmdb_ci et non cmdb, qui est la table de base réelle.
    Tableau 9. Paramètres
    Nom Type Description
    Aucun
    Tableau 10. Renvoie
    Type Description
    Chaîne Nom de la table de base 
    var table = new TableUtils("cmdb_ci_server");
gs.print(table.getAbsoluteBase());

    Sortie : cmdb_ci

    TableUtils : getAllExtensions()

    Renvoie la liste des tables qui étendent une table, y compris la table de base.

    Tableau 11. Paramètres
    Nom Type Description
    Aucun
    Tableau 12. Renvoie
    Type Description
    Arraylist Liste des tables qui complètent la table, y compris la table de base. 
    var table = new TableUtils("task");
gs.print(table.getAllExtensions());
    Sortie : 
    [task, incident, issue, kb_submission, sysapproval_group, change_request, change_request_imac, sc_task, 
problem, sc_req_item, ticket, ast_transfer_order, planned_task, change_task, change_phase, sc_request]

    TableUtils : getHierarchy()

    Renvoie une liste de toutes les classes participant à la hiérarchie de la table spécifiée.

    Tableau 13. Paramètres
    Nom Type Description
    Aucun
    Tableau 14. Renvoie
    Type Description
    Arraylist Liste de toutes les classes dans la hiérarchie de la table spécifiée. 
    var table = new TableUtils("cmdb_ci_server");
gs.print(table.getHierarchy());

    Sortie : [cmdb_ci_server, cmdb_ci_computer, cmdb_ci_hardware, cmdb_ci, cmdb_ci_mainframe, cmdb_ci_linux_server, cmdb_ci_mainframe_lpar, cmdb_ci_esx_server, cmdb_ci_unix_server, cmdb_ci_solaris_server, cmdb_ci_hpux_server, cmdb_ci_aix_server, cmdb_ci_osx_server, cmdb_ci_netware_server, cmdb_ci_win_server]

    TableUtils : getTables()

    Renvoie la hiérarchie de table.

    Tableau 15. Paramètres
    Nom Type Description
    Aucun
    Tableau 16. Renvoie
    Type Description
    Arraylist Liste de noms de tables dans la hiérarchie parente. 
    // Get the hierarchy of tables
var table = new TableUtils("cmdb_ci_computer");
var tableArrayList = table.getTables();

// Use the j2js method to convert the Java ArrayList to JavaScript
gs.include("j2js");
var tableArray = j2js(tableArrayList);

// Write the value of each element in the JavaScript array
var i = 0;
while ( i < tableArray.length ) {
gs.print("Table with index " + i + ": " + tableArray[i]);
i++;
}
    Sortie : 
    Table with index 0: cmdb_ci_computer
Table with index 1: cmdb_ci_hardware
Table with index 2: cmdb_ci
Table with index 3: cmdb

    TableUtils : getTableExtensions()

    Renvoie une liste de tables qui étendent une table.

    Tableau 17. Paramètres
    Nom Type Description
    Aucun
    Tableau 18. Renvoie
    Type Description
    Arraylist Une liste de noms de tables qui étendent la table.

    Cet exemple montre que 58 tables dans cette instance étendent la table Ordinateur [cmdb_ci_computer]. (Résultat condensé ci-dessous.)

    // Get the tables that extend the table
var table = new TableUtils("cmdb_ci_computer");
var tableArrayList = table.getTableExtensions();
 
// Use the j2js method to convert the Java ArrayList to JavaScript
gs.include("j2js");
var tableArray = j2js(tableArrayList);
 
// Write the value of each element in the JavaScript array
var i = 0;
while ( i < tableArray.length ) {
  gs.print("Table with index " + i + ": " + tableArray[i]);
  i++;
}
    Sortie : 
    Table with index 0: cmdb_ci_mainframe_hardware
Table with index 1: cmdb_ci_handheld_computing
Table with index 2: cmdb_ci_ucs_blade
Table with index 3: cmdb_ci_storage_switch
Table with index 4: cmdb_ci_server
Table with index 5: cmdb_ci_hmc_server
…
Table with index 56: cmdb_ci_pc_hardware
Table with index 57: cmdb_ci_ucs_rack_unit

    TableUtils : hasExtensions()

    Détermine si une table a été étendue.

    Tableau 19. Paramètres
    Nom Type Description
    Aucun
    Tableau 20. Renvoie
    Type Description
    Booléen Vrai si la table comporte des extensions. 
    var table = new TableUtils("cmdb_ci_server");
gs.print(table.hasExtensions());
    Sortie : 
    true

    TableUtils : isBaseClass()

    Détermine si une table est une classe de base, c’est-à-dire si elle n’a pas de parents et possède des extensions.

    Par exemple, Tâche est une classe de base puisqu’elle n’est pas étendue à partir d’une autre table et possède des tables étendues à partir de celle-ci. Sys_user n’est pas une classe de base car elle n’a pas de parents, mais n’a pas d’extensions.

    Tableau 21. Paramètres
    Nom Type Description
    Aucun
    Tableau 22. Renvoie
    Type Description
    Booléen Marqueur indiquant si une table est une table de classe de base, ce qui signifie qu’elle n’a pas de parents mais qu’elle a des extensions.
    Valeurs valides :
    • true : la table est une classe de base.
    • false : la table n’est pas une classe de base.

    Exemple

    var table = new TableUtils("task");
gs.print("Task is base class: " + table.isBaseClass());
 
var table = new TableUtils("sys_user");
gs.print("User is base class: " + table.isBaseClass());
    Sortie : 
     Task is base class: true
User is base class: false

    TableUtils - isSoloClass()

    Détermine si la table n’a ni parents ni extensions.

    Tableau 23. Paramètres
    Nom Type Description
    Aucun
    Tableau 24. Renvoie
    Type Description
    Booléen Vrai si la table n’a pas de parent et qu’aucune table n’est étendue à partir de celui-ci. 
    var table = new TableUtils("task");
gs.print("task is solo class: " + table.isSoloClass());
 
var table = new TableUtils("cmdb_ci_win_server");
gs.print("cmdb_ci_win_server is solo class: " + table.isSoloClass());
 
var table = new TableUtils("sys_user");
gs.print("sys_user is solo class: " + table.isSoloClass());
    Sortie : 
    task is solo class: false
cmdb_ci_win_server is solo class: false
sys_user is solo class: true

    TableUtils : TableUtils(String tableName)

    Crée l’instance d’une classe TableUtils.

    Tableau 25. Paramètres
    Nom Type Description
    tableName Chaîne Le nom de table 
    var tu = new TableUtils("incident");