Jump to

• Request
• Response

Update a public skill

patch

/hcmRestApi/resources/11.13.18.05/talentPersonProfiles/{talentPersonProfilesUniqID}/child/publicSkills/{SkillId}

Request

Path Parameters

• SkillId(required): integer(int64)
  The value of this parameter could be a hash of the key that is used to uniquely identify the resource item. The client should not generate the hash key value. Instead, the client should query on the collection resource with a filter to navigate to a specific resource item. For example: products?q=InventoryItemId=
• 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.

Supported Media Types

• application/json

Request Body - application/json ()

The following table describes the body parameters in the request for this task.

Root Schema : schema

Type: object

Show Source

• ConfirmationFlag: boolean
  Title: Confirmation Status

  Maximum Length: 30

  Indicates whether the proficiency level has been confirmed for the public skill. Valid values are true and false. Default value is false.
• endorsements: array Endorsements
  Title: Endorsements

  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.
• Group: string
  Title: Group Code

  Maximum Length: 30

  Code 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 Code

  Maximum Length: 30

  Code representing the proficiency level of public skill.
• ProficiencyLevelId: integer (int64)
  Title: Proficiency Level ID

  Unique identifier of the proficiency level in the public skill.
• ProfileId: integer (int64)
  Surrogate identifier for the person profile.
• SectionId: integer (int64)
  Unique identifier of the content section.

{
    "type":"object",
    "properties":{
        "ProfileId":{
            "type":"integer",
            "description":"Surrogate identifier for the person profile.",
            "format":"int64",
            "nullable":false,
            "x-hints":{
                "precision":18
            }
        },
        "Group":{
            "title":"Group Code",
            "maxLength":30,
            "type":"string",
            "description":"Code that indicates whether the skill is acquired or developing. Values can be ORA_DEVELOPED or ORA_DEVELOPING. Valid values are defined in the commonLookupsLOV.",
            "nullable":true,
            "x-hints":{
                "controlType":"choice"
            }
        },
        "ProficiencyLevelCode":{
            "title":"Proficiency Level Code",
            "maxLength":30,
            "type":"string",
            "description":"Code representing the proficiency level of public skill.",
            "nullable":true,
            "x-hints":{
                "controlType":"choice"
            }
        },
        "endorsements":{
            "title":"Endorsements",
            "type":"array",
            "description":"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.",
            "items":{
                "$ref":"#/components/schemas/talentPersonProfiles-publicSkills-endorsements-item-patch-request"
            }
        },
        "ConfirmationFlag":{
            "title":"Confirmation Status",
            "maxLength":30,
            "type":"boolean",
            "description":"Indicates whether the proficiency level has been confirmed for the public skill. Valid values are true and false. Default value is false.",
            "nullable":true
        },
        "ProficiencyLevelId":{
            "title":"Proficiency Level ID",
            "type":"integer",
            "description":"Unique identifier of the proficiency level in the public skill.",
            "format":"int64",
            "nullable":true,
            "x-hints":{
                "precision":18
            }
        },
        "SectionId":{
            "type":"integer",
            "description":"Unique identifier of the content section.",
            "format":"int64",
            "nullable":false,
            "x-hints":{
                "precision":18
            }
        }
    }
}

Nested Schema : Endorsements

Type: array

Title: Endorsements

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.

Show Source

• Array of: object talentPersonProfiles-publicSkills-endorsements-item-patch-request

{
    "title":"Endorsements",
    "type":"array",
    "description":"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.",
    "items":{
        "$ref":"#/components/schemas/talentPersonProfiles-publicSkills-endorsements-item-patch-request"
    }
}

Nested Schema : talentPersonProfiles-publicSkills-endorsements-item-patch-request

Type: object

Show Source

• ProficiencyLevelCode: string
  Title: Proficiency Level Code

  Maximum Length: 30

  Code representing the proficiency level of the skill.
• ProficiencyLevelId: integer (int64)
  Title: Proficiency Level ID

  Unique identifier of the proficiency level of the skill.
• Status: string
  Title: Status Code

  Maximum Length: 30

  Status of the endorsement. Values can be ORA_COMPLETED or ORA_PENDING or ORA_IGNORE. Valid values are defined in the commonLookupsLOV.

{
    "type":"object",
    "properties":{
        "Status":{
            "title":"Status Code",
            "maxLength":30,
            "type":"string",
            "description":"Status of the endorsement. Values can be ORA_COMPLETED or ORA_PENDING or ORA_IGNORE. Valid values are defined in the commonLookupsLOV.",
            "nullable":false,
            "x-hints":{
                "controlType":"choice",
                "includeInCompactView":true
            }
        },
        "ProficiencyLevelCode":{
            "title":"Proficiency Level Code",
            "maxLength":30,
            "type":"string",
            "description":"Code representing the proficiency level of the skill.",
            "nullable":true,
            "x-hints":{
                "controlType":"choice"
            }
        },
        "ProficiencyLevelId":{
            "title":"Proficiency Level ID",
            "type":"integer",
            "description":"Unique identifier of the proficiency level of the skill.",
            "format":"int64",
            "nullable":true,
            "x-hints":{
                "includeInCompactView":true,
                "precision":18
            }
        }
    }
}

Back to Top

Response

Supported Media Types

• application/json

Default Response

The following table describes the default response for this task.

Headers

• Metadata-Context(required):
  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(required):
  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.

Body ()

Root Schema : talentPersonProfiles-publicSkills-item-response

Type: object

Show Source

• ConfirmationFlag: boolean
  Title: Confirmation Status

  Maximum Length: 30

  Indicates 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 By

  Read Only: true

  Maximum Length: 64

  User who created the public skill.
• CreationDate: string (date-time)
  Title: Creation Date

  Read Only: true

  Date and time when the public skill was created.
• endorsements: array Endorsements
  Title: Endorsements

  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.
• Group: string
  Title: Group Code

  Maximum Length: 30

  Code 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: Group

  Read Only: true

  Maximum Length: 80

  Meaning of the skill group.
• LastUpdateDate: string (date-time)
  Title: Last Update Date

  Read Only: true

  Date and time when the public skill was last updated.
• LastUpdatedBy: string
  Title: Last Updated By

  Read Only: true

  Maximum Length: 64

  User who last updated the public section.
• links: array Links
  Title: Links

  The link relations associated with the resource instance.
• NumericRating: number
  Title: Numeric Rating

  Read Only: true

  Numeric rating of the public skill.
• ProficiencyLevelCode: string
  Title: Proficiency Level Code

  Maximum Length: 30

  Code representing the proficiency level of public skill.
• ProficiencyLevelId: integer (int64)
  Title: Proficiency Level ID

  Unique identifier of the proficiency level in the public skill.
• ProfileId: integer (int64)
  Surrogate identifier for the person profile.
• RatingModelId: string
  Title: Rating Model Id

  Read Only: true

  Unique identifier of the rating model associated with the public skill content section.
• SectionId: integer (int64)
  Unique identifier of the content section.
• Skill: string
  Title: Skill

  Maximum Length: 240

  Name of the public skill.
• SkillId: integer (int64)
  Title: Skill ID

  Read Only: true

  Unique identifier for the public skill.

{
    "type":"object",
    "properties":{
        "LastUpdatedBy":{
            "title":"Last Updated By",
            "maxLength":64,
            "type":"string",
            "description":"User who last updated the public section.",
            "nullable":false,
            "readOnly":true,
            "x-queryable":false
        },
        "ProfileId":{
            "type":"integer",
            "description":"Surrogate identifier for the person profile.",
            "format":"int64",
            "nullable":false,
            "x-hints":{
                "precision":18
            },
            "x-queryable":true
        },
        "CreationDate":{
            "title":"Creation Date",
            "type":"string",
            "description":"Date and time when the public skill was created.",
            "format":"date-time",
            "nullable":false,
            "readOnly":true,
            "x-queryable":false
        },
        "Group":{
            "title":"Group Code",
            "maxLength":30,
            "type":"string",
            "description":"Code that indicates whether the skill is acquired or developing. Values can be ORA_DEVELOPED or ORA_DEVELOPING. Valid values are defined in the commonLookupsLOV.",
            "nullable":true,
            "x-hints":{
                "controlType":"choice"
            },
            "x-queryable":true
        },
        "CreatedBy":{
            "title":"Created By",
            "maxLength":64,
            "type":"string",
            "description":"User who created the public skill.",
            "nullable":false,
            "readOnly":true,
            "x-queryable":false
        },
        "NumericRating":{
            "title":"Numeric Rating",
            "type":"number",
            "description":"Numeric rating of the public skill.",
            "nullable":true,
            "readOnly":true,
            "x-hints":{
                "precision":5,
                "scale":2
            },
            "x-queryable":true
        },
        "RatingModelId":{
            "title":"Rating Model Id",
            "type":"string",
            "description":"Unique identifier of the rating model associated with the public skill content section.",
            "nullable":true,
            "readOnly":true,
            "x-hints":{
                "dependencies":[
                    "SkillRatingModelId",
                    "TRatingModelId"
                ]
            },
            "x-queryable":true
        },
        "ConfirmationFlag":{
            "title":"Confirmation Status",
            "maxLength":30,
            "type":"boolean",
            "description":"Indicates whether the proficiency level has been confirmed for the public skill. Valid values are true and false. Default value is false.",
            "nullable":true,
            "x-queryable":true
        },
        "Skill":{
            "title":"Skill",
            "maxLength":240,
            "type":"string",
            "description":"Name of the public skill.",
            "nullable":false,
            "x-queryable":true
        },
        "ProficiencyLevelCode":{
            "title":"Proficiency Level Code",
            "maxLength":30,
            "type":"string",
            "description":"Code representing the proficiency level of public skill.",
            "nullable":true,
            "x-hints":{
                "controlType":"choice"
            },
            "x-queryable":true
        },
        "endorsements":{
            "title":"Endorsements",
            "type":"array",
            "description":"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.",
            "items":{
                "$ref":"#/components/schemas/talentPersonProfiles-publicSkills-endorsements-item-response"
            }
        },
        "links":{
            "title":"Links",
            "type":"array",
            "description":"The link relations associated with the resource instance.",
            "items":{
                "$ref":"#/components/schemas/link"
            }
        },
        "SkillId":{
            "title":"Skill ID",
            "type":"integer",
            "description":"Unique identifier for the public skill.",
            "format":"int64",
            "nullable":false,
            "readOnly":true,
            "x-hints":{
                "precision":18
            },
            "x-queryable":true
        },
        "GroupMeaning":{
            "title":"Group",
            "maxLength":80,
            "type":"string",
            "description":"Meaning of the skill group.",
            "nullable":false,
            "readOnly":true,
            "x-queryable":true
        },
        "ProficiencyLevelId":{
            "title":"Proficiency Level ID",
            "type":"integer",
            "description":"Unique identifier of the proficiency level in the public skill.",
            "format":"int64",
            "nullable":true,
            "x-hints":{
                "precision":18
            },
            "x-queryable":true
        },
        "SectionId":{
            "type":"integer",
            "description":"Unique identifier of the content section.",
            "format":"int64",
            "nullable":false,
            "x-hints":{
                "precision":18
            },
            "x-queryable":true
        },
        "LastUpdateDate":{
            "title":"Last Update Date",
            "type":"string",
            "description":"Date and time when the public skill was last updated.",
            "format":"date-time",
            "nullable":false,
            "readOnly":true,
            "x-queryable":false
        }
    }
}

Nested Schema : Endorsements

Type: array

Title: Endorsements

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.

Show Source

• Array of: object talentPersonProfiles-publicSkills-endorsements-item-response

{
    "title":"Endorsements",
    "type":"array",
    "description":"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.",
    "items":{
        "$ref":"#/components/schemas/talentPersonProfiles-publicSkills-endorsements-item-response"
    }
}

Nested Schema : Links

Type: array

Title: Links

The link relations associated with the resource instance.

Show Source

• Array of: object link

{
    "title":"Links",
    "type":"array",
    "description":"The link relations associated with the resource instance.",
    "items":{
        "$ref":"#/components/schemas/link"
    }
}

Nested Schema : talentPersonProfiles-publicSkills-endorsements-item-response

Type: object

Show Source

• CreatedBy: string
  Title: Created By

  Read Only: true

  Maximum Length: 64

  User who created the endorsement.
• CreationDate: string (date-time)
  Title: Creation Date

  Read Only: true

  Date and time when the endorsement was created.
• EndorsementId: integer (int64)
  Title: Endorsement ID

  Unique identifier for the endorsement.
• EndorserId: integer (int64)
  Title: Endorser ID

  Unique identifier of the endorser.
• LastUpdateDate: string (date-time)
  Title: Last Update Date

  Read Only: true

  Date and time when the endorsement was last updated.
• LastUpdatedBy: string
  Title: Last Updated By

  Read Only: true

  Maximum Length: 64

  User who last updated the endorsement.
• links: array Links
  Title: Links

  The link relations associated with the resource instance.
• NumericRating: number
  Title: Numeric Rating

  Read Only: true

  Numeric rating of the skill.
• ProficiencyLevelCode: string
  Title: Proficiency Level Code

  Maximum Length: 30

  Code representing the proficiency level of the skill.
• ProficiencyLevelId: integer (int64)
  Title: Proficiency Level ID

  Unique identifier of the proficiency level of the skill.
• RequestedDate: string (date-time)
  Title: Requested Date

  Read Only: true

  Date and time when the endorsement was created.
• RequestorPersonId: integer (int64)
  Title: Requester Person ID

  Unique identifier of the person who has requested the endorsement.
• Status: string
  Title: Status Code

  Maximum Length: 30

  Status of the endorsement. Values can be ORA_COMPLETED or ORA_PENDING or ORA_IGNORE. Valid values are defined in the commonLookupsLOV.

{
    "type":"object",
    "properties":{
        "LastUpdatedBy":{
            "title":"Last Updated By",
            "maxLength":64,
            "type":"string",
            "description":"User who last updated the endorsement.",
            "nullable":false,
            "readOnly":true,
            "x-queryable":false
        },
        "RequestorPersonId":{
            "title":"Requester Person ID",
            "type":"integer",
            "description":"Unique identifier of the person who has requested the endorsement.",
            "format":"int64",
            "nullable":false,
            "x-hints":{
                "includeInCompactView":true,
                "precision":18
            },
            "x-queryable":true
        },
        "Status":{
            "title":"Status Code",
            "maxLength":30,
            "type":"string",
            "description":"Status of the endorsement. Values can be ORA_COMPLETED or ORA_PENDING or ORA_IGNORE. Valid values are defined in the commonLookupsLOV.",
            "nullable":false,
            "x-hints":{
                "controlType":"choice",
                "includeInCompactView":true
            },
            "x-queryable":true
        },
        "CreationDate":{
            "title":"Creation Date",
            "type":"string",
            "description":"Date and time when the endorsement was created.",
            "format":"date-time",
            "nullable":false,
            "readOnly":true,
            "x-queryable":false
        },
        "CreatedBy":{
            "title":"Created By",
            "maxLength":64,
            "type":"string",
            "description":"User who created the endorsement.",
            "nullable":false,
            "readOnly":true,
            "x-queryable":false
        },
        "NumericRating":{
            "title":"Numeric Rating",
            "type":"number",
            "description":"Numeric rating of the skill.",
            "nullable":true,
            "readOnly":true,
            "x-hints":{
                "precision":5,
                "scale":2
            },
            "x-queryable":true
        },
        "EndorsementId":{
            "title":"Endorsement ID",
            "type":"integer",
            "description":"Unique identifier for the endorsement.",
            "format":"int64",
            "nullable":false,
            "x-hints":{
                "includeInCompactView":true,
                "precision":18
            },
            "x-queryable":true
        },
        "EndorserId":{
            "title":"Endorser ID",
            "type":"integer",
            "description":"Unique identifier of the endorser.",
            "format":"int64",
            "nullable":false,
            "x-hints":{
                "controlType":"choice",
                "includeInCompactView":true,
                "precision":18
            },
            "x-queryable":true
        },
        "ProficiencyLevelCode":{
            "title":"Proficiency Level Code",
            "maxLength":30,
            "type":"string",
            "description":"Code representing the proficiency level of the skill.",
            "nullable":true,
            "x-hints":{
                "controlType":"choice"
            },
            "x-queryable":true
        },
        "links":{
            "title":"Links",
            "type":"array",
            "description":"The link relations associated with the resource instance.",
            "items":{
                "$ref":"#/components/schemas/link"
            }
        },
        "RequestedDate":{
            "title":"Requested Date",
            "type":"string",
            "description":"Date and time when the endorsement was created.",
            "format":"date-time",
            "nullable":false,
            "readOnly":true,
            "x-hints":{
                "includeInCompactView":true
            },
            "x-queryable":true
        },
        "ProficiencyLevelId":{
            "title":"Proficiency Level ID",
            "type":"integer",
            "description":"Unique identifier of the proficiency level of the skill.",
            "format":"int64",
            "nullable":true,
            "x-hints":{
                "includeInCompactView":true,
                "precision":18
            },
            "x-queryable":true
        },
        "LastUpdateDate":{
            "title":"Last Update Date",
            "type":"string",
            "description":"Date and time when the endorsement was last updated.",
            "format":"date-time",
            "nullable":false,
            "readOnly":true,
            "x-queryable":false
        }
    }
}

Nested Schema : Links

Type: array

Title: Links

The link relations associated with the resource instance.

Show Source

• Array of: object link

{
    "title":"Links",
    "type":"array",
    "description":"The link relations associated with the resource instance.",
    "items":{
        "$ref":"#/components/schemas/link"
    }
}

Nested Schema : link

Type: object

Show Source

• href: string
  Title: hyperlink reference

  The URI to the related resource.
• kind: string
  Title: kind

  Allowed Values: [ "collection", "item", "describe", "other" ]

  The kind of the related resource.
• name: string
  Title: name

  The name of the link to the related resource.
• properties: object properties
• rel: string
  Title: relation

  Allowed Values: [ "self", "lov", "parent", "canonical", "child", "enclosure", "action", "custom" ]

  The name of the relation to the resource instance. Example: self.

{
    "type":"object",
    "properties":{
        "kind":{
            "title":"kind",
            "type":"string",
            "description":"The kind of the related resource.",
            "enum":[
                "collection",
                "item",
                "describe",
                "other"
            ]
        },
        "rel":{
            "title":"relation",
            "type":"string",
            "description":"The name of the relation to the resource instance.  Example: self.",
            "enum":[
                "self",
                "lov",
                "parent",
                "canonical",
                "child",
                "enclosure",
                "action",
                "custom"
            ]
        },
        "name":{
            "title":"name",
            "type":"string",
            "description":"The name of the link to the related resource."
        },
        "href":{
            "title":"hyperlink reference",
            "type":"string",
            "description":"The URI to the related resource."
        },
        "properties":{
            "type":"object",
            "properties":{
                "changeIndicator":{
                    "type":"string",
                    "description":"Change indicator or the ETag value of the resource instance."
                }
            }
        }
    }
}

Nested Schema : properties

Type: object

Show Source

• changeIndicator: string
  Change indicator or the ETag value of the resource instance.

{
    "type":"object",
    "properties":{
        "changeIndicator":{
            "type":"string",
            "description":"Change indicator or the ETag value of the resource instance."
        }
    }
}

Links

ProficiencyLevelLOV

Operation: /hcmRestApi/resources/11.13.18.05/ratingLevelsLOV

The following properties are defined on the LOV link relation:

• Source Attribute: ProficiencyLevelCode; Target Attribute: RatingLevelCode
• Display Attribute: NumericRating

endorsements

Operation: /hcmRestApi/resources/11.13.18.05/talentPersonProfiles/{talentPersonProfilesUniqID}/child/publicSkills/{SkillId}/child/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.

groupsLOV

Operation: /fscmRestApi/resources/11.13.18.05/commonLookupsLOV

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

sendEndorsementRequests

Operation: /hcmRestApi/resources/11.13.18.05/talentPersonProfiles/{talentPersonProfilesUniqID}/child/publicSkills/{SkillId}/action/sendEndorsementRequests

Parameters:

• SkillId: $request.path.SkillId
• talentPersonProfilesUniqID: $request.path.talentPersonProfilesUniqID

Allows users to request other workers to endorse a skill the users have.

Back to Top