GlideUser - グローバル

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む11読むのに数分

    • GlideUser API では、現在のユーザーと現在のユーザーロールに関する情報にアクセスできます。

    GlideUser API を使用すると、遅い GlideRecord クエリーを使用してユーザー情報を取得する必要がなくなります。

    GlideUser - getCompanyID()

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

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

    スコープ対応

    スコープ対象のアプリケーションで getCompanyID() メソッドを使用するには、対応するスコープ対象のメソッドを使用します：getCompanyID() 。

    GlideUser - getDisplayName()

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

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

    スコープ対応

    スコープ対象のアプリケーションで getDisplayName() メソッドを使用するには、対応するスコープ対象のメソッドを使用します：getDisplayName()。

    GlideUser - getDomainDisplayValue()

    ユーザーのセッションドメインの表示値を返します。

    表 : 5. パラメーター
    名前 タイプ 説明
    なし
    表 : 6. 返される内容
    タイプ 説明
    文字列 ユーザーのセッションドメインの表示値。 
    var currentUser = gs.getUser(); 
gs.info(currentUser.getDomainDisplayValue());

    スコープ対応

    スコープ対象のアプリケーションに対するワークアラウンドはありません。

    GlideUser - getDomainID()

    ユーザーの現在のセッションドメインの識別子を返します。

    返される識別子は、ドメインタイプとそのドメインのインスタンス化によって異なります。

    • ユーザーがグローバルドメインで構成されていて、ドメインピッカーを使用してドメインを切り替えない場合、このメソッドは null を返します。
    • ユーザーがドメインピッカーを使用してグローバルドメインに切り替えると、このメソッドは文字列「global」を返します。
    • 他のすべてのドメインの場合、このメソッドはそのドメインの sys_id を返します。
    表 : 7. パラメーター
    名前 タイプ 説明
    なし
    表 : 8. 返される内容
    タイプ 説明
    文字列 ドメイン識別子。 
    var domain = new GlideRecord('domain');
domain.get(gs.getUser().getDomainID());
gs.info(domain.name);

    GlideUser - getEmail()

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

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

    スコープ対応

    スコープ対象のアプリケーションで getEmail() メソッドを使用するには、対応するスコープ対象のメソッドを使用します：getEmail() 。

    GlideUser - getFirstName()

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

    表 : 11. パラメーター
    名前 タイプ 説明
    なし
    表 : 12. 返される内容
    タイプ 説明
    オブジェクト / 文字列 ユーザーの名。
    注:
    戻り値のデータタイプはオブジェクトですが、情報は文字列として返されます。
    		 
    var currentUser = gs.getUser(); 
var userName = currentUser.getFirstName();
gs.info('User First Name: + userName);
gs.info('Data type: ' + typeof userName);
    *** Script: User First Name: John
*** Script: Data type: object

    スコープ対応

    スコープ対象のアプリケーションで getFirstName() メソッドを使用するには、対応するスコープ対象のメソッドを使用します：getFirstName()。

    GlideUser - getID

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

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

    スコープ対応

    スコープ対象のアプリケーションで getID() メソッドを使用するには、対応するスコープ対象のメソッドを使用します：getID()。

    GlideUser - getLastName()

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

    表 : 15. パラメーター
    名前 タイプ 説明
    なし
    表 : 16. 返される内容
    タイプ 説明
    オブジェクト / 文字列 ユーザーの姓。
    注:
    戻り値のデータタイプはオブジェクトですが、情報は文字列として返されます。
    		 
    var currentUser = gs.getUser(); 
var userName = currentUser.getLastName();
gs.info('User Last Name: + userName);
gs.info('Data type: ' + typeof userName);
    *** Script: User Last Name: Smith
*** Script: Data type: object

    スコープ対応

    スコープ対象のアプリケーションで getLastName() メソッドを使用するには、対応するスコープ対象のメソッドを使用します：getLastName()。

    GlideUser - getMyGroups()

    ユーザーが属するすべてのグループのリストを含む反復子を返します。アクティブなグループのみが返されます。

    表 : 17. パラメーター
    名前 タイプ 説明
    なし
    表 : 18. 返される内容
    タイプ 説明
    反復子 ユーザーが属するアクティブなグループの sys_id のリスト。

    次の例は、ユーザーが属するグループのリストを返す方法を示しています。

    var groupsArray = gs.getUser().getMyGroups().toArray();
gs.info(groupsArray[0]);
    出力:
    cfcbad03d711110050f5edcb9e61038f

    スコープ対応

    このメソッドの有効範囲はありません。

    GlideUser - getName()

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

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

    スコープ対応

    スコープ対象のアプリケーションで getName() メソッドを使用するには、対応するスコープ対象のメソッド getName() を使用します。

    GlideUser - getRoles()

    ユーザーに関連付けられたロールのリストを返します。明示的に付与されたロール、継承されたロール、およびグループメンバーシップによって取得されたロールが含まれます。

    表 : 21. パラメーター
    名前 タイプ 説明
    なし
    表 : 22. 返される内容
    タイプ 説明
    オブジェクト ユーザーロールのカンマ区切りリスト。 
    var currentUser = gs.getUser(); 
gs.info(currentUser.getRoles());

    出力：

    admin,hr_fulfiller,itsa_fulfiller,security_admin

    スコープ対応

    スコープ対象のアプリケーションで getRoles() メソッドを使用するには、対応するスコープ対象メソッドを使用します：getRoles()。

    GlideUser：getUserByID (文字列 ID)

    渡されたユーザー ID (sys_user の sys_id) または user_name に関連付けられたユーザーオブジェクトを返します。

    表 : 23. パラメーター
    名前 タイプ 説明
    ID 文字列 目的のユーザーレコードの一意の ID (sys_id) または user_name。
    表 : 24. 返される内容
    タイプ 説明
    オブジェクト 指定された sys_id または user_name に関連付けられたユーザーオブジェクト。

    ユーザー名 (user_name) を使用した例。

    var currentUser = gs.getUser();
gs.info(currentUser.getFirstName()); // print the first name of the logged in user
var newUser = currentUser.getUserByID('abel.tuter'); // fetch a different user using the user_name field
gs.info(newUser.getFirstName()); // print the first name of the Abel Tuter user

    ユーザー ID (sys_id) を使用した例。

    var currentUser = gs.getUser();
gs.info(currentUser.getFirstName()); // print the first name of the logged in user
var newUser = currentUser.getUserByID('62826bf03710200044e0bfc8bcbe5df1'); // fetch Abel Tuter user using sys_id from sys_user record
gs.info(newUser.getFirstName()); // print the first name of the Abel Tuter user

    GlideUser - getUserRoles()

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

    表 : 25. パラメーター
    名前 タイプ 説明
    なし
    表 : 26. 返される内容
    タイプ 説明
    オブジェクト / 文字列 ユーザーに明示的に割り当てられたロールのカンマ区切りリスト。
    注:
    戻り値のデータタイプはオブジェクトですが、情報は文字列として返されます。
    		 
    var currentUser = gs.getUser(); 
var userRoles = currentUser.getUserRoles();
gs.info('User Roles: ' + userRoles);
gs.info('Data type: ' + typeof userRoles);
    *** Script: User Roles: ,admin,security_admin
*** Script: Data type: object

    スコープ対応

    スコープ対象のアプリケーションで getUserRoles() メソッドを使用するには、対応するスコープ対象メソッドを使用します：getUserRoles()。

    GlideUser - hasRole(文字列 role)

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

    表 : 27. パラメーター
    名前 タイプ 説明
    ロール 文字列 チェック対象のロール
    表 : 28. 返される内容
    タイプ 説明
    ブーリアン ユーザーにロールがある場合は true。 
    var currentUser = gs.getUser(); 
gs.info(currentUser.hasRole('admin'));

    スコープ対応

    スコープ対象のアプリケーションで hasRole() メソッドを使用するには、対応するスコープ対象メソッドを使用します：hasRole()。

    GlideUser - isExplicitMemberOf(文字列 group)

    現在のユーザーが指定されたグループの明示的なメンバーかどうかを判断します。このメソッドではアクティブなグループのみが評価されます。

    isMemberOf() メソッドは、ユーザーが親グループのメンバーである場合、親グループに対して true を返します。親グループに対してのみ true を返す場合は、このメソッドを使用します。

    表 : 29. パラメーター
    名前 タイプ 説明
    グループ 文字列 確認するユーザーグループのSys_id。
    表 : 30. 返される内容
    タイプ 説明
    ブール

    現在のユーザーが指定されたグループの明示的なメンバーであるかどうかを示すフラグ。

    有効な値：
    • true:現在のユーザーは指定されたグループの明示的なメンバーです。
    • false:現在のユーザーは指定されたグループの明示的なメンバーではありません。

    次の例は、現在のユーザーが指定されたグループの明示的なメンバーであるかどうかを確認する方法を示しています。

    var isExplMem = gs.getUser().isExplicitMemberOf('b8ef24616fc331003b3c498f5d3ee434');
gs.info(isExplMem);

    出力:

    false

    スコープ対応

    このメソッドの有効範囲はありません。

    GlideUser - isMemberOf(文字列 group)

    現在のユーザーが指定されたグループのメンバーかどうかを判別します。このメソッドではアクティブなグループのみが評価されます。

    ユーザーが子グループのメンバーである場合、このメソッドは親グループに対して true を返します。親グループに対してのみ true を返す場合は、 isExplicitMemberOf() を使用します。

    表 : 31. パラメーター
    名前 タイプ 説明
    グループ 文字列 確認するユーザーグループのSys_id。
    表 : 32. 返される内容
    タイプ 説明
    ブール

    現在のユーザーが指定されたグループのメンバーかどうかを示すフラグ。

    有効な値：
    • true:現在のユーザーは指定されたグループのメンバーです。
    • false:現在のユーザーは指定されたグループのメンバーではありません。

    次の例は、現在のユーザーが指定されたグループのメンバーかどうかを確認する方法を示しています。

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

    スコープ対応

    スコープ対象のアプリケーションで isMemberOf() メソッドを使用するには、対応するスコープ対象メソッドを使用します：isMemberOf()。