Manage Trading Community Source Systems Setup Task Guidance
Purpose and Boundary
Use this skill only to export or import the complete FSM setup package for
Manage Trading Community Source Systems. Fix the task identity to
HZ_MANAGE_TRADING_COMMUNITY_SOURCE_SYSTEMS under Trading Community Foundation.
Do not use this skill for planning, sequencing, standalone validation, template
generation, filtered exports, or individual source-system inspection or
maintenance. Validation is permitted only as a mandatory preflight for an
export or import.
Supported Operations
export: export every setup-data object owned by the fixed task as one
unfiltered, non-template FSM package through
shared.setup-export.task-level-export.
import: import one complete, unchanged FSM ZIP for the fixed task through
the mandatory core.data-loader workflow.
Treat a migration request as these two operations in sequence. Finish and
persist the source export before starting a separate target import preflight
and approval.
Fixed Task Context
- Pillar:
CX
- Offering:
Customer Data Management
- Functional area:
Trading Community Foundation
- Functional area code:
ORA_HZ_CDM_FOUNDATION
- Task name:
Manage Trading Community Source Systems
- Task code:
HZ_MANAGE_TRADING_COMMUNITY_SOURCE_SYSTEMS
- CSV export/import supported:
Y
- Data Loader import mode:
FSM
Never accept a task-code, offering, or functional-area override.
Whole-Task FSM Export
Require project_id and the named source Fusion environment. Resolve the
live task by the exact fixed task code and confirm
CSVExportImportSupportedFlag=Y; fail closed on a mismatch.
Fix template_only=false and export_criteria=[]. Refuse every filter,
business-object subset, and template/specification request.
Show the source environment, task name/code, unfiltered whole-task scope,
output directory, and one-process impact. Obtain explicit approval
immediately before the export POST.
Invoke shared.setup-export.task-level-export exactly once with the fixed
context. Use its shared FSM engine for submission, polling, ZIP or
ProcessLog retrieval, and packaging; do not implement task-local REST.
Run the approved command with unbuffered output:
python3 -u shared/setup-export/task-level-export/scripts/export_setup_task_csv.py \
--data \
--task-code HZ_MANAGE_TRADING_COMMUNITY_SOURCE_SYSTEMS \
--offering-name "Customer Data Management" \
--functional-area-name "Trading Community Foundation" \
--project-id "{project_id}" \
--output-dir project/{project_id}/exports/customer-data-management/trading-community-foundation/manage-trading-community-source-systems/ \
--token-cache auto \
--wait-seconds 300 \
--poll-interval 10
If the command runner yields a session or cell identifier, wait on that same
process until it exits. The -u option exposes the shared exporter's
Started ... process: <ProcessId> line without changing shared code.
Capture that identifier in the task skill's run record. Empty initial output
is not failure, and must not trigger a replacement export.
Persist the ProcessId as soon as it is returned. On success, verify the ZIP,
calculate SHA-256, store it in the declared export directory, register it,
and update project state.
On timeout, preserve the same ProcessId, last status, and elapsed time.
Resume only that process after a later request; never submit a replacement
export automatically.
Whole-Task FSM Import Through Data Loader
Require project_id, the named target Fusion environment, and one explicit
ZIP path. Reject loose CSV files, multiple archives, and directory scans.
Verify that the file is a readable ZIP containing exactly one member whose
basename is ASM_SETUP_CSV_METADATA.xml, and require its single
ObjectShortName to equal HZ_MANAGE_TRADING_COMMUNITY_SOURCE_SYSTEMS.
Preserve the archive byte for byte and calculate its SHA-256.
Invoke core.data-loader with the fixed task context and
dataloader_import_mode=FSM. Let Data Loader own source review, task
validation, FSM adapter selection, immutable preview creation, approval,
upload/initiation, and user-friendly reporting. Start with:
python3 core/data-loader/scripts/upload_and_initiate.py "{setup_data_zip_path}"
Require the task-routed preview and approval envelope to retain
executionRoute=data-loader, sourceType=FSM, the exact task code/name,
absolute archive path, archive SHA-256, and wholeTask=true.
Treat the initial import request as validation only. Display the exact target,
fixed task code, ZIP path and hash, and impact statement; stop before the
first POST. Continue only after the separate user message required by
core.data-loader approves that immutable artifact. Then use Data Loader's
approved task-routed command with the envelope returned by Task Hook:
python3 core/data-loader/scripts/upload_and_initiate.py "{setup_data_zip_path}" \
--task-routed \
--task-validation-envelope "{task_validation_envelope_path}" \
--approve-upload
Do not invoke setupTaskCSVImports, a shared import script, UCM upload, or a
product adapter directly from this skill. Any changed target, archive bytes,
task context, or execution option invalidates approval and restarts Data
Loader preflight.
Persist the accepted execution result and available redacted diagnostics in
the declared report path. Check status only when the user asks, and never
resubmit an import while its outcome is uncertain.
Error and Retry Contract
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.
- Refresh a cache-managed token once after a read-only 401 or 403. A second
authentication response blocks execution.
- Never retry an export or import POST automatically. Require a new immutable
preview and explicit approval before any new submission.
- On timeout or failure, report the environment, operation, task code,
ProcessId or request ID when available, last status, elapsed time,
diagnostic artifact, and recommended next action.
- Never print or persist tokens, secrets, authorization headers, token-cache
contents, full Base64 payloads, or sensitive customer data.
Result Contract
For export, report the source environment, fixed task name/code, ProcessId,
status, ZIP or log path, enclosure type, and ZIP SHA-256 when available. For
import, return the complete core.data-loader Markdown result and report the
target environment, fixed task name/code, immutable ZIP path and hash, status,
and available process log. Record the skill run and token usage for every
durable project activity.
Refusal Rules
- Refuse individual source-system creation, editing, deletion, or inspection.
- Refuse filtered, partial, criteria-based, and template/specification exports.
- Refuse task-code overrides, loose CSV files, edited or repacked ZIPs, and
packages that Data Loader cannot confirm as the fixed FSM task.
- Refuse direct endpoint, script, or adapter execution that bypasses the
required approval workflow.
Golden Scenarios
| Request |
Expected route |
| Export all trading-community source systems from TEST |
Approve and run one unfiltered FSM task export; persist the ZIP, hash, and process result |
| Import the complete exported ZIP into UAT |
Run core.data-loader preflight, require its separate immutable-artifact approval, and submit one FSM import |
| Export only one source system |
Refuse partial scope without making a Fusion call |
| Create or edit a source system |
Refuse record-level maintenance without making a Fusion call |
Sources
knowledge/setup-task-catalog/effective/setupTasksAll.json
shared/setup-export/task-level-export/SKILL.md
core/data-loader/SKILL.md
1---2skill_id: "cx.customer-data-management.trading-community-foundation.manage-trading-community-source-systems"3name: manage-trading-community-source-systems-setup-task-guidance4description: "Exports or imports the complete Manage Trading Community Source Systems setup-task data as an unfiltered Oracle Fusion FSM package. Use only for whole-task FSM export/import; route every import through core.data-loader and refuse record-level maintenance, filtered or template exports, and direct REST or loader execution."5layer: "pillar"6pillar: "CX"7offering: "Customer Data Management"8functional_area: "Trading Community Foundation"9functional_area_code: "ORA_HZ_CDM_FOUNDATION"10task_code: "HZ_MANAGE_TRADING_COMMUNITY_SOURCE_SYSTEMS"11task_name: "Manage Trading Community Source Systems"12parent_skill_id: "cx.customer-data-management.trading-community-foundation"13available_flag: "Y"14export_import_supported_flag: "Y"15csv_export_import_supported_flag: "Y"16dataloader_import_mode: "FSM"17source_catalog: "knowledge/setup-task-catalog/effective/setupTasksAll.json"18type: "orchestration"19execution_mode: "hybrid"20owner_team: "CX customer data management pillar team"21version: "0.2.0"22inputs:23 - "operation"24 - "project_id"25 - "fusion_environment_context"26 - "setup_data_zip_path"27 - "execution_options"28 - "execution_approval"29outputs:30 - "configuration_export"31 - "export_submission_record"32 - "data_load_execution_result"33 - "diagnostics"34 - "skill_run_record"35 - "token_usage_record"36depends_on:37 - "shared.setup-export.task-level-export"38 - "core.data-loader"39uses_core:40 - "core.auth.fusion-oauth-authentication"41 - "core.project-mgmt.artifact-registry-manager"42 - "core.project-mgmt.project-state-manager"43persists_project_state: true44token_usage_tracking:45 enabled: true46 granularity: "per_skill_run"47 artifact_type: "token_usage_record"48 default_location: "project/{project_id}/artifacts/shared/token-usage/current/token-usage-log.md"49 estimation_method: "chars/4 estimate unless exact tokenizer or API accounting is available"50 required_fields:51 - "activity_start_time"52 - "skill_id"53 - "task"54 - "trigger"55 - "artifacts_written"56 - "files_read"57 - "estimated_input_tokens"58 - "estimated_output_tokens"59 - "estimated_total_tokens"60 - "estimation_method"61 - "notes"62state_updates:63 - "exports"64 - "reports"65 - "token_usage_records"66workspace_outputs:67 - artifact_type: "configuration_export"68 default_location: "project/{project_id}/exports/customer-data-management/trading-community-foundation/manage-trading-community-source-systems/"69 versioning_policy: "append-only"70 - artifact_type: "report"71 default_location: "project/{project_id}/artifacts/pillars/cx/customer-data-management/trading-community-foundation/manage-trading-community-source-systems/current/"72 versioning_policy: "append-only"73 - artifact_type: "skill_run"74 default_location: "project/{project_id}/state/runs/"75 versioning_policy: "append-only"76 - artifact_type: "token_usage_record"77 default_location: "project/{project_id}/artifacts/shared/token-usage/current/token-usage-log.md"78 versioning_policy: "append-only"79applicability:80 industries:81 - "All"82 countries:83 - "All"84 fusion_releases:85 - "Current Oracle Fusion Cloud release"86side_effects:87 - "After explicit approval, creates and polls one whole-task FSM export process and writes its ZIP or process log to the project workspace."88 - "After the separate core.data-loader approval gate, imports one immutable whole-task FSM ZIP and can change source-system configuration in the target Fusion environment."89 - "Writes redacted execution, diagnostic, run, artifact-registry, state, and token-usage records under the selected project workspace."90required_privileges:91 - "Fusion privileges to discover the setup task and run setup task CSV exports."92 - "Fusion privileges to submit, inspect, and retrieve logs for setup task CSV imports."93metadata:94 source: https://skillmd.com/skills/oracle/manage-trading-community-source-systems-setup-task-guidance95---9697# Manage Trading Community Source Systems Setup Task Guidance9899## Purpose and Boundary100101Use this skill only to export or import the complete FSM setup package for102`Manage Trading Community Source Systems`. Fix the task identity to103`HZ_MANAGE_TRADING_COMMUNITY_SOURCE_SYSTEMS` under `Trading Community104Foundation`.105106Do not use this skill for planning, sequencing, standalone validation, template107generation, filtered exports, or individual source-system inspection or108maintenance. Validation is permitted only as a mandatory preflight for an109export or import.110111## Supported Operations1121131. `export`: export every setup-data object owned by the fixed task as one114 unfiltered, non-template FSM package through115 `shared.setup-export.task-level-export`.1162. `import`: import one complete, unchanged FSM ZIP for the fixed task through117 the mandatory `core.data-loader` workflow.118119Treat a migration request as these two operations in sequence. Finish and120persist the source export before starting a separate target import preflight121and approval.122123## Fixed Task Context124125- Pillar: `CX`126- Offering: `Customer Data Management`127- Functional area: `Trading Community Foundation`128- Functional area code: `ORA_HZ_CDM_FOUNDATION`129- Task name: `Manage Trading Community Source Systems`130- Task code: `HZ_MANAGE_TRADING_COMMUNITY_SOURCE_SYSTEMS`131- CSV export/import supported: `Y`132- Data Loader import mode: `FSM`133134Never accept a task-code, offering, or functional-area override.135136## Whole-Task FSM Export1371381. Require `project_id` and the named source Fusion environment. Resolve the139 live task by the exact fixed task code and confirm140 `CSVExportImportSupportedFlag=Y`; fail closed on a mismatch.1412. Fix `template_only=false` and `export_criteria=[]`. Refuse every filter,142 business-object subset, and template/specification request.1433. Show the source environment, task name/code, unfiltered whole-task scope,144 output directory, and one-process impact. Obtain explicit approval145 immediately before the export POST.1464. Invoke `shared.setup-export.task-level-export` exactly once with the fixed147 context. Use its shared FSM engine for submission, polling, ZIP or148 `ProcessLog` retrieval, and packaging; do not implement task-local REST.149 Run the approved command with unbuffered output:150151 ```bash152 python3 -u shared/setup-export/task-level-export/scripts/export_setup_task_csv.py \153 --data \154 --task-code HZ_MANAGE_TRADING_COMMUNITY_SOURCE_SYSTEMS \155 --offering-name "Customer Data Management" \156 --functional-area-name "Trading Community Foundation" \157 --project-id "{project_id}" \158 --output-dir project/{project_id}/exports/customer-data-management/trading-community-foundation/manage-trading-community-source-systems/ \159 --token-cache auto \160 --wait-seconds 300 \161 --poll-interval 10162 ```163164 If the command runner yields a session or cell identifier, wait on that same165 process until it exits. The `-u` option exposes the shared exporter's166 `Started ... process: <ProcessId>` line without changing shared code.167 Capture that identifier in the task skill's run record. Empty initial output168 is not failure, and must not trigger a replacement export.1695. Persist the `ProcessId` as soon as it is returned. On success, verify the ZIP,170 calculate SHA-256, store it in the declared export directory, register it,171 and update project state.1726. On timeout, preserve the same `ProcessId`, last status, and elapsed time.173 Resume only that process after a later request; never submit a replacement174 export automatically.175176## Whole-Task FSM Import Through Data Loader1771781. Require `project_id`, the named target Fusion environment, and one explicit179 ZIP path. Reject loose CSV files, multiple archives, and directory scans.1802. Verify that the file is a readable ZIP containing exactly one member whose181 basename is `ASM_SETUP_CSV_METADATA.xml`, and require its single182 `ObjectShortName` to equal `HZ_MANAGE_TRADING_COMMUNITY_SOURCE_SYSTEMS`.183 Preserve the archive byte for byte and calculate its SHA-256.1843. Invoke `core.data-loader` with the fixed task context and185 `dataloader_import_mode=FSM`. Let Data Loader own source review, task186 validation, FSM adapter selection, immutable preview creation, approval,187 upload/initiation, and user-friendly reporting. Start with:188189 ```bash190 python3 core/data-loader/scripts/upload_and_initiate.py "{setup_data_zip_path}"191 ```192193 Require the task-routed preview and approval envelope to retain194 `executionRoute=data-loader`, `sourceType=FSM`, the exact task code/name,195 absolute archive path, archive SHA-256, and `wholeTask=true`.1964. Treat the initial import request as validation only. Display the exact target,197 fixed task code, ZIP path and hash, and impact statement; stop before the198 first POST. Continue only after the separate user message required by199 `core.data-loader` approves that immutable artifact. Then use Data Loader's200 approved task-routed command with the envelope returned by Task Hook:201202 ```bash203 python3 core/data-loader/scripts/upload_and_initiate.py "{setup_data_zip_path}" \204 --task-routed \205 --task-validation-envelope "{task_validation_envelope_path}" \206 --approve-upload207 ```2085. Do not invoke `setupTaskCSVImports`, a shared import script, UCM upload, or a209 product adapter directly from this skill. Any changed target, archive bytes,210 task context, or execution option invalidates approval and restarts Data211 Loader preflight.2126. Persist the accepted execution result and available redacted diagnostics in213 the declared report path. Check status only when the user asks, and never214 resubmit an import while its outcome is uncertain.215216## Error and Retry Contract217218Classify failures as `input_validation`, `catalog_or_metadata_mismatch`,219`auth_expired_or_invalid`, `authorization_or_privilege`,220`transport_or_environment`, `fusion_api_error`, `process_timeout`,221`process_failed`, `artifact_persistence`, or `approval_blocker`.222223- Refresh a cache-managed token once after a read-only 401 or 403. A second224 authentication response blocks execution.225- Never retry an export or import POST automatically. Require a new immutable226 preview and explicit approval before any new submission.227- On timeout or failure, report the environment, operation, task code,228 `ProcessId` or request ID when available, last status, elapsed time,229 diagnostic artifact, and recommended next action.230- Never print or persist tokens, secrets, authorization headers, token-cache231 contents, full Base64 payloads, or sensitive customer data.232233## Result Contract234235For export, report the source environment, fixed task name/code, `ProcessId`,236status, ZIP or log path, enclosure type, and ZIP SHA-256 when available. For237import, return the complete `core.data-loader` Markdown result and report the238target environment, fixed task name/code, immutable ZIP path and hash, status,239and available process log. Record the skill run and token usage for every240durable project activity.241242## Refusal Rules243244- Refuse individual source-system creation, editing, deletion, or inspection.245- Refuse filtered, partial, criteria-based, and template/specification exports.246- Refuse task-code overrides, loose CSV files, edited or repacked ZIPs, and247 packages that Data Loader cannot confirm as the fixed FSM task.248- Refuse direct endpoint, script, or adapter execution that bypasses the249 required approval workflow.250251## Golden Scenarios252253| Request | Expected route |254|---|---|255| Export all trading-community source systems from TEST | Approve and run one unfiltered FSM task export; persist the ZIP, hash, and process result |256| Import the complete exported ZIP into UAT | Run `core.data-loader` preflight, require its separate immutable-artifact approval, and submit one FSM import |257| Export only one source system | Refuse partial scope without making a Fusion call |258| Create or edit a source system | Refuse record-level maintenance without making a Fusion call |259260## Sources261262- `knowledge/setup-task-catalog/effective/setupTasksAll.json`263- `shared/setup-export/task-level-export/SKILL.md`264- `core/data-loader/SKILL.md`