--- sourceDocument: Xanadu API リファレンス sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/api-reference Release : - xanadu ft:locale : - ja-JP ft:publication_title : - Xanadu API リファレンス ft:clusterId : - crapiref bundleId : - crapiref workflow : - Creator --- # GlideUser - グローバル # GlideUser - グローバル {#ariaid-title1} * リリースバージョン: Xanadu * * 更新日 2024年08月01日 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：11分 GlideUser API は、現在のユーザーと現在のユーザーロールに関する情報にアクセスするためのメソッドを提供します。 GlideUser API を使用すると、ユーザー情報を取得するために低速な GlideRecord クエリを使用する必要がなくなります。 ## GlideUser - getCompanyID() {#ariaid-title2} 現在のユーザーの会社の sys_id を返します。 {#GUser-getCompanyID__table_vmc_n33_xz__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | なし | | | [表 : 1. パラメーター] {#GUser-getCompanyID__table_vmc_n33_xz} {#GUser-getCompanyID__table_wmc_n33_xz__entry__2} | タイプ | 説明 | |-|-| | 文字列 | 会社の sys_id | [表 : 2. 返される内容] {#GUser-getCompanyID__table_wmc_n33_xz} var currentUser = gs.getUser(); gs.info(currentUser.getCompanyID()); ### スコープ対応 {#GUser-getCompanyID__section_fzj_lyh_xz} スコープ対象のアプリケーションで getCompanyID() メソッドを使用するには、対応するスコープ対象のメソッドを使用します：[getCompanyID()](https://servicenow-prod.fluidtopics.net/0HfWZdx0SIVDQ1L27yj83Q#r_ScopedGlideUserGetCompanyID "現在のユーザーの会社の sys_id を返します。")。 ## GlideUser - getDisplayName() {#ariaid-title3} 現在のユーザーの表示名を返します。 {#GUser-getDisplayName__table_qqh_mh3_xz__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | なし | | | [表 : 3. パラメーター] {#GUser-getDisplayName__table_qqh_mh3_xz} {#GUser-getDisplayName__table_rqh_mh3_xz__entry__2} | タイプ | 説明 | |-|-| | 文字列 | ユーザーの表示名 | [表 : 4. 返される内容] {#GUser-getDisplayName__table_rqh_mh3_xz} var currentUser = gs.getUser(); gs.info(currentUser.getDisplayName()); ### スコープ対応 {#GUser-getDisplayName__section_fzj_lyh_xz} スコープ対象のアプリケーションで getDisplayName() メソッドを使用するには、対応するスコープ対象のメソッドを使用します：[getDisplayName()](https://servicenow-prod.fluidtopics.net/0HfWZdx0SIVDQ1L27yj83Q#r_ScopedGlideUserGetDisplayName "現在のユーザーの表示名を返します。")。 ## GlideUser - getDomainDisplayValue() {#ariaid-title4} ユーザーのセッションドメインの表示値を返します。 {#GUser-getDomainDisplayValue__table_wrr_hlg_zz__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | なし | | | [表 : 5. パラメーター] {#GUser-getDomainDisplayValue__table_wrr_hlg_zz} {#GUser-getDomainDisplayValue__table_xrr_hlg_zz__entry__2} | タイプ | 説明 | |-|-| | 文字列 | ユーザーのセッションドメインの表示値。 | [表 : 6. 返される内容] {#GUser-getDomainDisplayValue__table_xrr_hlg_zz} var currentUser = gs.getUser(); gs.info(currentUser.getDomainDisplayValue()); ### スコープ対応 {#GUser-getDomainDisplayValue__section_oy2_nts_mcb} スコープ対象のアプリケーションに対するワークアラウンドはありません。 ## GlideUser - getDomainID() {#ariaid-title5} ユーザーの現在のセッションドメインの識別子を返します。 返される識別子は、ドメインタイプとそのドメインのインスタンス化によって異なります。 * ユーザーがグローバルドメインで構成されていて、ドメインピッカーを使用してドメインを切り替えない場合、このメソッドは null を返します。 * ユーザーがドメインピッカーを使用してグローバルドメインに切り替えると、このメソッドは文字列「global」を返します。 * 他のすべてのドメインの場合、このメソッドはそのドメインの sys_id を返します。 {#GUser-getDomainID__ul_l4v_kc1_pfb} {#GUser-getDomainID__table_trl_lzz_4fb__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | なし | | | [表 : 7. パラメーター] {#GUser-getDomainID__table_trl_lzz_4fb} {#GUser-getDomainID__table_url_lzz_4fb__entry__2} | タイプ | 説明 | |-|-| | 文字列 | ドメイン識別子。 | [表 : 8. 返される内容] {#GUser-getDomainID__table_url_lzz_4fb} var domain = new GlideRecord('domain'); domain.get(gs.getUser().getDomainID()); gs.info(domain.name); ## GlideUser - getEmail() {#ariaid-title6} ユーザーのメールアドレスを返します。 {#GUser-getEmail__table_nxz_qg3_xz__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | なし | | | [表 : 9. パラメーター] {#GUser-getEmail__table_nxz_qg3_xz} {#GUser-getEmail__table_oxz_qg3_xz__entry__2} | タイプ | 説明 | |-|-| | 文字列 | ユーザーのメールアドレス | [表 : 10. 返される内容] {#GUser-getEmail__table_oxz_qg3_xz} var currentUser = gs.getUser(); gs.info(currentUser.getEmail()); ### スコープ対応 {#GUser-getEmail__section_fzj_lyh_xz} スコープ対象のアプリケーションで getEmail() メソッドを使用するには、対応するスコープ対象のメソッドを使用します：[getEmail()](https://servicenow-prod.fluidtopics.net/0HfWZdx0SIVDQ1L27yj83Q#r_SGU-getEmail "ユーザーのメールアドレスを返します。")。 ## GlideUser - getFirstName() {#ariaid-title7} ユーザーの名を返します。 {#GUser-getFirstName__table_mjs_zb3_xz__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | なし | | | [表 : 11. パラメーター] {#GUser-getFirstName__table_mjs_zb3_xz} {#GUser-getFirstName__table_njs_zb3_xz__entry__2} | タイプ | 説明 | |-|-| | オブジェクト / 文字列 | ユーザーの名。 注: 戻り値のデータタイプはオブジェクトですが、情報は文字列として返されます。 | [表 : 12. 返される内容] {#GUser-getFirstName__table_njs_zb3_xz} 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 ### スコープ対応 {#GUser-getFirstName__section_fzj_lyh_xz} スコープ対象のアプリケーションで getFirstName() メソッドを使用するには、対応するスコープ対象のメソッドを使用します：[getFirstName()](https://servicenow-prod.fluidtopics.net/0HfWZdx0SIVDQ1L27yj83Q#r_SGU-getFirstName "ユーザーの名を返します。")。 ## GlideUser - getID {#ariaid-title8} 現在のユーザーの sys_id を返します。 {#GUser-getID__table_vtq_4xh_xz__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | なし | | | [表 : 13. パラメーター] {#GUser-getID__table_vtq_4xh_xz} {#GUser-getID__table_wtq_4xh_xz__entry__2} | タイプ | 説明 | |-|-| | 文字列 | ユーザーの sys_id | [表 : 14. 返される内容] {#GUser-getID__table_wtq_4xh_xz} var currentUser = gs.getUser(); gs.info(currentUser.getID()); ### スコープ対応 {#GUser-getID__section_fzj_lyh_xz} スコープ対象のアプリケーションで getID() メソッドを使用するには、対応するスコープ対象のメソッドを使用します：[getID()](https://servicenow-prod.fluidtopics.net/0HfWZdx0SIVDQ1L27yj83Q#r_ScopedGlideUserGetID "現在のユーザーの sys_id を取得します。")。 ## GlideUser - getLastName() {#ariaid-title9} ユーザーの姓を返します。 {#GUser-getLastName__table_agq_1g3_xz__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | なし | | | [表 : 15. パラメーター] {#GUser-getLastName__table_agq_1g3_xz} {#GUser-getLastName__table_bgq_1g3_xz__entry__2} | タイプ | 説明 | |-|-| | オブジェクト / 文字列 | ユーザーの姓。 注: 戻り値のデータタイプはオブジェクトですが、情報は文字列として返されます。 | [表 : 16. 返される内容] {#GUser-getLastName__table_bgq_1g3_xz} 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 ### スコープ対応 {#GUser-getLastName__section_fzj_lyh_xz} スコープ対象のアプリケーションで getLastName() メソッドを使用するには、対応するスコープ対象のメソッドを使用します：[getLastName()](https://servicenow-prod.fluidtopics.net/0HfWZdx0SIVDQ1L27yj83Q#r_SGU-getLastName "ユーザーの姓を返します。")。 ## GlideUser - getMyGroups() {#ariaid-title10} ユーザーが属するすべてのグループのリストを含む反復子を返します。アクティブなグループのみが返されます。 {#GUser-getMyGroups__table_llp_tc5_5bb__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | なし | | | [表 : 17. パラメーター] {#GUser-getMyGroups__table_llp_tc5_5bb} {#GUser-getMyGroups__table_mlp_tc5_5bb__entry__2} | タイプ | 説明 | |-|-| | 反復子 | ユーザーが属するアクティブなグループの sys_id のリスト。 | [表 : 18. 返される内容] {#GUser-getMyGroups__table_mlp_tc5_5bb} 次の例は、ユーザーが属するグループのリストを返す方法を示しています。 var groupsArray = gs.getUser().getMyGroups().toArray(); gs.info(groupsArray[0]); 出力: cfcbad03d711110050f5edcb9e61038f ### スコープ対応 {#GUser-getMyGroups__section_p31_wts_mcb} このメソッドの有効範囲はありません。 ## GlideUser - getName() {#ariaid-title11} 現在のユーザーのユーザー ID またはログイン名を返します。 {#GUser-getName__table_exc_w13_xz__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | なし | | | [表 : 19. パラメーター] {#GUser-getName__table_exc_w13_xz} {#GUser-getName__table_fxc_w13_xz__entry__2} | タイプ | 説明 | |-|-| | 文字列 | ユーザー ID | [表 : 20. 返される内容] {#GUser-getName__table_fxc_w13_xz} var currentUser = gs.getUser(); gs.info(currentUser.getName()); ### スコープ対応 {#GUser-getName__section_fzj_lyh_xz} スコープ対象のアプリケーションで getName() メソッドを使用するには、対応するスコープ対象のメソッド [getName()](https://servicenow-prod.fluidtopics.net/0HfWZdx0SIVDQ1L27yj83Q#r_ScopedGlideUserGetName "現在のユーザーのユーザー ID またはログイン名を返します。") を使用します。 ## GlideUser - getRoles() {#ariaid-title12} ユーザーに関連付けられたロールのリストを返します。明示的に付与されたロール、継承されたロール、およびグループメンバーシップによって取得されたロールが含まれます。 {#GUser-getRoles__table_ml5_q4m_xz__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | なし | | | [表 : 21. パラメーター] {#GUser-getRoles__table_ml5_q4m_xz} {#GUser-getRoles__table_nl5_q4m_xz__entry__2} | タイプ | 説明 | |-|-| | オブジェクト | ユーザーロールのカンマ区切りリスト。 | [表 : 22. 返される内容] {#GUser-getRoles__table_nl5_q4m_xz} var currentUser = gs.getUser(); gs.info(currentUser.getRoles()); 出力： admin,hr_fulfiller,itsa_fulfiller,security_admin ### スコープ対応 {#GUser-getRoles__section_fzj_lyh_xz} スコープ対象のアプリケーションで getRoles() メソッドを使用するには、対応するスコープ対象メソッドを使用します：[getRoles()](https://servicenow-prod.fluidtopics.net/0HfWZdx0SIVDQ1L27yj83Q#r_SGU-getRoles "明示的に付与されたロール、継承されたロール、およびグループメンバーシップによって取得されたロールのリストを返します。")。 ## GlideUser：getUserByID (文字列 ID) {#ariaid-title13} 渡されたユーザー ID (sys_user の sys_id) または user_name に関連付けられたユーザーオブジェクトを返します。 {#GUser-getUserByID_S__table_wsx_qkr_h2b__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | ID | 文字列 | 目的のユーザーレコードの一意の ID (sys_id) または user_name。 | [表 : 23. パラメーター] {#GUser-getUserByID_S__table_wsx_qkr_h2b} {#GUser-getUserByID_S__table_xsx_qkr_h2b__entry__2} | タイプ | 説明 | |-|-| | オブジェクト | 指定された sys_id または user_name に関連付けられたユーザーオブジェクト。 | [表 : 24. 返される内容] {#GUser-getUserByID_S__table_xsx_qkr_h2b} ユーザー名 (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() {#ariaid-title14} ユーザーに明示的に付与されたロールのリストを返します。 {#GUser-getUserRoles__table_pkf_xnm_xz__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | なし | | | [表 : 25. パラメーター] {#GUser-getUserRoles__table_pkf_xnm_xz} {#GUser-getUserRoles__table_qkf_xnm_xz__entry__2} | タイプ | 説明 | |-|-| | オブジェクト / 文字列 | ユーザーに明示的に割り当てられたロールのカンマ区切りリスト。 注: 戻り値のデータタイプはオブジェクトですが、情報は文字列として返されます。 | [表 : 26. 返される内容] {#GUser-getUserRoles__table_qkf_xnm_xz} 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 ### スコープ対応 {#GUser-getUserRoles__section_fzj_lyh_xz} スコープ対象のアプリケーションで getUserRoles() メソッドを使用するには、対応するスコープ対象メソッドを使用します：[getUserRoles()](https://servicenow-prod.fluidtopics.net/0HfWZdx0SIVDQ1L27yj83Q#r_SGU-getUserRoles "ユーザーに明示的に付与されたロールのリストを返します。")。 ## GlideUser - hasRole(文字列 role) {#ariaid-title15} 現在のユーザーに指定されたロールがあるかどうかを判別します。 {#GUser-hasRole_S__table_xmz_mmm_xz__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | ロール | 文字列 | チェック対象のロール | [表 : 27. パラメーター] {#GUser-hasRole_S__table_xmz_mmm_xz} {#GUser-hasRole_S__table_ymz_mmm_xz__entry__2} | タイプ | 説明 | |-|-| | ブーリアン | ユーザーにロールがある場合は true。 | [表 : 28. 返される内容] {#GUser-hasRole_S__table_ymz_mmm_xz} var currentUser = gs.getUser(); gs.info(currentUser.hasRole('admin')); ### スコープ対応 {#GUser-hasRole_S__section_fzj_lyh_xz} スコープ対象のアプリケーションで hasRole() メソッドを使用するには、対応するスコープ対象メソッドを使用します：[hasRole()](https://servicenow-prod.fluidtopics.net/0HfWZdx0SIVDQ1L27yj83Q#r_ScopedGlideUserHasRole_String "現在のユーザーに指定されたロールがあるかどうかを判別します。")。 ## GlideUser - isExplicitMemberOf(文字列グループ) {#ariaid-title16} 現在のユーザーが指定されたグループの明示的なメンバーであるかどうかを判定します。このメソッドではアクティブなグループのみが評価されます。 isMemberOf() メソッドは、ユーザーが子グループのメンバーである場合、親グループに対して true を返します。親グループに対してのみ true を返す場合は、このメソッドを使用します。 {#GUser-isExplicitMemberOf_S__table_l1q_4lm_xz__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | グループ | 文字列 | 確認するユーザーグループのSys_id。 | [表 : 29. パラメーター] {#GUser-isExplicitMemberOf_S__table_l1q_4lm_xz} {#GUser-isExplicitMemberOf_S__table_m1q_4lm_xz__entry__2} | タイプ | 説明 | |-|-| | ブーリアン | 現在のユーザーが指定されたグループの明示的なメンバーであるかどうかを示すフラグ。 有効な値： * true:現在のユーザーは、指定されたグループの明示的なメンバーです。 * false:現在のユーザーは、指定されたグループの明示的なメンバーではありません。 {#GUser-isExplicitMemberOf_S__ul_gvv_fqf_nsb} | [表 : 30. 返される内容] {#GUser-isExplicitMemberOf_S__table_m1q_4lm_xz} 次の例は、現在のユーザーが指定されたグループの明示的なメンバーであるかどうかを確認する方法を示しています。 var isExplMem = gs.getUser().isExplicitMemberOf('b8ef24616fc331003b3c498f5d3ee434'); gs.info(isExplMem); 出力: false ### スコープ対応 {#GUser-isExplicitMemberOf_S__section_wxy_xpz_kwb} このメソッドの有効範囲はありません。 ## GlideUser - isMemberOf(文字列 group) {#ariaid-title17} 現在のユーザーが指定されたグループのメンバーかどうかを判別します。このメソッドではアクティブなグループのみが評価されます。 ユーザーが子グループのメンバーである場合、このメソッドは親グループに対して true を返します。親グループに対してのみ true を返す場合は、 isExplicitMemberOf() を使用します。 {#GUser-isMemberOf_S__table_l1q_4lm_xz__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | グループ | 文字列 | 確認するユーザーグループのSys_id。 | [表 : 31. パラメーター] {#GUser-isMemberOf_S__table_l1q_4lm_xz} {#GUser-isMemberOf_S__table_m1q_4lm_xz__entry__2} | タイプ | 説明 | |-|-| | ブーリアン | 現在のユーザーが指定されたグループのメンバーであるかどうかを示すフラグ。 有効な値： * true:現在のユーザーは、指定されたグループのメンバーです。 * false:現在のユーザーは指定されたグループのメンバーではありません。 {#GUser-isMemberOf_S__ul_gvv_fqf_nsb} | [表 : 32. 返される内容] {#GUser-isMemberOf_S__table_m1q_4lm_xz} 次の例は、現在のユーザーが指定されたグループのメンバーであるかどうかを確認する方法を示しています。 var currentUser = gs.getUser(); gs.info(currentUser.isMemberOf(­'Capacity Mgmt')); ### スコープ対応 {#GUser-isMemberOf_S__section_fzj_lyh_xz} スコープ対象のアプリケーションで isMemberOf() メソッドを使用するには、対応するスコープ対象メソッドを使用します：[isMemberOf()](https://servicenow-prod.fluidtopics.net/0HfWZdx0SIVDQ1L27yj83Q#r_ScopedGlideUserIsMemberOf_String "現在のユーザーが指定されたグループのメンバーかどうかを判別します。")。