TabellenUtils – Global

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 5 Minuten Lesedauer

    • Die TabellenUtils Die Skripteinbindung bietet Verknüpfungen für den Zugriff auf tabellenbezogene Informationen.

    Diese Klasse ist für serverseitige Skripts verfügbar.

    TableUtils – TableUtils(String tableName)

    Erstellt eine Instanz einer TableUtils-Klasse.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    tableName Zeichenfolge Der Tabellenname 
    var tu = new TableUtils("incident");

    TableUtils – drop(String tableName)

    Verwirft eine Datenbanktabelle.

    Hinweis:
    Mit äußerster Vorsicht verwenden. Durch das Verwerfen einer Tabelle werden die Tabelle und alle ihre Daten dauerhaft gelöscht. Wenn die Tabelle erweitert ist, verwenden Sie dropTableAndExtensions.
    Tabelle : 2. Parameter
    Name Typ Beschreibung
    tableName Zeichenfolge Name der zu verwerfenden Tabelle
    Tabelle : 3. Ergebnisse
    Typ Beschreibung
    void 
    var tu = new TableUtils();
tu.drop("table_that_will_be_lost_forever");
    Ausgabe: 
    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)

    Verwirft eine Datenbanktabelle und bereinigt Verweise auf die Tabelle.

    Hinweis:
    Mit äußerster Vorsicht verwenden. Durch das Verwerfen einer Datenbanktabelle werden die Tabelle und alle ihre Daten dauerhaft gelöscht. Wenn die Tabelle erweitert ist, verwenden Sie dropTableAndExtensions.
    Tabelle : 4. Parameter
    Name Typ Beschreibung
    tableName Zeichenfolge Name der zu verwerfenden Tabelle
    Tabelle : 5. Ergebnisse
    Typ Beschreibung
    void 
    var tu = new TableUtils();
tu.dropAndClean("table_that_will_be_lost_forever");
    Ausgabe: 
    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)

    Verwirft eine Datenbanktabelle, alle erweiterten Tabellen, und bereinigt Verweise auf die Tabellen.

    Hinweis:
    Mit äußerster Vorsicht verwenden. Durch das Verwerfen einer Datenbanktabelle werden die Tabelle und alle ihre Daten dauerhaft gelöscht.
    Tabelle : 6. Parameter
    Name Typ Beschreibung
    tableName Zeichenfolge Die zu verwerfende Tabelle
    Tabelle : 7. Ergebnisse
    Typ Beschreibung
    void 
    var tu = new TableUtils();
tu.dropTableAndExtensions("table_that_will_be_lost_forever");
    Ausgabe: 
    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()

    Gibt den Namen der Basistabelle zurück, aus der die Tabelle erweitert wurde.

    Hinweis:
    Für jeden Tisch unter der cmdb_ci Hierarchie gibt diese Methode cmdb_ci und nicht cmdb zurück, was die eigentliche Basistabelle ist.
    Tabelle : 8. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 9. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Name der Basistabelle 
    var table = new TableUtils("cmdb_ci_server");
gs.print(table.getAbsoluteBase());

    Ausgabe: cmdb_ci

    TableUtils – getAllExtensions()

    Gibt die Liste der Tabellen zurück, die eine Tabelle erweitern, einschließlich der Basistabelle.

    Tabelle : 10. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 11. Ergebnisse
    Typ Beschreibung
    ArrayList Eine Liste der Tabellen, die die Tabelle erweitern, einschließlich der Basistabelle. 
    var table = new TableUtils("task");
gs.print(table.getAllExtensions());
    Ausgabe: 
    [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()

    Gibt eine Liste aller Klassen zurück, die an der Hierarchie der angegebenen Tabelle beteiligt sind.

    Tabelle : 12. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 13. Ergebnisse
    Typ Beschreibung
    ArrayList Eine Liste aller Klassen in der Hierarchie der angegebenen Tabelle. 
    var table = new TableUtils("cmdb_ci_server");
gs.print(table.getHierarchy());

    Ausgabe: [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()

    Gibt die Tabellenhierarchie zurück.

    Tabelle : 14. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 15. Ergebnisse
    Typ Beschreibung
    ArrayList Eine Liste der Tabellennamen in der übergeordneten Hierarchie. 
    // 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++;
}
    Ausgabe: 
    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()

    Gibt eine Liste von Tabellen zurück, die eine Tabelle erweitern.

    Tabelle : 16. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 17. Ergebnisse
    Typ Beschreibung
    ArrayList Eine Liste mit Tabellennamen, die die Tabelle erweitern.

    Dieses Beispiel zeigt, dass 58 Tabellen in dieser Instanz die Tabelle Computer [cmdb_ci_Computer] erweitern. (Ausgabe unten komprimiert.)

    // 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++;
}
    Ausgabe: 
    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()

    Bestimmt, ob eine Tabelle erweitert wurde.

    Tabelle : 18. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 19. Ergebnisse
    Typ Beschreibung
    Boolean „True“, wenn die Tabelle Erweiterungen hat. 
    var table = new TableUtils("cmdb_ci_server");
gs.print(table.hasExtensions());
    Ausgabe: 
    true

    TableUtils – isBaseClass()

    Bestimmt, ob eine Tabelle eine Basisklasse ist, d. h. sie hat keine übergeordneten Elemente und Erweiterungen.

    Beispielsweise ist Aufgabe eine Basisklasse, da sie nicht aus einer anderen Tabelle erweitert wird und daraus Tabellen enthält. SYS_user ist keine Basisklasse, da sie keine übergeordneten Elemente hat, aber keine Erweiterungen hat.

    Tabelle : 20. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 21. Ergebnisse
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob eine Tabelle eine Basisklassen-Tabelle ist, d. h. sie hat keine übergeordneten Elemente, aber Erweiterungen.
    Gültige Werte:
    • Wahr: Tabelle ist eine Basisklasse.
    • Falsch: Tabelle ist keine Basisklasse.
    		 
    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());
    Ausgabe: 
     Task is base class: true
User is base class: false

    TableUtils – isSoloClass()

    Bestimmt, ob die Tabelle keine übergeordneten Elemente und keine Erweiterungen hat.

    Tabelle : 22. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 23. Ergebnisse
    Typ Beschreibung
    Boolean „True“, wenn die Tabelle kein übergeordnetes Element hat und keine Tabelle aus ihr erweitert wurde. 
    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());
    Ausgabe: 
    task is solo class: false
cmdb_ci_win_server is solo class: false
sys_user is solo class: true

    TableUtils – tableExists()

    Überprüft, ob eine Tabelle vorhanden ist.

    Tabelle : 24. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 25. Ergebnisse
    Typ Beschreibung
    Boolean „True“, wenn die Tabelle existiert. 
    var table = new TableUtils("my_table");
gs.print("Does 'my_table' exist? " + table.tableExists());

    Ausgabe: Existiert 'my_table'? false