GlideImpersonate - Global

The GlideImpersonate API enables administrators to pose as another authenticated user for testing purposes.

Use this API when you need to act as another user so to test functionality within your application. When impersonating another user, the administrator has access to exactly what the impersonated user would have access to in the system, including the same menus and modules.

注:

The system records anything the administrator does while impersonating another user as having been done by that user.

GlideImpersonate - canDebug(String userSysId)

Verifies whether the specified user can perform debugging on scripts.

In order for a user to be able to debug scripts, they must be on a developer instance. Debugging is not allowed on production instances.

表 : 1. Parameters

Name	Type	Description
userSysId	String	sys_Id of the user to verify for debugging capability.

表 : 2. Returns

Type	Description
Boolean	True: User is able to debug the application. False: User is not able to debug the application.

userDebug: function(userId) {
  var impUser = new GlideImpersonate();
  impUser.canDebug(userId);
 }

GlideImpersonate - canImpersonate(String userSysId)

Verifies whether the current user can impersonate the specified user.

If the current user is not assigned the admin role, the user to impersonate is inactive, or there are other issues with impersonating the specified user, the method returns "false" and the user cannot be impersonated.

表 : 3. Parameters

Name	Type	Description
userSysId	String	sys_Id of the user to impersonate

表 : 4. Returns

Type	Description
Boolean	Flag that indicates whether the current user can impersonate the specified user. Possible values: true: Current user can impersonate the specified user. false: Current user cannot impersonate the specified user.

function onlineImpersonate(userSysId) {
  if (!GlideImpersonate().canImpersonate(userSysId)){
    gs.addInfoMessage("No access to impersonate " + userSysId);
  } else {
    GlideImpersonate().impersonate(userSysId);
  }
  return;
}

GlideImpersonate - impersonate(String userSysId)

Sets the user ID for the current administrator to the passed-in user ID, enabling the administrator to act as that user.

When impersonating another user, the administrator has access to exactly what the impersonated user would have access to in the system, including the same menus and modules. Only use this method when testing functionality in an application. Ensure that once you are finished impersonating a user that you call the method again with the administrator sys_Id to stop the impersonation.

表 : 5. Parameters

Name	Type	Description
userSysId	String	Sys_id of the user to impersonate.

表 : 6. Returns

Type	Description
String	Sys_id of the user that was logged in prior to the impersonation request.

The following example shows how to get the current user object.

var user = gs.getUserDisplayName();
gs.print ("The current user display name is: " + user);

var impUser = new GlideImpersonate();
impUser.impersonate("62826bf03710200044e0bfc8bcbe5df1");
var user = gs.getUserDisplayName();
gs.print ("The impersonated user display name is: " + user);

Output:

The current user display name is: System Administrator
The impersonated user display name is: Abel Tuter

GlideImpersonate - isImpersonating()

Determines whether the current user is impersonating another user.

表 : 7. Parameters

Name	Type	Description
None

表 : 8. Returns

Type	Description
Boolean	True: User is currently impersonating another user. False: User is not currently impersonating another user.

function abortOnImpersonate() {
    if (GlideImpersonate().isImpersonating()){
  current.setAbortAction(true);
  gs.addInfoMessage("Transaction canceled due to Impersonation");
    }
    return;
}