CurrentUserService Class

Uses:
Extends: Ember.Service
Module: Services
Defined In: addon\services\current-user.js:11

This service handles various functionality that deals with logged in user management. This is one of the most used services in Ember FW GC, and once injected has various properties and methods which can be called upon it which are invaluable to various aspects of the department.

Note: This is different from the user model in that this deals with the currently logged in user, rather than an array of user models from Group Control. Because this is a service and not a user model, it should not be used as such. For example, a property expecting a user model, should not be set in the following way:

this.set('user', this.get('currentUser'));

But rather using the id to find the actual user model from a user array:

this.set('user', this.get('users').findBy('id', this.get('currentUser.userId')));

That being said the CurrentUser service is indispensable to a proper integration of Group Control with the apps. For a list of all available properties and methods, see below.

Show:
changeDepartment
(
  • newDept
)
Promise public

Defined in addon\services\current-user.js:171

Changes the department the user is currently viewing the department as.

Parameters:

  • newDept String

    new department to view

Returns:

Promise:

Promise that resolves when the request has been made successfully

changePassword
(
  • needSecure
)
private

Defined in addon\services\current-user.js:244

Shortcut to trigger the change-password trigger

Parameters:

  • needSecure Boolean

    Whether or the user needs to change this password for security reasons.

check () Promise public

Defined in addon\services\current-user.js:191

Checks if the user is still logged in.

Returns:

Promise:

Promise that resolves with the current user's status

checkDepartment
(
  • department
)
Boolean public

Defined in addon\services\current-user.js:158

Checks if the user is currently viewing the application as a particular department

Parameters:

  • department String

    department to check

Returns:

Boolean:

whether or not the current department matches the provided one

reload () Promise public

Defined in addon\services\current-user.js:214

Reloads the user's roles

Returns:

Promise:

Promise that resolves when the request has completed.

apps

Array public

Defined in addon\services\current-user.js:50

Array of apps the user has access to

currentDept

String public

Defined in addon\services\current-user.js:95

Current department the user is viewing the application as

departments

Array public

Defined in addon\services\current-user.js:77

Array of departments the user has access to for the current app

email

String public

Defined in addon\services\current-user.js:131

Email of the user

hasRoles

Boolean public

Defined in addon\services\current-user.js:68

If true, the user has roles in this app

hasRoles

Boolean public

Defined in addon\services\current-user.js:86

If true, the user has at least one department

nameFirst

String public

Defined in addon\services\current-user.js:104

First name of the user

nameFull

String public

Defined in addon\services\current-user.js:143

Full name of the user, using the user's first, last, and preferred name (if available)

nameLast

String public

Defined in addon\services\current-user.js:113

Last name of the user

namePref

String public

Defined in addon\services\current-user.js:122

Preferred first name (nickname) of the user

roles

Array public

Defined in addon\services\current-user.js:59

Array of roles the user has for the current app and department

userId

String public

Defined in addon\services\current-user.js:41

Username of the logged in user.