GlideUser :スコープ指定

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間：6分

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

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

    Scoped GlideUser - getCompanyID()

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

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

    Scoped GlideUser - getDisplayName()

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

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

    Scoped GlideUser - getEmail()

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

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

    Scoped GlideUser - getFirstName()

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

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

    Scoped GlideUser - getID()

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

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

    Scoped GlideUser - getLastName()

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

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

    Scoped GlideUser - getName()

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

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

    Scoped GlideUser - getPreference(文字列 name)

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

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

    Scoped 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

    Scoped GlideUser - getUserRoles()

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

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

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

    Scoped GlideUser - hasRole(文字列 role)

    現在のユーザーに指定されたロールがあるかどうかを判別します。

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

    Scoped GlideUser - isMemberOf(文字列 group)

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

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

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

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

    出力:

    false

    Scoped GlideUser - savePreference(文字列 name, 文字列 value)

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

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