bw_write_dtp
Create, update, or configure a Data Transfer Process, including filters, filter routines, extraction modes, and batch/error-handling settings, for SAP BW/4HANA modeling.
Instructions
Create or change a DTP, including its filters and a filter routine. The operation enum lists every operation with what it requires; bw_describe(tool: "bw_write_dtp", operation: "…") gives the complete parameter definition of one.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"operation": "<operation>"
},
"name": "bw_write_dtp"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| package | No | Development package (default "$TMP"). [create] | |
| dtp_name | No | Defined per operation — bw_describe(tool: "bw_write_dtp", operation: "…") gives each definition. [update, set_filter_routine] | |
| operation | Yes | Operation — one of: create: Create a new DTP (Data Transfer Process) for an existing Transformation and activate it. Requires trfn_name, source_name, source_type, target_name, target_type. | update: Update DTP properties: description, the value selection of one filter field, extraction mode (Full vs Delta), and/or the semantic group. Requires dtp_name. | set_filter_routine: Set an ABAP filter routine on a DTP filter field. Requires dtp_name, field_name, routine_code. | |
| transport | No | Transport request number. [update] | |
| trfn_name | No | Technical name of the existing Transformation (UUID-like key). [create] | |
| field_name | No | Filter field name as it appears in the DTP XML fields element. [set_filter_routine] | |
| batch_class | No | Batch manager: job priority (class A, B or C). [update] | |
| description | No | Defined per operation — bw_describe(tool: "bw_write_dtp", operation: "…") gives each definition. [create, update] | |
| global_code | No | Optional global declarations for the routine. [set_filter_routine] | |
| server_name | No | Batch manager: the server group or host name for server_type "group" or "host"; an empty string clears it. [update] | |
| server_type | No | Batch manager: where the parallel jobs run; with "group" or "host", pass server_name. [update] | |
| source_name | No | Source object name (e.g. [create] | |
| source_type | No | g. [create] | |
| target_name | No | Target object name (e.g. [create] | |
| target_type | No | Target object type (e.g. [create] | |
| trfn_name_2 | No | Optional second transformation in a multi-step chain. [create] | |
| filter_field | No | Filter field to set. Use the exact field name from bw_get_dtp; a name that does not exist is rejected. Requires filter_value or filter_selections. [create, update] | |
| filter_value | No | One or more values for an Equal selection, comma-separated (e.g. Full definition: bw_describe(tool: "bw_write_dtp", operation: "create"). [create, update] | |
| package_size | No | Extraction: package size in records (at least 1). [update] | |
| routine_code | No | ABAP routine code (plain text, without FORM/ENDFORM wrapper). [set_filter_routine] | |
| source_system | No | Source system name of the DataSource. [create] | |
| track_records | No | Error handling: track records after a failed request. [update] | |
| hana_execution | No | Runtime: execute the DTP in SAP HANA. [update] | |
| extraction_mode | No | Switch the DTP extraction mode. [update] | |
| level_of_detail | No | Runtime: level of detail of the temporary storage (trace by package, erroneous records, or by record). [update] | |
| filter_excluding | No | If true, all values of filter_value are excluded instead of included. Default false. Applies to filter_value only; filter_selections carries a sign per entry. [create, update] | |
| request_handling | No | Error handling: what happens to a request with errors. [update] | |
| filter_selections | No | Full selection vocabulary for one filter field, equivalent to an ABAP RANGE table. Full definition: bw_describe(tool: "bw_write_dtp", operation: "create"). [create, update] | |
| parallel_processes | No | Batch manager: number of parallel processes (1..99). [update] | |
| filter_clear_fields | No | Comma-separated list of field names whose value selections are removed. [update] | |
| only_get_delta_once | No | Request selection, delta only: only get the delta once (DELTAONLYONCE). [update] | |
| parallel_extraction | No | Extraction: extract data packages in parallel. [update] | |
| semantic_group_fields | No | Comma-separated list of field names that form the semantic group (e.g. [update] | |
| target_object_subtype | No | InfoObject sub-object to load into. [create] | |
| transport_lock_holder | No | Transport lock holder. [update] | |
| overall_request_status | No | Execution: how the overall request status is set. [update] | |
| delta_init_without_data | No | Request selection, delta only: perform the delta initialization without data transfer (INITSIMU). [update] | |
| technical_request_status | No | Execution: technical status of a request with warnings. [update] | |
| extract_all_green_requests | No | Request selection: extract all green requests (ignore the overall status). [update] | |
| only_retrieve_last_request | No | Request selection: only retrieve the last request (ONLYLASTREQUEST). [update] | |
| number_of_errors_per_package | No | Error handling: maximum number of errors per package before the request is cancelled. [update] | |
| retrieve_until_no_more_new_data | No | Request selection: retrieve until no more new data (FETCHUNTILEOF). [update] | |
| get_all_new_data_request_by_request | No | Request selection, delta only: get all new data request by request (SINGLEREQUEST). [update] | |
| repeat_red_requests_in_process_chain | No | Execution: automatically repeat red requests when the DTP runs in a process chain. [update] |