Update an interval goal
/fscmRestApi/resources/11.13.18.05/incentiveCompensationPerformanceMeasures/{PerformanceMeasureId}/child/performanceMeasureGoals/{GoalId}/child/performanceMeasureIntervalGoals/{IntervalGoalId}
Request
-
GoalId(required): integer(int64)
The unique identifier for a goal record.
-
IntervalGoalId(required): integer(int64)
The unique identifier for the interval goal details.
-
PerformanceMeasureId(required): integer(int64)
The unique identifier for the performance measure.
-
Metadata-Context: string
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: string
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.
- application/json
object-
AlternateIntervalTarget1: number
Title:
Alternate Interval Target 1Default Value:0The alternate interval target number for a measure, for example, stretch goal for an interval. The default value is 0. -
AlternateIntervalTarget1Percent: number
Title:
Alternate Interval Target 1The alternate interval target percentage for a measure, for example, stretch goal for an interval. This is calculated on the respective alternate target. -
AlternateIntervalTarget2: number
Title:
Alternate Interval Target 2Default Value:0The alternate interval target number for a measure, for example, stretch goal for an interval. The default value is 0. -
AlternateIntervalTarget2Percent: number
Title:
Alternate Interval Target 2The alternate interval target percentage for a measure, for example, stretch goal for an interval. This is calculated on the respective alternate target. -
AlternateIntervalTarget3: number
Title:
Alternate Interval Target 3Default Value:0The alternate interval target number for a measure, for example, stretch goal for an interval. The default value is 0. -
AlternateIntervalTarget3Percent: number
Title:
Alternate Interval Target 3The alternate interval target percentage for a measure, for example, stretch goal for an interval. This is calculated on the respective alternate target. -
AlternateIntervalTarget4: number
Title:
Alternate Interval Target 4Default Value:0The alternate interval target number for a measure, for example, stretch goal for an interval. The default value is 0. -
AlternateIntervalTarget4Percent: number
Title:
Alternate Interval Target 4The alternate interval target percentage for a measure, for example, stretch goal for an interval. This is calculated on the respective alternate target. -
AlternateIntervalTarget5: number
Title:
Alternate Interval Target 5Default Value:0The alternate interval target number for a measure, for example, stretch goal for an interval. The default value is 0. -
AlternateIntervalTarget5Percent: number
Title:
Alternate Interval Target 5The alternate interval target percentage for a measure, for example, stretch goal for an interval. This is calculated on the respective alternate target. -
GoalId: integer
(int64)
The unique identifier for a goal record.
-
IntervalNumber: string
Title:
PeriodMaximum Length:80The display value of the interval. -
performanceMeasurePeriodGoals: array
Period Goals
Title:
Period GoalsThe Period Goals resource is used to view and update the target or the goal values at each period. It can also be used to display all details of the goals across periods. This is created when creating a Performance Measure with a default value of 0. This needs to be updated later if needed.
arrayPeriod Goalsobject-
AlternatePeriodTarget1: number
Title:
Alternate Period Target 1Default Value:0The alternate period target number for a measure, for example, stretch goal for a period. The default value is 0. -
AlternatePeriodTarget1Percent: number
Title:
Alternate Period Target 1The alternate period target percentage for a measure, for example, stretch goal for a period. -
AlternatePeriodTarget2: number
Title:
Alternate Period Target 2Default Value:0The alternate period target number for a measure, for example, stretch goal for a period. The default value is 0. -
AlternatePeriodTarget2Percent: number
Title:
Alternate Period Target 2The alternate period target percentage for a measure, for example, stretch goal for a period. -
AlternatePeriodTarget3: number
Title:
Alternate Period Target 3Default Value:0The alternate period target number for a measure, for example, stretch goal for a period. The default value is 0. -
AlternatePeriodTarget3Percent: number
Title:
Alternate Period Target 3The alternate period target percentage for a measure, for example, stretch goal for a period. -
AlternatePeriodTarget4: number
Title:
Alternate Period Target 4Default Value:0The alternate period target number for a measure, for example, stretch goal for a period. The default value is 0. -
AlternatePeriodTarget4Percent: number
Title:
Alternate Period Target 4The alternate period target percentage for a measure, for example, stretch goal for a period. -
AlternatePeriodTarget5: number
Title:
Alternate Period Target 5Default Value:0The alternate period target number for a measure, for example, stretch goal for a period. The default value is 0. -
AlternatePeriodTarget5Percent: number
Title:
Alternate Period Target 5The alternate period target percentage for a measure, for example, stretch goal for a period. -
GoalId: integer
(int64)
The unique identifier for a goal.
-
IntervalGoalId: integer
(int64)
The unique identifier for the interval goal details.
-
PeriodTarget: number
Title:
Period TargetDefault Value:0The period target number for a measure. -
PeriodTargetPercent: number
Title:
Period TargetThe period target percentage for a measure.
Response
- application/json
Default Response
-
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.
object-
AlternateIntervalTarget1: number
Title:
Alternate Interval Target 1Default Value:0The alternate interval target number for a measure, for example, stretch goal for an interval. The default value is 0. -
AlternateIntervalTarget1Percent: number
Title:
Alternate Interval Target 1The alternate interval target percentage for a measure, for example, stretch goal for an interval. This is calculated on the respective alternate target. -
AlternateIntervalTarget2: number
Title:
Alternate Interval Target 2Default Value:0The alternate interval target number for a measure, for example, stretch goal for an interval. The default value is 0. -
AlternateIntervalTarget2Percent: number
Title:
Alternate Interval Target 2The alternate interval target percentage for a measure, for example, stretch goal for an interval. This is calculated on the respective alternate target. -
AlternateIntervalTarget3: number
Title:
Alternate Interval Target 3Default Value:0The alternate interval target number for a measure, for example, stretch goal for an interval. The default value is 0. -
AlternateIntervalTarget3Percent: number
Title:
Alternate Interval Target 3The alternate interval target percentage for a measure, for example, stretch goal for an interval. This is calculated on the respective alternate target. -
AlternateIntervalTarget4: number
Title:
Alternate Interval Target 4Default Value:0The alternate interval target number for a measure, for example, stretch goal for an interval. The default value is 0. -
AlternateIntervalTarget4Percent: number
Title:
Alternate Interval Target 4The alternate interval target percentage for a measure, for example, stretch goal for an interval. This is calculated on the respective alternate target. -
AlternateIntervalTarget5: number
Title:
Alternate Interval Target 5Default Value:0The alternate interval target number for a measure, for example, stretch goal for an interval. The default value is 0. -
AlternateIntervalTarget5Percent: number
Title:
Alternate Interval Target 5The alternate interval target percentage for a measure, for example, stretch goal for an interval. This is calculated on the respective alternate target. -
CreatedBy: string
Title:
Created ByRead Only:trueMaximum Length:255The user who created the record. -
CreationDate: string
(date-time)
Title:
Creation DateRead Only:trueThe date and time when the record was created. -
GoalId: integer
(int64)
The unique identifier for a goal record.
-
IntervalGoalId: integer
(int64)
The unique identifier for the interval goal details.
-
IntervalNumber: string
Title:
PeriodMaximum Length:80The display value of the interval. -
IntervalTarget: number
Title:
Interval TargetRead Only:trueDefault Value:0The target number specified for the goal interval. The default value is 0. -
IntervalTargetPercent: number
Title:
Interval TargetRead Only:trueThe target percentage specified for the goal interval. -
LastUpdateDate: string
(date-time)
Title:
Last Updated DateRead Only:trueThe date and time when the record was last updated. -
LastUpdatedBy: string
Title:
Last Updated ByRead Only:trueMaximum Length:255The user who last updated the record. -
LastUpdateLogin: string
Title:
Last Update LoginRead Only:trueMaximum Length:32The session login of the user who last updated the record. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
PerformanceMeasureIntervalGoalDeleteFlag: boolean
Read Only:
trueDefault Value:falseIndicates whether a performance measure interval goal can be deleted. -
performanceMeasurePeriodGoals: array
Period Goals
Title:
Period GoalsThe Period Goals resource is used to view and update the target or the goal values at each period. It can also be used to display all details of the goals across periods. This is created when creating a Performance Measure with a default value of 0. This needs to be updated later if needed.
arrayLinksarrayPeriod Goalsobject-
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.
object-
changeIndicator: string
Change indicator or the ETag value of the resource instance.
object-
AlternateITDTarget1: number
Title:
Alternate ITD Target 1Read Only:trueThe alternate interval-to-date target number for a measure. -
AlternateITDTarget2: number
Title:
Alternate ITD Target 2Read Only:trueThe alternate interval-to-date target number for a measure. -
AlternateITDTarget3: number
Title:
Alternate ITD Target 3Read Only:trueThe alternate interval-to-date target number for a measure. -
AlternateITDTarget4: number
Title:
Alternate ITD Target 4Read Only:trueThe alternate interval-to-date target number for a measure. -
AlternateITDTarget5: number
Title:
Alternate ITD Target 5Read Only:trueThe alternate interval-to-date target number for a measure. -
AlternatePeriodTarget1: number
Title:
Alternate Period Target 1Default Value:0The alternate period target number for a measure, for example, stretch goal for a period. The default value is 0. -
AlternatePeriodTarget1Percent: number
Title:
Alternate Period Target 1The alternate period target percentage for a measure, for example, stretch goal for a period. -
AlternatePeriodTarget2: number
Title:
Alternate Period Target 2Default Value:0The alternate period target number for a measure, for example, stretch goal for a period. The default value is 0. -
AlternatePeriodTarget2Percent: number
Title:
Alternate Period Target 2The alternate period target percentage for a measure, for example, stretch goal for a period. -
AlternatePeriodTarget3: number
Title:
Alternate Period Target 3Default Value:0The alternate period target number for a measure, for example, stretch goal for a period. The default value is 0. -
AlternatePeriodTarget3Percent: number
Title:
Alternate Period Target 3The alternate period target percentage for a measure, for example, stretch goal for a period. -
AlternatePeriodTarget4: number
Title:
Alternate Period Target 4Default Value:0The alternate period target number for a measure, for example, stretch goal for a period. The default value is 0. -
AlternatePeriodTarget4Percent: number
Title:
Alternate Period Target 4The alternate period target percentage for a measure, for example, stretch goal for a period. -
AlternatePeriodTarget5: number
Title:
Alternate Period Target 5Default Value:0The alternate period target number for a measure, for example, stretch goal for a period. The default value is 0. -
AlternatePeriodTarget5Percent: number
Title:
Alternate Period Target 5The alternate period target percentage for a measure, for example, stretch goal for a period. -
CreatedBy: string
Title:
Created ByRead Only:trueMaximum Length:255The user who created the record. -
CreationDate: string
(date-time)
Title:
Creation DateRead Only:trueThe date and time when the record was created. -
GoalId: integer
(int64)
The unique identifier for a goal.
-
IntervalGoalId: integer
(int64)
The unique identifier for the interval goal details.
-
ITDTarget: number
Title:
ITD TargetRead Only:trueThe Interval-to-date target number for a measure. -
LastUpdateDate: string
(date-time)
Title:
Last Updated DateRead Only:trueThe date when the record was last updated. -
LastUpdatedBy: string
Title:
Last Updated ByRead Only:trueMaximum Length:255The user who last updated the record. -
LastUpdateLogin: string
Title:
Last Update LoginRead Only:trueMaximum Length:32The session login of the user who last updated the record. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
PerformanceMeasurePeriodGoalDeleteFlag: boolean
Read Only:
trueDefault Value:falseInidcates whether a performance measure period goal can be deleted. -
PeriodGoalId: integer
(int64)
The unique identifier for the period goal details.
-
PeriodName: string
Title:
PeriodRead Only:trueMaximum Length:30The name for an interval of time defined in the calendar. -
PeriodTarget: number
Title:
Period TargetDefault Value:0The period target number for a measure. -
PeriodTargetPercent: number
Title:
Period TargetThe period target percentage for a measure.
arrayLinks- performanceMeasurePeriodGoals
-
Parameters:
- GoalId:
$request.path.GoalId - IntervalGoalId:
$request.path.IntervalGoalId - PerformanceMeasureId:
$request.path.PerformanceMeasureId
The Period Goals resource is used to view and update the target or the goal values at each period. It can also be used to display all details of the goals across periods. This is created when creating a Performance Measure with a default value of 0. This needs to be updated later if needed. - GoalId:
Examples
The following example shows how to update an interval goal by submitting a PATCH request on the REST resource using cURL.
cURL Command
curl -u <username:password> \ -X PATCH -d
@example_request_payload.json https://servername.fa.us2.oraclecloud.com/fscmRestApi/resources/11.13.18.05/incentiveCompensationPerformanceMeasures/300100090511017/child/performanceMeasureGoals/300100090511019/child/performanceMeasureIntervalGoals/300100090511020
Example of Request Body
The following example shows the contents of the request body in JSON format.
{
"AlternateIntervalTarget1": 0,
"AlternateIntervalTarget2": 0,
"AlternateIntervalTarget3": 0,
"AlternateIntervalTarget4": 0,
"AlternateIntervalTarget5": 20
}
Example of Response Body
The following example shows the contents of the response body in JSON format.
{
"IntervalGoalId": 300100090511020,
"GoalId": 300100090511019,
"IntervalNumber": "2016001",
"AlternateIntervalTarget1": 0,
"AlternateIntervalTarget2": 0,
"AlternateIntervalTarget3": 0,
"AlternateIntervalTarget4": 0,
"AlternateIntervalTarget5": 20,
"IntervalTarget": 0,
"IntervalTargetPercent": null,
"AlternateIntervalTarget1Percent": null,
"AlternateIntervalTarget2Percent": null,
"AlternateIntervalTarget3Percent": null,
"AlternateIntervalTarget4Percent": null,
"AlternateIntervalTarget5Percent": null,
"CreatedBy": "OIC_PLAN_ADMIN_OPERATIONS",
"CreationDate": "2017-06-08T11:28:10.392-07:00",
"LastUpdatedBy": "OIC_PLAN_ADMIN_OPERATIONS",
"LastUpdateDate": "2017-06-08T12:06:28-07:00",
"LastUpdateLogin": "516E508C5BC4377FE0532DD6F00A0214",
"PerformanceMeasureIntervalGoalDeleteFlag": false,
"links": [
...
]
}