GlideUser - スコープ指定

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間：5分

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

    Scoped GlideUser - getUserRoles()

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

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

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

    Scoped GlideUser - hasRole(文字列 role)

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

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

    Scoped GlideUser - isMemberOf(文字列 group)

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

    表 : 23. パラメーター
    名前 タイプ 説明
    グループ 文字列 チェックするグループ。
    表 : 24. 返される内容
    タイプ 説明
    ブーリアン ユーザーが指定されたグループのメンバーであるかどうかを示すフラグ。
    可能な値：
    • true:ユーザーは指定されたグループのメンバーです。
    • false:ユーザーは指定されたグループのメンバーではありません。
    		 
    var currentUser = gs.getUser(); 
gs.info(currentUser.isMemberOf(­'Capacity Mgmt'));

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

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

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