1. REST API for Oracle Field Service Cloud Service
  2. Tasks
  3. Core
  4. Users

Get a user

get

/rest/ofscCore/v1/users/{login}

This operation retrieves the details of the specified user account.

Request

Path Parameters
Back to Top

Response

Supported Media Types

200 Response

This section describes the 200 status response for this operation.
Body ()
Root Schema : User
Type: object
Title: User
The details of the user account.
Show Source
  • Avatar
    Title: Avatar
    The profile picture of the user.
  • Title: Blocked Until Time
    The time until the account is blocked.
  • Title: Created Time
    The date and time when the user account is created.
  • Title: Date Format
    The date format of the user account. Allowed Values: ["dd/mm/yy", "mm/dd/yy","dd.mm.yy","yyyy/mm/dd"].
  • Title: Language
    The preferred language of the user. This field accepts the language codes listed on: Supported Language Codes.
  • Title: Last Login Time
    The date and time when the user logged in to the account.
  • Title: Last Password Change Time
    The date and time when the password was changed.
  • 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.
  • Title: Login
    The unique identifier of the user account in Oracle Field Service.
  • Title: Login Attempts
    The number of unsuccessful login attempts.
  • Title: Long Date Format
    The long date format of the user account.
  • 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.

  • Title: Name
    The full name of the user.
  • 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'.
  • 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
    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.
  • Title: Self Assignment
    Indicates whether the users can assign activities to themselves.
  • Title: Status
    Allowed Values: [ "active", "inactive" ]
    The status of the user account.
  • Title: Time Format
    The time format of the user account. Allowed Values: [ "12-hour", "24-hour" ].
  • 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.

  • 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.

  • 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 Zones

    This is a read-only field and is only returned in responses.

  • Title: User Type
    The type of the user account. The access controls of the user account are defined based on the user type.
  • Title: Week Start
    Allowed Values: [ "sunday", "monday", "tuesday", "wednesday", "thursday", "friday", "saturday", "default" ]
    The day on which the week starts for the user account.
Nested Schema : Avatar
Type: object
Title: Avatar
The profile picture of the user.
Show Source
Nested Schema : Resources
Type: array
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.
Show Source

Default Response

This section describes the default error response for this operation.
Body ()
Root Schema : Error
Type: object
Show Source
Back to Top

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/
		}
	]
}
Back to Top