bw_swap_process_chain_dtp
Swap a DTP load variant in an existing process chain using the BW/4HANA Cockpit REST API. Replaces only the specified DTP variant while preserving other chain elements.
Instructions
Swap one DTP load variant for another in an existing Process Chain (RSPC), via the BW/4HANA Cockpit REST API. In-place edit: reads the current model, replaces the matching DTP_LOAD node's variant, and PUTs it back — edges and all other nodes are preserved unchanged. Prefer this over bw_update_process_chain for a single-variant swap, since it does not require re-specifying the whole chain. Optionally activates afterwards. A 412 on the PUT means the ETag was stale (chain modified between read and write); the error reports this explicitly.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Process chain technical name (e.g. "CHAIN_NAME"). Case-insensitive. | |
| new_dtp | Yes | DTP variant name to set instead (e.g. "DTP_NAME_NEW"). | |
| old_dtp | Yes | DTP variant name currently in the chain (e.g. "DTP_NAME_OLD"). | |
| activate | No | If true, activate the chain immediately after the edit. Default false. | |
| transport_request | No | Optional transport request to record the change into. Only relevant when the chain is in a transportable package (not $TMP). If the chain is transportable and exactly one request is available, it is chosen automatically; pass this to disambiguate when several are available. Ignored for $TMP (local) chains. | |
| refresh_description | No | If true (default), pull the new variant's step description from its metadata. Cosmetic; the existing description is kept if metadata is unavailable. |