Assign Legal Entities Setup Task Guidance
Purpose
Provides task-specific setup planning, routing, export, import, and validation guidance for Assign Legal Entities under General Ledger.
Setup Task Skill Contract
- task_code:
GL_ASSIGN_LEGAL_ENTITIES
- task_name:
Assign Legal Entities
- parent_skill_id:
erp.financials.general-ledger
- pillar:
ERP
- offering:
Financials
- functional_area:
General Ledger
- functional_area_code:
ORA_FIN_GENERAL_LEDGER
- available_flag:
Y
- export_import_supported_flag:
Y
- csv_export_import_supported_flag:
Y
- dataloader_import_mode:
FSM
- businessObject: ``
- source_catalog:
knowledge/setup-task-catalog/effective/setupTasksAll.json
Usage
Use this skill when planning, sequencing, exporting, importing, or validating setup data for Assign Legal Entities under General Ledger.
In assisted mode, route reference reads, the approved scoped export, and package download through the declared core/shared services, then prepare the proposed import artifact for review. Import execution and its approval workflow remain delegated to core.data-loader.
Read Order
- Read the Task-Local Plan Validation and Node Execution sections below. They define this task's runtime contract.
- Read the task registry and select exactly one entry for
GL_ASSIGN_LEGAL_ENTITIES / Assign Legal Entities.
- Read each reachable node's source heading and owning rule tables in this skill's
ora-resource/ folder, including every named resolver definition in reference lookups. Complete Task-Local Plan Validation before starting any node.
- Read error handling before preview or external execution, and read the owning source rules again before performing each reached node.
- Load
core.fusion-api.rest-api-client when a node reaches a declared live resolver or the scoped-export create step.
- Load
shared.setup-export.fsm-csv-export only after that create step returns a ProcessId.
Task-Local Plan Validation
Build setup_task_plan directly from the shipped registry and its local source tables. This is an LLM validation step; it requires no authoring tool or planner script. Before any external request, require all of the following:
| Check |
Required result |
| Task identity and readiness |
Registry schema is 3.0, representation is nested, and the selected task matches this manifest's code and name. Task and reachable-node readiness are ready, with empty blocking_reasons. |
| Graph integrity |
Node IDs are unique; start_node is ALE.VALIDATE_INPUT; every prerequisite and transition target exists in this task; the graph is acyclic; every reachable nonterminal has declared outcomes and every path ends at a terminal with no outgoing transitions. |
| Source integrity |
Every source.file resolves inside this skill's ora-resource/ folder and its heading exists. Match each node by Rule ID to exactly one source Task Nodes row; node type, sequence, action type, transitions, prerequisites, failure behavior, and applicability must agree. Treat source line numbers as navigation hints, not proof of agreement. |
| Rule and resolver completeness |
Read the owning validation, dependency, lookup, defaulting, design, and error rules for every reachable node. Each named resolver has exactly one local or live definition with its source, match rule, outputs, and failure behavior. Missing definitions, unresolved TBD values, or contradictions block the plan. |
| Supported actions and routes |
This task uses validate_input, reference_lookup, resolve_dependency, apply_default, design_enforcement, execution_gate, and terminal. Live resolvers use the declared REST client; local rules stay local. ALE.ACQUIRE_SCOPED_EXPORT coordinates only the scoped-export operation explicitly defined in dependency readiness. A node's action or route label alone does not authorize an external operation. |
| Request boundary |
The normalized request is direct legal-entity assignment to a primary ledger. Removal, reassignment, ledger-child authoring, and balancing-segment assignment are unsupported. Validate supplied inputs at ALE.VALIDATE_INPUT before any lookup. |
Only after these checks pass, record a machine-readable setup_task_plan with status: planned, validation.status: ready, exact task identity, start node, the validated graph, and checked source references. A ready plan permits entry into the graph; each node still requires current evidence and its operation-specific gates.
For a missing, stale, inconsistent, or incomplete graph or source, stop with FAILED before external execution. Record the failed check, Rule ID/source when available, failure class, and corrective action in the project's diagnostics. Use input validation for malformed or incomplete contracts and catalog mismatch for task identity disagreement. Request correction of the ALE resources and registry; do not repair the graph during execution or substitute an undeclared route.
Node Execution
- Start at
ALE.VALIDATE_INPUT. Follow declared transition outcomes; sequence numbers do not authorize skipping a node. Every listed prerequisite must have succeeded in the current run before a node can execute.
- Apply only the reached node's owning source rules and named resolvers. Record the observed outcome and sanitized evidence, then follow its exact transition target. An unlisted outcome stops with
FAILED; never invent a transition, lookup, default, retry, or cross-task action.
- Complete the active workflow's environment, identity, privilege, catalog, payload, artifact, and approval checks before each external operation. Obtain approval for the exact target environment, operation, and scoped-export payload immediately before the create request. Submit at most once in the run and pass its returned ProcessId to the declared polling/download skill.
- At
ALE.PREVIEW_GATE, use the immutable artifact and approval workflow owned by core.data-loader; carry that approval into the declared handoff without requesting the same approval twice. The ALE graph does not execute the import. ALE.READY_FOR_IMPORT means ready for that handoff, not that an assignment was imported or verified. RETURN_ISSUES means stop and disclose the blocker.
- Maintain a task-local run record with the normalized request fingerprint, current node, completed path and outcomes, sanitized evidence references, missing requirements, preview/approval fingerprints, verified side effects, and safe resume stage. Persist it and token usage under the manifest's project locations; exclude credentials, tokens, sensitive payloads, and protected response data.
- On resume, compare the request fingerprint and refresh changed or time-sensitive evidence. A material input, environment, package, or delta change invalidates preview and approval. Reconcile any uncertain mutation through the declared safe verification route before considering a retry; never replay it automatically.
The handoff must report task code and name, status, current or terminal Rule ID and action type, completed path and outcomes, sanitized validated facts, blockers, verified side effects, and one safe next action with resume context. Use MISSING for an unresolved required fact or approval, UNSUPPORTED for an out-of-scope request, and FAILED for contract or execution failures. Do not claim assignment success from a ready plan, a successful lookup, an export receipt, or the import-readiness terminal.
Setup Task Metadata
- Task name:
Assign Legal Entities
- Task code:
GL_ASSIGN_LEGAL_ENTITIES
- Available:
Y
- Export/import supported:
Y
- CSV export/import supported:
Y
- CSV export/import routing:
supported
- Data Loader import mode:
FSM
- Business Object: ``
CSV Export, Import, and Validation Workflow
CSVExportImportSupportedFlag is Y, but this task requires a primary-ledger-scoped export. The task-local compiled ora-resource plan selects scoped REST creation followed by ProcessId-based polling and download.
- Execute the task-local plan only after Task-Local Plan Validation succeeds against
ora-resource/ora_rule_registry.json and its current source rules; do not use prior run outcomes as current evidence.
- At
ALE.ACQUIRE_SCOPED_EXPORT, use the route and exact scope values declared in ora-resource/ora_dependency_readiness.md. Use this declared scoped REST-create route; do not substitute shared.setup-export.task-level-export.
- Use
core.fusion-api.rest-api-client for the read-only GETs defined by resolve_primary_ledger and resolve_legal_entity_exact_identifier, plus exactly one separately approved scoped export-process POST after the primary-ledger gate passes. Do not submit additional POSTs. Follow the exact root-sibling JSON structure in ora-resource/ora_dependency_readiness.md; never nest the criteria array inside the process row. Then pass only the returned ProcessId to shared.setup-export.fsm-csv-export for polling and download.
- Validate the returned package and requested mapping through the remaining reached task nodes,
shared.validation.setup-data-validator, and shared.validation.reference-data-validator.
- Route any eventual import through
core.data-loader; preserve its immutable-preview and explicit-approval gates.
Use this task metadata when invoking those skills:
- Offering:
Financials
- Functional area / Setup Object:
General Ledger
- Setup task name:
Assign Legal Entities
- Setup task code:
GL_ASSIGN_LEGAL_ENTITIES
Inputs
implementation_objective
project_context
setup_task_scope
setup_data_artifacts
Outputs
setup_task_plan
setup_data_routing
validation_checkpoints
skill_run_record
token_usage_record
Implementation Notes
Use the parent functional-area skill erp.financials.general-ledger for functional-area sequencing and scope decisions. Track token usage for any generated project artifact or skill-run record using the manifest policy.
1---2skill_id: "erp.financials.general-ledger.assign-legal-entities"3name: assign-legal-entities-setup-task-guidance4description: "Provides task-specific setup guidance for Assign Legal Entities under the General Ledger functional area."5layer: "pillar"6pillar: "ERP"7offering: "Financials"8functional_area: "General Ledger"9functional_area_code: "ORA_FIN_GENERAL_LEDGER"10task_code: "GL_ASSIGN_LEGAL_ENTITIES"11task_name: "Assign Legal Entities"12parent_skill_id: "erp.financials.general-ledger"13available_flag: "Y"14export_import_supported_flag: "Y"15csv_export_import_supported_flag: "Y"16dataloader_import_mode: "FSM"17businessObject: ""18source_catalog: "knowledge/setup-task-catalog/effective/setupTasksAll.json"19type: "planning"20execution_mode: "assisted"21owner_team: "ERP financials 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 - "skill_run_record"33 - "token_usage_record"34depends_on:35 - "core.fusion-api.rest-api-client"36 - "shared.setup-export.fsm-csv-export"37 - "shared.validation.setup-data-validator"38 - "shared.validation.reference-data-validator"39 - "core.data-loader"40uses_core:41 - "core.fusion-api.rest-api-client"42 - "core.project-mgmt.artifact-version-manager"43 - "core.project-mgmt.artifact-registry-manager"44 - "core.project-mgmt.project-state-manager"45persists_project_state: true46token_usage_tracking:47 enabled: true48 granularity: "per_skill_run"49 artifact_type: "token_usage_record"50 default_location: "project/{project_id}/artifacts/shared/token-usage/current/token-usage-log.md"51 estimation_method: "chars/4 estimate unless exact tokenizer or API accounting is available"52 required_fields:53 - "activity_start_time"54 - "skill_id"55 - "task"56 - "trigger"57 - "artifacts_written"58 - "files_read"59 - "estimated_input_tokens"60 - "estimated_output_tokens"61 - "estimated_total_tokens"62 - "estimation_method"63 - "notes"64state_updates:65 - "setup_task_sequence"66 - "configuration_blueprints"67 - "validation_results"68 - "token_usage_records"69workspace_outputs:70 - artifact_type: "configuration_blueprint"71 default_location: "project/{project_id}/artifacts/pillars/erp/financials/general-ledger/assign-legal-entities/current/"72 versioning_policy: "major-new-version-minor-confirm-update"73 - artifact_type: "validation_result"74 default_location: "project/{project_id}/artifacts/pillars/erp/financials/general-ledger/assign-legal-entities/current/"75 versioning_policy: "major-new-version-minor-confirm-update"76 - artifact_type: "skill_run"77 default_location: "project/{project_id}/state/runs/"78 versioning_policy: "append-only"79 - artifact_type: "token_usage_record"80 default_location: "project/{project_id}/artifacts/shared/token-usage/current/token-usage-log.md"81 versioning_policy: "append-only"82applicability:83 industries:84 - "All"85 countries:86 - "All"87 fusion_releases:88 - "Current Oracle Fusion Cloud release"89side_effects:90 - "Performs declared read-only ledger and legal-entity lookups through core.fusion-api.rest-api-client."91 - "Creates one approved primary-ledger-scoped GL_ASSIGN_LEGAL_ENTITIES export process through core.fusion-api.rest-api-client."92 - "Polls the returned ProcessId and downloads the export package through shared.setup-export.fsm-csv-export."93 - "Writes setup plans, proposed import artifacts, validation evidence, run records, and token usage to the project workspace."94required_privileges:95 - "Read ledger reference data through ledgersLOV in the selected Fusion environment."96 - "Read legal-entity reference data through legalEntitiesLOV in the selected Fusion environment."97 - "Create and retrieve GL_ASSIGN_LEGAL_ENTITIES FSM CSV export processes, packages, and process logs."98metadata:99 source: https://skillmd.com/skills/oracle/assign-legal-entities-setup-task-guidance100---101102# Assign Legal Entities Setup Task Guidance103104## Purpose105106Provides task-specific setup planning, routing, export, import, and validation guidance for `Assign Legal Entities` under `General Ledger`.107108## Setup Task Skill Contract109110- task_code: `GL_ASSIGN_LEGAL_ENTITIES`111- task_name: `Assign Legal Entities`112- parent_skill_id: `erp.financials.general-ledger`113- pillar: `ERP`114- offering: `Financials`115- functional_area: `General Ledger`116- functional_area_code: `ORA_FIN_GENERAL_LEDGER`117- available_flag: `Y`118- export_import_supported_flag: `Y`119- csv_export_import_supported_flag: `Y`120- dataloader_import_mode: `FSM`121- businessObject: ``122- source_catalog: `knowledge/setup-task-catalog/effective/setupTasksAll.json`123124## Usage125126Use this skill when planning, sequencing, exporting, importing, or validating setup data for `Assign Legal Entities` under `General Ledger`.127128In assisted mode, route reference reads, the approved scoped export, and package download through the declared core/shared services, then prepare the proposed import artifact for review. Import execution and its approval workflow remain delegated to `core.data-loader`.129130## Read Order1311321. Read the Task-Local Plan Validation and Node Execution sections below. They define this task's runtime contract.1332. Read [the task registry](ora-resource/ora_rule_registry.json) and select exactly one entry for `GL_ASSIGN_LEGAL_ENTITIES` / `Assign Legal Entities`.1343. Read each reachable node's source heading and owning rule tables in this skill's `ora-resource/` folder, including every named resolver definition in [reference lookups](ora-resource/ora_reference_lookups.md). Complete Task-Local Plan Validation before starting any node.1354. Read [error handling](ora-resource/ora_error_handling.md) before preview or external execution, and read the owning source rules again before performing each reached node.1365. Load `core.fusion-api.rest-api-client` when a node reaches a declared live resolver or the scoped-export create step.1376. Load `shared.setup-export.fsm-csv-export` only after that create step returns a ProcessId.138139## Task-Local Plan Validation140141Build `setup_task_plan` directly from the shipped registry and its local source tables. This is an LLM validation step; it requires no authoring tool or planner script. Before any external request, require all of the following:142143| Check | Required result |144|---|---|145| Task identity and readiness | Registry schema is `3.0`, representation is `nested`, and the selected task matches this manifest's code and name. Task and reachable-node readiness are `ready`, with empty `blocking_reasons`. |146| Graph integrity | Node IDs are unique; `start_node` is `ALE.VALIDATE_INPUT`; every prerequisite and transition target exists in this task; the graph is acyclic; every reachable nonterminal has declared outcomes and every path ends at a terminal with no outgoing transitions. |147| Source integrity | Every `source.file` resolves inside this skill's `ora-resource/` folder and its heading exists. Match each node by Rule ID to exactly one source `Task Nodes` row; node type, sequence, action type, transitions, prerequisites, failure behavior, and applicability must agree. Treat source line numbers as navigation hints, not proof of agreement. |148| Rule and resolver completeness | Read the owning validation, dependency, lookup, defaulting, design, and error rules for every reachable node. Each named resolver has exactly one local or live definition with its source, match rule, outputs, and failure behavior. Missing definitions, unresolved `TBD` values, or contradictions block the plan. |149| Supported actions and routes | This task uses `validate_input`, `reference_lookup`, `resolve_dependency`, `apply_default`, `design_enforcement`, `execution_gate`, and `terminal`. Live resolvers use the declared REST client; local rules stay local. `ALE.ACQUIRE_SCOPED_EXPORT` coordinates only the scoped-export operation explicitly defined in [dependency readiness](ora-resource/ora_dependency_readiness.md). A node's action or route label alone does not authorize an external operation. |150| Request boundary | The normalized request is direct legal-entity assignment to a primary ledger. Removal, reassignment, ledger-child authoring, and balancing-segment assignment are unsupported. Validate supplied inputs at `ALE.VALIDATE_INPUT` before any lookup. |151152Only after these checks pass, record a machine-readable `setup_task_plan` with `status: planned`, `validation.status: ready`, exact task identity, start node, the validated graph, and checked source references. A ready plan permits entry into the graph; each node still requires current evidence and its operation-specific gates.153154For a missing, stale, inconsistent, or incomplete graph or source, stop with `FAILED` before external execution. Record the failed check, Rule ID/source when available, failure class, and corrective action in the project's diagnostics. Use `input validation` for malformed or incomplete contracts and `catalog mismatch` for task identity disagreement. Request correction of the ALE resources and registry; do not repair the graph during execution or substitute an undeclared route.155156## Node Execution1571581. Start at `ALE.VALIDATE_INPUT`. Follow declared transition outcomes; sequence numbers do not authorize skipping a node. Every listed prerequisite must have succeeded in the current run before a node can execute.1592. Apply only the reached node's owning source rules and named resolvers. Record the observed outcome and sanitized evidence, then follow its exact transition target. An unlisted outcome stops with `FAILED`; never invent a transition, lookup, default, retry, or cross-task action.1603. Complete the active workflow's environment, identity, privilege, catalog, payload, artifact, and approval checks before each external operation. Obtain approval for the exact target environment, operation, and scoped-export payload immediately before the create request. Submit at most once in the run and pass its returned ProcessId to the declared polling/download skill.1614. At `ALE.PREVIEW_GATE`, use the immutable artifact and approval workflow owned by `core.data-loader`; carry that approval into the declared handoff without requesting the same approval twice. The ALE graph does not execute the import. `ALE.READY_FOR_IMPORT` means ready for that handoff, not that an assignment was imported or verified. `RETURN_ISSUES` means stop and disclose the blocker.1625. Maintain a task-local run record with the normalized request fingerprint, current node, completed path and outcomes, sanitized evidence references, missing requirements, preview/approval fingerprints, verified side effects, and safe resume stage. Persist it and token usage under the manifest's project locations; exclude credentials, tokens, sensitive payloads, and protected response data.1636. On resume, compare the request fingerprint and refresh changed or time-sensitive evidence. A material input, environment, package, or delta change invalidates preview and approval. Reconcile any uncertain mutation through the declared safe verification route before considering a retry; never replay it automatically.164165The handoff must report task code and name, status, current or terminal Rule ID and action type, completed path and outcomes, sanitized validated facts, blockers, verified side effects, and one safe next action with resume context. Use `MISSING` for an unresolved required fact or approval, `UNSUPPORTED` for an out-of-scope request, and `FAILED` for contract or execution failures. Do not claim assignment success from a ready plan, a successful lookup, an export receipt, or the import-readiness terminal.166167## Setup Task Metadata168169- Task name: `Assign Legal Entities`170- Task code: `GL_ASSIGN_LEGAL_ENTITIES`171- Available: `Y`172- Export/import supported: `Y`173- CSV export/import supported: `Y`174- CSV export/import routing: `supported`175- Data Loader import mode: `FSM`176- Business Object: ``177178## CSV Export, Import, and Validation Workflow179180`CSVExportImportSupportedFlag` is `Y`, but this task requires a primary-ledger-scoped export. The task-local compiled `ora-resource` plan selects scoped REST creation followed by ProcessId-based polling and download.1811821. Execute the task-local plan only after Task-Local Plan Validation succeeds against `ora-resource/ora_rule_registry.json` and its current source rules; do not use prior run outcomes as current evidence.1832. At `ALE.ACQUIRE_SCOPED_EXPORT`, use the route and exact scope values declared in `ora-resource/ora_dependency_readiness.md`. Use this declared scoped REST-create route; do not substitute `shared.setup-export.task-level-export`.1843. Use `core.fusion-api.rest-api-client` for the read-only GETs defined by `resolve_primary_ledger` and `resolve_legal_entity_exact_identifier`, plus exactly one separately approved scoped export-process POST after the primary-ledger gate passes. Do not submit additional POSTs. Follow the exact root-sibling JSON structure in `ora-resource/ora_dependency_readiness.md`; never nest the criteria array inside the process row. Then pass only the returned ProcessId to `shared.setup-export.fsm-csv-export` for polling and download.1854. Validate the returned package and requested mapping through the remaining reached task nodes, `shared.validation.setup-data-validator`, and `shared.validation.reference-data-validator`.1865. Route any eventual import through `core.data-loader`; preserve its immutable-preview and explicit-approval gates.187188Use this task metadata when invoking those skills:189190- Offering: `Financials`191- Functional area / Setup Object: `General Ledger`192- Setup task name: `Assign Legal Entities`193- Setup task code: `GL_ASSIGN_LEGAL_ENTITIES`194195196197198## Inputs199200- `implementation_objective`201- `project_context`202- `setup_task_scope`203- `setup_data_artifacts`204205## Outputs206207- `setup_task_plan`208- `setup_data_routing`209- `validation_checkpoints`210- `skill_run_record`211- `token_usage_record`212213## Implementation Notes214215Use the parent functional-area skill `erp.financials.general-ledger` for functional-area sequencing and scope decisions. Track token usage for any generated project artifact or skill-run record using the manifest policy.