clear_data
Remove scenario-specific financial data for a given year and period in Oracle EPM Cloud FCCS to maintain system accuracy and prepare for new entries.
Instructions
Clear data for specified scenario, year, and period / Limpar dados
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| scenario | No | Scenario to clear | |
| year | No | Year to clear | |
| period | No | Period to clear |
Implementation Reference
- fccs_agent/tools/data.py:246-270 (handler)Primary MCP tool handler function for 'clear_data'. Builds parameters from optional inputs (scenario, year, period) and delegates to the underlying FCCS client method.async def clear_data( scenario: Optional[str] = None, year: Optional[str] = None, period: Optional[str] = None ) -> dict[str, Any]: """Clear data for specified scenario, year, and period / Limpar dados. Args: scenario: Scenario to clear. year: Year to clear. period: Period to clear. Returns: dict: Job submission result. """ parameters = {} if scenario: parameters["scenario"] = scenario if year: parameters["year"] = year if period: parameters["period"] = period result = await _client.clear_data(_app_name, parameters) return {"status": "success", "data": result}
- fccs_agent/tools/data.py:409-420 (schema)JSON schema definition for the 'clear_data' tool input validation, part of TOOL_DEFINITIONS list used by MCP.{ "name": "clear_data", "description": "Clear data for specified scenario, year, and period / Limpar dados", "inputSchema": { "type": "object", "properties": { "scenario": {"type": "string", "description": "Scenario to clear"}, "year": {"type": "string", "description": "Year to clear"}, "period": {"type": "string", "description": "Period to clear"}, }, }, },
- fccs_agent/agent.py:164-164 (registration)Registration of the 'clear_data' tool handler in the central TOOL_HANDLERS dictionary, mapping name to data.clear_data function."clear_data": data.clear_data,
- Supporting client method in FccsClient that submits the CLEARDATA job to the FCCS REST API endpoint.async def clear_data( self, app_name: str, parameters: dict[str, Any] ) -> dict[str, Any]: """Clear data / Limpar dados.""" if self.config.fccs_mock_mode: return {"jobId": "402", "status": "Submitted", "jobType": "ClearData"} payload = {"jobType": "CLEARDATA", **parameters} response = await self._client.post( f"/{app_name}/jobs{self._get_query_params()}", json=payload ) response.raise_for_status() return response.json()
- fccs_agent/agent.py:193-195 (registration)Inclusion of data.py TOOL_DEFINITIONS (containing clear_data schema) into the aggregated ALL_TOOL_DEFINITIONS for MCP server.data.TOOL_DEFINITIONS + reports.TOOL_DEFINITIONS + consolidation.TOOL_DEFINITIONS +