JavaScript API Reference

Obtaining Current User Information

View.user

The following examples demonstrate the use of the View.user object to obtain current user information:

var isReservationManager = View.user.isMemberOfGroup('RESERVATION MANAGER');
var userName = View.user.name;
var em_id = View.user.employee.id;
var dvId = View.user.employee.organization.divisionId;

The View.user object contains the following properties:

Property

Description

View.user.name User name
View.user.role User role name
View.user.email User email address
View.user.locale User locale name
View.user.employee.id Employee ID
View.user.employee.number Employee number
View.user.employee.phone Employee phone
View.user.employee.imageFile Employee image file name
View.user.employee.honorific Employee honorific
View.user.employee.space.roomId Employee room ID
View.user.employee.space.floorId Employee floor ID
View.user.employee.space.buildingId Employee building ID
View.user.employee.space.siteId Employee site ID
View.user.employee.space.countryId Employee country ID
View.user.employee.organization.divisionId Employee division ID
View.user.employee.organization.departmentId Employee department ID
View.user.isMemberOfGroup('FIM') Returns true if the user belongs to specified group or to the '%' group
View.user.groups Array of group names this user belongs to
View.user.isGuest Returns true is the user is a guest user

AbCommonResources-getUser()

The information associated with the current logged-in user is available by calling an AbCommonResources-getUser workflow rule. The workflow rule returns a User JS object that contains all data fields for the current user. The object should be considered read-only and cannot be used to change the user information.

The User object contains the following properties:

Property name

Property type

Property description

Example

User_name

string

User name

AFM

role_name

string

Name of the role this user belongs to

FIM

Email

string

User email address

afm@afm.com

Locale

string

User locale string

en_US

Groups

Array<string>

Array of group names this user belongs to

["Administrator", "Host"]

The f ollowing properties are null if the user email does not match any record in the em table

Employee.em_id

string

Employee name

Employee.em_number

string

Employee number

Employee.phone

string

Employee phone number

Employee.bl_id

string

Building ID

Employee.fl_id

string

Floor ID

Employee.rm_id

string

Room ID

Employee.Building.site_id

string

Site ID

Employee.Building.country_id

string

Country ID

Employee.dv_id

string

Division ID

Employee.dp_id

string

Department ID

The example below shows how to obtain the current user information:

function getUserInfo() {
var result = Workflow.call('AbCommonResources-getUser', {});
if (result.code == 'executed') {
var user = result.data;

alert('User ' + user.name + ' belongs to groups ' + user.groups;
} else {
handleError('Could not obtain UserInfo', result);
}
}