TableUtils - グローバル

TableUtils スクリプトインクルードは、テーブル関連情報にアクセスするためのショートカットを提供します。

このクラスは、サーバーサイドスクリプトで使用できます。

TableUtils - TableUtils(文字列 tableName)

TableUtils クラスのインスタンスを作成します。

表 : 1. パラメーター

名前	タイプ	説明
tableName	文字列	テーブル名

var tu = new TableUtils("incident");

TableUtils - drop(文字列 tableName)

データベーステーブルを削除します。

注:

十分に注意して使用してください。テーブルを削除すると、テーブルとその全データが完全に削除されます。テーブルが拡張されている場合は、dropTableAndExtensionsを使用します。

表 : 2. パラメーター

名前	タイプ	説明
tableName	文字列	削除するテーブルの名前

表 : 3. 返される内容

タイプ	説明
なし

var tu = new TableUtils();
tu.drop("table_that_will_be_lost_forever");

出力:

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(文字列 tableName)

データベーステーブルを削除し、テーブルへの参照をクリーンアップします。

注:

十分に注意して使用してください。データベーステーブルを削除すると、テーブルとその全データが完全に削除されます。テーブルが拡張されている場合は、dropTableAndExtensionsを使用します。

表 : 4. パラメーター

名前	タイプ	説明
tableName	文字列	削除するテーブルの名前

表 : 5. 返される内容

タイプ	説明
なし

var tu = new TableUtils();
tu.dropAndClean("table_that_will_be_lost_forever");

出力:

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(文字列 tableName)

データベーステーブルとその拡張されたテーブルをすべて削除し、テーブルへの参照をクリーンアップします。

注:

十分に注意して使用してください。データベーステーブルを削除すると、テーブルとその全データが完全に削除されます。

表 : 6. パラメーター

名前	タイプ	説明
tableName	文字列	削除するテーブル

表 : 7. 返される内容

タイプ	説明
なし

var tu = new TableUtils();
tu.dropTableAndExtensions("table_that_will_be_lost_forever");

出力:

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()

テーブルの拡張元のベーステーブル名を返します。

注:

cmdb_ci 階層の下にあるテーブルの場合、このメソッドは cmdb_ci を返し、実際のベーステーブルである cmdb は返しません。

表 : 8. パラメーター

名前	タイプ	説明
なし

表 : 9. 返される内容

タイプ	説明
文字列	ベーステーブル名

var table = new TableUtils("cmdb_ci_server");
gs.print(table.getAbsoluteBase());

出力：cmdb_ci

TableUtils - getAllExtensions()

テーブルを拡張するテーブルのリスト (ベーステーブルを含む) を返します。

表 : 10. パラメーター

名前	タイプ	説明
なし

表 : 11. 返される内容

タイプ	説明
ArrayList	テーブルを拡張するテーブルのリスト (ベーステーブルを含む)。

var table = new TableUtils("task");
gs.print(table.getAllExtensions());

出力：

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

指定されたテーブルの階層に参加しているすべてのクラスのリストを返します。

表 : 12. パラメーター

名前	タイプ	説明
なし

表 : 13. 返される内容

タイプ	説明
ArrayList	指定されたテーブルの階層内のすべてのクラスのリスト。

var table = new TableUtils("cmdb_ci_server");
gs.print(table.getHierarchy());

出力：[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()

テーブル階層を返します。

表 : 14. パラメーター

名前	タイプ	説明
なし

表 : 15. 返される内容

タイプ	説明
ArrayList	親階層内のテーブル名のリスト。

// 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++;
}

出力：

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()

テーブルを拡張するテーブルのリストを返します。

表 : 16. パラメーター

名前	タイプ	説明
なし

表 : 17. 返される内容

タイプ	説明
ArrayList	テーブルを拡張するテーブル名のリスト。

この例では、このインスタンス内の 58 個のテーブルがコンピューター [cmdb_ci_computer] テーブルを拡張していることを示します。(出力は下に要約。)

// 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++;
}

出力：

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()

テーブルが拡張されているかどうかを判断します。

表 : 18. パラメーター

名前	タイプ	説明
なし

表 : 19. 返される内容

タイプ	説明
ブーリアン	テーブルに拡張がある場合は true。

var table = new TableUtils("cmdb_ci_server");
gs.print(table.hasExtensions());

出力：

true

TableUtils - isBaseClass()

テーブルが基底クラスであるかどうか、すなわち親がなくて拡張があるかどうかを判断します。

例えば、Task は別のテーブルから拡張されておらず、そこからテーブルが拡張されているため、基底クラスです。sys_user は親を持たないが拡張もないため、基底クラスではありません。

表 : 20. パラメーター

名前	タイプ	説明
なし

表 : 21. 返される内容

タイプ	説明
ブーリアン	テーブルが基底クラステーブルである、すなわち親がなく拡張があるかどうかを示すフラグ。 有効な値： true：テーブルは基底クラスである。 false：テーブルは基底クラスではない。

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());

出力:

 Task is base class: true
User is base class: false

TableUtils - isSoloClass()

テーブルに親も拡張もないかどうかを判断します。

表 : 22. パラメーター

名前	タイプ	説明
なし

表 : 23. 返される内容

タイプ	説明
ブーリアン	テーブルに親がなく、そこから拡張されているテーブルもない場合は true。

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());

出力：

task is solo class: false
cmdb_ci_win_server is solo class: false
sys_user is solo class: true

TableUtils - tableExists()

テーブルが存在するかどうかを確認します。

表 : 24. パラメーター

名前	タイプ	説明
なし

表 : 25. 返される内容

タイプ	説明
ブーリアン	テーブルが存在する場合は true。

var table = new TableUtils("my_table");
gs.print("Does 'my_table' exist? " + table.tableExists());

出力：Does 'my_table' exist? false