Update a performance measure goal
patch
/fscmRestApi/resources/11.13.18.05/participantCompensationPlans/{participantCompensationPlansUniqID}/child/ParticipantPlanComponents/{ParticipantPlanComponentId}/child/ParticipantPlanComponentPerformanceMeasures/{ParticipantPerformanceMeasureId}/child/ParticipantPerformanceMeasureGoals/{ParticipantGoalId}
Request
Path Parameters
-
ParticipantGoalId(required): integer(int64)
The unique identifier of the goal associated with the participant performance measure.
-
ParticipantPerformanceMeasureId(required): integer(int64)
The unique identifier of the performance measure associated with the participant plan component.
-
ParticipantPlanComponentId(required): integer(int64)
The unique identifier of the plan component associated with the participant compensation plan.
-
participantCompensationPlansUniqID(required): string
This is the hash key of the attributes which make up the composite key for the Participant Compensation Plans resource and used to uniquely identify an instance of Participant Compensation Plans. The client should not generate the hash key value. Instead, the client should query on the Participant Compensation Plans collection resource in order to navigate to a specific instance of Participant Compensation Plans to get the hash key.
Header Parameters
-
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.
Supported Media Types
- application/json
Root Schema : schema
Type:
Show Source
object-
AlternateTarget1: number
Title:
Alternate Target 1Default Value:0The alternate target number for a measure, for example, stretch goal. -
AlternateTarget2: number
Title:
Alternate Target 2Default Value:0The alternate target number for a measure, for example, stretch goal. -
AlternateTarget3: number
Title:
Alternate Target 3Default Value:0The alternate target number for a measure, for example, stretch goal. -
AlternateTarget4: number
Title:
Alternate Target 4Default Value:0The alternate target number for a measure, for example, stretch goal. -
AlternateTarget5: number
Title:
Alternate Target 5Default Value:0The alternate target number for a measure, for example, stretch goal. -
DistributeEvenlyFlag: boolean
The instruction for the application to evenly distribute the total target and alternate targets to the respective interval and period amounts for this web service request. The possible values are TRUE and FALSE.
-
GoalTarget: number
Title:
Total TargetDefault Value:0The expected level of attainment assigned to the participant for the measure. -
ParticipantGoalIntervalGoals: array
Interval Goals
Title:
Interval GoalsThe performance measure interval goals service is used to view the interval target amounts for a participant performance measure that can be individualized. You enable individualization for a performance measure by setting the Individualize option to Yes for the related participant plan component. -
ParticipantGoalPeriodGoals: array
Period Goals
Title:
Period GoalsThe performance measure period goals service is used to view and update the period target amounts for a participant performance measure that can be individualized. You enable individualization for a performance measure by setting the Individualize option to Yes for the related participant plan component.
Nested Schema : Interval Goals
Type:
arrayTitle:
Interval GoalsThe performance measure interval goals service is used to view the interval target amounts for a participant performance measure that can be individualized. You enable individualization for a performance measure by setting the Individualize option to Yes for the related participant plan component.
Show Source
Nested Schema : Period Goals
Type:
arrayTitle:
Period GoalsThe performance measure period goals service is used to view and update the period target amounts for a participant performance measure that can be individualized. You enable individualization for a performance measure by setting the Individualize option to Yes for the related participant plan component.
Show Source
Nested Schema : participantCompensationPlans-ParticipantPlanComponents-ParticipantPlanComponentPerformanceMeasures-ParticipantPerformanceMeasureGoals-ParticipantGoalIntervalGoals-item-patch-request
Type:
Show Source
objectNested Schema : schema
Type:
Show Source
object-
AlternatePeriodTarget1: number
Title:
Alternate Period Target 1Default Value:0The alternate period target number 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. -
AlternatePeriodTarget3: number
Title:
Alternate Period Target 3Default Value:0The alternate period target number 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. -
AlternatePeriodTarget5: number
Title:
Alternate Period Target 5Default Value:0The alternate period target number for a measure, for example, stretch goal for a period. -
PeriodTarget: number
Title:
Period TargetDefault Value:0The period target number for a measure.
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 : participantCompensationPlans-ParticipantPlanComponents-ParticipantPlanComponentPerformanceMeasures-ParticipantPerformanceMeasureGoals-item-response
Type:
Show Source
object-
AlternateTarget1: number
Title:
Alternate Target 1Default Value:0The alternate target number for a measure, for example, stretch goal. -
AlternateTarget2: number
Title:
Alternate Target 2Default Value:0The alternate target number for a measure, for example, stretch goal. -
AlternateTarget3: number
Title:
Alternate Target 3Default Value:0The alternate target number for a measure, for example, stretch goal. -
AlternateTarget4: number
Title:
Alternate Target 4Default Value:0The alternate target number for a measure, for example, stretch goal. -
AlternateTarget5: number
Title:
Alternate Target 5Default Value:0The alternate target number for a measure, for example, stretch goal. -
CreatedBy: string
Read Only:
trueMaximum Length:64The user who created the participant performance measure goal. -
CreationDate: string
(date-time)
Read Only:
trueThe date and time when the participant performance measure goal is created. -
DistributeEvenlyFlag: boolean
The instruction for the application to evenly distribute the total target and alternate targets to the respective interval and period amounts for this web service request. The possible values are TRUE and FALSE.
-
GoalId: integer
(int64)
Read Only:
trueThe unique identifier of the goal associated with the base compensation plan. The base plan is modeled by the plan administrator and is the source of the participant plan. -
GoalInterval: string
Title:
IntervalRead Only:trueThe performance interval that describes the span of time to be measured for the attainment of the goal amounts, such as period, quarter, or year. This interval is the same as the corresponding performance (measure) interval. -
GoalTarget: number
Title:
Total TargetDefault Value:0The expected level of attainment assigned to the participant for the measure. -
LastUpdateDate: string
(date-time)
Read Only:
trueThe date and time when the participant performance measure goal is last updated. -
LastUpdatedBy: string
Read Only:
trueMaximum Length:64The user who last updated the participant performance measure goal. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
ParticipantGoalId: integer
(int64)
Read Only:
trueThe unique identifier of the goal associated with the participant performance measure. -
ParticipantGoalIntervalGoals: array
Interval Goals
Title:
Interval GoalsThe performance measure interval goals service is used to view the interval target amounts for a participant performance measure that can be individualized. You enable individualization for a performance measure by setting the Individualize option to Yes for the related participant plan component. -
ParticipantGoalPeriodGoals: array
Period Goals
Title:
Period GoalsThe performance measure period goals service is used to view and update the period target amounts for a participant performance measure that can be individualized. You enable individualization for a performance measure by setting the Individualize option to Yes for the related participant plan component. -
ParticipantPerformanceMeasureId: integer
(int64)
Read Only:
trueThe unique identifier of the participant performance measure. -
PerformanceMeasureId: integer
(int64)
Read Only:
trueThe unique identifier of the performance measure associated with the base compensation plan. The base plan is modeled by the plan administrator and is the source of the participant plan. -
PerformanceMeasureName: string
Title:
NameRead Only:trueThe name of the performance measure.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : Interval Goals
Type:
arrayTitle:
Interval GoalsThe performance measure interval goals service is used to view the interval target amounts for a participant performance measure that can be individualized. You enable individualization for a performance measure by setting the Individualize option to Yes for the related participant plan component.
Show Source
Nested Schema : Period Goals
Type:
arrayTitle:
Period GoalsThe performance measure period goals service is used to view and update the period target amounts for a participant performance measure that can be individualized. You enable individualization for a performance measure by setting the Individualize option to Yes for the related participant plan component.
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 : participantCompensationPlans-ParticipantPlanComponents-ParticipantPlanComponentPerformanceMeasures-ParticipantPerformanceMeasureGoals-ParticipantGoalIntervalGoals-item-response
Type:
Show Source
object-
AlternateIntervalTarget1: number
Title:
Alternate Interval Target 1Read Only:trueDefault Value:0The alternate interval target for a measure, for example, stretch goal for an interval. -
AlternateIntervalTarget2: number
Title:
Alternate Interval Target 2Read Only:trueDefault Value:0The alternate interval target for a measure, for example, stretch goal for an interval. -
AlternateIntervalTarget3: number
Title:
Alternate Interval Target 3Read Only:trueDefault Value:0The alternate interval target for a measure, for example, stretch goal for an interval. -
AlternateIntervalTarget4: number
Title:
Alternate Interval Target 4Read Only:trueDefault Value:0The alternate interval target for a measure, for example, stretch goal for an interval. -
AlternateIntervalTarget5: number
Title:
Alternate Interval Target 5Read Only:trueDefault Value:0The alternate interval target for a measure, for example, stretch goal for an interval. -
CreatedBy: string
Read Only:
trueMaximum Length:64The user who created the interval goal. -
CreationDate: string
(date-time)
Read Only:
trueThe date and time when the interval goal is created. -
GoalId: integer
(int64)
Read Only:
trueThe unique identifier of the goal associated with the base compensation plan. The base plan is modeled by the plan administrator and is the source of the participant plan. -
IntervalGoalId: integer
(int64)
Title:
PeriodRead Only:trueThe unique identifier of the interval goal associated with the base compensation plan. The base plan is modeled by the plan administrator and is the source of the participant plan. -
IntervalNumber: number
Title:
PeriodRead Only:trueThe display number for the interval. -
IntervalTarget: number
Title:
Interval TargetRead Only:trueDefault Value:0The target number specified for the goal interval. -
LastUpdateDate: string
(date-time)
Read Only:
trueThe date and time when the interval is last updated. -
LastUpdatedBy: string
Read Only:
trueMaximum Length:64The user who last updated the interval goal. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
ParticipantGoalId: integer
(int64)
Read Only:
trueThe unique identifier of the goal. -
ParticipantIntervalGoalId: integer
(int64)
Read Only:
trueThe unique identifier of the participant interval goal details.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : participantCompensationPlans-ParticipantPlanComponents-ParticipantPlanComponentPerformanceMeasures-ParticipantPerformanceMeasureGoals-ParticipantGoalPeriodGoals-item-response
Type:
Show Source
object-
AlternateITDTarget1: number
Title:
Alternate ITD Target 1Read Only:trueDefault Value:0The alternate interval-to-date target number for a measure. -
AlternateITDTarget2: number
Title:
Alternate ITD Target 2Read Only:trueDefault Value:0The alternate interval-to-date target number for a measure. -
AlternateITDTarget3: number
Title:
Alternate ITD Target 3Read Only:trueDefault Value:0The alternate interval-to-date target number for a measure. -
AlternateITDTarget4: number
Title:
Alternate ITD Target 4Read Only:trueDefault Value:0The alternate interval-to-date target number for a measure. -
AlternateITDTarget5: number
Title:
Alternate ITD Target 5Read Only:trueDefault Value:0The 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. -
AlternatePeriodTarget2: number
Title:
Alternate Period Target 2Default Value:0The alternate period target number 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. -
AlternatePeriodTarget4: number
Title:
Alternate Period Target 4Default Value:0The alternate period target number 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. -
CreatedBy: string
Read Only:
trueMaximum Length:64The user who created the period goal. -
CreationDate: string
(date-time)
Read Only:
trueThe date and time when the period goal is created. -
GoalId: integer
(int64)
Read Only:
trueThe unique identifier of the goal associated with the base compensation plan. The base plan is modeled by the plan administrator and is the source of the participant plan. -
IntervalGoalId: integer
(int64)
Read Only:
trueThe unique identifier of the interval goal associated with the base compensation plan. The base plan is modeled by the plan administrator and is the source of the participant plan. -
ITDTarget: number
Title:
ITD TargetRead Only:trueDefault Value:0The interval-to-date target number for a measure. -
LastUpdateDate: string
(date-time)
Read Only:
trueThe date and time when the period goal is last updated. -
LastUpdatedBy: string
Read Only:
trueMaximum Length:64The user who last updated the period goal. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
ParticipantGoalId: integer
(int64)
Read Only:
trueThe unique identifier of the goal. -
ParticipantIntervalGoalId: integer
(int64)
Read Only:
trueThe unique identifier of the participant interval goal details. -
ParticipantPeriodGoalId: integer
(int64)
Read Only:
trueThe unique identifier of the period goal. -
PeriodEndDate: string
(date)
Title:
End DateRead Only:trueThe date when the period of time ends. -
PeriodGoalId: integer
(int64)
Read Only:
trueThe unique identifier of the period goal associated with the base compensation plan. The base plan is modeled by the plan administrator and is the source of the participant plan. -
PeriodId: integer
(int64)
Title:
PeriodRead Only:trueThe unique identifier for the period of time defined in the calendar. -
PeriodName: string
Title:
PeriodRead Only:trueMaximum Length:30The name for a period of time defined in the calendar. -
PeriodStartDate: string
(date)
Title:
Start DateRead Only:trueThe date when the period of time begins. -
PeriodTarget: number
Title:
Period TargetDefault Value:0The period target number for a measure.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Links
- ParticipantGoalIntervalGoals
-
Parameters:
- ParticipantGoalId:
$request.path.ParticipantGoalId - ParticipantPerformanceMeasureId:
$request.path.ParticipantPerformanceMeasureId - ParticipantPlanComponentId:
$request.path.ParticipantPlanComponentId - participantCompensationPlansUniqID:
$request.path.participantCompensationPlansUniqID
The performance measure interval goals service is used to view the interval target amounts for a participant performance measure that can be individualized. You enable individualization for a performance measure by setting the Individualize option to Yes for the related participant plan component. - ParticipantGoalId:
- ParticipantGoalPeriodGoals
-
Parameters:
- ParticipantGoalId:
$request.path.ParticipantGoalId - ParticipantPerformanceMeasureId:
$request.path.ParticipantPerformanceMeasureId - ParticipantPlanComponentId:
$request.path.ParticipantPlanComponentId - participantCompensationPlansUniqID:
$request.path.participantCompensationPlansUniqID
The performance measure period goals service is used to view and update the period target amounts for a participant performance measure that can be individualized. You enable individualization for a performance measure by setting the Individualize option to Yes for the related participant plan component. - ParticipantGoalId: