Load Goal Data with HCM Data Loader
Load Goal Data with HCM Data Loader
Oracle Fusion Human Capital Management 11g Release 11 Update 12 and Later
O R A C L E TECHNICAL BRIEF | DECEMBER 2016
Table of Contents
Introduction 1
How to Use the Information in This Document 1
Example Dat Files 2
Supported Business Scenarios 3
Considerations and Prerequisites for Goal 4
Loading Goal 4
Goal 4
Goal Action 9
Goal Plan Goal 11
Goal Target Outcome 13
Goal Measurement 15
Goal Access 18
Goal Alignment 19
Goal Errors 20
Deletion Support for Goal 23
Deleting Goal Dat File Examples 24
Considerations and Prerequisites for Goal Plan 25
Loading Goal Plan 25
Goal Plan 25
Goal Plan Dat File Examples 27
Goal Plan Goal 27
Goal Dat File Examples 29
Goal Plan Document Type 30
Goal Plan Dat File Examples 30
Mass Request 31
Goal Plan Dat File Examples 32
Eligibility Profile Object 32
Goal Plan Dat File Examples 33
Mass Request Assignment 34
Goal Plan Dat File Examples 34
Table of Figures
Figure 1: Goal (Goal Details) .................................................................................................................................... 8
Figure 2: Goal Action (Goal Details) ....................................................................................................................... 10
Figure 3: Goal Plan Goal ........................................................................................................................................ 12
Figure 4: Goal Target Outcome (Goal Details) ....................................................................................................... 15
For general information about preparing data for loading using HCM Data Loader or the HCM Data
Loader file format, see the HCM Data Loader User’s Guide (MOS Doc ID: 1664133.1).
HCM Data Loader Attribute The attribute name to supply when providing your data in the
business object data (.dat) file. Attribute names with a *1 suffix are foreign-object references
that support the integration key types. As source keys are recommended where possible, the
document describes how to supply source key values. User key attributes are identified for
when you do not have the source key value.
User Interface Prompt The prompt seen on the user interface. The data that you supply in
the associated attribute derives this field value, which is not necessarily the same as the value
that you supply. For example, for the Location field on an Organization page you can supply
the Oracle Fusion surrogate ID, source key, or Oracle Fusion GUID to identify the location
uniquely. The value seen on the user interface will be the location name.
If the User Interface Prompt is prefixed with an asterisk (*), then the attribute is mandatory
when you create a new record.
Functional Description Additional information describing the attribute and how to supply
valid values.
Errors Identifies errors that may occur when loading data for the business object. Information
about resolving the error is provided.
Deletion Support Describes the extent to which the business object supports data deletion. Some
objects do not support deletion, while others may support deletion of child records only.
Translation Information on how to provide translation data for the translatable attributes in the
business object hierarchy.
For both user key and source key examples, ensure any references to foreign objects refer to data that
exists in your test environment.
Load Library Goals 1. Content Item Library goals are loaded as Content Items.
Load Organization Goals 1. Person (Line Manager) Person refers to the organization owner.
2. Organization Goal plans are required.
3. Goal Plan
4. Goal
Load Goal Plans 1. Goal Goal plan objects can reference template
2. Assignment (Worker) goals.
3. Person (Worker) Primary worker job assignments are required if
4. Eligibility Profile workers and managers are referenced.
5. Organization
6. Goal Plan Doc Type Organizations are required for organization
7. Goal Plan goal plans.
Review periods must exist in the database
before uploading associated goal plans.
Goal Plan Document Type entry is required in
the [Link] file when the
IncludeInPerfDoc flag has value of Y.
Load Goal Plan Sets 1. Goal Plan Goal plan set objects can reference goal
2. Person (Worker) plans.
3. Assignment (Worker) Primary worker job assignments are required if
4. Eligibility Profile workers and managers are referenced.
5. Goal Plan Set
Review periods must exist in the database
before uploading associated goal plan sets.
Load Worker Performance 1. Assignment (Worker) Goal supports references to library goals.
Goals 2. Person (Worker) Worker performance goals must be associated
3. Goal Plan with goal plans.
4. Content Item
5. Goal
Load Worker Development 1. Person (Worker) Worker development goals are not associated
Goals 2. Content Item with goal plans.
3. Goal
Goal
Goals represent objectives of employees and organizations and can be used as templates for other goals. Goals
can have tasks and desired outcomes; achievement of goals can be measured. Employees can share their goals
with other employees; they can also align their goals with other employee and organization goals. Goals can be
associated with goal plans. The load use cases for goal are listed in the Supported Business Scenarios section
above and they are Load Template Goals, Load Organization Goals, Load Worker Performance Goals, and Load
For more information on goals and their types, see the help topic Goal Management: Explained in Oracle
Applications Help at [Link]
Library Goals are stored and loaded as Profile Content Items. Loading of Profile Content Items is not covered in this
document. Library Goals however can be referenced in Goal objects as described below in the Goal section.
Loading Goal
Goal data must be supplied in the [Link] file for processing by HCM Data Loader.
GOAL HIERARCHY
Goal Plan Goal Details of relationships between goals and goal plans. GoalPlanGoal
Used in Load Worker Performance Goals and Load Organization Goals cases.
Goal Measurement Details of single and multiple measurements associated with a goal. GoalMeasurement
Only single measurement can be defined for a development goal.
Goal
The Goal component holds the main information about a goal including its name, success criteria, completion
percentage, and other attributes.
GOAL ATTRIBUTES
SourceSystemId / * (not displayed) You must provide a unique reference for the record being created. In Release 11,
SourceSystemOwner user keys are not supported for this object. You must supply a source key to
provide a unique reference for the goal record.
GoalName * Goal Name The name of the goal. There is no unique requirement.
TargetCompletionDate Target Completion Date The target completion date for the goal.
Reference the assignment of the HR Specialist who is creating the goal plan that
will contain these goals.
If supplying user keys, then use the WorkerAssignmentNumber attribute.
This attribute also supports the integration key types. If you supplied a source key
for the assignment, then supply the same value here and append the source key
hint to the attribute name. For example, AssignmentId(SourceSystemId).
*1
OrganizationId * Department Used for the Load Organization Goals scenario only.
Unique ID that identifies the organization this goal is for. If supplying user keys,
then use the OrganizationName attribute.
This attribute also supports the integration key types. If you supplied a source key
for the organization, then supply the same value here and append the source key
hint to the attribute name. For example: OrganizationId(SourceSystemId).
PublishedFlag Published Used for the Load Organization Goals scenario only.
Indicates whether an organization goal is published to the organization. The
manager who owns the goal can set the flag using the goal action Publish in the
application.
PercentCompleteCode Completion Percentage Goal completion percentage code. This attribute is validated using the lookup
HRG_PERCENT_COMPLETE.
StatusCode * Status Status of the goal. This attribute is validated using the lookup
HRG_GOAL_STATUS
PriorityCode Priority Priority of the goal. This attribute is validated using the lookup HRG_PRIORITY.
*1
RequestorPersonId (not displayed) Unique ID that identifies the person requesting the goal. If supplying user keys,
then use the RequestorPersonNumber attribute.
This attribute also supports the integration key types. If you supplied a source key
for the person, then supply the same value here and append the source key hint to
the attribute name. For example, RequestorPersonId(SourceSystemId). This
attribute is not mandatory.
AssignedByPersonId *1 * derived as Organization Unique ID that identifies the person assigning the goal. If supplying user keys, then
Owner for Organization use the AssignedByPersonNumber attribute.
Goals and not displayed This attribute also supports the integration key types. If you supplied a source key
in other scenarios for the person, then supply the same value here and append the source key hint to
the attribute name. For example AssignedByPersonId(SourceSystemId).
MeasureCalcRuleCode Calculation Rule The calculation rule for aggregating measurements. This attribute is validated
using the lookup HRG_MEASURE_CALC_RULE.
The default rule SUM is applied if no value is specified.
*1
ReferenceContentItemId (not displayed) Holds a reference to a Library Goal (which is loaded as a Content Item). The
items must have already been loaded. If supplying user keys, then use the
ReferenceContentItemName attribute to pass the goal name of the Library Goal.
This attribute also supports the integration key types. If you supplied a source key
for the ContentItem, then supply the same value here and append the source key
hint to the attribute name. For example:
ReferenceContentItemId(SourceSystemId).
ReferenceGoalId (not displayed) Used in the Load Worker Goals scenario only.
If a worker goal is created from a shared goal or published organization goal, then
supply a unique ID to identify the referenced goal.
In Release 11, user keys are not supported. You need to supply a different key
type to identify uniquely the referenced goal. For example:
ReferenceGoaldId(SourceSystemId).
PublishDate (not displayed) Used in the Load Organization Goals scenario only.
The goal published date.
LevelCode Level The level code of the goal. This attribute is validated using the lookup
HRG_GOAL_MEASUREMENT_LEVEL.
IncludeInPerfdocFlag Enable Inclusion into Determines whether the goal must be included in performance documents of the
Performance Document worker. Accepts values Y, N, or null. Null is considered as N.
AllowKeyAttrUpdateFlag (not displayed) Determines whether the worker can update key attributes of the goal. Accepts
values Y, N, or null. Null value defaults to Y.
User key attributes that are required only if no other key type is supplied to identify uniquely the object they reference.
WorkerPersonNumber *Person Number Person number of the person the goal is for.
WorkerAssignmentNu *Assignment Number Assignment number of the assignment the goal is for.
mber
RequestorPersonNum (not displayed) Person number of the person who requested the goal.
ber
AssignedByPersonNu * derived as Organization Person number of the person who assigned the goal.
mber Owner for Organization
Goals and not displayed in
other scenarios
ReferenceContentItem (not displayed) The name of the referenced goal library goal.
Name
The value supplied will derive the value seen in the field specified in the User Interface Prompt.
*1
The foreign object references support use of all four key types: Oracle surrogate ID, Oracle GUID, source key, and user key.
In Release 11, user keys are not supported for the Goal object. You must supply a source key to provide a unique
reference for the goal record.
This file creates an active performance goal for a worker. The PersonId and AssignmentId attributes must
correspond to those of the worker. Alternatively, supply the user key attributes WorkerPersonNumber and
WorkerAssignmentNumber.
The AssignedByPersonId attribute must correspond to the HR specialist creating the goal. Alternatively, the user key
attribute AssignedByPersonNumber can be used.
For performance goals, GoalPlanGoal entry must also be part of the .dat file. For development goals, GoalPlanGoal
entry must not be specified.
METADATA|Goal|SourceSystemId|SourceSystemOwner|GoalName|Description|StartDate|Ta
rgetCompletionDate|WorkerPersonNumber|WorkerAssignmentNumber|StatusCode|GoalSour
ceCode|AllowKeyAttrUpdateFlag|IncludeInPerfdocFlag|AssignedByPersonNumber
MERGE|Goal|WorkerGoal_001_SSID|VISION|WorkerGoal_001|WorkerGoal_001_Desc|2015/01
/01|2015/12/31|8153787|EEEE8153787|Not started|HR|Y|Y|8153756
METADATA|GoalPlanGoal|SourceSystemId|SourceSystemOwner|GoalId(SourceSystemId)|Go
This file creates an active performance goal against a library goal for a worker. Currently HCM Data Loader does not
default the attributes from the library goal. You must supply these values for the worker goal.
METADATA|Goal|SourceSystemId|SourceSystemOwner|GoalName|Description|StartDate|Ta
rgetCompletionDate|WorkerPersonNumber|WorkerAssignmentNumber|StatusCode|GoalSour
ceCode|AllowKeyAttrUpdateFlag|IncludeInPerfdocFlag|AssignedByPersonNumber|Refere
nceContentItemName
MERGE|Goal|WorkerGoal_002_SSID|VISION|WorkerGoal_002|WorkerGoal_002_Desc|2015/01
/01|2015/12/31|8153787|EEEE8153787|Not started|HR|Y|Y|8153756|ZHRG-Completing
Learning Path
This file creates an organization goal for a line manager belonging to the organization Vision Corporation Enterprise.
The AssignedByPersonId attribute must correspond to the line manager who owns the organization goal.
Alternatively use the user key attribute AssignedByPersonNumber. If you want to publish the organization goal
while loading, set the PublishedFlag attribute to Y.
METADATA|Goal|SourceSystemId|SourceSystemOwner|GoalName|Description|StartDate|Ta
rgetCompletionDate|OrganizationName|StatusCode|GoalSourceCode|AllowKeyAttrUpdate
Flag|AssignedByPersonNumber|PublishedFlag
MERGE|Goal|OrganizationGoal_001_SSID|VISION|OrganizationGoal_001|OrganizationGoa
l_001_Desc|2015/01/01|2015/12/31|Vision Corporation Enterprise|Not
started|Organization owner|Y|8153786|Y
METADATA|GoalPlanGoal|SourceSystemId|SourceSystemOwner|GoalId(SourceSystemId)|Go
alPlanName|GoalPlanStartDate|GoalPlanEndDate|PriorityCode
MERGE|GoalPlanGoal|GoalPlanGoal_002_SSID|VISION|OrganizationGoal_001_SSID
|GP_009_01|2015/01/01|2015/12/31|Medium
Goal Action
The Goal Action component holds details of tasks defined for the goal.
The discriminator GoalAction is used to load goal task records using HCM Data Loader. The following GoalAction
attributes are commonly supplied when loading a new goal task.
SourceSystemId / * (not displayed) You must provide a unique reference for the record being created. In Release 11,
SourceSystemOwner user keys are not supported for this object. You must supply a source key to
provide a unique reference for the goal action record.
*1
GoalId * (not displayed) You must provide a unique reference for the goal this action is for. In Release 9,
user keys are not supported for this reference. You must supply the source key
used for the goal record. When supplying source key values remember to append
the source key hint to the attribute name. For example: GoalId(SourceSystemId).
ActionTypeCode * Type The type of goal task. This attribute is validated using the lookup
HRG_GOAL_TASK_TYPE.
PriorityCode Priority The priority of the goal task. This attribute is validated using the lookup
HRG_PRIORITY.
TargetCompletionDate Target Completion Date The target date to achieve the goal task.
PercentCompleteCode Completion Percentage Goal completion percentage code. This attribute is validated using the lookup
HRG_PERCENT_COMPLETE.
StatusCode Status The action status. This attribute is validated using the lookup
HRG_GOAL_TASK_STATUS.
ActionUrl Related Link URL to launch a page related to the goal task.
The value supplied will derive the value seen in the field specified in the User Interface Prompt.
*1
The foreign object references support use of all four key types: Oracle surrogate ID, Oracle GUID, source key, and user key.
In Release 11, user keys are not supported for the GoalAction object. You must supply a source key to provide a
unique reference for the goal action record.
This file creates a worker goal with an action (task). While creating a performance goal, you must provide a goal
plan goal.
METADATA|Goal|SourceSystemId|SourceSystemOwner|GoalName|Description|StartDate|Ta
rgetCompletionDate|WorkerPersonNumber|WorkerAssignmentNumber|StatusCode|GoalSour
ceCode|AllowKeyAttrUpdateFlag|IncludeInPerfdocFlag|AssignedByPersonNumber
MERGE|Goal|WorkerGoal_001_SSID|VISION|WorkerGoal_001|WorkerGoal_001_Desc|2015/01
/01|2015/12/31|8153787|EEEE8153787|Not started|HR|Y|Y|8153756
METADATA|GoalAction|SourceSystemId|SourceSystemOwner|GoalId(SourceSystemId)|Acti
onName|ActionTypeCode|PriorityCode|StartDate|TargetCompletionDate|PercentComplet
eCode|StatusCode|ActionUrl|Comments
MERGE|GoalAction|GoalAction_001_SSID|VISION|WorkerGoal_001_SSID|GoalAction_001|C
oaching|Medium|2015/01/01|2015/12/31|0|Not
started|[Link] for task
METADATA|GoalPlanGoal|SourceSystemId|SourceSystemOwner|GoalId(SourceSystemId)|Go
alPlanName|GoalPlanStartDate|GoalPlanEndDate|PriorityCode
MERGE|GoalPlanGoal|GoalPlanGoal_003_SSID|VISION|WorkerGoal_001_SSID|GP_009_01|20
15/01/01|2015/12/31|Medium
The discriminator GoalPlanGoal is used to load goal plan records using HCM Data Loader. The following
GoalPlanGoal attributes are commonly supplied when loading a new goal plan goal.
The goal plan goal component is mandatory while creating performance goals. GoalPlanGoal records can be
passed through HCM Data Loader to associate a Worker or Organization goal to goal plans that do not have
autoassociation enabled or to update or delete existing records. This component is not required for developmental
goals and must not be provided.
SourceSystemId / * (not displayed) You must provide a unique reference for the record being created. In Release 11,
SourceSystemOwner user keys are not supported for this object. You must supply a source key to provide
a unique reference for the goal plan goal record.
GoalId *1 * (not displayed) You must provide a unique reference for the goal this plan goal is for. In Release 11,
user keys are not supported for this reference. You must supply the source key used
for the goal record. When supplying source key values remember to append the
source key hint to the attribute name. For example: GoalId(SourceSystemId).
PriorityCode Priority The priority of the goal. This attribute is validated using the lookup HRG_PRIORITY.
Weighting Weight The weight or importance of a goal relative to other goals in the same goal plan.
Expressed as a percentage. Mandatory if the goal plan enforces the 100% sum of
weights rule.
GoalPlanId *1 * Goal Plan Name The unique reference to the goal plan this goal is associated with. If using user keys,
* Start Date then supply the user key attributes GoalPlanName, GoalPlanStartDate, and
GoalPlanEndDate.
* End Date
This attribute also supports the integration key types. If you supplied a source key for
the Goal Plan, then supply the same value here and append the source key hint to
the attribute name. For example: GoalPlanId(SourceSystemId).
GoalPlanSetExternalld Shown within brackets in the The unique reference to the goal plan set associated with the goal plan that includes
“Goal Plan” section if a goal the goal.
plan is included in a goal
plan set.
User key attributes that are required only if no other key type is supplied to identify uniquely the object they reference.
The value supplied will derive the value seen in the field specified in the User Interface Prompt.
*1
The foreign object references support use of all four key types: Oracle Fusion surrogate ID, Oracle Fusion GUID, source key, and
user key.
In Release 11, user keys are not supported for the GoalPlanGoal object. You must supply a source key to provide a
unique reference for the goal plan goal record.
METADATA|Goal|SourceSystemId|SourceSystemOwner|GoalName|Description|StartDate|Ta
rgetCompletionDate|WorkerPersonNumber|WorkerAssignmentNumber|StatusCode|GoalSour
ceCode|AllowKeyAttrUpdateFlag|IncludeInPerfdocFlag|AssignedByPersonNumber
MERGE|Goal|WorkerGoal_001_SSID|VISION|WorkerGoal_001|WorkerGoal_001_Desc|2015/01
/01|2015/12/31|8153787|EEEE8153787|Not started|HR|Y|Y|8153756
METADATA|GoalPlanGoal|SourceSystemId|SourceSystemOwner|GoalId(SourceSystemId)|Go
alPlanName|GoalPlanStartDate|GoalPlanEndDate|PriorityCode
MERGE|GoalPlanGoal|GoalPlanGoal_001_SSID|VISION|WorkerGoal_001_SSID|GP_009_01|20
15/01/01|2015/12/31|Medium
The discriminator GoalTargetOutcome is used to load target outcome records using HCM Data Loader. The
following GoalTargetOutcome attributes are commonly supplied when loading a new goal.
SourceSystemId / * (not displayed) You must provide a unique reference for the record being created. In Release 11,
SourceSystemOwner user keys are not supported for this object. You must supply a source key to provide
a unique reference for the goal target outcome record.
GoalId *1 * (not displayed) You must provide a unique reference for the goal this target outcome is for. In
Release 11, user keys are not supported for this reference. You must supply the
source key used for the goal record. When supplying source key values remember to
append the source key hint to the attribute name. For example:
GoalId(SourceSystemId).
ContentItemId *1 * Content Item Type The unique reference to the content item for this target outcome. If using user keys,
* Content Item Name then supply the user key attributes ContentItemName and
ContentTypeContextName.
This attribute also supports the integration key types. If you supplied a source key for
the Content Item, then supply the same value here and append the source key hint
to the attribute name. For example: ContentId(SourceSystemId).
TargetRatingLevelId *1 Target Proficiency Level The first target rating level associated with this target outcome. If using user keys,
then supply the user key attributes ContentItemName, ContentTypeContextName,
and TargetRatingLevelCode.
(Used only for
Competencies and This attribute also supports the integration key types. If you supplied a source key for
Languages) the rating level, then supply the same value here and append the source key hint to
the attribute name. For example, TargetRatingLevelId(SourceSystemId).
TargetRatingLevelId2 *1 Target Proficiency Level The second target rating level associated with this target outcome. If using user
(Used only for Languages) keys, then supply the user key attributes ContentItemName,
ContentTypeContextName, and TargetRatingLevelCode2.
This attribute also supports the integration key types. If you supplied a source key for
the rating level, then supply the same value here and append the source key hint to
ContentSourceCode Source The source of the content referred to in the target outcome. This attribute is validated
using the lookup HRG_TARGET_OUTCOME_SOURCE.
User key attributes that are required only if no other key type is supplied to identify uniquely the object they reference.
TargetRatingLevelCode Target Proficiency Level The code for the first target rating level.
Reading – for Languages
TargetRatingLevelCode2 Writing – for Languages The code for the second target rating level.
TargetRatingLevelCode3 Speaking – for Languages The code for the third target rating level.
The value supplied will derive the value seen in the field specified in the User Interface Prompt.
*1
The foreign object references support use of all four key types: Oracle surrogate ID, Oracle GUID, source key, and user key.
In Release 11 user keys are not supported for the GoalTargetOutcome object. You must supply a source key to
provide a unique reference for the goal target outcome record.
This file creates a worker goal with a target outcome. You must provide a goal plan goal attribute while creating a
performance goal.
METADATA|Goal|SourceSystemId|SourceSystemOwner|GoalName|Description|StartDate|Ta
rgetCompletionDate|WorkerPersonNumber|WorkerAssignmentNumber|StatusCode|GoalSour
ceCode|AllowKeyAttrUpdateFlag|IncludeInPerfdocFlag|AssignedByPersonNumber
MERGE|Goal|WorkerGoal_001_SSID|VISION|WorkerGoal_001|WorkerGoal_001_Desc|2015/01
/01|2015/12/31|8153787|EEEE8153787|Not started|HR|Y|Y|8153756
METADATA|GoalTargetOutcome|SourceSystemId|SourceSystemOwner|GoalId(SourceSystemI
d)|ContentItemName|ContentTypeContextName|Comments|TargetRatingLevelCode|Content
SourceCode
MERGE|GoalTargetOutcome|GoalTargetOutcome_001_SSID|VISION|WorkerGoal_001_SSID|Co
aching|COMPETENCY|Gives timely and constructive feedback, and helpful
suggestions to improve or develop new skills and behaviors|5|Content library
METADATA|GoalPlanGoal|SourceSystemId|SourceSystemOwner|GoalId(SourceSystemId)|Go
alPlanName|GoalPlanStartDate|GoalPlanEndDate|PriorityCode
MERGE|GoalPlanGoal|GoalPlanGoal_001_SSID|VISION|WorkerGoal_001_SSID|GP_009_01|20
15/01/01|2015/12/31|Medium
Goal Measurement
The discriminator GoalMeasurement is used to load goal measurement records using HCM Data Loader. The
following GoalMeasurement attributes are commonly supplied when loading a new goal.
SourceSystemId / * (not displayed) You must provide a unique reference for the record being created. In Release 11,
SourceSystemOwner user keys are not supported for this object. You must supply a source key to provide
a unique reference for the goal measurement record.
GoalId *1 * (not displayed) You must provide a unique reference for the goal this goal measurement is for. In
Release 11, user keys are not supported for this reference. You must supply the
source key used for the goal record. When supplying source key values, remember
to append the source key hint to the attribute name. For example:
GoalId(SourceSystemId).
MeasureTypeCode *Quantitative or The type of the measurement, which can be either quantitative or qualitative. This
Qualitative (not attribute is validated using the lookup HRG_GOAL_MEASUREMENT_TYPE.
displayed )
UomCode Unit of Measurement The unit of measurement. This attribute is validated using the lookup
HRG_GOAL_QUANTITATIVE_UOM.
TargetType Target Type The target type of the measurement. This attribute is validated using the lookup
HRG_GOAL_QUANT_MEASURE_TYPE.
DisplaySequence Sequence Number The display sequence of the measurement as seen in the user interface.
The value supplied will derive the value seen in the field specified in the User Interface Prompt.
*1
The foreign object references support use of all four key types: Oracle surrogate ID, Oracle GUID, source key, and user key.
In Release 11, user keys are not supported for the GoalMeasurement object. You must supply a source key to
provide a unique reference for the goal measurement record.
This file creates a worker goal with a goal measurement. You must provide a goal plan goal attribute while creating
a performance goal.
METADATA|Goal|SourceSystemId|SourceSystemOwner|GoalName|Description|StartDate|Ta
rgetCompletionDate|WorkerPersonNumber|WorkerAssignmentNumber|StatusCode|GoalSour
ceCode|AllowKeyAttrUpdateFlag|IncludeInPerfdocFlag|AssignedByPersonNumber
MERGE|Goal|WorkerGoal_001_SSID|VISION|WorkerGoal_001|WorkerGoal_001_Desc|2015/01
/01|2015/12/31|8153787|EEEE8153787|Not started|HR|Y|Y|8153756
METADATA|GoalMeasurement|SourceSystemId|SourceSystemOwner|GoalId(SourceSystemId)
|MeasurementName|MeasureTypeCode|UomCode|TargetType|TargetValue|StartDate|EndDat
e|DisplaySequence|Comments
MERGE|GoalMeasurement|GoalMeasurement_001_SSID|VISION|WorkerGoal_001_SSID|GoalMe
asurement_001|Quantitative|Currency|Minimum|100|2015/01/01|2015/12/31|1|GoalMeas
urement_001_Comments
METADATA|GoalPlanGoal|SourceSystemId|SourceSystemOwner|GoalId(SourceSystemId)|Go
alPlanName|GoalPlanStartDate|GoalPlanEndDate|PriorityCode
MERGE|GoalPlanGoal|GoalPlanGoal_004_SSID|VISION|WorkerGoal_001_SSID|GP_009_01|20
15/01/01|2015/12/31|Medium
The discriminator GoalAccess is used to load goal-sharing records using HCM Data Loader. The following
GoalAccess attributes are commonly supplied when loading a new goal sharing record.
SourceSystemId / * (not displayed) You must provide a unique reference for the record being created. In Release 11,
SourceSystemOwner user keys are not supported for this object. You must supply a source key to
provide a unique reference for the goal access record.
GoalId *1 * (not displayed) You must provide a unique reference for the goal this goal access is for. In Release
11, user keys are not supported for this reference. You must supply the source key
used for the goal record. When supplying source key values, remember to append
the source key hint to the attribute name. For example: GoalId(SourceSystemId).
PersonId *1 * Name You must provide a unique reference to the person that the goal is shared with. If
supplying user keys, then use the GoalAccessPersonNumber attribute. This
attribute also supports the integration key types. If you supplied a source key for the
person, then supply the same value here and append the source key hint to the
attribute name. For example: PersonId(SourceSystemId).
GoalActionAccessFlag Share tasks The flag that indicates whether the goal tasks must be accessible by the referenced
person.
User key attributes that are required only if no other key type is supplied to identify uniquely the object they reference.
GoalAccessPersonNu Name The number of the person the goal is shared with.
mber
The value supplied will derive the value seen in the field specified in the User Interface Prompt.
*1
The foreign object references support use of all four key types: Oracle surrogate ID, Oracle GUID, source key, and user key.
In Release 11, user keys are not supported for the GoalAccess object. You must supply a source key to provide a
unique reference for the goal access record.
This file creates a worker goal with a goal access record to share the goal (along with the corresponding task) with
another worker. You must provide a goal plan goal attribute while creating a performance goal.
METADATA|Goal|SourceSystemId|SourceSystemOwner|GoalName|Description|StartDate|Ta
rgetCompletionDate|WorkerPersonNumber|WorkerAssignmentNumber|StatusCode|GoalSour
ceCode|AllowKeyAttrUpdateFlag|IncludeInPerfdocFlag|AssignedByPersonNumber
MERGE|Goal|WorkerGoal_001_SSID|VISION|WorkerGoal_001|WorkerGoal_001_Desc|2015/01
/01|2015/12/31|8153787|EEEE8153787|Not started|HR|Y|Y|8153756
METADATA|GoalAccess|SourceSystemId|SourceSystemOwner|GoalId(SourceSystemId)|Goal
AccessPersonNumber|GoalActionAccessFlag
MERGE|GoalAccess|GoalAccess_001_SSID|VISION|WorkerGoal_001_SSID|8153794|Y
METADATA|GoalPlanGoal|SourceSystemId|SourceSystemOwner|GoalId(SourceSystemId)|Go
alPlanName|GoalPlanStartDate|GoalPlanEndDate|PriorityCode
MERGE|GoalPlanGoal|GoalPlanGoal_002_SSID|VISION|WorkerGoal_001_SSID|GP_009_01|20
15/01/01|2015/12/31|Medium
Goal Alignment
The Goal Alignment component holds a reference to a goal with which the goal is aligned.
The discriminator GoalAlignment is used to load goal access alignment using HCM Data Loader. The following
GoalAlignment attributes are commonly supplied when loading a new goal alignment.
SourceSystemId / * (not displayed) You must provide a unique reference for the record being created. In Release 11,
SourceSystemOwner user keys are not supported for this object. You must supply a source key to
provide a unique reference for the goal alignment record.
GoalId *1 * (not displayed) You must provide a unique reference for the goal this goal alignment is for. In
Release 11, user keys are not supported for this reference. You must supply the
source key used for the goal record. When supplying source key values, remember
to append the source key hint to the attribute name. For example:
GoalId(SourceSystemId).
AlignedGoalId *1 * Aligned to Goal You must provide a unique reference for the alignment goal. In Release 11, user
keys are not supported for this reference. You must supply the source key used for
the goal record. When supplying source key values, remember to append the
source key hint to the attribute name. For example:
AlignedGoalId(SourceSystemId).
The value supplied will derive the value seen in the field specified in the User Interface Prompt.
*1
The foreign object references support use of all four key types: Oracle surrogate ID, Oracle GUID, source key, and user key.
In Release 11, user keys are not supported for the GoalAlignment object. You must supply a source key to provide a
unique reference for the goal alignment record.
This file creates a worker goal with an alignment record to align the goal with the organization goal.
Note: The organization goal must already exist in the Oracle HCM Cloud before a goal alignment can be supplied to
reference it.
METADATA|Goal|SourceSystemId|SourceSystemOwner|GoalName|Description|StartDate|Ta
rgetCompletionDate|WorkerPersonNumber|WorkerAssignmentNumber|StatusCode|GoalSour
ceCode|AllowKeyAttrUpdateFlag|IncludeInPerfdocFlag|AssignedByPersonNumber
MERGE|Goal|WorkerGoal_001_SSID|VISION|WorkerGoal_001|WorkerGoal_001_Desc|2015/01
/01|2015/12/31|8153787|EEEE8153787|Not started|HR|Y|Y|8153756
METADATA|GoalAlignment|SourceSystemId|SourceSystemOwner|GoalId(SourceSystemId)|A
lignedGoalId(SourceSystemId)
MERGE|GoalAlignment|GoalAlignment_001_SSID|VISION|WorkerGoal_001_SSID|Organizati
onGoal_001_SSID
Goal Errors
You may experience errors while loading goals if the data is not provided as expected. Some of the more commonly
occurring errors are:
Error Resolution
The assigned by person ID does not Ensure that the value passed for the AssignedByPersonId attribute is valid.
exist.
The requester person ID does not exist. Ensure that the value passed for the RequestorPersonId attribute is valid.
The goal does not exist in the goal Ensure that the value passed for the ReferenceContentItemId attribute is valid. Also, note that
library. ReferenceGoalId must not be passed when ReferenceContentItemId is passed.
The reference goal does not exist. Ensure that the value passed for the ReferenceGoalId attribute is valid. Also, note that
ReferenceContentItemId must not be passed when ReferenceGoalId is passed.
The assignment does not exist. Ensure that the value passed for the AssignmentId attribute is valid.
Development goals and personal goals IncludeInPerfdocFlag must be set to Y for Performance Goals only.
cannot be included in performance
documents.
Development goals and personal goals While creating Organization goals, GoalTypeCode must be set to PERFORMANCE or null.
cannot be created as organization
goals.
The goal cannot be published because The PublishedFlag attribute can be set to Y for Organization goals only.
it is not an organization goal.
Development goals or personal goals GoalAlignment records can be passed in the [Link] file for Performance goals only.
cannot be aligned with other goals.
This action cannot be performed Ensure that the profile option HRG_ENABLE_PERFORMANCE_GOAL is set to Y to enable
because the use of the Performance creation of Performance goals.
goal type is not enabled.
No actions can be performed on Ensure that the profile option HRG_ENABLE_DEVELOPMENT_GOAL is set to Y to enable
development goals because the use of creation of Development goals.
development goals is not enabled.
The target completion date must be Ensure that the TargetCompletionDate on the goal is later than or equal to the StartDate on the
later or equal to the start date. goal. Also, ensure that the ActualCompletionDate on the goal is later than or equal to the Start
Date.
Failed to validate a row with key … in Ensure that the GoalSourceCode is being passed as Organization owner while creating
GoalEO” error while creating an Organization goals.
Organization goal.
You must provide a value for the person The PersonId column on the goal is mandatory for Worker goals and Template goals.
ID.
The person ID does not match the Ensure that the PersonId and AssignmentId values on the goal are valid together.
assignment ID. Enter a new person ID
or assignment ID and try again.
An assignment ID or organization ID is AssignmentId is mandatory for Worker goals and Template goals. OrganizationId is mandatory
required to create a performance goal. for Organization goals.
A value for either the assignment ID or AssignmentId is mandatory for Worker goals and Template goals. OrganizationId is mandatory
organization ID must be entered, not for Organization goals. Both attributes cannot be populated for the same goal.
both.
The actual completion date must be The ActualCompletionDate cannot be a future date. It must be earlier than or equal to the current
earlier than or equal to {TODAY’S date.
DATE}.
You cannot save this goal until it is Goal Plan association with the goal is required. Add goal plan goal entry to the [Link] file.
GoalAction:
Error Resolution
Date error while loading GoalAction Ensure that the TargetCompletionDate on the goal action is later than or equal to the StartDate
record. on the goal action.
The goal task start date and end dates As the message states, the goal task start date and end dates must be later than or equal to the
must be later than or equal to the goal goal start date and earlier than or equal to the goal target completion date.
start date and earlier than or equal to
the goal target completion date.
Goal tasks cannot be created because Enable goal tasks by setting the profile option HRG_ENABLE_TASK.
the use of goal tasks is not enabled.
GoalPlanGoal:
Error Resolution
The same goal type must be used for Ensure that the GoalPlanId specified on the GoalPlanGoal row is of the same type (Performance
both the goal and the goal plan. or Development) as the goal.
Goal Weights cannot be assigned The weighting attribute cannot be populated on the GoalPlanGoal record unless weights are
because the use of goal weighting is not enabled for the Goal Plan.
enabled.
The goal cannot be assigned because it Ensure that the goal plan is assigned to the worker before creating a GoalPlanGoal record to
belongs to a goal plan that is not assign the goal to the goal plan.
assigned to the worker.
This action cannot be performed Enable Performance Goal Plans by setting the profile option HRG_USE_PERF_GOAL_PLANS.
because the use of performance goal
plans is not enabled.
This action cannot be performed Enable Development Goal Plans by setting the profile option HRG_USE_DEV_GOAL_PLANS.
because the use of development goal
plans is not enabled.
GoalTargetOutcome:
Error Resolution
The content item does not exist. Ensure that the value passed for the ContentItemId is valid.
Goal target outcomes cannot be Enable goal target outcomes by setting the profile option HRG_ENABLE_OUTCOMES.
created because the use of goal target
outcomes is not enabled.
GoalMeasurement:
Error Resolution
The measurement end date must be Ensure that the EndDate on the measurement is later than or equal to the StartDate on the
later than or equal to measurement start measurement.
date.
GoalAccess:
Error Resolution
The goals cannot be shared because Ensure that the value passed for the PersonId attribute is valid.
the person ID of a person with whom
the goals are shared does not exist.
Enter another person ID and try again.
The goal is already shared with A goal can be shared with a person once only. Check the PersonId attribute and ensure that the
{PERSON _NAME}. goal is not already shared with that person.
Goals cannot be shared because the Enable shared goals by setting the profile option HRG_ENABLE_GRANT_ACCESS.
use of shared goals is not enabled.
GoalAlignment:
Error Resolution
You cannot align the goal A goal can be aligned once only.
{SOURCE_GOAL} because it is already
aligned to the goal {ALIGNED_GOAL}.
The goal to which you are aligning the Ensure that the value passed for AlignedGoalId column is valid.
performance goal does not exist.
Development goals or personal goals Only performance goals can be aligned with other goals.
cannot be aligned with other goals.
Goals cannot be aligned because the Enable alignment of goals by setting the profile option HRG_ENABLE_GOAL_ALIGN.
use of alignment goals is not enabled.
You cannot align the goal to the Ensure that there is no cyclic alignment between goals.
selected goal because the selected goal
is aligned to other goals in a hierarchy
that is aligned to the original goal.
The goal cannot be aligned because the Ensure that the goal to which the current goal is being aligned to is not canceled.
goal to which it is being aligned has the
status Canceled.
You must take care when using HCM Data Loader to delete records, as deleted records cannot be recovered. Do
not supply DELETE instructions in the same file as MERGE instructions.
When we delete a goal record using HCM Data Loader, the following child records are automatically deleted along
with the parent record:
Note: GoalMeasurement records are not automatically deleted when the parent goal is deleted using HCM Data
Loader. You must delete the GoalMeasurement records explicitly before deleting the parent goal.
Other child records can also be individually deleted using HCM Data Loader if needed.
Note: GoalMeasurement records are not automatically deleted when the parent goal is deleted using HCM Data
Loader. You need to explicitly pass a DELETE line for the same in the [Link] file.
[Link]
METADATA|GoalMeasurement|SourceSystemId|SourceSystemOwner|GoalId(SourceSystemId)
DELETE|GoalMeasurement|GoalMeasurement_001_SSID|VISION|WorkerGoal_001_SSID
[Link]
METADATA|Goal|SourceSystemId|SourceSystemOwner
DELETE|Goal|WorkerGoal_001_SSID|VISION
For more information on goal plans, see the help topic Goal Plans: Explained in Oracle Applications Help at
[Link]
The load process for Goal Plan loads goal plan objects but it does not run the actual assignment of the goal plans to
employees. The latter is done either in the application by HR or administrators when they schedule execution of goal
plan assignments using the Manage Goal Plans task or via HCM Data Loader using the GoalPlanAssignment
component of the GoalPlan object.
Goal Plan Goal Details of template goals included in the goal plan. GoalPlanGoal
Goal Plan Details of document types associated with the goal plan. GoalPlanDocTypes
Document Type
Mass Request Details of goal plan generation requests submitted by HR or an administrator. This MassRequest
component is mandatory while loading the full hierarchy.
Eligibility Profile Details of eligibility profiles attached to the goal plan. EligibilityProfileObject
Object
Mass Request Details or organizations associated with the goal plan. MassRequestAssignment
Assignment
Mass Request Details of workers and managers included in the goal plan. MassRequestHierarchy
Hierarchy
Mass Request Details of workers exempted from the goal plan. MassRequestExemption
Exemption
Goal Plan Details of worker or organizational assignments associated with the goal plan. GoalPlanAssignment
Assignment
Goal Plan
The discriminator GoalPlan is used to load goal plan records using HCM Data Loader. The following GoalPlan
attributes are commonly supplied when loading a new goal plan.
SourceSystemId / * External ID You must provide a unique reference for the record being created. Supply either a
SourceSystemOwner source key or the user key attribute GoalPlanExternalId.
IncludeInPerfdocFlag *Include in The flag that determines whether employee goals associated with this goal plan
Performance Document must be included in the employee performance document. The GoalPlanDocTypes
component is required when this flag is set to Y.
EnableWeightingFlag Enable Weight The flag that determines whether the weight feature must be enabled for goals
associated with this goal plan.
EnforceGoalWeightFlag Enforce Sum of Goal The flag that determines whether the sum of goal weights associated with this goal
Weights to 100% plan must be validated to be equal to 100%.
GoalAccessLevelCode *Allow Updates to This attribute is validated using the lookup HRG_GOAL_ACCESS_LEVELS.
Goals By
ReqSubmittedByPersonId *1 *(not displayed) Provide a unique reference to the person who would be creating the goal plan. If
using user keys, then supply the user key attribute
ReqSubmittedByPersonNumber.
This attribute also supports the integration key types. If you supplied a source key
for the referenced person, then supply the same value here and append the
source key hint to the attribute name. For example:
ReqSubmittedByPersonId(SourceSystemId).
This attribute is mandatory while creating new goal plans if the MassRequest
component is not being passed in the [Link] file.
RequestSubmissionDate *(not displayed) Provide the date when HR is creating this goal plan. This attribute is mandatory
while creating new goal plans if the MassRequest component is not being passed
in the [Link] file.
User key attributes that are only required if no other key type is supplied to uniquely identify the object they reference.
ReqSubmittedByPers *(not displayed) The person number of the person creating the goal plan.
onNumber
The value supplied will derive the value seen in the field specified in the User Interface Prompt.
*1
The foreign object references support use of all four key types: Oracle surrogate ID, Oracle GUID, source key, and user key.
[Link]
METADATA|GoalPlan|GoalPlanExternalId|GoalPlanName|GoalPlanTypeCode|GoalPlanActiv
eFlag|EnableWeightingFlag|StartDate|EndDate|EnforceGoalWeightFlag|GoalAccessLeve
lCode|IncludeInPerfdocFlag|ReqSubmittedByPersonNumber|RequestSubmissionDate|Revi
ewPeriodName
MERGE|GoalPlan|GP_001_01|GP_001_01|Performance|A|Y|2015/01/01|2015/12/31|Y|HR
specialist and manager|N|8153756|2015/09/20|Default Review Period - Vision
Corporation Enterprise
SourceSystemId / * (not displayed) You must provide a unique reference for the record being created. In Release 11
SourceSystemOwner user keys are not supported for this object. You must supply a source key to provide
a unique reference for the goal plan goal record.
GoalPlanId *1 * (not displayed) You must provide a unique reference for the goal plan this record is for. If using user
keys, then supply the user key attribute GoalPlanExternalId.
This attribute also supports the integration key types. If you supplied a source key for
the goal plan, then supply the same value here and append the source key hint to
the attribute name. For example: GoalPlanId(SourceSystemId).
GoalId *1 *Goal Name Provide a unique reference for the goal. In Release 11 user keys are not supported
for this object. You must supply a source key to provide a unique reference for the
goal.
PriorityCode Priority The priority of the goal in the goal plan. This attribute is validated using the lookup
HRG_PRIORITY.
Weighting Weight The weight of the goal in the goal plan. The weight value must be between zero and
one hundred. The type of this attribute is NUMBER (5, 2) and so it also supports
decimals.
User key attributes that are required only if no other key type is supplied to identify uniquely the object they reference.
GoalPlanExternalId External ID The external ID for the goal plan to which this goal plan goal belongs.
The value supplied will derive the value seen in the field specified in the User Interface Prompt.
*1
The foreign object references support use of all four key types: Oracle surrogate ID, Oracle GUID, source key, and user key.
[Link]
METADATA|Goal|SourceSystemId|SourceSystemOwner|GoalName|Description|StartDate|T
argetCompletionDate|WorkerPersonNumber|WorkerAssignmentNumber|PercentCompleteCo
de|StatusCode|GoalSourceCode|PrivateFlag|AllowKeyAttrUpdateFlag|IncludeInPerfdo
cFlag|AssignedByPersonNumber|GoalVersionTypeCode
MERGE|Goal|TemplateGoal_001_SSID|VISION|TemplateGoal_001|TemplateGoal_001|2015/
01/01|2015/12/31|8153756|EEEE8153756|0|Not started|HR
specialist|N|Y|Y|8153756|Mass request
METADATA|GoalPlanGoal|SourceSystemId|SourceSystemOwner|GoalPlanName|GoalPlanSta
rtDate|GoalPlanEndDate|GoalId(SourceSystemId)|PriorityCode|Weighting
MERGE|GoalPlanGoal|GPG_001_01_SSID|VISION|GP_001_01|2015/01/01|2015/12/31|Templ
ateGoal_001_SSID|Medium|0
The discriminator GoalPlanDocTypes is used to load goal plan document type records for a goal plan using HCM
Data Loader. The following GoalPlanDocTypes attributes are commonly supplied when loading a new goal plan.
SourceSystemId/SourceSystemOwner *(not displayed) You must provide a unique reference for the
record being created. You must supply a
source key to provide a unique reference for
the document type record.
GoalPlanId *1 *(not displayed) You must provide a unique reference for the
goal plan this record is for. If using user
keys, then supply the user key attribute:
GoalPlanExternalId
This attribute also supports the integration
key types. If you supplied a source key for
the goal plan, then supply the same value
here and append the source key hint to the
attribute name. For example:
GoalPlanId(SourceSystemId).
User key attributes that are required only if no other key type is supplied to identify uniquely the object they reference.
GoalPlanExternalId External ID The external ID for the goal plan this goal plan goal belongs to.
DocTypeName *Document Types The document type name this record belongs to
The value supplied will derive the value seen in the field specified in the User Interface Prompt.
*1
The foreign object references support use of all four key types: Oracle surrogate ID, Oracle GUID, source key, and user key.
[Link]
METADATA|GoalPlan|GoalPlanExternalId|GoalPlanName|GoalPlanTypeCode|GoalPlanActiv
eFlag|EnableWeightingFlag|StartDate|EndDate|EnforceGoalWeightFlag|GoalAccessLeve
lCode|IncludeInPerfdocFlag|ReqSubmittedByPersonNumber|RequestSubmissionDate|Revi
ewPeriodName
MERGE|GoalPlan|GP_001_02|GP_001_02|Performance|A|Y|2016/01/01|2016/12/31|Y|HR
specialist and manager|Y|8153756|2016/10/04|Default Review Period - Vision
Corporation Enterprise
METADATA|GoalPlanDocTypes|GoalPlanExternalId|DocTypeName
MERGE|GoalPlanDocTypes|GP_001_02|Annual Evaluations
The discriminator MassRequest is used to load goal plan mass request records using HCM Data Loader.
Customers must pass the MassRequest component explicitly if they want to associate a SourceSystemId to the
template mass request record, which they can use later for updating or deleting the subcomponents that define the
employee population or organization included in the goal plan.
While loading new goal plans, note that the components Mass Request Hierarchy, Mass Request Exemption, Mass
Request Assignment and Eligibility Profile Object cannot be present in the [Link] file without the parent Mass
Request component.
The following MassRequest attributes are commonly supplied when loading a new goal plan.
SourceSystemId / * (not displayed) You must provide a unique reference for the record being created. Supply either a
SourceSystemOwner source key or the user key attribute GoalPlanExternalId.
GoalPlanId *1 * (not displayed) You must provide a unique reference for the goal plan this record is for. If using user
keys, then supply the user key attribute GoalPlanExternalId.
This attribute also supports the integration key types. If you supplied a source key for
the goal plan, then supply the same value here and append the source key hint to
the attribute name. For example: GoalPlanId(SourceSystemId).
ReqSubmittedByPers * (not displayed) Provide a unique reference to the person who is creating the goal plan. If supplying
onId *1 user keys, then use the ReqSubmittedByPersonNumber attribute.
This attribute also supports the integration key types. If you supplied a source key for
the person, then supply the same value here and append the source key hint to the
attribute name. For example: ReqSubmittedByPersonId(SourceSystemId).
RequestSubmissionD (not displayed) Provide the date when HR is creating this goal plan. If this attribute is not passed, it
ate is defaulted to the current system date.
User key attributes that are required only if no other key type is supplied to identify uniquely the object they reference.
GoalPlanExternalId (not displayed) The external ID for the goal plan to which this goal plan goal belongs.
ReqSubmittedByPers (not displayed) The number of the person who is creating the goal plan.
onNumber
The value supplied will derive the value seen in the field specified in the User Interface Prompt.
This file creates a goal plan with a mass request. Note that the attributes ReqSubmittedByPersonId and
RequestSubmissionDate are not supplied for the GoalPlan component in this case
METADATA|GoalPlan|GoalPlanExternalId|GoalPlanName|GoalPlanTypeCode|GoalPlanActiv
eFlag|EnableWeightingFlag|StartDate|EndDate|EnforceGoalWeightFlag|GoalAccessLeve
lCode|IncludeInPerfdocFlag|ReviewPeriodName
MERGE|GoalPlan|GP_001_03|GP_001_03|Performance|A|Y|2016/01/01|2016/12/31|Y|HR
specialist and manager|N|Default Review Period - Vision Corporation Enterprise
METADATA|MassRequest|GoalPlanExternalId|ReqSubmittedByPersonNumber
MERGE|MassRequest|GP_001_03|8153756
The discriminator EligibilityProfileObject is used to load eligibility profile records for a goal plan using HCM Data
Loader. The following EligibilityProfileObject attributes are commonly supplied when loading a new goal plan.
SourceSystemId / * (not displayed) You must provide a unique reference for the record being created. Supply either a
SourceSystemOwner source key or the user key attributes EligibilityProfileName andGoalPlanExternalId.
ObjectId *1 * (not displayed) Provide a unique reference to the mass request this record belongs to. If using user
keys, then supply the user key attribute GoalPlanExternalId.
This attribute also supports the integration key types, if you supplied a source key for
the mass request, then supply the same value here and append the source key hint
to the attribute name. For example: ObjectId(SourceSystemId).
RequiredFlag Required The flag that determines whether this eligibility profile is required.
User key attributes that are required only if no other key type is supplied to identify uniquely the object they reference.
GoalPlanExternalId (not displayed) The external ID for the goal plan this eligibility profile object belongs to.
The value supplied will derive the value seen in the field specified in the User Interface Prompt.
This file creates a goal plan with eligibility criteria for the mass request.
METADATA|GoalPlan|GoalPlanExternalId|GoalPlanName|GoalPlanTypeCode|GoalPlanActiv
eFlag|EnableWeightingFlag|StartDate|EndDate|EnforceGoalWeightFlag|GoalAccessLeve
lCode|IncludeInPerfdocFlag|ReviewPeriodName
MERGE|GoalPlan|GP_001_04|GP_001_04|Performance|A|Y|2016/01/01|2016/12/31|Y|HR
specialist and manager|N|Default Review Period - Vision Corporation Enterprise
METADATA|MassRequest|GoalPlanExternalId|ReqSubmittedByPersonNumber
MERGE|MassRequest|GP_001_04|8153756
METADATA|EligibilityProfileObject|GoalPlanExternalId|EligibilityProfileName|Requ
iredFlag
MERGE|EligibilityProfileObject|GP_001_04|Goals_EligibilityProfile_Software
Developer 4|Y
This file creates the eligibility profile object for an existing goal plan and mass request.
METADATA|EligibilityProfileObject|GoalPlanExternalId|EligibilityProfileName|Requ
iredFlag
The discriminator MassRequestAssignment is used to load mass request assignment records for a mass request
within a goal plan using HCM Data Loader. The following MassRequestAssignment attributes are commonly
supplied when loading a new goal plan.
SourceSystemId / * (not displayed) You must provide a unique reference for the record being created. Supply either a
SourceSystemOwner source key or the user key attributes OrganizationName and GoalPlanExternalId.
OrganizationId *1 * Organization Name Provide a unique reference to the organization. If using user keys, then supply the
user key attribute OrganizationName.
Currently this attribute does not support the source key
MassRequestId *1 * (not displayed) Provide a unique reference to the mass request this record belongs to. If using user
keys, then supply the user key attribute GoalPlanExternalId.
This attribute also supports the integration key types. If you supplied a source key for
the mass request, then supply the same value here and append the source key hint
to the attribute name. For example: MassRequestId(SourceSystemId).
User key attributes that are required only if no other key type is supplied to identify uniquely the object they reference.
GoalPlanExternalId (not displayed) The external ID for the goal plan to which this eligibility profile object belongs.
The value supplied will derive the value seen in the field specified in the User Interface Prompt.
*1
The foreign object references support use of all four key types: Oracle surrogate ID, Oracle GUID, source key, and user key.
METADATA|GoalPlan|GoalPlanExternalId|GoalPlanName|GoalPlanTypeCode|GoalPlanActiv
eFlag|EnableWeightingFlag|StartDate|EndDate|EnforceGoalWeightFlag|GoalAccessLeve
lCode|IncludeInPerfdocFlag|ReviewPeriodName
MERGE|GoalPlan|GP_001_05|GP_001_05|Performance|A|Y|2016/01/01|2016/12/31|Y|HR
specialist and manager|N|Default Review Period - Vision Corporation Enterprise
METADATA|MassRequest|GoalPlanExternalId|ReqSubmittedByPersonNumber
MERGE|MassRequest|GP_001_05|8153756
METADATA|MassRequestAssignment|OrganizationName|GoalPlanExternalId
MERGE|MassRequestAssignment|Vision Corporation Enterprise|GP_001_05
This file creates a mass request assignment for a goal plan and mass request that already exist. Note: user keys
can be used in this case.
METADATA|MassRequestAssignment|OrganizationName|GoalPlanExternalId
MERGE|MassRequestAssignment|Vision Air|GP_001_05
The discriminator MassRequestHierarchy is used to load mass request hierarchy records for a goal plan using
HCM Data Loader. The following MassRequestHierarchy attributes are commonly supplied when loading a new
goal plan.
SourceSystemId / * (not displayed) You must provide a unique reference for the record being created. Supply either a
SourceSystemOwner source key or the user key attributes ManagerAssignmentNumber and
GoalPlanExternalId.
MassRequestId *1 * (not displayed) Provide a unique reference to the mass request this record belongs to. If using
user keys, then supply the user key attribute GoalPlanExternalId.
This attribute also supports the integration key types. If you supplied a source key
for the mass request, then supply the same value here and append the source key
hint to the attribute name. For example: MassRequestId(SourceSystemId).
ManagerAssignmentId Job Provide a unique reference to the manager assignment (or the worker assignment
*1
if the Cascading Level is Self). If using user keys, then supply the user key
attribute ManagerAssignmentNumber.
This attribute also supports the integration key types. If you supplied a source key
for the manager (or worker) assignment, then supply the same value here and
append the source key hint to the attribute name. For example:
ManagerAssignmentId(SourceSystemId).
ManagerId *1 Name Provide a unique reference to the manager (or the worker if the Cascading Level is
Self). If using user keys, then supply the user key attribute
ManagerAssignmentNumber.
This attribute also supports the integration key types. If you supplied a source key
for the manager (or worker), then supply the same value here and append the
source key hint to the attribute name. For example: ManagerId(SourceSystemId).
CascadingLevel Assignees Specific the type of hierarchy selection method. Provide one of the following
values (0,1, 999999,2 or 1000000):
0 - Self
1 - Direct reports
999999 - All reports
2 - Self and direct reports
1000000 - Self and all reports
User key attributes that are required only if no other key type is supplied to identify uniquely the object they reference.
GoalPlanExternalId External ID The external ID for the goal plan this eligibility profile object belongs to.
The value supplied will derive the value seen in the field specified in the User Interface Prompt.
*1
The foreign object references support use of all four key types: Oracle surrogate ID, Oracle GUID, source key, and user key.
This file creates a goal plan with a hierarchy for the mass request.
METADATA|GoalPlan|GoalPlanExternalId|GoalPlanName|GoalPlanTypeCode|GoalPlanActiv
This file creates a mass request hierarchy for a goal plan and mass request that already exist. Note: user keys can
be used in this case.
The discriminator MassRequestExemption is used to load mass request exemption records for a goal plan using
HCM Data Loader. The following MassRequestExemption attributes are commonly supplied when loading a new
goal plan.
SourceSystemId / * (not displayed) You must provide a unique reference for the record being created.
SourceSystemOwner
MassRequestHierarch *(not displayed) You must provide a unique reference for the mass request hierarchy this record is
yId *1 for. This attribute also supports the integration key types. If you supplied a source
key for the mass request hierarchy, then supply the same value here and append
the source key hint to the attribute name. For example:
MassRequestHierarchyId(SourceSystemId). If using user keys, then supply the user
key attributes GoalPlanExternalId and ManagerAssignmentNumber.
MassRequestId *1 (not displayed) Provide a unique reference for the mass request. If using user keys, then supply the
PersonId *1 * Name Provide a unique reference to the person who needs to be exempted from the goal
plan. If using user keys, then supply the user key attribute
WorkerAssignmentNumber.
This attribute also supports the integration key types. If you supplied a source key
for the person, then supply the same value here and append the source key hint to
the attribute name. For example: PersonId(SourceSystemId).
AssignmentId *1 * Job Provide a unique reference to the assignment of the person who needs to be
exempted from the goal plan. If using user keys, then supply the user key attribute
WorkerAssignmentNumber.
This attribute also supports the integration key types. If you supplied a source key
for the assignment, then supply the same value here and append the source key
hint to the attribute name. For example: AssignmentId(SourceSystemId).
User key attributes that are required only if no other key type is supplied to identify uniquely the object they reference.
GoalPlanExternalId (not displayed) The external ID for the goal plan to which this eligibility profile object belongs.
WorkerAssignmentNu Job (In the “Select or The assignment number for the worker.
mber deselect assignees” popup)
The value supplied will derive the value seen in the field specified in the User Interface Prompt.
*1
The foreign object references support use of all four key types: Oracle surrogate ID, Oracle GUID, source key, and user key.
This file creates a goal plan with a mass request exemption for the hierarchy
METADATA|GoalPlan|GoalPlanExternalId|GoalPlanName|GoalPlanTypeCode|GoalPlanActiv
eFlag|EnableWeightingFlag|StartDate|EndDate|EnforceGoalWeightFlag|GoalAccessLeve
lCode|IncludeInPerfdocFlag|ReviewPeriodName
MERGE|GoalPlan|GP_001_07|GP_001_07|Performance|A|Y|2016/01/01|2016/12/31|Y|HR
specialist and manager|N|Default Review Period - Vision Corporation Enterprise
METADATA|MassRequest|GoalPlanExternalId|ReqSubmittedByPersonNumber
MERGE|MassRequest|GP_001_07|8153756
COMMENT Assigning Worker to Goal Plan GP_001_07
METADATA|MassRequestHierarchy|GoalPlanExternalId|ManagerAssignmentNumber|Cascadi
ngLevel
MERGE|MassRequestHierarchy|GP_001_07|EEEE8153786|999999
COMMENT Excluding one worker from Goal Plan GP_001_07
METADATA|MassRequestExemption|GoalPlanExternalId|ManagerAssignmentNumber|WorkerA
ssignmentNumber
MERGE|MassRequestExemption|GP_001_07|EEEE8153786|EEEE8153787
Note: Do not pass a value for the MassRequestId attribute in this case as the value is automatically derived.
This file creates a mass request exemption for an existing goal plan and mass request hierarchy.
Note that the user keys ManagerAssignmentNumber and GoalPlanExternalId are not currently supported for the
attribute MassRequestHierarchyId while loading a MassRequestExemption record separately, and they cannot
identify the parent mass request hierarchy record in this case. We need to pass the source key for mass request
hierarchy MassRequestHierarchyId(SourceSystemId) instead, as shown below. Also, note that the attribute
MassRequestId is mandatory in this case and, since source key is not supported for this attribute, you need to pass
GoalPlanExternalId as shown below.
The discriminator GoalPlanAssignment is used to load goal plan assignment records using HCM Data Loader. The
following GoalPlanAssignment attributes are commonly supplied when assigning a goal plan to a worker
population or organization.
SourceSystemId / * (not displayed) You must provide a unique reference for the record being created. You must supply
SourceSystemOwner a source key to provide a unique reference for the goal plan assignment record.
GoalPlanId *1 * (not displayed) You must provide a unique reference for the goal plan this record is for. If using
user keys, then supply the user key attribute GoalPlanExternalId.
This attribute also supports the integration key types. If you supplied a source key
for the goal plan, then supply the same value here and append the source key hint
to the attribute name. For example: GoalPlanId(SourceSystemId).
GoalPlanStartDate * Start Date The start date of the goal plan. If this attribute is not passed, then it is the start date
of the Goal Plan by default.
GoalPlanEndDate * End Date The end date of the goal plan. If this attribute is not passed, then it is the end date
of the Goal Plan by default.
GoalPlanSetId*1 * (not displayed) You must provide a unique reference for the goal plan set this record is for. If using
user keys, then supply the user key attribute GoalPlanSetExternalId.
This attribute also supports the integration key types. If you supplied a source key
for the goal plan set, then supply the same value here and append the source key
hint to the attribute name. For example: GoalPlanSetId(SourceSystemId).
GoalPlanSetStartDate * Start Date The start date of the goal plan set. If this attribute is not passed, then it is the start
date of the Goal Plan Set by default.
GoalPlanSetEndDate * End Date The end date of the goal plan set. If this attribute is not passed, then it is the end
date of the Goal Plan Set by default.
PersonId *1 * Name Provide a unique reference to the person with whom the goal plan is being
associated. If supplying user keys, then use the WorkerAssignmentNumber
attribute. This attribute also supports the integration key types. If you supplied a
source key for the person, then supply the same value here and append the source
key hint to the attribute name. For example: PersonId(SourceSystemId).
AssignmentId *1 Job Provide a unique reference to the assignment. If using user keys, then supply the
user key attribute WorkerAssignmentNumber.
This attribute also supports the integration key types. If you supplied a source key
for the worker assignment, then supply the same value here and append the source
key hint to the attribute name. For example: AssignmentId(SourceSystemId).
OrganizationId * Department Used for the Organization Goal Plan scenario only.
Unique ID that identifies the organization this goal plan is for. If supplying user keys,
then use the OrganizationName attribute.
This attribute also supports the integration key types. If you supplied a source key
for the organization, then supply the same value here and append the source key
hint to the attribute name. For example: OrganizationId(SourceSystemId).
Weighting Weight The weight of the goal plan in the goal plan set. The weight value must be between
zero and one hundred. The type of this attribute is NUMBER (5, 2) and so it also
supports decimals.
User key attributes that are required only if no other key type is supplied to identify uniquely the object they reference.
GoalPlanExternalId External ID The external ID for the goal plan to which this goal plan assignment belongs.
GoalPlanSetExternalId Shown within brackets The external ID for the goal plan set to which this goal plan assignment belongs.
in the “Goal Plan”
section if a goal plan is
included in a goal plan
set.
OrganizationName Department Used for the Organization Goal Plan assignment scenario only.
The value supplied will derive the value seen in the field specified in the User Interface Prompt.
*1
The foreign object references support use of all four key types: Oracle surrogate ID, Oracle GUID, source key, and user key.
Creating a Goal Plan with Goal Plan Assignment Component for a Worker
This file creates a new goal plan and goal plan assignment for a worker.
METADATA|GoalPlan|GoalPlanExternalId|GoalPlanName|GoalPlanTypeCode|GoalPlanActiv
eFlag|EnableWeightingFlag|StartDate|EndDate|EnforceGoalWeightFlag|GoalAccessLeve
lCode|IncludeInPerfdocFlag|ReqSubmittedByPersonNumber|RequestSubmissionDate
MERGE|GoalPlan|GP_001_01|GP_001_01|Performance|A|Y|2015/01/01|2015/12/31|N|HR
specialist and manager|Y|8153756|2015/04/01
METADATA|GoalPlanAssignment|SourceSystemId|SourceSystemOwner|GoalPlanExternalId|
WorkerAssignmentNumber|Status
MERGE|GoalPlanAssignment|GPA_001_01|VISION|GP_001_01|EEEE8153787|Active
Associating a Goal Plan Assignment with an Existing Goal Plan for a Worker
[Link]
This file creates a worker goal plan assignment for a goal plan that already exists. Note: user keys can be used in
this case.
METADATA|GoalPlanAssignment|SourceSystemId|SourceSystemOwner|GoalPlanExternalId|
WorkerAssignmentNumber|Status
MERGE|GoalPlanAssignment|GPA_001_01|VISION|GP_001_01|EEEE8153787|Active
Creating a Goal Plan with a Goal Plan Assignment Component for an Organization
[Link]
This file creates a new goal plan and goal plan assignment for an organization.
METADATA|GoalPlan|GoalPlanExternalId|GoalPlanName|GoalPlanTypeCode|GoalPlanActiv
eFlag|EnableWeightingFlag|StartDate|EndDate|EnforceGoalWeightFlag|GoalAccessLeve
lCode|IncludeInPerfdocFlag|ReqSubmittedByPersonNumber|RequestSubmissionDate
MERGE|GoalPlan|GP_001_01|GP_001_01|Performance|A|Y|2015/01/01|2015/12/31|N|HR
specialist and manager|Y|8153756|2015/04/01
METADATA|GoalPlanAssignment|SourceSystemId|SourceSystemOwner|GoalPlanExternalId|
OrganizationName|Status
MERGE|GoalPlanAssignment|GPA_001_01|VISION|GP_001_01|Vision Corporation
Enterprise|Active
Associating a Goal Plan Assignment with an Existing Goal Plan for an Organization
[Link]
This file creates a worker goal plan assignment for a goal plan that already exists. Note: user keys can be used in
this case.
METADATA|GoalPlanAssignment|SourceSystemId|SourceSystemOwner|GoalPlanExternalId|
OrganizationName|Status
MERGE|GoalPlanAssignment|GPA_001_01|VISION|GP_001_01|Vision Corporation
Enterprise|Active
GoalPlan
Error Resolution
This action cannot be performed Ensure that the profile option HRG_USE_PERF_GOAL_PLANS is set if you are creating
because the use of performance goal performance goal plans.
plans is not enabled.
This action cannot be performed Ensure that the profile option HRG_USE_DEV_GOAL_PLANS is set if you are creating
because the use of development goal development goal plans.
plans is not enabled.
No actions can be performed on Ensure that the profile option HRG_ENABLE_DEVELOPMENT_GOAL is set if you are creating
development goals because the use of development goal plans.
development goals is not enabled.
This action cannot be performed Ensure that the profile option HRG_ENABLE_PERFORMANCE_GOAL is set if you are creating
because the use of the Performance development goal plans.
goal type is not enabled.
The goal plan end date must be later Ensure that the goal plan end date is later than or equal to the goal plan start date.
than or equal to the goal plan start date.
Unique key validation error. While loading goal plan records, ensure that the combination of GoalPlanName, StartDate, and
EndDate is unique. Also, ensure that the GoalPlanExternalId is unique.
An application error occurred: The attributes ReqSubmittedByPersonId and RequestSubmissionDate are mandatory when the
[Link]. goal plan record is loaded without the MassRequest component in the [Link] file. See the
sample MERGE line in the GoalPlan section.
GoalPlanGoal
Error Resolution
You cannot create a goal plan period for Ensure that the value passed for the GoalPlanId attribute is valid.
a goal plan that does not exist.
The goal does not exist. Ensure that the value passed for GoalId is valid. The GoalId must correspond to a template goal
(GoalVersionTypeCode = MASS_REQ). See the sample MERGE lines in the GoalPlanGoal
section.
The same goal type must be used for Ensure that the goal type on the template goal matches the goal plan type.
both the goal and the goal plan.
Goal Weights cannot be assigned The weighting attribute cannot be populated on the GoalPlanGoal record unless weights are
because the use of goal weighting is not enabled for the Goal Plan.
enabled.
This action cannot be performed Enable Performance Goal Plans by setting the profile option HRG_USE_PERF_GOAL_PLANS.
because the use of performance goal
plans is not enabled.
This action cannot be performed Enable Development Goal Plans by setting the profile option HRG_USE_DEV_GOAL_PLANS.
because the use of development goal
plans is not enabled.
MassRequest
Error Resolution
The requester ID does not exist. Ensure that the value passed for RequestSubmittedPersonId is valid.
EligibilityProfileObject
Error Resolution
You have selected the same eligibility An eligibility profile can only be assigned once to a goal plan.
profile more than once for the
performance template or period. Select
a unique eligibility profile.
MassRequestAssignment
Error Resolution
The same assignment was entered An organization can be included only once in a goal plan.
more than once.
MassRequestHierarchy
Error Resolution
The request cannot be completed Ensure that the value passed for the ManagerId column is valid.
because {PersonId} does not exist.
The same manager and cascading level A manager and cascading level combination can be included once only in a goal plan.
can only be entered once in this
request.
MassRequestExemption
Error Resolution
A parent for this record was not found. User keys are not supported for the MassRequestExemption component while loading
Use any of the four supported key- MassRequestExemption records separately. You must supply a source key to provide a unique
resolution systems to supply a valid reference for the mass request exemption record in this case. Also, note that the user key
parent reference. attributes ManagerAssignmentNumber and GoalPlanExternalId are not supported for the
MassRequestHierarchyId attribute while loading MassRequestExemption record separately. You
must pass a source key for mass request hierarchy while loading the mass request exemption
records separately. See the sample MERGE lines given in the MassRequestExemption section.
The record referenced by the foreign Do not pass the MassRequestId attribute while loading the MassRequestExemption component
key attribute MassRequestId was not along with parent MassRequestHierarchy, MassRequest, and GoalPlan components in the same
found. Either specify a valid foreign key [Link] file. The value for this column is automatically derived in this case.
or create the referenced record first. See the sample MERGE lines given in the MassRequestExemption section.
JBO-27014: Attribute MassRequestId in The attribute MassRequestId is mandatory while loading MassRequestExemption component
MassReqExemptionsEO is required. separately after loading the parent GoalPlan, MassRequest, and MassRequestHierarchy
components in a different [Link] file. Source keys are not supported for this attribute. You
must supply GoalPlanExternalId. See the sample MERGE lines given in the
MassRequestExemption section.
You must take care when using HCM Data Loader to delete records, as deleted records cannot be recovered. Do
not supply DELETE instructions in the same file as MERGE instructions.
When we delete a goal plan record using HCM Data Loader, the following child records are automatically deleted
along with the parent record:
Template MassRequest
MassRequestHierarchy
MassRequestExemption
EligibilityProfileObject
MassRequestAssignment
Note: GoalPlanGoal records (which link the goal plan to template goals) and GoalPlanAssignment records are not
automatically deleted when the parent goal plan is deleted using HCM Data Loader. Delete the relevant
GoalPlanGoal and GoalPlanAssignment records explicitly before deleting the parent goal plan. Other child records
can also be individually deleted using HCM Data Loader if needed.
Following are sample METADATA and MERGE lines to delete the goal plan goal record that links goal plan
GP_001_01 with template goal TemplateGoal_001 (SourceSystemId: TemplateGoal_001_SSID).
[Link]
This file deletes the goal plan goal created in the Creating a Goal Plan with a Goal section.
METADATA|GoalPlanGoal|SourceSystemId|SourceSystemOwner|GoalPlanExternalId|
DELETE|GoalPlanGoal|GPG_001_01_SSID|VISION|GP_001_01
[Link]
METADATA|GoalPlanAssignment|SourceSystemId|SourceSystemOwner|GoalPlanExternalId
DELETE|GoalPlanAssignment|GPA_001_01|VISION|GP_001_01
Following are sample METADATA and MERGE lines to delete the template goal TemplateGoal_001
(SourceSystemId: TemplateGoal_001_SSID).
[Link]
METADATA|Goal|SourceSystemId|SourceSystemOwner
DELETE|Goal|TemplateGoal_001_SSID|VISION
Following are sample METADATA and DELETE lines to delete the goal plan GP_001_01 along with its other child
records.
[Link]
METADATA|GoalPlan|GoalPlanExternalId
DELETE|GoalPlan|GP_001_01
For more information on goal plan sets, see the help topic Goal Plan Sets: Explained in Oracle Applications Help at
[Link]
The load process for Goal Plan Set will load goal plan set objects but it will not run the actual assignment of the goal
plan sets to employees. The latter is done either in the application by HR or administrators when they schedule
execution of goal plan set assignments using Manage Goal Plan Sets task or via HCM Data Loader using the
GoalPlanAssignment component of the GoalPlan object.
Goal Plan Set Plan Details of goal plans attached to a goal plan set. GoalPlanSetPlan
Mass Request Details of goal plan set generation request submitted by HR or administrator. This MassRequest
component is mandatory while loading the full hierarchy.
Eligibility Profile Details of eligibility profiles attached to a goal plan set. EligibilityProfileObject
Object
Mass Request Detail of workers and managers attached to a goal plan set. MassRequestHierarchy
Hierarchy
Mass Request Details of workers exempted from a goal plan set. MassRequestExemption
Exemption
The discriminator GoalPlanSet is used to load goal plan set records using HCM Data Loader. The following
GoalPlanSet attributes are commonly supplied when loading a new goal plan set.
SourceSystemId / * External ID You must provide a unique reference for the record being created. Supply either a
SourceSystemOwner source key or the user key attribute GoalPlanSetExternalId
GoalPlanSetExternalId *External ID A unique reference to the goal plan set in an external system.
GoalPlanSetName Goal Plan Set The name of the goal plan set.
Name
StartDate Start Date The start date of the goal plan set.
EndDate End Date The end date of the goal plan set.
ReqSubmittedByPersonId*1 *(not displayed) Provide a unique reference to the person creating the goal plan set. If using user
keys, then supply the user key attribute ReqSubmittedByPersonNumber.
This attribute also supports the integration key types. If you supplied a source key for
the referenced person, then supply the same value here and append the source key
hint to the attribute name. For example: ReqSubmittedByPersonId(SourceSystemId).
This attribute is mandatory while creating new goal plan sets if the MassRequest
component is not being passed in the [Link] file.
RequestSubmissionDate (not displayed) Provide the date when HR is creating this goal plan set. This attribute is mandatory
when creating new goal plan sets if the MassRequest component is not being
passed in the [Link] file.
The value supplied will derive the value seen in the field specified in the User Interface Prompt.
*1
The foreign object references support use of all four key types: Oracle surrogate ID, Oracle GUID, source key, and user key.
[Link]
This file creates a goal plan set without a mass request. In this case, the template mass request record for the goal
plan set is created automatically using the values passed for attributes ReqSubmittedByPersonId and
RequestSubmissionDate. While loading new goal plan sets, note that the components Mass Request Hierarchy,
Mass Request Exemption, and Eligibility Profile Object cannot be present in the [Link] file without the
parent Mass Request component.
METADATA|GoalPlanSet|GoalPlanSetExternalId|GoalPlanSetName|Description|GoalPlanS
etActiveFlag|StartDate|EndDate|ReqSubmittedByPersonNumber|RequestSubmissionDate|
ReviewPeriodName
MERGE|GoalPlanSet|GPS_001_01|GPS_001_01|GPS_001_01|A|2016/01/01|2016/12/31|81537
56|2016/06/10|Default Review Period - Vision Corporation Enterprise
The discriminator GoalPlanSetPlan is used to load goal plan set plan records using HCM Data Loader. The
following GoalPlanSetPlan attributes are commonly supplied when loading a new goal plan set plan.
Note that the goal plans that need to be included in the goal plan set must have been created previously using
[Link] file. When [Link] and [Link] files are included in the same zip file, [Link] is
processed before [Link].
SourceSystemId / * (not displayed) You must provide a unique reference for the record being created. Supply either
SourceSystemOwner a source key or the user key attributes GoalPlanExternalId and
GoalPlanSetExternalId.
GoalPlanSetId * (not displayed for this You must provide a unique reference for the goal plan set this record is for. If
component) using user keys, then supply the user key attribute GoalPlanSetExternalId.
This attribute also supports the integration key types. If you supplied a source
key for the goal plan set, then supply the same value here and append the
source key hint to the attribute name. For example:
GoalPlanSetId(SourceSystemId).
GoalPlanId *Goal Plan Name You must provide a unique reference for the goal plan this record is for. If using
user keys, then supply the user key attribute GoalPlanExternalId.
This attribute also supports the integration key types. If you supplied a source
key for the goal plan, then supply the same value here and append the source
key hint to the attribute name. For example: GoalPlanId(SourceSystemId).
Weighting Weight The weight of the goal plan in the goal plan set. The weight value must be
between zero and one hundred. The type of this attribute is NUMBER (5, 2) and
so it also supports decimals.
User key attributes that are required only if no other key type is supplied to identify uniquely the object they reference.
GoalPlanSetExternalId (not displayed for this The external ID for the goal plan set this goal plan belongs to.
component)
GoalPlanExternalId Goal Plan Name The external ID for this goal plan.
The value supplied will derive the value seen in the field specified in the User Interface Prompt.
*1
The foreign object references support use of all four key types: Oracle surrogate ID, Oracle GUID, source key, and user key.
Figure 16: Goal Plan Set Plan (Manage Goal Plan Sets)
Navigation: Manage Goal Plan Sets - Worker Assignment - Goal Plans
This file creates a goal plan set to include two goal plans.
METADATA|GoalPlanSet|GoalPlanSetExternalId|GoalPlanSetName|Description|GoalPlanS
etActiveFlag|StartDate|EndDate|ReqSubmittedByPersonNumber|RequestSubmissionDate|
ReviewPeriodName
MERGE|GoalPlanSet|GPS_002_01|GPS_002_01|GPS_002_01|A|2015/01/01|2015/12/31|81537
56|2015/09/28|Default Review Period - Vision Corporation Enterprise
COMMENT Assign 2 goal plans without worker/elpro assignment to the gps
METADATA|GoalPlanSetPlan|GoalPlanSetExternalId|GoalPlanExternalId|Weighting
MERGE|GoalPlanSetPlan|GPS_002_01|GP_001_02|60
Mass Request
The Mass Request component holds attributes of the mass request object associated with the goal plan set. It is
referenced by subcomponents that collectively define the employee population to assign the goal plan set to. These
subcomponents are listed in the Goal Plan Set Hierarchy table above. Every goal plan set needs to be associated
with a mass request record having a RequestTypeCode of TEMPLATE, irrespective of the presence of these
subcomponents.
The discriminator MassRequest is used to load goal plan set mass request records using HCM Data Loader. Note
that the MassRequest component is mandatory if the attributes ReqSubmittedByPersonId and
RequestSubmissionDate are not provided for the GoalPlanSet component while loading a new goal plan set. If
these attributes are provided for the GoalPlanSet component, then the template mass request record for the goal
plan set is created automatically using these values. Customers must pass the MassRequest component explicitly if
they want to associate a SourceSystemId to the template mass request record that they can use later for updating or
deleting the subcomponents that define the employee population.
While loading new goal plan sets, note that the components Mass Request Hierarchy, Mass Request Exemption,
and Eligibility Profile Object cannot be present in the [Link] file without the parent Mass Request
component.
The following MassRequest attributes are commonly supplied when loading a new goal plan set.
SourceSystemId / * (not displayed) You must provide a unique reference for the record being created. Supply either a
SourceSystemOwner source key or the user key attribute GoalPlanSetExternalId.
GoalPlanSetId *1 External ID You must provide a unique reference for the goal plan set this record is for. If using
user keys, then supply the user key attribute GoalPlanSetExternalId
This attribute also supports the integration key types. If you supplied a source key for
the goal plan set, then supply the same value here and append the source key hint
to the attribute name. For example: GoalPlanSetId(SourceSystemId)
ReqSubmittedByPersonId *1 * (not displayed) Provide a unique reference to the person who is creating the goal plan set. If
supplying user keys, then use the ReqSubmittedByPersonNumber attribute.
This attribute also supports the integration key types. If you supplied a source key for
the person, then supply the same value here and append the source key hint to the
attribute name. For example: RequestSubmittedByPersonId(SourceSystemId)
RequestSubmissionDate (not displayed) Provide the date when HR is creating this goal plan set. If this attribute is not passed,
it is defaulted to sysdate.
User key attributes that are required only if no other key type is supplied to identify uniquely the object they reference.
GoalPlanSetExternalId (not displayed) The external ID for the goal plan set.
ReqSubmittedByPerson * (not displayed) The number of the person who is creating the goal plan set.
Number
The value supplied will derive the value seen in the field specified in the User Interface Prompt.
*1
The foreign object references support use of all four key types: Oracle surrogate ID, Oracle GUID, source key, and user key.
This file creates a goal plan set with a mass request. You must not provide the ReqSubmittedByPersonId and
RequestSubmissionDate attributes for the GoalPlanSet component in this case.
METADATA|GoalPlanSet|GoalPlanSetExternalId|GoalPlanSetName|Description|GoalPlanS
etActiveFlag|StartDate|EndDate|ReviewPeriodName
MERGE|GoalPlanSet|GPS_001_02|GPS_001_02|GPS_001_02|A|2016/01/01|2016/12/31|Defau
lt Review Period - Vision Corporation Enterprise
METADATA|MassRequest|GoalPlanSetExternalId|ReqSubmittedByPersonNumber
MERGE|MassRequest|GPS_001_02|8153756
The discriminator EligibilityProfileObject is used to load eligibility profile records for a goal plan set using HCM
Data Loader. The following EligibilityProfileObject attributes are commonly supplied when loading a new goal plan
set.
SourceSystemId / * (not displayed) You must provide a unique reference for the record being created. Supply either a
SourceSystemOwner source key or the user key attributes EligibilityProfileName and GoalPlanSetExternalId.
ObjectId *1 * (not displayed) Provide a unique reference to the mass request this record belongs to. If using user
keys, then supply the user key attribute GoalPlanSetExternalId.
This attribute also supports the integration key types. If you supplied a source key for
the mass request, then supply the same value here and append the source key hint to
the attribute name. For example: ObjectId(SourceSystemId).
.
RequiredFlag Required The flag that determines whether this eligibility profile is required.
User key attributes that are required only if no other key type is supplied to identify uniquely the object they reference.
GoalPlanSetExternalId (not displayed for this The external ID for the goal plan set this eligibility profile object belongs to.
component)
The value supplied will derive the value seen in the field specified in the User Interface Prompt.
*1
The foreign object references support use of all four key types: Oracle surrogate ID, Oracle GUID, source key, and user key.
This file creates a goal plan set with an eligibility profile object.
METADATA|GoalPlanSet|GoalPlanSetExternalId|GoalPlanSetName|Description|GoalPlanS
etActiveFlag|StartDate|EndDate|ReviewPeriodName
MERGE|GoalPlanSet|GPS_001_03|GPS_001_03|GPS_001_03|A|2016/01/01|2016/12/31|Defau
lt Review Period - Vision Corporation Enterprise
METADATA|MassRequest|GoalPlanSetExternalId|ReqSubmittedByPersonNumber
MERGE|MassRequest|GPS_001_03|8153756
METADATA|EligibilityProfileObject|GoalPlanSetExternalId|EligibilityProfileName|R
equiredFlag
MERGE|EligibilityProfileObject|GPS_001_03|Goals_EligibilityProfile_Software
Developer 4|Y
This file creates an eligibility profile object for an existing goal plan set.
METADATA|EligibilityProfileObject|GoalPlanSetExternalId|EligibilityProfileName|R
equiredFlag
MERGE|EligibilityProfileObject|GPS_001_01|Age 22 and above|Y
The discriminator MassRequestHierarchy is used to load mass request hierarchy records for a goal plan set using
HCM Data Loader. The following MassRequestHierarchy attributes are commonly supplied when loading a new
goal plan set.
SourceSystemId / * (not displayed) You must provide a unique reference for the record being created. Supply either a
SourceSystemOwner source key or the user key attributes ManagerAssignmentNumber and
GoalPlanSetExternalId.
*1
MassRequestId * (not displayed) Provide a unique reference to the mass request this record belongs to. If using
user keys, then supply the user key attribute GoalPlanSetExternalId.
This attribute also supports the integration key types. If you supplied a source key
for the mass request, then supply the same value here and append the source key
hint to the attribute name. For example: MassRequestId(SourceSystemId).
ManagerAssignmentId *1 Job Provide a unique reference to the manager assignment (or the worker assignment
if the Cascading Level is Self). If using user keys, then supply the user key
attribute ManagerAssignmentNumber.
This attribute also supports the integration key types. If you supplied a source key
for the manager (or worker) assignment, then supply the same value here and
append the source key hint to the attribute name. For example:
ManagerAssignmentId(SourceSystemId).
ManagerId *1 Name Provide a unique reference to the manager (or the worker if the Cascading Level is
Self). If using user keys, then supply the user key attribute
ManagerAssignmentNumber.
This attribute also supports the integration key types. If you supplied a source key
for the manager (or worker), then supply the same value here and append the
source key hint to the attribute name. For example: ManagerId(SourceSystemId).
CascadingLevel Assignees Specific type of hierarchy selection method. Provide one of the following values
(0,1, 999999,2 or 1000000):
0 - Self
1 - Direct reports
999999 - All reports
2 - Self and direct reports
1000000 - Self and all reports
User key attributes that are required only if no other key type is supplied to identify uniquely the object they reference.
GoalPlanSetExternalId (not displayed for this The external ID for the goal plan set this mass request hierarchy object belongs to.
component)
The value supplied will derive the value seen in the field specified in the User Interface Prompt.
*1
The foreign object references support use of all four key types: Oracle surrogate ID, Oracle GUID, source key, and user key.
[Link]
This file creates a goal plan set with a mass request and mass request hierarchy.
METADATA|GoalPlanSet|GoalPlanSetExternalId|GoalPlanSetName|Description|GoalPlanS
etActiveFlag|StartDate|EndDate|ReviewPeriodName
MERGE|GoalPlanSet|GPS_001_04|GPS_001_04|GPS_001_04|A|2016/01/01|2016/12/31|Defau
lt Review Period - Vision Corporation Enterprise
METADATA|MassRequest|GoalPlanSetExternalId|ReqSubmittedByPersonNumber
MERGE|MassRequest|GPS_001_04|8153756
COMMENT Assigning Worker to Goal Plan Set GPS_001_04
METADATA|MassRequestHierarchy|GoalPlanSetExternalId|ManagerAssignmentNumber|Casc
adingLevel
MERGE|MassRequestHierarchy|GPS_001_04|EEEE8153786|999999
This file creates a mass request hierarchy for an existing goal plan set with a mass request.
The discriminator MassRequestExemption is used to load mass request exemption records for a goal plan set
using HCM Data Loader. The following MassRequestExemption attributes are commonly supplied when loading a
new goal plan set.
SourceSystemId / * (not displayed) You must provide a unique reference for the record being created.
SourceSystemOwner
MassRequestHierarch (not displayed) You must provide a unique reference for the mass request hierarchy this record is
yId *1 for.
This attribute also supports the integration key types. If you supplied a source key
for the mass request hierarchy, then supply the same value here and append the
source key hint to the attribute name. For example:
MassRequestHierarchyId(SourceSystemId). If using user keys, then supply the
user key attributes GoalPlanSetExternalId and ManagerAssignmentNumber.
MassRequestId *1 (not displayed) Provide a unique reference for the mass request. If using user keys supply the
user key attribute GoalPlanSetExternalId.
Note that the source key is not supported for this attribute currently.
Do not pass this attribute while loading MassRequestExemption component along
with parent MassRequestHierarchy, MassRequest, and GoalPlanSet components
in the same [Link] file. The value for this column is automatically
derived in this case.
This column is mandatory while loading a MassRequestExemption component
separately after loading the parent GoalPlanSet, MassRequest, and
MassRequestHierarchy components in a different [Link] file. See the
sample MERGE lines given in this section.
PersonId *1 Name Provide a unique reference to the person who needs to be exempted from the goal
plan set. If using user keys, then supply the user key attribute
WorkerAssignmentNumber.
This attribute also supports the integration key types. If you supplied a source key
for the person, then supply the same value here and append the source key hint to
the attribute name. For example: PersonId(SourceSystemId).
AssignmentId *1 Job Provide a unique reference to the assignment of the person who needs to be
exempted from the goal plan set. If using user keys, then supply the user key
attribute WorkerAssignmentNumber.
This attribute also supports the integration key types. If you supplied a source key
for the assignment, then supply the same value here and append the source key
hint to the attribute name. For example: AssignmentId(SourceSystemId).
User key attributes that are required only if no other key type is supplied to identify uniquely the object they reference.
GoalPlanSetExternalId (not displayed for this The external ID for the goal plan set this mass request exemption object belongs
component) to.
WorkerAssignmentNu Job (In the “Select or The assignment number for the worker.
mber deselect assignees” popup)
The value supplied will derive the value seen in the field specified in the User Interface Prompt.
*1
The foreign object references support use of all four key types: Oracle surrogate ID, Oracle GUID, source key, and user key.
This file creates a goal plan set with a mass request hierarchy and exemption.
Do not pass a value for the MassRequestId attribute in this case as the value is automatically derived.
METADATA|GoalPlanSet|GoalPlanSetExternalId|GoalPlanSetName|Description|GoalPlanS
etActiveFlag|StartDate|EndDate|ReviewPeriodName
MERGE|GoalPlanSet|GPS_001_05|GPS_001_05|GPS_001_05|A|2016/01/01|2016/12/31|Defau
lt Review Period - Vision Corporation Enterprise
METADATA|MassRequest|GoalPlanSetExternalId|ReqSubmittedByPersonNumber
MERGE|MassRequest|GPS_001_05|8153756
COMMENT Assigning Worker to Goal Plan Set GPS_001_05
METADATA|MassRequestHierarchy|GoalPlanSetExternalId|ManagerAssignmentNumber|Casc
adingLevel
MERGE|MassRequestHierarchy|GPS_001_05|EEEE8153786|999999
COMMENT Excluding one worker from Goal Plan Set GPS_001_05
METADATA|MassRequestExemption|GoalPlanSetExternalId|ManagerAssignmentNumber|Work
This file creates a mass request exemption for an existing goal plan set and mass request hierarchy. Note: the user
keys ManagerAssignmentNumber and GoalPlanSetExternalId are not currently supported for the attribute
MassRequestHierarchyId while loading a MassRequestExemption record separately, and they cannot identify the
parent mass request hierarchy record in this case. You must supply the mass request hierarchy source key instead,
as shown below.
The GoalPlanSetExternalId must also be supplied, as the source key for the mass request is not currently
supported.
GoalPlanSet
Error Resolution
A goal plan set with the code value Ensure that the GoalPlanSetExternalId value is unique.
{GOAL_PLAN_SET_CODE} already
exists. Enter a unique code.
The goal plan end date must be later Ensure that the goal plan set end date is later than or equal to the goal plan set start date.
than or equal to the goal plan start date.
An application error occurred: The attributes ReqSubmittedByPersonId and RequestSubmissionDate are mandatory when the
[Link]. goal plan set record is loaded without the MassRequest component in the [Link] file.
See the sample MERGE line in the GoalPlanSet section.
MassRequest
Error Resolution
The requester ID does not exist. Ensure that the value passed for RequestSubmittedPersonId is valid.
EligibilityProfileObject
Error Resolution
You have selected the same eligibility An eligibility profile can be assigned once only to a goal plan set.
MassRequestHierarchy
Error Resolution
The request cannot be completed Ensure that the value passed for the ManagerId column is valid.
because {PersonId} does not exist.
The same manager and cascading level A manager and cascading level combination can be included once only in a goal plan set.
can only be entered once in this
request.
MassRequestExemption
Error Resolution
A parent for this record was not found. User keys are not supported for the MassRequestExemption component while loading
Use any of the four supported key- MassRequestExemption records separately. You must supply a source key to provide a unique
resolution systems to supply a valid reference for the mass request exemption record in this case. Also, note that the user key
parent reference. attributes ManagerAssignmentNumber and GoalPlanSetExternalId are not supported for the
MassRequestHierarchyId attribute while loading a MassRequestExemption record separately.
You must pass a source key for mass request hierarchy while loading mass request exemption
records separately. See the sample MERGE lines given in the MassRequestExemption section.
The record referenced by the foreign Do not pass the MassRequestId attribute while loading MassRequestExemption component
key attribute MassRequestId was not along with parent MassRequestHierarchy, MassRequest, and GoalPlanSet components in the
found. Either specify a valid foreign key same [Link] file. The value for this column is automatically derived in this case.
or create the referenced record first. See the sample MERGE lines given in the MassRequestExemption section.
JBO-27014: Attribute MassRequestId in The attribute MassRequestId is mandatory while loading MassRequestExemption component
MassReqExemptionsEO is required. separately after loading the parent GoalPlanSet, MassRequest, and MassRequestHierarchy
components in a different [Link] file. In addition, since source key is not supported for
this attribute, you need to pass GoalPlanSetExternalId instead. See the sample MERGE lines
given in the MassRequestExemption section.
You must take care when using HCM Data Loader to delete records, as deleted records cannot be recovered. Do
not supply DELETE instructions in the same file as MERGE instructions for the same goal plan set records.
Use Case: Delete Goal Plan Sets and Their Child Records
When we delete a goal plan set record through HCM Data Loader, the following child records are automatically
deleted along with the parent record. These child records can also be individually deleted through HCM Data Loader
if needed.
Template MassRequest
MassRequestHierarchy
Do not delete goal plan sets that have already been assigned to workers.
[Link]
This file deletes a goal plan set along with all its child components.
METADATA|GoalPlanSet|GoalPlanSetExternalId
DELETE|GoalPlanSet|GPS_006_01
CONNECT W ITH US
[Link]/oracle Copyright © 2014, Oracle and/or its affiliates. All rights reserved. This document is provided for information purposes only, and the
contents hereof are subject to change without notice. This document is not warranted to be error-free, nor subject to any other
warranties or conditions, whether expressed orally or implied in law, including implied warranties and conditions of merchantability or
[Link]/oracle fitness for a particular purpose. We specifically disclaim any liability with respect to this document, and no contractual obligations are
formed either directly or indirectly by this document. This document may not be reproduced or transmitted in any form or by any
[Link]/oracle means, electronic or mechanical, for any purpose, without our prior written permission.
Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.
[Link]
Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and
are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are
trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group. 1116