Benefit Groups Setup Task Guidance
Purpose
Provides task-specific setup planning, routing, export, import, and validation guidance for Benefit Groups under Benefits General Configuration.
Setup Task Skill Contract
- task_code:
BEN_MANAGE_BENEFIT_GROUPS - task_name:
Benefit Groups - parent_skill_id:
hcm.benefits-configuration.benefits-general-configuration - pillar:
HCM - offering:
Benefits Configuration - functional_area:
Benefits General Configuration - functional_area_code:
ORA_BENEFITS_GENERAL_CONFIGURATION - available_flag:
Y - export_import_supported_flag:
N - csv_export_import_supported_flag:
N - dataloader_import_mode:
HDL - businessObject:
benefitGroups - source_catalog:
knowledge/setup-task-catalog/effective/setupTasksAll.json
Usage
Use this skill when planning, sequencing, exporting, importing, or validating setup data for Benefit Groups under Benefits General Configuration.
Setup Task Metadata
- Task name:
Benefit Groups - Task code:
BEN_MANAGE_BENEFIT_GROUPS - Available:
Y - Export/import supported:
N - CSV export/import supported:
N - CSV export/import routing:
not supported - Data Loader import mode:
HDL - Business Object:
benefitGroups
HDL Business Object
Use benefitGroups as the HDL business object for this task. Benefit Groups
is the setup-task display name; use the current Fusion Data Loader sample to
confirm the DAT filename, section header, attributes, keys, and supported
operations before preparing an artifact.
When a benefitGroups.LegalEmployer value is supplied, validate it through
the read-only legal employer lookup
using core.fusion-api.rest-api-client only when the active project workflow
selects that lookup step. Query legalEmployersLov with q=Name and require
an exact Name match; preserve the supplied value. A 403 records
unverified_forbidden without failing field validation. It does not verify
the value, so resolve access or use another workflow-approved authoritative
check before a live load. If only LegalEntityId is supplied, do not infer a
LegalEmployer name or run this name lookup.
Read input validation,
reference lookups,
dependency readiness,
defaulting,
design enforcement, and
error handling before preflight or live
activity. Keep DAT validation and loading on core.data-loader.
CSV Export, Import, and Validation Workflow
CSVExportImportSupportedFlag is N, so this task is not marked as CSV export/import supported in the effective setup-task catalog.
Do not route CSV export work to shared.setup-export.task-level-export or CSV import work to core.data-loader unless live Fusion metadata or Oracle guidance confirms support. Use shared.validation.setup-data-validator only when a setup data artifact is available for review. Use shared.validation.reference-data-validator when the task depends on cross-pillar reference data.
Inputs
implementation_objectiveproject_contextsetup_task_scopesetup_data_artifacts
Outputs
setup_task_plansetup_data_routingvalidation_checkpointsskill_run_recordtoken_usage_record
Implementation Notes
Use the parent functional-area skill hcm.benefits-configuration.benefits-general-configuration for functional-area sequencing and scope decisions. Track token usage for any generated project artifact or skill-run record using the manifest policy.