Benefit Self-Service Configuration Setup Task Guidance
Purpose
Provides task-specific setup planning, routing, export, import, and validation guidance for Benefit Self-Service Configuration under Benefits General Configuration.
Setup Task Skill Contract
- task_code:
BEN_MANAGE_GROUP_SPACE
- task_name:
Benefit Self-Service Configuration
- 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:
benefitSelfServiceConfigurations
- source_catalog:
knowledge/setup-task-catalog/effective/setupTasksAll.json
Usage
Use this skill when planning, sequencing, exporting, importing, or validating setup data for Benefit Self-Service Configuration under Benefits General Configuration.
Setup Task Metadata
- Task name:
Benefit Self-Service Configuration
- Task code:
BEN_MANAGE_GROUP_SPACE
- Available:
Y
- Export/import supported:
N
- CSV export/import supported:
N
- CSV export/import routing:
not supported
- Data Loader import mode:
HDL
- Business Object:
benefitSelfServiceConfigurations
HDL Business Object and Routing
CSVExportImportSupportedFlag is N; FSM CSV export/import is not a supported route for this task. This does not prohibit the explicitly selected HDL route.
Use core.data-loader for data-changing Benefit Self-Service Configuration activity. The sole approved HDL business object is benefitSelfServiceConfigurations. Do not replace it with the setup-task label, a guessed REST resource, browser entry, FSM CSV, or another loader route.
Before creating a DAT, generate or retrieve the current Fusion Data Loader sample for benefitSelfServiceConfigurations. That sample is authoritative for the case-sensitive filename stem, METADATA header, section hierarchy, supported RestAction values, required attributes, user keys, effective dating, and delete support. Do not infer any of these from the task or object name.
When a benefitSelfServiceConfigurations.AllowUnrestrictedProcessingTypeMeaning
value is supplied and the current sample confirms that attribute, validate it
through the read-only reference lookups
using LookupType=BEN_ALLOW_SS_UNRST_PROCG. For a supplied
SelfServiceEnrollmentPathMeaning, first confirm that the current
benefitSelfServiceConfigurations sample exposes that exact field. Only then
validate it with LookupType=ORA_BEN_SS_PATH_SELECTION. Do not infer this
field's presence from benefitFeaturePreferences or copy another object's
field into this skill's DAT. If the self-service sample lacks the field,
report the mapping mismatch and omit it from the artifact. Use
core.fusion-api.rest-api-client only when the active project workflow
selects these read-only lookups. A 403 records unverified_forbidden without
failing field validation or stopping independent checks. It does not verify
the value; resolve access or use another workflow-approved authoritative
check before a live load. Keep DAT validation and loading on
core.data-loader.
Defaulting Rules
CustomSurrogateUserKey is a dummy technical attribute. Do not request it from the user or treat it as a record-identity input. Always populate it with the literal value UPSERT in each applicable benefitSelfServiceConfigurations DAT row.
Input Validation and Preflight
Perform every check before an artifact becomes immutable or a Fusion-changing action begins:
- Confirm task
BEN_MANAGE_GROUP_SPACE, object benefitSelfServiceConfigurations, project Run Book status active, intended environment, and requested operation.
- Reject absent or ambiguous record identity, duplicate source identities, unsupported action semantics, malformed or stale sample headers, and values that do not satisfy the current sample's required fields and reference values. Validate each supplied
AllowUnrestrictedProcessingTypeMeaning and sample-confirmed SelfServiceEnrollmentPathMeaning through its selected read-only LOV; record valid, invalid, ambiguous, or unverified_forbidden per row and field. Supply CustomSurrogateUserKey=UPSERT without requesting user input.
- Validate the DAT filename, encoding,
METADATA/data-row column alignment, section hierarchy, record relationships, and any sample-declared date or effective-dating format. Format a supplied SelfServiceEffectiveDate as date-only YYYY-MM-DD; reject a malformed, time-bearing, or timezone-bearing value rather than silently changing its meaning. Preserve row-level validation errors; do not silently coerce other values.
- Confirm prerequisite benefits configuration is ready through the selected workflow. An HTTP 403 from the conditional LOV check does not fail field validation; retain
unverified_forbidden and continue independent checks. Require authoritative verification before live load if reference setup could not be verified.
- Build a versioned immutable DAT/archive, capture its checksum, and preflight it through
core.data-loader. A source, target, object, operation, or artifact change requires a new preflight.
HDL Operations and Approval Gates
| Requested operation |
HDL route |
Control point |
| Create or merge |
Prepare a benefitSelfServiceConfigurations DAT solely from the current sample. |
Validate and preflight the immutable artifact; obtain the Data Loader workflow approval immediately before upload. |
| Update |
Prepare an update only when current metadata supports the required identity and action. |
Do not guess PATCH or merge semantics; revalidate and obtain fresh approval. |
| Delete |
Use a delete DAT only when the current sample supports deletion and the user explicitly requests it. |
Treat as destructive and require explicit approval immediately before upload. |
| Read or verify |
Inspect workflow-selected metadata or load status. |
Read-only inspection does not authorize a later load. |
Any live action is governed by core.data-loader's approval workflow. This skill must not initiate an upload or load merely because a plan, sample, preview, or artifact was approved earlier.
Error Handling and Diagnostics
Classify failures as input_validation, catalog_or_metadata_mismatch, auth_expired_or_invalid, authorization_or_privilege, transport_or_environment, fusion_api_error, process_timeout, process_failed, artifact_persistence, or approval_blocker.
- Fail closed before side effects on invalid input, ambiguous identities, unsupported CSV routing, missing sample guidance, inactive Run Book, privilege failure, overwrite conflict, or missing approval.
- A cache-managed 401/403 may refresh once. Retry read-only transport failures only with bounded attempts. Never automatically retry a live upload, initiation, create, update, or delete; an idempotency key or fresh explicit approval is required.
- For the conditional
commonLookupsLOV checks, a 403 is unverified_forbidden, not an invalid field value; do not throw a field-validation error. It still requires authoritative verification before live load.
- On a timeout, stop polling and record the environment, operation, task code, object, ProcessId/requestId, last status, elapsed wait, and next-check path. Do not submit a second load.
- On terminal failure or partial completion, retrieve the available process log or status payload; preserve successful row outcomes and an
errors array for failed rows.
- Persist sanitized
hdl_preflight_result and load_diagnostic artifacts under this skill's declared project workspace. Include status, stage, failure class, message, recommended action, environment, artifact references, checksum, and external identifiers. Never print or persist credentials, tokens, token caches, private keys, customer-sensitive values, or full payload contents.
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_objective
project_context
setup_task_scope
setup_data_artifacts
Outputs
setup_task_plan
setup_data_routing
validation_checkpoints
hdl_preflight_result
load_diagnostic
skill_run_record
token_usage_record
Implementation Notes
Use the parent functional-area skill hcm.benefits-configuration.benefits-general-configuration for functional-area sequencing and scope decisions. Read the task-local ora-resource/ora_reference_lookups.md before reference validation. Track token usage for any generated project artifact or skill-run record using the manifest policy.
1---2skill_id: "hcm.benefits-configuration.benefits-general-configuration.benefit-self-service-configuration"3name: benefit-self-service-configuration-setup-task-guidance4description: "Provides task-specific setup guidance for Benefit Self-Service Configuration under the Benefits General Configuration functional area."5layer: "pillar"6pillar: "HCM"7offering: "Benefits Configuration"8functional_area: "Benefits General Configuration"9functional_area_code: "ORA_BENEFITS_GENERAL_CONFIGURATION"10task_code: "BEN_MANAGE_GROUP_SPACE"11task_name: "Benefit Self-Service Configuration"12parent_skill_id: "hcm.benefits-configuration.benefits-general-configuration"13available_flag: "Y"14export_import_supported_flag: "N"15csv_export_import_supported_flag: "N"16dataloader_import_mode: "HDL"17businessObject: "benefitSelfServiceConfigurations"18source_catalog: "knowledge/setup-task-catalog/effective/setupTasksAll.json"19type: "planning"20execution_mode: "assisted"21owner_team: "HCM benefits configuration pillar team"22version: "0.1.0"23inputs:24 - "implementation_objective"25 - "project_context"26 - "setup_task_scope"27 - "setup_data_artifacts"28outputs:29 - "setup_task_plan"30 - "setup_data_routing"31 - "validation_checkpoints"32 - "hdl_preflight_result"33 - "load_diagnostic"34 - "skill_run_record"35 - "token_usage_record"36depends_on:37 - "hcm.benefits-configuration.benefits-general-configuration"38 - "core.data-loader"39uses_core:40 - "core.data-loader"41 - "core.fusion-api.rest-api-client"42 - "core.diagnostics.role-access-check"43 - "core.project-mgmt.artifact-version-manager"44 - "core.project-mgmt.artifact-registry-manager"45 - "core.project-mgmt.project-state-manager"46persists_project_state: true47token_usage_tracking:48 enabled: true49 granularity: "per_skill_run"50 artifact_type: "token_usage_record"51 default_location: "project/{project_id}/artifacts/shared/token-usage/current/token-usage-log.md"52 estimation_method: "chars/4 estimate unless exact tokenizer or API accounting is available"53 required_fields:54 - "activity_start_time"55 - "skill_id"56 - "task"57 - "trigger"58 - "artifacts_written"59 - "files_read"60 - "estimated_input_tokens"61 - "estimated_output_tokens"62 - "estimated_total_tokens"63 - "estimation_method"64 - "notes"65state_updates:66 - "setup_task_sequence"67 - "configuration_blueprints"68 - "validation_results"69 - "token_usage_records"70workspace_outputs:71 - artifact_type: "configuration_blueprint"72 default_location: "project/{project_id}/artifacts/pillars/hcm/benefits-configuration/benefits-general-configuration/benefit-self-service-configuration/current/"73 versioning_policy: "major-new-version-minor-confirm-update"74 - artifact_type: "validation_result"75 default_location: "project/{project_id}/artifacts/pillars/hcm/benefits-configuration/benefits-general-configuration/benefit-self-service-configuration/current/"76 versioning_policy: "major-new-version-minor-confirm-update"77 - artifact_type: "skill_run"78 default_location: "project/{project_id}/state/runs/"79 versioning_policy: "append-only"80 - artifact_type: "token_usage_record"81 default_location: "project/{project_id}/artifacts/shared/token-usage/current/token-usage-log.md"82 versioning_policy: "append-only"83applicability:84 industries:85 - "All"86 countries:87 - "All"88 fusion_releases:89 - "Current Oracle Fusion Cloud release"90side_effects:91 - "Reads selected-environment commonLookupsLOV when the active workflow authorizes reference validation."92required_privileges:93 - "Read access to selected-environment commonLookupsLOV for supplied reference fields."94metadata:95 source: https://skillmd.com/skills/oracle/benefit-self-service-configuration-setup-task-guidance96---9798# Benefit Self-Service Configuration Setup Task Guidance99100## Purpose101102Provides task-specific setup planning, routing, export, import, and validation guidance for `Benefit Self-Service Configuration` under `Benefits General Configuration`.103104## Setup Task Skill Contract105106- task_code: `BEN_MANAGE_GROUP_SPACE`107- task_name: `Benefit Self-Service Configuration`108- parent_skill_id: `hcm.benefits-configuration.benefits-general-configuration`109- pillar: `HCM`110- offering: `Benefits Configuration`111- functional_area: `Benefits General Configuration`112- functional_area_code: `ORA_BENEFITS_GENERAL_CONFIGURATION`113- available_flag: `Y`114- export_import_supported_flag: `N`115- csv_export_import_supported_flag: `N`116- dataloader_import_mode: `HDL`117- businessObject: `benefitSelfServiceConfigurations`118- source_catalog: `knowledge/setup-task-catalog/effective/setupTasksAll.json`119120## Usage121122Use this skill when planning, sequencing, exporting, importing, or validating setup data for `Benefit Self-Service Configuration` under `Benefits General Configuration`.123124## Setup Task Metadata125126- Task name: `Benefit Self-Service Configuration`127- Task code: `BEN_MANAGE_GROUP_SPACE`128- Available: `Y`129- Export/import supported: `N`130- CSV export/import supported: `N`131- CSV export/import routing: `not supported`132- Data Loader import mode: `HDL`133- Business Object: `benefitSelfServiceConfigurations`134135## HDL Business Object and Routing136137`CSVExportImportSupportedFlag` is `N`; FSM CSV export/import is not a supported route for this task. This does not prohibit the explicitly selected HDL route.138139Use `core.data-loader` for data-changing Benefit Self-Service Configuration activity. The sole approved HDL business object is `benefitSelfServiceConfigurations`. Do not replace it with the setup-task label, a guessed REST resource, browser entry, FSM CSV, or another loader route.140141Before creating a DAT, generate or retrieve the current Fusion Data Loader sample for `benefitSelfServiceConfigurations`. That sample is authoritative for the case-sensitive filename stem, `METADATA` header, section hierarchy, supported `RestAction` values, required attributes, user keys, effective dating, and delete support. Do not infer any of these from the task or object name.142143When a `benefitSelfServiceConfigurations.AllowUnrestrictedProcessingTypeMeaning`144value is supplied and the current sample confirms that attribute, validate it145through the read-only [reference lookups](ora-resource/ora_reference_lookups.md)146using `LookupType=BEN_ALLOW_SS_UNRST_PROCG`. For a supplied147`SelfServiceEnrollmentPathMeaning`, first confirm that the current148`benefitSelfServiceConfigurations` sample exposes that exact field. Only then149validate it with `LookupType=ORA_BEN_SS_PATH_SELECTION`. Do not infer this150field's presence from `benefitFeaturePreferences` or copy another object's151field into this skill's DAT. If the self-service sample lacks the field,152report the mapping mismatch and omit it from the artifact. Use153`core.fusion-api.rest-api-client` only when the active project workflow154selects these read-only lookups. A 403 records `unverified_forbidden` without155failing field validation or stopping independent checks. It does not verify156the value; resolve access or use another workflow-approved authoritative157check before a live load. Keep DAT validation and loading on158`core.data-loader`.159160## Defaulting Rules161162`CustomSurrogateUserKey` is a dummy technical attribute. Do not request it from the user or treat it as a record-identity input. Always populate it with the literal value `UPSERT` in each applicable `benefitSelfServiceConfigurations` DAT row.163164## Input Validation and Preflight165166Perform every check before an artifact becomes immutable or a Fusion-changing action begins:1671681. Confirm task `BEN_MANAGE_GROUP_SPACE`, object `benefitSelfServiceConfigurations`, project Run Book status `active`, intended environment, and requested operation.1692. Reject absent or ambiguous record identity, duplicate source identities, unsupported action semantics, malformed or stale sample headers, and values that do not satisfy the current sample's required fields and reference values. Validate each supplied `AllowUnrestrictedProcessingTypeMeaning` and sample-confirmed `SelfServiceEnrollmentPathMeaning` through its selected read-only LOV; record `valid`, `invalid`, `ambiguous`, or `unverified_forbidden` per row and field. Supply `CustomSurrogateUserKey=UPSERT` without requesting user input.1703. Validate the DAT filename, encoding, `METADATA`/data-row column alignment, section hierarchy, record relationships, and any sample-declared date or effective-dating format. Format a supplied `SelfServiceEffectiveDate` as date-only `YYYY-MM-DD`; reject a malformed, time-bearing, or timezone-bearing value rather than silently changing its meaning. Preserve row-level validation errors; do not silently coerce other values.1714. Confirm prerequisite benefits configuration is ready through the selected workflow. An HTTP 403 from the conditional LOV check does not fail field validation; retain `unverified_forbidden` and continue independent checks. Require authoritative verification before live load if reference setup could not be verified.1725. Build a versioned immutable DAT/archive, capture its checksum, and preflight it through `core.data-loader`. A source, target, object, operation, or artifact change requires a new preflight.173174## HDL Operations and Approval Gates175176| Requested operation | HDL route | Control point |177| --- | --- | --- |178| Create or merge | Prepare a `benefitSelfServiceConfigurations` DAT solely from the current sample. | Validate and preflight the immutable artifact; obtain the Data Loader workflow approval immediately before upload. |179| Update | Prepare an update only when current metadata supports the required identity and action. | Do not guess PATCH or merge semantics; revalidate and obtain fresh approval. |180| Delete | Use a delete DAT only when the current sample supports deletion and the user explicitly requests it. | Treat as destructive and require explicit approval immediately before upload. |181| Read or verify | Inspect workflow-selected metadata or load status. | Read-only inspection does not authorize a later load. |182183Any live action is governed by `core.data-loader`'s approval workflow. This skill must not initiate an upload or load merely because a plan, sample, preview, or artifact was approved earlier.184185## Error Handling and Diagnostics186187Classify failures as `input_validation`, `catalog_or_metadata_mismatch`, `auth_expired_or_invalid`, `authorization_or_privilege`, `transport_or_environment`, `fusion_api_error`, `process_timeout`, `process_failed`, `artifact_persistence`, or `approval_blocker`.188189- Fail closed before side effects on invalid input, ambiguous identities, unsupported CSV routing, missing sample guidance, inactive Run Book, privilege failure, overwrite conflict, or missing approval.190- A cache-managed 401/403 may refresh once. Retry read-only transport failures only with bounded attempts. Never automatically retry a live upload, initiation, create, update, or delete; an idempotency key or fresh explicit approval is required.191- For the conditional `commonLookupsLOV` checks, a 403 is `unverified_forbidden`, not an invalid field value; do not throw a field-validation error. It still requires authoritative verification before live load.192- On a timeout, stop polling and record the environment, operation, task code, object, ProcessId/requestId, last status, elapsed wait, and next-check path. Do not submit a second load.193- On terminal failure or partial completion, retrieve the available process log or status payload; preserve successful row outcomes and an `errors` array for failed rows.194- Persist sanitized `hdl_preflight_result` and `load_diagnostic` artifacts under this skill's declared project workspace. Include status, stage, failure class, message, recommended action, environment, artifact references, checksum, and external identifiers. Never print or persist credentials, tokens, token caches, private keys, customer-sensitive values, or full payload contents.195196## CSV Export, Import, and Validation Workflow197198`CSVExportImportSupportedFlag` is `N`, so this task is not marked as CSV export/import supported in the effective setup-task catalog.199200Do 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.201202203204205## Inputs206207- `implementation_objective`208- `project_context`209- `setup_task_scope`210- `setup_data_artifacts`211212## Outputs213214- `setup_task_plan`215- `setup_data_routing`216- `validation_checkpoints`217- `hdl_preflight_result`218- `load_diagnostic`219- `skill_run_record`220- `token_usage_record`221222## Implementation Notes223224Use the parent functional-area skill `hcm.benefits-configuration.benefits-general-configuration` for functional-area sequencing and scope decisions. Read the task-local `ora-resource/ora_reference_lookups.md` before reference validation. Track token usage for any generated project artifact or skill-run record using the manifest policy.