GlideUser - スコープ指定

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：6分

    • GlideUser API は、現在のユーザーと現在のユーザーロールに関する情報にアクセスするためのメソッドを提供します。

    GlideUser API を使用すると、ユーザー情報を取得するために低速の GlideRecord クエリを使用する必要がなくなります。

    スコープ対象 GlideUser - getCompanyID()

    現在のユーザーの会社sys_idを返します。

    表 : 1. パラメーター
    名前 タイプ 説明
    なし
    表 : 2. 返される内容
    タイプ 説明
    文字列 会社sys_id。 
    var currentUser = gs.getUser(); 
gs.info(currentUser.getCompanyID());

    スコープ対象 GlideUser - getDisplayName()

    現在のユーザーの表示名を返します。

    表 : 3. パラメーター
    名前 タイプ 説明
    なし
    表 : 4. 返される内容
    タイプ 説明
    文字列 ユーザーの表示名 
    var currentUser = gs.getUser(); 
gs.info(currentUser.getDisplayName());

    スコープ指定 GlideUser - getEmail()

    ユーザーのメールアドレスを返します。

    表 : 5. パラメーター
    名前 タイプ 説明
    なし
    表 : 6. 返される内容
    タイプ 説明
    文字列 ユーザーのメールアドレス。 
    var currentUser = gs.getUser(); 
gs.info(currentUser.getEmail());

    スコープ付き GlideUser - getFirstName()

    ユーザーの名を返します。

    表 : 7. パラメーター
    名前 タイプ 説明
    なし
    表 : 8. 返される内容
    タイプ 説明
    文字列 ユーザーの名。 
    var currentUser = gs.getUser(); 
gs.info(currentUser.getFirstName());

    スコープ付き GlideUser - getID()

    現在のユーザーのsys_idを取得します。

    表 : 9. パラメーター
    名前 タイプ 説明
    なし
    表 : 10. 返される内容
    タイプ 説明
    文字列 ユーザーのsys_id。 
    var currentUser = gs.getUser(); 
gs.info(currentUser.getID());

    スコープ付き GlideUser - getLastName()

    ユーザーの姓を返します。

    表 : 11. パラメーター
    名前 タイプ 説明
    なし
    表 : 12. 返される内容
    タイプ 説明
    文字列 ユーザーの姓。 
    var currentUser = gs.getUser(); 
gs.info(currentUser.getLastName());

    スコープ指定 GlideUser - getName()

    現在のユーザーのユーザー ID またはログイン名を返します。

    表 : 13. パラメーター
    名前 タイプ 説明
    なし
    表 : 14. 返される内容
    タイプ 説明
    文字列 ユーザー ID またはログイン名。 
    var currentUser = gs.getUser(); 
gs.info(currentUser.getName());

    スコープ対象 GlideUser - getPreference(文字列名)

    現在のユーザーの指定されたユーザー設定値を取得します。

    表 : 15. パラメーター
    名前 タイプ 説明
    name 文字列 設定の名前。
    表 : 16. 返される内容
    タイプ 説明
    文字列 設定値。 
    var currentUser = gs.getUser(); 
currentUser.savePreference(­'myPref','red'); 
gs.info(currentUser.getPreference(­'myPref'));

    スコープ付き GlideUser - getRoles()

    明示的に付与されたロール、継承されたロール、およびグループメンバーシップによって獲得されたロールを含むロールのリストを返します。

    表 : 17. パラメーター
    名前 タイプ 説明
    なし
    表 : 18. 返される内容
    タイプ 説明
    アレイ ユーザーが利用できるすべてのロールのリスト 
    var currentUser = gs.getUser(); 
gs.info(currentUser.getRoles());

    スコープ指定 GlideUser - getTimeZoneLabel()

    現在のユーザーの優先言語で現在のユーザーのタイムゾーンラベルを返します。

    ユーザーの優先言語の設定の詳細については、「 User specific language」を参照してください。

    表 : 19. パラメーター
    名前 タイプ 説明
    なし
    表 : 20. 返される内容
    タイプ 説明
    文字列 現在のユーザーのタイムゾーンラベル。

    この例は、現在のユーザーのタイムゾーンラベルを優先言語で返す方法を示しています。

    gs.info(gs.getUser().getTimeZoneLabel());

    出力:

    Europe/Dublin

    スコープ付き GlideUser - getTimeZoneLabelLang(文字列言語)

    指定された言語で現在のユーザーのタイムゾーンラベルを返します。

    表 : 21. パラメーター
    名前 タイプ 説明
    言語 文字列 タイムゾーンラベルに使用する言語。言語 [sys_language] テーブルの ID 列にあります。

    有効な言語が指定されていない場合、タイムゾーンラベルは英語で返されます。
    表 : 22. 返される内容
    タイプ 説明
    文字列 現在のユーザーのタイムゾーンラベル。

    この例では、現在のユーザーのタイムゾーンラベルを指定された言語で返す方法を示します。

    gs.info(gs.getUser().getTimeZoneLabelLang("es")); //Spanish
gs.info(gs.getUser().getTimeZoneLabelLang("ja")); //Japanese
gs.info(gs.getUser().getTimeZoneLabelLang("jksjsjks")); //invalid

    出力:

    Europa/Dublín
ヨーロッパ/ダブリン
Europe/Dublin

    スコープ付き GlideUser - getUserRoles()

    ユーザーに明示的に付与されたロールのリストを返します。

    getRoles() メソッドとは異なり、このメソッドは、ユーザーが継承するロールまたはグループメンバーシップから取得したロールを返しません。

    表 : 23. パラメーター
    名前 タイプ 説明
    なし
    表 : 24. 返される内容
    タイプ 説明
    アレイ ユーザーに明示的にアサインされたロールのリスト。 
    var currentUser = gs.getUser(); 
gs.info(currentUser.getUserRoles());

    スコープ対象 GlideUser - hasRole(String role)

    現在のユーザーが指定されたロールを持っているかどうかを判定します。

    表 : 25. パラメーター
    名前 タイプ 説明
    ロール 文字列 確認するロール。
    表 : 26. 返される内容
    タイプ 説明
    ブーリアン ユーザーが指定されたロールを持っているかどうかを示すフラグ。
    可能な値：
    • true:ユーザーは指定されたロールを持っています。
    • false:ユーザーには指定されたロールがありません。
    		 
    var currentUser = gs.getUser(); 
gs.info(currentUser.hasRole('admin'));

    スコープ対象 GlideUser - isMemberOf(文字列グループ)

    現在のユーザーが指定されたグループのメンバーかどうかを判断します。

    表 : 27. パラメーター
    名前 タイプ 説明
    グループ 文字列 確認するグループのSys_idまたは名前。
    表 : 28. 返される内容
    タイプ 説明
    ブーリアン ユーザーが指定されたグループのメンバーであるかどうかを示すフラグ。
    可能な値：
    • true:ユーザーはグループのメンバーです。
    • false:ユーザーはグループのメンバーではありません。

    次の例では、現在のユーザーがキャパシティ管理グループのメンバーかどうかを確認します。

    var currentUser = gs.getUser(); 
gs.info(currentUser.isMemberOf('Capacity Mgmt'));

    出力:

    false

    スコープ対象 GlideUser - savePreference(文字列名, 文字列値)

    ユーザー設定値をデータベースに保存します。

    表 : 29. パラメーター
    名前 タイプ 説明
    name 文字列 保存するための設定。
    value 文字列 設定値。
    表 : 30. 返される内容
    タイプ 説明
    なし 
    var currentUser = gs.getUser(); 
currentUser.savePreference('myPref','red'); 
gs.info(currentUser.getPreference('myPref'));