Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space MOBUD and version 3

The User object contains properties related to a user. Users include mobile workers or technicians, planners, managers and administrators. 

Panel
borderColorgrey
bgColorwhitesmoke

On this page:

Table of Contents
maxLevel2

Related pages:

User Object Formats

Include Page
_User Object Formats
_User Object Formats

User Object Properties

(info) Required properties are in bold.

Property

Type

Description

Activated

boolean

Identifies is the user record is activated. If not activated the user will be unable to logon to the system.

Valid values are:

  • true - User is active and can use the system.
  • false - User is not active and can not logon to the system.
AuthenticationIDstring

When ServicePower enables the entity to run within a unique domain for SSO purposes, the system will utilize this field for authentication purposes.

User API will replicate value of the required UserID field into the AuthenticationID field, in the case that an AuthenticationID value hasn't been provided. It is highly recommended that an AuthenticationID value be provided when the customer is using either 3rd party authentication or a custom domain.

Status
title3.32.0

Deleted

boolean

Identifies if the user record is to be deleted.

Notes:


Valid values are:

  • true - The user object should be deleted
  • false - The user object should not be deleted. This is the default value if this property is not specified.

 

DGroupIDstringSpecifies the Deployment Group the user is assigned to.

Email

 

Specifies the email address of the user.

EntityEmployeeNumber

string

Warning

This property is deprecated. Please use the Extensions property instead.

Extensions

collection

Include Page
_def_Extensions
_def_Extensions

FaceTime

string

Identifies the Apple FaceTime ID associated with the user.

FirstName

string

Identifies the first name of the user.

Lockedbool

Identifies is the user account is locked. If true, then this user will not be able to access the Nexus management console or the ServiceMobility mobile application.

An administrator has the ability to lock any user (except their own).

Valid values are:

  • true - The user is locked out of the system
  • false (default) - The user is not locked out of the system

3.13

IsMobileWorkerbool

Identifies if the user is a mobile worker. If true, then this user has access to the ServiceMobility mobile application.

Valid values are:

  • true - The user is a mobile worker
  • false (default) - This user is not a mobile worker

v.3.13

LanguageCode

string

Identifies the language in which the mobile application will be run for the user. If the mobile application does not have the selected language translations deployed it will default to English.

LastName

string

Identifies the last name of the user.

Phones

collection

A collection of phone numbers associated with the contact.

Phone Properties

PropertyTypeDescription
PhoneNumstringThe phone number.
PhoneTypestring

Identifies the type of phone number.

See: REST System Categories Phone Types

Password

string

Identifies the password for the user.

Passwords are always stored encrypted with a unique user cryptography salt value.

ResetPassword

boolean

Identifies if the password should be reset to the value specified by the Password property.

Valid values are:

  •  true = The password will be reset to the value identifies by the Password property
  •  false = The password will not be reset. This is the default value if this property is not provided.
ServiceTeamIDstring

Identifies the service team the user is associated with. This field should be populate for any user that is a field technician / worker. If the user is a manager or planner then this field can be left empty.

Status
title3.20.0

SMS

string

This field contains the number used to send SMS to the user. Typically this is a user's mobile phone number.

Status

string

Future. This field is currently not used.

StorageLocationID

string

Identifies the storage location assigned to the user. When the user is using the mobile application this is the inventory location where parts will be consumed from. If you are not using / tracking inventory then this field can be left blank.

UserID

string

This field represents the user's logon to the system. This includes both the portal and mobile application. Note, based on the user's roles access either the portal or mobile application may be restricted.