bw_create_dtp
Create and activate a Data Transfer Process (DTP) for an existing transformation in SAP BW/4HANA. Supports optional field filtering and multi-step transformation chains.
Instructions
Create a new DTP (Data Transfer Process) for an existing Transformation and activate it. The DTP name is server-generated. Optionally set a filter on one source field (Equal operator). After creation the DTP is activated automatically. IMPORTANT: Before calling this tool, always check the full transformation chain. Single-step chain (e.g. ADSO->ADSO): use trfn_name only. Two-step chain (e.g. ADSO->TRCS->ADSO): use trfn_name for the first transformation and trfn_name_2 for the second; source_name/source_type = the start object, target_name/target_type = the end object. Omitting trfn_name_2 in a two-step chain causes a persistent HTTP 500 error. Use bw_get_transformation or bw_xref to determine the chain before creating the DTP. DataSource source: set source_type "RSDS" and pass source_system (the DataSource source system). source_name is then the plain DataSource name; the tool builds the RSDS compound source key internally.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| package | No | Development package (default "$TMP"). | |
| trfn_name | Yes | Technical name of the existing Transformation (UUID-like key). | |
| description | No | Optional DTP description text (default: empty). | |
| source_name | Yes | Source object name (e.g. "SOURCE_NAME"). | |
| source_type | Yes | Source object type (e.g. "ADSO", "TRCS", "RSDS"). Use "RSDS" for a DataSource source — source_system is then required. | |
| target_name | Yes | Target object name (e.g. "TARGET_NAME"). | |
| target_type | Yes | Target object type (e.g. "ADSO"). Use "IOBJ" to load into an InfoObject; the loaded sub-object (attributes / texts / hierarchies) is selected with target_object_subtype. | |
| trfn_name_2 | No | Optional second transformation in a multi-step chain. Include when the DTP spans two transformations (e.g. ADSO→TRCS→ADSO). | |
| filter_field | No | Field name to filter on. Requires filter_dta_name and filter_value. | |
| filter_value | No | Filter value for the Equal selection (e.g. "PL_001"). | |
| source_system | No | Source system name of the DataSource. Required when source_type is "RSDS". | |
| filter_dta_name | No | Internal dtaName for the filter field. | |
| target_object_subtype | No | InfoObject sub-object to load into. Only applies when target_type is "IOBJ". ATTR (default) = attributes/master data (IOBJA), TEXT = texts (IOBJT), HIER = hierarchies (IOBJH). Must match the sub-object the transformation chain targets. |