Update an assignment
patch
/hcmRestApi/resources/11.13.18.05/emps/{empsUniqID}/child/assignments/{assignmentsUniqID}
Request
Path Parameters
-
assignmentsUniqID(required): string
This is the hash key of the attributes which make up the composite key for the (assignments) resource and used to uniquely identify an instance of (assignments). The client should not generate the hash key value. Instead, the client should query on the (assignments) collection resource in order to navigate to a specific instance of (assignments) to get the hash key.
-
empsUniqID(required): string
This is the hash key of the attributes which make up the composite key for the (emps) resource and used to uniquely identify an instance of (emps). The client should not generate the hash key value. Instead, the client should query on the (emps) collection resource in order to navigate to a specific instance of (emps) to get the hash key.
Header Parameters
-
Effective-Of:
This header accepts a string value. The string is a semi-colon separated list of
= . It is used to perform effective date range operations. The accepted parameters are RangeMode, RangeSpan, RangeStartDate, RangeEndDate, RangeStartSequence and RangeEndSequence. The parameter values are always strings. The possible values for RangeMode are SET_LOGICAL_START, SET_LOGICAL_END, END_DATE, SET_EFFECTIVE_START, SET_EFFECTIVE_END, REPLACE_CORRECTION, REPLACE_UPDATE, RECONCILE_CORRECTION, CORRECTION, RECONCILE_UPDATE, UPDATE, ZAP and DELETE_CHANGES. The possible values for RangeSpan are PHYSICAL_ROW_END_DATE and LOGICAL_ROW_END_DATE. The values for RangeStartDate and RangeEndDate have to be a string representation of a date in yyyy-MM-dd format. The value for RangeStartSequence and RangeEndSequence must be strings such that when parsed they yield positive integers. -
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
Root Schema : schema
Type:
Show Source
object-
ActionCode: string
Title:
Action CodeMaximum Length:30Action performed on a particular record, such as Hire, Add Pending Worker, Manager Change, and so on. Valid values are defined in the list ActionCodeLOV. -
ActionReasonCode: string
Title:
Reason CodeMaximum Length:30User-defined code for the action reason. Specifies the reason for the action performed on the record. Valid values are defined in the list ActionReasonCodeLOV. -
AssignmentCategory: string
Title:
Assignment CategoryMaximum Length:30User-defined category such as Full-Time Permanent or Part-Time Permanent. Valid values are defined in the list AssignmentCategoryLOV. -
assignmentDFF: array
assignmentDFF
-
assignmentExtraInformation: array
assignmentExtraInformation
-
AssignmentName: string
Title:
Assignment NameMaximum Length:80Name of the assignment. -
AssignmentNumber: string
Title:
Assignment NumberMaximum Length:30Unique identifier for the assignment or terms. Valid for workers and nonworkers. -
AssignmentProjectedEndDate: string
(date)
Title:
Projected End DateDate on which the assignment is expected to end. -
AssignmentStatus: string
Title:
Assignment StatusMaximum Length:30HR status of the assignment, such as Active or Inactive. Valid values are defined in the list AssignmentStatusLOV. -
AssignmentStatusTypeId: integer
(int64)
Title:
Assignment Status Type IDUnique identifier for the user-defined assignment status. Valid values are defined in the list AssignmentStatusTypeIdLOV. -
BusinessUnitId: integer
(int64)
Title:
Business Unit IDUnique identifier for the business unit. Valid values are defined in the list BusinessUnitIdLOV. -
DefaultExpenseAccount: string
Default expense account represented as a concatenated value of all the related segments.
-
DepartmentId: integer
(int64)
Title:
Organization IDUnique identifier for the department. Valid values are defined in the list DepartmentIdLOV. -
EffectiveEndDate: string
(date)
Title:
Effective End DateDate at the end of the period within which the employee assignment is effective. -
EffectiveStartDate: string
(date)
Title:
Effective Start DateDate at the beginning of the period within which the employee assignment is effective. -
empreps: array
Employee Representatives
Title:
Employee RepresentativesThe empreps resource is a child of the assignments resource. It includes all employee representatives as of the specified date. By default, the current date is retained.
This resource is currently under controlled availability. -
EndTime: string
Title:
End TimeMaximum Length:5Work day normal end time. -
Frequency: string
Title:
FrequencyMaximum Length:30Frequency of normal working hours such as week, month, year. Valid values are defined in the list FrequencyLOV. -
FullPartTime: string
Title:
Full Time or Part TimeMaximum Length:30Indicates whether the position the employee is hired for is full-time or part-time. Valid values are defined in the list FullPartTimeLOV. -
GradeId: integer
(int64)
Title:
Grade IDUnique identifier for the grade. Valid values are defined in the list GradeIdLOV. -
GradeLadderId: integer
(int64)
Title:
Grade Ladder IDUnique identifier for the grade ladder. -
JobId: integer
(int64)
Title:
Job IDUnique identifier for the job. Valid values are defined in the list JobIdLOV. -
LegalEntityId: integer
(int64)
Title:
Legal Entity IDUnique identifier for the legal entity. -
LocationId: integer
(int64)
Title:
Location IDUnique identifier for the location. Valid values are defined in the list LocationIdLOV. -
ManagerAssignmentId: integer
(int64)
Title:
Manager Assignment IDIdentifier for the manager's assignment. -
ManagerId: integer
(int64)
Title:
Manager IDUnique identifier for a manager. Valid values are defined in the list ManagerIdLOV. -
ManagerType: string
Title:
TypeMaximum Length:30Role of the manager with regards to the overall organization structure. For example, functional, project leader, and so on. -
PeopleGroup: string
People group represented as a concatenated value of all the related key flexfield segments.
-
peopleGroupKeyFlexfield: array
peopleGroupKeyFlexfield
-
PeriodOfServiceId: integer
(int64)
Title:
Period of Service IDPrimary key autogenerated by the application. -
PersonTypeId: integer
(int64)
Title:
Person Type IDUnique identifier for the person type. Valid values are defined in the list PersonTypeIdLOV. -
PositionId: integer
(int64)
Title:
Position IDUnique identifier for a position. Valid values are defined in the list PositionIdLOV. -
PrimaryAssignmentFlag: boolean
Title:
Primary AssignmentMaximum Length:30Default Value:falseIndicates whether the current assignment is the primary assignment. Valid values are Yes and No. -
PrimaryWorkRelationFlag: boolean
Title:
Primary Work RelationshipMaximum Length:30Indicates whether the current work relationship is primary. Valid values are Yes and No. -
PrimaryWorkTermsFlag: boolean
Title:
Primary Employment TermsMaximum Length:30Default Value:falseIndicates whether the current employment terms are primary. Valid values are Yes and No. -
ProbationPeriodEndDate: string
(date)
Title:
Probation End DateEnd date of the probation period. -
ProbationPeriodLength: number
Title:
Probation PeriodDuration of the probation period. -
ProbationPeriodUnitOfMeasure: string
Title:
Probation UnitMaximum Length:30Units for the probation period duration. Valid values are defined in the list QUALIFYING_UNITS. -
ProjectedStartDate: string
(date)
Title:
Projected Start DateProposed start date for the pending worker. -
ProposedPersonTypeId: string
Title:
Proposed Person TypeMaximum Length:30Unique identifier for the worker class. This value is valid only if the PersonTypeId is Pending Worker. It can be any of the employee or contingent worker types. Valid values are defined in the list ProposedPersonTypeIdLOV. -
RegularTemporary: string
Title:
Regular or TemporaryMaximum Length:30Indicates whether the position the employee is hired for is regular or temporary. Valid values are defined in the list RegularTemporaryLOV. -
SalaryAmount: number
Title:
Salary AmountSalary amount entered based on the salary frequency. -
SalaryBasisId: integer
(int64)
Identifier for the set of details linked to a worker's base pay. It identifies the payroll characteristics used to pay base earnings, the duration for which base pay is quoted, the factor used to annualize base pay, any components used to attribute base pay adjustments to different reasons, and any associated grade rate for salary validation. Valid values are defined in the list SalaryBasisIdLOV.
-
SalaryCode: string
Title:
Hourly Paid or SalariedMaximum Length:30Identifies whether the assignment is paid by the hour or by a salary. Either maintained at the assignment level or employment or placement terms but not both. Valid values are defined in the list SalaryCodeLOV. -
StartTime: string
Title:
Start TimeMaximum Length:5Work day normal start time. -
TermsEffectiveStartDate: string
(date)
Title:
Effective Start DateDate at the beginning of the period within which the employee term is effective. -
WorkerCategory: string
Title:
Worker CategoryMaximum Length:30Category of the worker such as Blue Collar, Civil Servant, and so on. Valid values are defined in the list WorkerCategoryLOV. -
WorkingAsManager: string
Title:
Working as a ManagerMaximum Length:30Indicates whether the person is a manager. Valid values are Yes and No. -
WorkingAtHome: string
Title:
Working at HomeMaximum Length:30Indicates whether the person is working at home. Valid values are Yes and No. -
WorkingHours: number
Title:
Working HoursNormal working hours. -
WorkTaxAddressId: integer
(int64)
Title:
Tax Address IDUnique identifier for the address that's used for taxation purposes. This can be different from a mailing address. Valid values are defined in the list WorkTaxAddressIdLOV.
Nested Schema : assignmentExtraInformation
Type:
Show Source
array-
Array of:
object Discriminator: CategoryCode
Discriminator:
{ "propertyName":"CategoryCode", "mapping":{ "PER_ASG_EIT":"#/components/schemas/oracle_apps_hcm_employment_core_flex_assignmentExtraInfoEFF_Category_view_j__CategoryPerAsgEitprivateVO-item-patch-request" } }
Nested Schema : Employee Representatives
Type:
arrayTitle:
Employee RepresentativesThe empreps resource is a child of the assignments resource. It includes all employee representatives as of the specified date. By default, the current date is retained.
This resource is currently under controlled availability.
Show Source
This resource is currently under controlled availability.
Nested Schema : schema
Type:
Show Source
object-
__FLEX_Context: string
Title:
Context ValueMaximum Length:30 -
__FLEX_Context_DisplayValue: string
Title:
Context Value -
EffectiveEndDate: string
(date)
Title:
Effective End Date -
EffectiveLatestChange: string
Title:
Effective Latest ChangeMaximum Length:30 -
EffectiveSequence: integer
(int32)
Title:
Effective Sequence -
EffectiveStartDate: string
(date)
Title:
Effective Start Date
Nested Schema : Discriminator: CategoryCode
Type:
objectDiscriminator: CategoryCode
Discriminator Values
Match One Schema
Show Source
Nested Schema : oracle_apps_hcm_employment_core_flex_assignmentExtraInfoEFF_Category_view_j__CategoryPerAsgEitprivateVO-item-patch-request
Type:
Show Source
object-
CategoryCode: string
Title:
EFF ContextMaximum Length:80Default Value:PER_ASG_EIT -
EffectiveEndDate: string
(date)
Title:
Effective End Date -
EffectiveLatestChange: string
Title:
Effective Latest ChangeMaximum Length:30 -
EffectiveSequence: integer
(int32)
Title:
Effective Sequence -
EffectiveStartDate: string
(date)
Title:
Effective Start Date -
InformationORA_5FPER_5FRET_5FGRADEprivateVO: array
InformationORA_5FPER_5FRET_5FGRADEprivateVO
Nested Schema : workers-workRelationships-assignments-assignmentsEFF-InformationORA_5FPER_5FRET_5FGRADEprivateVO-item-patch-request
Type:
Show Source
object-
AeiInformationCategory: string
Maximum Length:
30Default Value:ORA_PER_RET_GRADE -
AssignmentExtraInfoId: integer
(int64)
-
AssignmentId: integer
(int64)
-
BusinessGroupId: integer
(int64)
-
EffectiveEndDate: string
(date)
Title:
Effective End Date -
EffectiveLatestChange: string
Maximum Length:
30Default Value:Y -
EffectiveSequence: integer
(int32)
Default Value:
1 -
EffectiveStartDate: string
(date)
Title:
Effective Start Date -
endDate: string
(date)
Title:
End Date -
frequency: string
Title:
Pay BasisMaximum Length:150 -
grade: string
Title:
GradeMaximum Length:150 -
grade_Display: string
Title:
Grade -
gradeLadder: string
Title:
Pay Table IDMaximum Length:150 -
gradeLadder_Display: string
Title:
Pay Table ID -
payPlan: string
Title:
Pay PlanMaximum Length:150 -
primaryIndicator: string
Title:
Primary IndicatorMaximum Length:150 -
primaryIndicator_Display: string
Title:
Primary Indicator -
startDate: string
(date)
Title:
Start Date -
step: string
Title:
StepMaximum Length:150 -
step_Display: string
Title:
Step
Nested Schema : emps-assignments-peopleGroupKeyFlexfield-item-patch-request
Type:
Show Source
objectResponse
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 : emps-assignments-item-response
Type:
Show Source
object-
ActionCode: string
Title:
Action CodeMaximum Length:30Action performed on a particular record, such as Hire, Add Pending Worker, Manager Change, and so on. Valid values are defined in the list ActionCodeLOV. -
ActionReasonCode: string
Title:
Reason CodeMaximum Length:30User-defined code for the action reason. Specifies the reason for the action performed on the record. Valid values are defined in the list ActionReasonCodeLOV. -
ActualTerminationDate: string
(date)
Read Only:
trueActual date of termination of employment. This is required during termination, when the TerminateWorkRelationshipFlag is set to Y. -
AssignmentCategory: string
Title:
Assignment CategoryMaximum Length:30User-defined category such as Full-Time Permanent or Part-Time Permanent. Valid values are defined in the list AssignmentCategoryLOV. -
assignmentDFF: array
assignmentDFF
-
assignmentExtraInformation: array
assignmentExtraInformation
-
AssignmentId: integer
(int64)
Title:
Assignment IDUnique identifier for the assignment. This is a primary key generated by the application. -
AssignmentName: string
Title:
Assignment NameMaximum Length:80Name of the assignment. -
AssignmentNumber: string
Title:
Assignment NumberMaximum Length:30Unique identifier for the assignment or terms. Valid for workers and nonworkers. -
AssignmentProjectedEndDate: string
(date)
Title:
Projected End DateDate on which the assignment is expected to end. -
AssignmentStatus: string
Title:
Assignment StatusMaximum Length:30HR status of the assignment, such as Active or Inactive. Valid values are defined in the list AssignmentStatusLOV. -
AssignmentStatusTypeId: integer
(int64)
Title:
Assignment Status Type IDUnique identifier for the user-defined assignment status. Valid values are defined in the list AssignmentStatusTypeIdLOV. -
BusinessUnitId: integer
(int64)
Title:
Business Unit IDUnique identifier for the business unit. Valid values are defined in the list BusinessUnitIdLOV. -
CreationDate: string
(date-time)
Title:
Creation DateRead Only:trueDate and time of creation of the employee assignment record. -
DefaultExpenseAccount: string
Default expense account represented as a concatenated value of all the related segments.
-
DepartmentId: integer
(int64)
Title:
Organization IDUnique identifier for the department. Valid values are defined in the list DepartmentIdLOV. -
EffectiveEndDate: string
(date)
Title:
Effective End DateDate at the end of the period within which the employee assignment is effective. -
EffectiveStartDate: string
(date)
Title:
Effective Start DateDate at the beginning of the period within which the employee assignment is effective. -
empreps: array
Employee Representatives
Title:
Employee RepresentativesThe empreps resource is a child of the assignments resource. It includes all employee representatives as of the specified date. By default, the current date is retained.
This resource is currently under controlled availability. -
EndTime: string
Title:
End TimeMaximum Length:5Work day normal end time. -
Frequency: string
Title:
FrequencyMaximum Length:30Frequency of normal working hours such as week, month, year. Valid values are defined in the list FrequencyLOV. -
FullPartTime: string
Title:
Full Time or Part TimeMaximum Length:30Indicates whether the position the employee is hired for is full-time or part-time. Valid values are defined in the list FullPartTimeLOV. -
GradeId: integer
(int64)
Title:
Grade IDUnique identifier for the grade. Valid values are defined in the list GradeIdLOV. -
GradeLadderId: integer
(int64)
Title:
Grade Ladder IDUnique identifier for the grade ladder. -
JobId: integer
(int64)
Title:
Job IDUnique identifier for the job. Valid values are defined in the list JobIdLOV. -
LastUpdateDate: string
(date-time)
Title:
Last Updated DateRead Only:trueDate and time of update of the employee assignment record. -
LegalEntityId: integer
(int64)
Title:
Legal Entity IDUnique identifier for the legal entity. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
LocationId: integer
(int64)
Title:
Location IDUnique identifier for the location. Valid values are defined in the list LocationIdLOV. -
ManagerAssignmentId: integer
(int64)
Title:
Manager Assignment IDIdentifier for the manager's assignment. -
ManagerId: integer
(int64)
Title:
Manager IDUnique identifier for a manager. Valid values are defined in the list ManagerIdLOV. -
ManagerType: string
Title:
TypeMaximum Length:30Role of the manager with regards to the overall organization structure. For example, functional, project leader, and so on. -
OriginalHireDate: string
(date)
Read Only:
trueOriginal date of hire for employment. -
PeopleGroup: string
People group represented as a concatenated value of all the related key flexfield segments.
-
peopleGroupKeyFlexfield: array
peopleGroupKeyFlexfield
-
PeriodOfServiceId: integer
(int64)
Title:
Period of Service IDPrimary key autogenerated by the application. -
PersonTypeId: integer
(int64)
Title:
Person Type IDUnique identifier for the person type. Valid values are defined in the list PersonTypeIdLOV. -
PositionId: integer
(int64)
Title:
Position IDUnique identifier for a position. Valid values are defined in the list PositionIdLOV. -
PrimaryAssignmentFlag: boolean
Title:
Primary AssignmentMaximum Length:30Default Value:falseIndicates whether the current assignment is the primary assignment. Valid values are Yes and No. -
PrimaryWorkRelationFlag: boolean
Title:
Primary Work RelationshipMaximum Length:30Indicates whether the current work relationship is primary. Valid values are Yes and No. -
PrimaryWorkTermsFlag: boolean
Title:
Primary Employment TermsMaximum Length:30Default Value:falseIndicates whether the current employment terms are primary. Valid values are Yes and No. -
ProbationPeriodEndDate: string
(date)
Title:
Probation End DateEnd date of the probation period. -
ProbationPeriodLength: number
Title:
Probation PeriodDuration of the probation period. -
ProbationPeriodUnitOfMeasure: string
Title:
Probation UnitMaximum Length:30Units for the probation period duration. Valid values are defined in the list QUALIFYING_UNITS. -
ProjectedStartDate: string
(date)
Title:
Projected Start DateProposed start date for the pending worker. -
ProposedPersonTypeId: string
Title:
Proposed Person TypeMaximum Length:30Unique identifier for the worker class. This value is valid only if the PersonTypeId is Pending Worker. It can be any of the employee or contingent worker types. Valid values are defined in the list ProposedPersonTypeIdLOV. -
RegularTemporary: string
Title:
Regular or TemporaryMaximum Length:30Indicates whether the position the employee is hired for is regular or temporary. Valid values are defined in the list RegularTemporaryLOV. -
SalaryAmount: number
Title:
Salary AmountSalary amount entered based on the salary frequency. -
SalaryBasisId: integer
(int64)
Identifier for the set of details linked to a worker's base pay. It identifies the payroll characteristics used to pay base earnings, the duration for which base pay is quoted, the factor used to annualize base pay, any components used to attribute base pay adjustments to different reasons, and any associated grade rate for salary validation. Valid values are defined in the list SalaryBasisIdLOV.
-
SalaryCode: string
Title:
Hourly Paid or SalariedMaximum Length:30Identifies whether the assignment is paid by the hour or by a salary. Either maintained at the assignment level or employment or placement terms but not both. Valid values are defined in the list SalaryCodeLOV. -
StartTime: string
Title:
Start TimeMaximum Length:5Work day normal start time. -
TermsEffectiveStartDate: string
(date)
Title:
Effective Start DateDate at the beginning of the period within which the employee term is effective. -
WorkerCategory: string
Title:
Worker CategoryMaximum Length:30Category of the worker such as Blue Collar, Civil Servant, and so on. Valid values are defined in the list WorkerCategoryLOV. -
WorkingAsManager: string
Title:
Working as a ManagerMaximum Length:30Indicates whether the person is a manager. Valid values are Yes and No. -
WorkingAtHome: string
Title:
Working at HomeMaximum Length:30Indicates whether the person is working at home. Valid values are Yes and No. -
WorkingHours: number
Title:
Working HoursNormal working hours. -
WorkTaxAddressId: integer
(int64)
Title:
Tax Address IDUnique identifier for the address that's used for taxation purposes. This can be different from a mailing address. Valid values are defined in the list WorkTaxAddressIdLOV.
Nested Schema : assignmentExtraInformation
Type:
Show Source
array-
Array of:
object Discriminator: CategoryCode
Discriminator:
{ "propertyName":"CategoryCode", "mapping":{ "PER_ASG_EIT":"#/components/schemas/oracle_apps_hcm_employment_core_flex_assignmentExtraInfoEFF_Category_view_j__CategoryPerAsgEitprivateVO-item-response" } }
Nested Schema : Employee Representatives
Type:
arrayTitle:
Employee RepresentativesThe empreps resource is a child of the assignments resource. It includes all employee representatives as of the specified date. By default, the current date is retained.
This resource is currently under controlled availability.
Show Source
This resource is currently under controlled availability.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : emps-assignments-assignmentDFF-item-response
Type:
Show Source
object-
__FLEX_Context: string
Title:
Context ValueMaximum Length:30 -
__FLEX_Context_DisplayValue: string
Title:
Context Value -
AssignmentId: integer
(int64)
Title:
Assignment ID -
AssignmentType: string
Title:
Assignment TypeMaximum Length:30 -
EffectiveEndDate: string
(date)
Title:
Effective End Date -
EffectiveLatestChange: string
Title:
Effective Latest ChangeMaximum Length:30 -
EffectiveSequence: integer
(int32)
Title:
Effective Sequence -
EffectiveStartDate: string
(date)
Title:
Effective Start Date -
links: array
Links
Title:
LinksThe link relations associated with the resource instance.
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.
Nested Schema : Discriminator: CategoryCode
Type:
objectDiscriminator: CategoryCode
Discriminator Values
Match One Schema
Show Source
Nested Schema : oracle_apps_hcm_employment_core_flex_assignmentExtraInfoEFF_Category_view_j__CategoryPerAsgEitprivateVO-item-response
Type:
Show Source
object-
AssignmentId: integer
(int64)
Title:
Assignment ID -
AssignmentType: string
Title:
Assignment TypeMaximum Length:30 -
CategoryCode: string
Title:
EFF ContextMaximum Length:80Default Value:PER_ASG_EIT -
EffectiveEndDate: string
(date)
Title:
Effective End Date -
EffectiveLatestChange: string
Title:
Effective Latest ChangeMaximum Length:30 -
EffectiveSequence: integer
(int32)
Title:
Effective Sequence -
EffectiveStartDate: string
(date)
Title:
Effective Start Date -
InformationORA_5FPER_5FRET_5FGRADEprivateVO: array
InformationORA_5FPER_5FRET_5FGRADEprivateVO
-
links: array
Links
Title:
LinksThe link relations associated with the resource instance.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : workers-workRelationships-assignments-assignmentsEFF-InformationORA_5FPER_5FRET_5FGRADEprivateVO-item-response
Type:
Show Source
object-
AeiInformationCategory: string
Maximum Length:
30Default Value:ORA_PER_RET_GRADE -
AssignmentExtraInfoId: integer
(int64)
-
AssignmentId: integer
(int64)
-
BusinessGroupId: integer
(int64)
-
CreationDate: string
(date-time)
Read Only:
true -
EffectiveEndDate: string
(date)
Title:
Effective End Date -
EffectiveLatestChange: string
Maximum Length:
30Default Value:Y -
EffectiveSequence: integer
(int32)
Default Value:
1 -
EffectiveStartDate: string
(date)
Title:
Effective Start Date -
endDate: string
(date)
Title:
End Date -
frequency: string
Title:
Pay BasisMaximum Length:150 -
grade: string
Title:
GradeMaximum Length:150 -
grade_Display: string
Title:
Grade -
gradeLadder: string
Title:
Pay Table IDMaximum Length:150 -
gradeLadder_Display: string
Title:
Pay Table ID -
LastUpdateDate: string
(date-time)
Read Only:
true -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
payPlan: string
Title:
Pay PlanMaximum Length:150 -
primaryIndicator: string
Title:
Primary IndicatorMaximum Length:150 -
primaryIndicator_Display: string
Title:
Primary Indicator -
startDate: string
(date)
Title:
Start Date -
step: string
Title:
StepMaximum Length:150 -
step_Display: string
Title:
Step
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : emps-assignments-empreps-item-response
Type:
Show Source
object-
AsgResponsibilityId: integer
(int64)
Read Only:
truePrimary key autogenerated by the application. -
AssignmentId: integer
(int64)
Title:
Assignment IDRead Only:trueInternal identifier for the assignment. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
PersonId: integer
(int64)
Read Only:
trueInternal unique identifier for the person. -
ResponsibilityName: string
Read Only:
trueMaximum Length:240Name of an area of responsibility. -
ResponsibilityTypeCode: string
Title:
Lookup CodeRead Only:trueMaximum Length:30Identifier of the responsibility type for which this record holds the criteria. The value is validated against HCM_LOOKUPS with the lookup type PER_RESPONSIBILITY_TYPES. -
ResponsibilityTypeName: string
Title:
MeaningRead Only:trueMaximum Length:80Name of the responsibility type for which this record holds the criteria. For example, Benefits Representative.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : emps-assignments-peopleGroupKeyFlexfield-item-response
Type:
Show Source
object-
_ID_FLEX_NUM: integer
(int64)
Read Only:
true -
_PEOPLE_GROUP_ID: integer
(int64)
Read Only:
true -
EnabledFlag: string
Read Only:
trueMaximum Length:1 -
EndDateActive: string
(date)
Read Only:
true -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
StartDateActive: string
(date)
Read Only:
true
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Links
- AssignmentStatusTypeIdLOV
-
The list of values for the user-defined status of the assignment.
- SalaryBasisIdLOV
-
The list of values for salary basis.
- assignmentDFF
-
Parameters:
- assignmentsUniqID:
$request.path.assignmentsUniqID - empsUniqID:
$request.path.empsUniqID
- assignmentsUniqID:
- assignmentExtraInformation
-
Parameters:
- assignmentsUniqID:
$request.path.assignmentsUniqID - empsUniqID:
$request.path.empsUniqID
- assignmentsUniqID:
- empreps
-
Parameters:
- assignmentsUniqID:
$request.path.assignmentsUniqID - empsUniqID:
$request.path.empsUniqID
The empreps resource is a child of the assignments resource. It includes all employee representatives as of the specified date. By default, the current date is retained.
This resource is currently under controlled availability. - assignmentsUniqID:
- peopleGroupKeyFlexfield
-
Parameters:
- assignmentsUniqID:
$request.path.assignmentsUniqID - empsUniqID:
$request.path.empsUniqID
- assignmentsUniqID:
Examples
The following example shows how to update an employee assignment for manager change, by submitting a PATCH request on the REST resource using cURL.
Note:
Always execute PATCH operations against the self link returned in the GET response.curl -i -u "<username>:<password>" -H "Content-Type: application/vnd.oracle.adf.resourceitem+json" -H "Effective-Of:RangeMode=UPDATE;RangeStartDate=2019-01-01" -X PATCH -d <payload> https://<host>:<port>/hcmRestApi/resources/11.13.18.05/emps/00020000004AACED00057372000D6A6176612E73716C2E4461746514FA46683F3566970200007872000E6A6176612E7574696C2E44617465686A81014B597419030000787077080000012D147EA440780000000EACED00057708000110F07EBB375D/child/assignments/00040000000EACED00057708000110F07EBB37790000000EACED0005770800000000000001850000000EACED00057708000000000000017F0000004AACED00057372000D6A6176612E73716C2E4461746514FA46683F3566970200007872000E6A6176612E7574696C2E44617465686A81014B597419030000787077080000016805879C4078
Example of Payload
The following shows an example of the payload
{
"ActionCode":"MANAGER_CHANGE",
"ManagerAssignmentId":"389",
"ManagerId":"383",
"ManagerType":"LINE_MANAGER"
}
Example of Response Header
The following shows an example of the response header.
Status: HTTP/1.1 200 OK Content-Type : application/json
Example of Response Body
The following example shows the contents of the response body in JSON format.
{
"AssignmentName":"Asg1DEFLG1457528209432",
"PersonTypeId":13,"BusinessUnitId":202,
"LocationId":null,"JobId":11,
"GradeId":null,
"DepartmentId":null,
"WorkerCategory":"WC",
"AssignmentCategory":"FT",
"WorkingAtHome":"N",
"WorkingAsManager":"N",
"SalaryCode":"H",
"WorkingHours":12,"Frequency":"D",
"StartTime":"08:00",
"EndTime":"17:00",
"SalaryAmount":100000,
"SalaryBasisId":100010024999994,
"ActionCode":"MANAGER_CHANGE",
"ActionReasonCode":"NEWHIRE",
"AssignmentStatus":"ACTIVE",
"WorkTaxAddressId":300100011952957,
"AssignmentId":300100081104761,
"EffectiveStartDate":"2019-01-01",
"EffectiveEndDate":"4712-12-31",
"PositionId":null,
"TermsEffectiveStartDate":"2019-01-01, "ManagerAssignmentId":389,
"ManagerId":383,
"ManagerType":"LINE_MANAGER",
"AssignmentNumber":"E955160008236641",
"PeriodOfServiceId":300100081104753,
"OriginalHireDate":null,
"PrimaryAssignmentFlag":"Y",
"ProbationPeriodEndDate":null,
"ProbationPeriodLength":null,
"ProbationPeriodUnitOfMeasure":null,
"AssignmentProjectedEndDate":null,
"ActualTerminationDate":null,
"LegalEntityId":40010,
"PrimaryWorkRelationFlag":"Y",
"PrimaryWorkTermsFlag":"N",
"CreationDate":"2016-03-09 18:27:24.133",
"LastUpdateDate":"2016-03-09 18:28:36.53",
"links":[24]
0: {...
...}
}