Get a work skill group
/rest/ofscMetadata/v1/workSkillGroups/{label}
This operation retrieves the specified work skill group.
The response contains the translations of the work skill group name in the user's language in the translation structure and in the entity fields.
Request
-
label(required): string
Minimum Length:
1
Maximum Length:40
The label of the work skill group.
Response
- application/json
- application/schema+json
200 Response
object
Work Skill Group
-
active(required):
boolean
Title:
Active
Contains one of the following values: true or false.
If true, then the work skill group is active. If false, then the work skill group is inactive. By default, it is true.
Note: It is present for all work skill groups.
-
addToCapacityCategory(required):
boolean
Title:
Add to Capacity Category
Contains one of the following values: true or false.
If true, then the work skill group is added to the capacity category. By default, it is true.
Note: This field is present for all work skill groups.
-
assignToResource(required):
boolean
Title:
Assign to Resource
Contains one of the following values: true or false.
If true, then the work skill group is assigned to the resource. By default, it is true.
Note: This field is present for all work skill groups.
-
label:
string
Title:
Label
Minimum Length:1
Maximum Length:40
The label of the work skill group. -
name:
string
Title:
Name
Minimum Length:1
Maximum Length:5000
The name of the work skill group in the user's language. -
translations(required):
array Translations
Title:
Translations
The array of translation objects associated with the work skill group. -
workSkills:
array Work Skills
Title:
Work Skills
The array of work skill objects associated with the work skill group.
array
Translations
array
Work Skills
object
-
language(required):
string
This field contains language code of a text translation, it conatains two characters length code in responses (e.g. 'en', 'es') but can be used in requests as extended ISO code (e.g. 'en-US') as well as old two character format.
-
languageISO:
string
This field is used only in responses and returns ISO language code (e.g. 'en-US'). This field is ignored in the requests (use 'language' instead)
-
name(required):
string
object
-
label(required):
string
The label of the work skill object.
-
ratio(required):
integer
Minimum Value:
1
Maximum Value:100
The ratio used to assign the work skill group to a resource.
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 specific work skill group by submitting a GET request on the REST resource.
Example of Request Header
The following shows an example of the request header.
GET /rest/ofscMetadata/v1/workSkillGroups/ws_group_1 HTTP/1.0 Host: <instance_name>.fs.ocs.oraclecloud.com Authorization: Basic c29hcEBwZXRyb2xpYXNoZXZ5Y2gucmVzdDox 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:54:08 GMT Content-Type: application/json; charset=utf-8 Transfer-Encoding: chunked Connection: keep-alive
Example of Response Body
The following example shows the contents of the response body in JSON format.
{ "label":"ws_group_1", "name":"Work skill group 1", "active":true, "assignToResource":true, "addToCapacityCategory":true, "translations":[ { "language":"en", "name":"Work skill group 1" }, "language":"es", "name":"Work skill group 1" } }, "workSkills":[ { "label":"NP", "ratio":10 }, { "label":"UP", "ratio":100 } ], "links":[ { "rel":"canonical", "href":"https://<instance_name>.fs.ocs.oraclecloud.com/rest/ofscMetadata/v1/workSkillGroups/ws_group_1" }, { "rel":"describedby", "href":"https://<instance_name>.fs.ocs.oraclecloud.com/rest/ofscMetadata/v1/metadata-catalog/workSkillGroups" } ] }