Create a public skill
post
/hcmRestApi/resources/11.13.18.05/talentPersonProfiles/{talentPersonProfilesUniqID}/child/publicSkills
Request
Path Parameters
-
talentPersonProfilesUniqID(required): string
This is the hash key of the attributes which make up the composite key for the Talent Person Profiles resource and used to uniquely identify an instance of Talent Person Profiles. The client should not generate the hash key value. Instead, the client should query on the Talent Person Profiles collection resource in order to navigate to a specific instance of Talent Person Profiles to get the hash key.
Header Parameters
-
Metadata-Context:
If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
-
REST-Framework-Version:
The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
-
Upsert-Mode:
Contains one of the following values: true or false. If true, the server performs an Upsert operation instead of a Create operation. During an Upsert operation, the server attempts to find an existing resource that matches the payload. If a match is found, the server updates the existing resource instead of creating a new one. If not found or false (default), the server performs a Create operation. Note that the Upsert operation isn't supported for date-effective REST resources.
Supported Media Types
- application/json
Root Schema : schema
Type:
Show Source
object-
Comments: string
(byte)
Title:
CommentsComments of the content item. -
DateAchieved: string
(date)
Title:
Date AchievedDate when skill was achieved. -
Description: string
(byte)
Title:
DescriptionDescription of the skill item. -
endorsements: array
Endorsements
Title:
EndorsementsThe endorsements resource is a child of public skills resource. It provides a list of all endorsements for worker's public skills. This resource is currently under controlled availability. -
Group: string
Title:
Group CodeMaximum Length:30Code that indicates whether the skill is acquired or developing. Values can be ORA_DEVELOPED or ORA_DEVELOPING. Valid values are defined in the commonLookupsLOV. -
ProficiencyLevelCode: string
Title:
Proficiency Level CodeMaximum Length:30Code representing the proficiency level of public skill. -
ProficiencyLevelId: integer
(int64)
Title:
Proficiency Level IDUnique identifier of the proficiency level in the public skill. -
ProfileId(required): integer
(int64)
Surrogate identifier for the person profile.
-
ProjectName: string
Title:
Project Name or ActivitiesMaximum Length:2000Name of the project or activity. -
RelatedItemFlag: boolean
Title:
Related ItemMaximum Length:30Attribute specific to learning outcome. Indicates whether the public skill item doesn't need to be copied to the learner's talent profiles after completion of the course or specialization. Valid values are Y and N. -
SectionId(required): integer
(int64)
Unique identifier of the content section.
-
Skill(required): string
Title:
SkillMaximum Length:240Name of the public skill. -
SkillCurationStatus: string
Title:
Skill Curation StatusMaximum Length:30Code representing the source of skill item. -
SkillCurationType: string
Maximum Length:
30Code representing the source of skill item. -
SkillType: string
Title:
Skill Type CodeMaximum Length:30Type of skill. Valid values defined in commonLookupsLOV. -
SourceType: string
Maximum Length:
30Code representing the source of skill item. -
YearsOfExperience: integer
(int64)
Title:
Years of ExperienceYears of experience with the skill.
Nested Schema : Endorsements
Type:
arrayTitle:
EndorsementsThe endorsements resource is a child of public skills resource. It provides a list of all endorsements for worker's public skills. This resource is currently under controlled availability.
Show Source
Nested Schema : schema
Type:
Show Source
object-
EndorsementId: integer
(int64)
Title:
Endorsement IDUnique identifier for the endorsement. -
EndorserId: integer
(int64)
Title:
Endorser IDUnique identifier of the endorser. -
ProficiencyLevelCode: string
Title:
Proficiency Level CodeMaximum Length:30Code representing the proficiency level of the skill. -
ProficiencyLevelId: integer
(int64)
Title:
Proficiency Level IDUnique identifier of the proficiency level of the skill. -
RequestorPersonId: integer
(int64)
Title:
Requester Person IDUnique identifier of the person who has requested the endorsement. -
Status: string
Title:
Status CodeMaximum Length:30Status of the endorsement. Values can be ORA_COMPLETED or ORA_PENDING or ORA_IGNORE. Valid values are defined in the commonLookupsLOV.
Response
Supported Media Types
- application/json
Default Response
The following table describes the default response for this task.
Headers
-
Metadata-Context:
If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
-
REST-Framework-Version:
The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
Root Schema : talentPersonProfiles-publicSkills-item-response
Type:
Show Source
object-
Comments: string
(byte)
Title:
CommentsComments of the content item. -
ConfirmationFlag: boolean
Title:
Confirmation StatusRead Only:trueMaximum Length:30Indicates whether the proficiency level has been confirmed for the public skill. Valid values are true and false. Default value is false. -
CreatedBy: string
Title:
Created ByRead Only:trueMaximum Length:64User who created the public skill. -
CreationDate: string
(date-time)
Title:
Creation DateRead Only:trueDate and time when the public skill was created. -
DateAchieved: string
(date)
Title:
Date AchievedDate when skill was achieved. -
Description: string
(byte)
Title:
DescriptionDescription of the skill item. -
endorsements: array
Endorsements
Title:
EndorsementsThe endorsements resource is a child of public skills resource. It provides a list of all endorsements for worker's public skills. This resource is currently under controlled availability. -
Group: string
Title:
Group CodeMaximum Length:30Code that indicates whether the skill is acquired or developing. Values can be ORA_DEVELOPED or ORA_DEVELOPING. Valid values are defined in the commonLookupsLOV. -
GroupMeaning: string
Title:
GroupRead Only:trueMaximum Length:80Meaning of the skill group. -
LastUpdateDate: string
(date-time)
Title:
Last Update DateRead Only:trueDate and time when the public skill was last updated. -
LastUpdatedBy: string
Title:
Last Updated ByRead Only:trueMaximum Length:64User who last updated the public section. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
NumericRating: number
Title:
Numeric RatingRead Only:trueNumeric rating of the public skill. -
ProficiencyLevel: string
Title:
Proficiency LevelRead Only:trueMaximum Length:2000Description or name of the proficiency level of the public skill. -
ProficiencyLevelCode: string
Title:
Proficiency Level CodeMaximum Length:30Code representing the proficiency level of public skill. -
ProficiencyLevelId: integer
(int64)
Title:
Proficiency Level IDUnique identifier of the proficiency level in the public skill. -
ProfileId: integer
(int64)
Surrogate identifier for the person profile.
-
ProjectName: string
Title:
Project Name or ActivitiesMaximum Length:2000Name of the project or activity. -
RatingModelId: integer
Title:
Rating Model IdRead Only:trueUnique identifier of the rating model associated with the public skill content section. -
RelatedItemFlag: boolean
Title:
Related ItemMaximum Length:30Attribute specific to learning outcome. Indicates whether the public skill item doesn't need to be copied to the learner's talent profiles after completion of the course or specialization. Valid values are Y and N. -
SectionId: integer
(int64)
Unique identifier of the content section.
-
Skill: string
Title:
SkillMaximum Length:240Name of the public skill. -
SkillCurationStatus: string
Title:
Skill Curation StatusMaximum Length:30Code representing the source of skill item. -
SkillCurationType: string
Maximum Length:
30Code representing the source of skill item. -
SkillId: integer
(int64)
Title:
Skill IDRead Only:trueUnique identifier for the public skill. -
SkillType: string
Title:
Skill Type CodeMaximum Length:30Type of skill. Valid values defined in commonLookupsLOV. -
SourceType: string
Maximum Length:
30Code representing the source of skill item. -
YearsOfExperience: integer
(int64)
Title:
Years of ExperienceYears of experience with the skill.
Nested Schema : Endorsements
Type:
arrayTitle:
EndorsementsThe endorsements resource is a child of public skills resource. It provides a list of all endorsements for worker's public skills. This resource is currently under controlled availability.
Show Source
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : talentPersonProfiles-publicSkills-endorsements-item-response
Type:
Show Source
object-
CreatedBy: string
Title:
Created ByRead Only:trueMaximum Length:64User who created the endorsement. -
CreationDate: string
(date-time)
Title:
Creation DateRead Only:trueDate and time when the endorsement was created. -
EndorsementId: integer
(int64)
Title:
Endorsement IDUnique identifier for the endorsement. -
EndorserId: integer
(int64)
Title:
Endorser IDUnique identifier of the endorser. -
LastUpdateDate: string
(date-time)
Title:
Last Update DateRead Only:trueDate and time when the endorsement was last updated. -
LastUpdatedBy: string
Title:
Last Updated ByRead Only:trueMaximum Length:64User who last updated the endorsement. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
NumericRating: number
Title:
Numeric RatingRead Only:trueNumeric rating of the skill. -
ProficiencyLevelCode: string
Title:
Proficiency Level CodeMaximum Length:30Code representing the proficiency level of the skill. -
ProficiencyLevelId: integer
(int64)
Title:
Proficiency Level IDUnique identifier of the proficiency level of the skill. -
RequestedDate: string
(date-time)
Title:
Requested DateRead Only:trueDate and time when the endorsement was created. -
RequestorPersonId: integer
(int64)
Title:
Requester Person IDUnique identifier of the person who has requested the endorsement. -
Status: string
Title:
Status CodeMaximum Length:30Status of the endorsement. Values can be ORA_COMPLETED or ORA_PENDING or ORA_IGNORE. Valid values are defined in the commonLookupsLOV.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : link
Type:
Show Source
object-
href: string
Title:
hyperlink referenceThe URI to the related resource. -
kind: string
Title:
kindAllowed Values:[ "collection", "item", "describe", "other" ]The kind of the related resource. -
name: string
Title:
nameThe name of the link to the related resource. -
properties: object
properties
-
rel: string
Title:
relationAllowed Values:[ "self", "lov", "parent", "canonical", "child", "enclosure", "action", "custom" ]The name of the relation to the resource instance. Example: self.
Nested Schema : properties
Type:
Show Source
object-
changeIndicator: string
Change indicator or the ETag value of the resource instance.
Links
- ProficiencyLevelLOV
-
The following properties are defined on the LOV link relation:
- Source Attribute: ProficiencyLevelCode; Target Attribute: RatingLevelCode
- Display Attribute: NumericRating
- endorsements
-
Parameters:
- SkillId:
$request.path.SkillId - talentPersonProfilesUniqID:
$request.path.talentPersonProfilesUniqID
The endorsements resource is a child of public skills resource. It provides a list of all endorsements for worker's public skills. This resource is currently under controlled availability. - SkillId:
- groupsLOV
-
Parameters:
- finder:
LookupTypeFinder%3BLookupType%3DORA_HRT_SKILL_GROUP
The following properties are defined on the LOV link relation:- Source Attribute: Group; Target Attribute: LookupCode
- Display Attribute: Meaning
- finder:
- sendEndorsementRequests
-
Parameters:
- SkillId:
$request.path.SkillId - talentPersonProfilesUniqID:
$request.path.talentPersonProfilesUniqID
Allows users to request other workers to endorse a skill the users have. - SkillId: