Get a user
/rest/ofscCore/v1/users/{login}
Request
-
login(required): string
The unique identifier of the user account in Oracle Field Service.
Response
- application/json
200 Response
object
User
-
avatar:
object Avatar
Title:
Avatar
The profile picture of the user. -
blockedUntilTime:
string
Title:
Blocked Until Time
The time until the account is blocked. -
createdTime:
string
Title:
Created Time
The date and time when the user account is created. -
dateFormat:
string
Title:
Date Format
The date format of the user account. Allowed Values: ["dd/mm/yy", "mm/dd/yy","dd.mm.yy","yyyy/mm/dd"]. -
language(required):
string
Title:
Language
The preferred language of the user. This field accepts the language codes listed on: Supported Language Codes. -
lastLoginTime:
string
Title:
Last Login Time
The date and time when the user logged in to the account. -
lastPasswordChangeTime:
string
Title:
Last Password Change Time
The date and time when the password was changed. -
lastUpdatedTime:
string
Title:
Last Updated Time
The date and time when the user account was updated. This field is not updated if a custom property or the profile picture of the user is changed. This field is only updated when one of the built-in properties is changed. -
login:
string
Title:
Login
The unique identifier of the user account in Oracle Field Service. -
loginAttempts:
integer
Title:
Login Attempts
The number of unsuccessful login attempts. -
longDateFormat:
string
Title:
Long Date Format
The long date format of the user account. -
mainResourceId:
string
Title:
Main Resource ID
The unique identifier of the main resource of the user account. This field is only set for resources that represent field service personnel. It is not set for groups and routing buckets.This field is not returned in the response if empty strings are passed in the request.
-
name(required):
string
Title:
Name
The full name of the user. -
organizationalUnit:
string
Title:
Organizational Unit
The identifier of the organization unit where the user works. The value of this field can be the ID of a resource with the role as 'bucket' or 'organization unit'. -
passwordTemporary:
boolean
Title:
Temporary Password
The temporary password of the user account. If the temporary password is set, then the user is prompted to change password on the next login. -
resources(required):
array Resources
Title:
Resources
Minimum Number of Items:1
Unique Items Required:true
The list of resources assigned to the user account. These resources along with their children are visible to the user. This list does not incIude the resources whose resource ID values are empty. -
selfAssignment:
boolean
Title:
Self Assignment
Indicates whether the users can assign activities to themselves. -
status:
string
Title:
Status
Allowed Values:[ "active", "inactive" ]
The status of the user account. -
timeFormat:
string
Title:
Time Format
The time format of the user account. Allowed Values: [ "12-hour", "24-hour" ]. -
timeZone(required):
string
Title:
Time Zone
The name of the user's time zone.This field accepts both Oracle Field Service time zone names (for example, Eastern) and IANA standard time zone names (for example, America/New_York). It is recommended that IANA names are specified.
For a list of supported time zones, see Supported Time Zones.
-
timeZoneDiff:
integer
Title:
Time Zone Diff
The difference between UTC and the user's local time, displayed in minutes. For example, -180 means that the user's time is 3 hours behind UTC.This is a read-only field.
-
timeZoneIANA:
string
Title:
Time Zone IANA Name
The IANA name of the user's time zone (for example, America/New_York). For the list of IANA time zone names, see IANA Time ZonesThis is a read-only field and is only returned in responses.
-
userType(required):
string
Title:
User Type
The type of the user account. The access controls of the user account are defined based on the user type. -
weekStart:
string
Title:
Week Start
Allowed Values:[ "sunday", "monday", "tuesday", "wednesday", "thursday", "friday", "saturday", "default" ]
The day on which the week starts for the user account.
array
Resources
1
true
Default Response
object
-
detail:
string
The detailed description of this error.
-
status:
string
The HTTP status code of this error.
-
title(required):
string
The brief description of this error.
-
type(required):
string
The URL of the web page containing more details about this error.
Examples
The following example shows how to get a user by submitting a GET request on the REST resource.
Example of Request Header
The following shows an example of the request header.
GET /rest/ofscCore/v1/users/phillip HTTP/1.0 Authorization: Basic c29hcEB5YW1hdG86MQ== Host: devlaptop03 Accept: */*
Example of Response Header
The following shows an example of the response header.
HTTP/1.1 200 OK Server: nginx/1.6.2 Date: Fri, 24 Jul 2015 08:35:48 GMT ContentType: application/json; charset=utf8 Connection: close
Example of Response Body
The following example shows the contents of the response body in JSON format:
{ "name": "phillip", "status": "active", "login": "phillip", "language": "en", "dateFormat": 10, "longDateFormat": 17, "timeFormat": 13, "weekStart": "default", "timeZoneDiff": 120, "timeZone": "Central Europe", "createdTime": "20110202 16:09:30", "lastLoginTime": "20110202 19:33:54", "lastPasswordChangeTime": "20130507 14:56:58", "userType": "Technician", "resources": [ "33011" ], "collaborationGroups": { "links": [ { "rel": "canonical", "href": "https://mysite.example.com/rest/ofscCore/v1/users/phillip/collaborationGroups" } ] }, "links": [ { "rel": "canonical", "href": "https://mysite.example.com/rest/ofscCore/v1/users/phillip" }, { "rel": "describedby", "href": "https://mysite.example.com/rest/ofscCore/v1/metadatacatalog/ } ] }