sap-cli-skill/docs/adt/05.提交与传输-原理.md

---
title: 提交与传输 - 原理
created: 2026-05-18
tags:
  - SAP
  - ADT
  - transport
  - CTS
  - version-management
  - REST
parent: "[[sap-cli/README|SAP ADT 学习笔记总览]]"
prev: "[[sap-cli/04.检查代码-原理|04.检查代码 - 原理]]"
---

# 提交与传输 — 原理

> [!abstract] 核心概念
> SAP 中的 "提交代码" 与 Git 等版本控制系统不同。ABAP 使用 **CTS (Change and Transport System)** 来管理代码变更。代码修改被记录在 **传输请求 (Transport Request)** 中，通过传输请求将变更从开发系统 → 测试系统 → 生产系统进行迁移。

## 1. 传输管理概念模型

### 传输系统架构

```
┌──────────────┐     ┌──────────────┐     ┌──────────────┐
│   开发系统    │     │   测试系统    │     │   生产系统    │
│   (DEV)      │     │   (QAS)      │     │   (PRD)      │
│              │     │              │     │              │
│  创建/修改    │────▶│  测试/验证    │────▶│  部署上线     │
│  代码        │     │  代码        │     │  代码        │
└──────┬───────┘     └──────────────┘     └──────────────┘
       │
       │ 导出
       ▼
┌──────────────┐
│ 传输目录      │
│ (Transport   │
│  Directory)  │
│              │
│ .TR 文件     │
│ 数据文件     │
└──────────────┘
       │
       │ 导入
       ▼
   目标系统 (QAS/PRD)
```

### 传输请求结构

```
传输请求 (Transport Request - TR)
├── 请求头 (Request Header)
│   ├── 编号: K9XXXXXX
│   ├── 类型: K (Workbench) / W (Customizing) / T (Transport of Copies)
│   ├── 描述: "Implement sales order validation"
│   ├── 所有者: DEVELOPER01
│   ├── 状态: D (Modifiable) → R (Released)
│   └── 目标系统: QAS
│
├── 任务 (Task) — 可以有多个
│   ├── 编号: K9XXXXYY
│   ├── 所有者: DEVELOPER01
│   └── 状态: D → R
│
└── 对象列表 (Object List)
    ├── ZCL_SALES_ORDER (CLAS)
    ├── Z_SALES_REPORT (PROG)
    └── Z_SALES_TABLE (TABL)
```

## 2. ADT 中的传输工作流

### 完整流程

```
1. 创建传输请求
   ↓
2. 将对象分配到传输请求
   ↓
3. 开发/修改代码
   ↓
4. 激活代码
   ↓
5. (可选) 运行 ATC 检查
   ↓
6. 发布传输请求
   ↓
7. 导入到目标系统
```

## 3. REST API 详解

### 3.1 列出传输请求

```
GET /sap/bc/adt/cts/transportrequests
    ?user={username}
    &status={D|R}
```

| 参数 | 说明 |
|------|------|
| `user` | 按所有者过滤 |
| `status` | `D` = 可修改, `R` = 已发布 |

### 响应

```xml
<cts:transportRequests xmlns:cts="http://www.sap.com/adt/cts">
  <cts:request number="K900001"
               description="Implement sales validation"
               owner="DEVELOPER01"
               status="D"/>
</cts:transportRequests>
```

### 3.2 创建传输请求

```
POST /sap/bc/adt/cts/transportrequests
Content-Type: application/xml

<?xml version="1.0" encoding="utf-8"?>
<cts:request xmlns:cts="http://www.sap.com/adt/cts"
             cts:type="K"
             cts:description="Implement sales validation"
             cts:target="QAS"/>
```

| 字段 | 说明 |
|------|------|
| `type="K"` | Workbench 请求（程序、类等） |
| `type="W"` | Customizing 请求（配置数据） |
| `type="T"` | Transport of Copies（复制传输） |

### 3.3 发布传输请求

```
POST /sap/bc/adt/cts/transportrequests/{request_number}/newreleasejobs
```

### 后端处理流程

```
1. ADT CTS 端点接收发布请求
   ↓
2. 传输系统执行预检查：
   ├── 检查所有任务是否已发布
   ├── 检查所有对象是否已激活
   ├── (可选) 运行 ATC 检查
   └── 检查是否有未释放的对象
   ↓
3. 将传输请求导出到传输目录
   ├── 生成数据文件（包含对象内容）
   └── 生成控制文件（包含元数据）
   ↓
4. 请求状态变为 R (Released)
   ↓
5. 传输管理系统 (tp / STMS) 将请求导入目标系统
```

### 3.4 Transport of Copies

> [!tip] Transport of Copies
> Transport of Copies (ToC) 是一种特殊类型的传输，用于在不改变原始传输请求的情况下将代码复制到目标系统。常用于紧急修复或临时部署。

```
POST /sap/bc/adt/cts/transportrequests/{source_request}/tocopies
```

## 4. 对象分配到传输请求

### 原理

当开发者修改一个对象时，系统会提示选择或创建传输请求。对象随后被记录到传输请求的任务中。

### 分配方式

```
┌────────────────────────────────────────────────────┐
│ 方式 1: 自动提示                                    │
│   修改对象时 → Eclipse 弹出对话框 → 选择/创建 TR     │
├────────────────────────────────────────────────────┤
│ 方式 2: 拖拽分配                                    │
│   在 Project Explorer 中拖拽对象到 TR                 │
├────────────────────────────────────────────────────┤
│ 方式 3: 批量分配                                    │
│   选择多个对象 → Assign to Transport Request         │
└────────────────────────────────────────────────────┘
```

## 5. 版本管理

### ABAP 版本管理机制

ABAP 内置了 **版本数据库 (Version Database)**，每次激活对象时自动创建一个版本。

### ADT 中的版本比较

```
┌────────────────────────────────────────────┐
│ 版本类型                                     │
├────────────────────────────────────────────┤
│ 活跃版本 (Active Version)                     │
│   → 当前系统中正在运行的代码版本               │
│ 非活跃版本 (Inactive Version)                 │
│   → 已保存但未激活的修改版本                   │
│ 传输版本 (Transport Version)                  │
│   → 传输请求中记录的版本                       │
│ 历史版本 (Historical Version)                 │
│   → 版本数据库中保存的所有历史版本             │
└────────────────────────────────────────────┘
```

### 比较操作

| 操作 | 说明 |
|------|------|
| Compare with Active Version | 当前编辑 vs 活跃版本 |
| Compare with Local History | 当前 vs 本地历史（客户端缓存） |
| Compare with Transport Version | 当前 vs 传输中的版本 |
| Version History | 查看所有历史版本 |

## 6. ADT 传输管理 vs SAP GUI 传输管理

| 功能 | SAP GUI | ADT Eclipse |
|------|---------|-------------|
| 创建 TR | `SE01` / `SE09` | 右键 → New → Transport Request |
| 查看 TR | `SE01` / `SE09` | Transport Requests 视图 |
| 发布 TR | `SE01` → Release | 右键 → Release |
| 查看 TR 内容 | `SE01` → Display | 双击 TR → 展开对象列表 |
| TR 详情 | `SE03` | Properties 视图 |
| 版本比较 | `SE80` → Version Management | 右键 → Compare With |
| 批量操作 | `SE01` | 多选 + 上下文菜单 |

## 7. 传输发布与 ATC 集成

> [!important] 传输发布质量门禁
> 传输发布时可以配置 **ATC 质量门禁**，确保代码质量达标后才能发布到目标系统。

### 配置流程

```
1. 在 SAP 系统中配置 ATC 传输检查
   (事务码: SATC -> 配置传输发布检查)
   ↓
2. 设置检查规则：
   ├── 设置 Baseline
   ├── 配置检查范围
   └── 设置严重级别阈值
   ↓
3. 传输发布时自动触发 ATC
   ↓
4. 只有通过检查的传输才能继续发布
   （或配置为仅警告不阻止）
```

## 8. 通过 REST API 实现自动化传输管理

### Python 自动化示例

```python
def automated_transport_workflow(client, object_uri, description):
    """自动化传输工作流"""

    # 1. 创建传输请求
    tr_number = create_transport_request(
        client,
        description=description,
        target_system="QAS"
    )

    # 2. 修改代码（参见 03.修改代码-原理）
    lock_handle = lock_object(client, object_uri)
    # ... 修改源代码 ...
    write_source(client, object_uri, modified_source, lock_handle)
    unlock_object(client, object_uri, lock_handle)

    # 3. 激活代码
    activate_object(client, object_uri)

    # 4. 运行 ATC 检查
    atc_result = run_atc_check(client, object_uri)
    critical = [f for f in atc_result["findings"]
                if f["priority"] == "1"]
    if critical:
        raise Exception("ATC check failed")

    # 5. 发布传输请求
    release_transport(client, tr_number)

    return tr_number
```

## 9. 常见问题与解决方案

| 问题 | 原因 | 解决方案 |
|------|------|---------|
| 无法创建 TR | 缺少 S_CTS_ADMI 权限 | 联系 BASIS 分配权限 |
| 发布失败 | 对象未激活 | 先激活所有对象 |
| ATC 阻止发布 | 存在严重问题 | 修复 ATC 发现或更新 Baseline |
| 传输导入失败 | 目标系统缺少依赖 | 确保依赖对象已在目标系统激活 |
| 锁定冲突 | 其他用户正在编辑 | 等待或请求解锁 |

## 🔗 相关笔记

- [[sap-cli/03.修改代码-原理|03.修改代码 - 原理]] — 代码修改 → 传输请求
- [[sap-cli/04.检查代码-原理|04.检查代码 - 原理]] — ATC 检查与传输发布集成

## 📚 参考来源

- [SAP Help Portal - ADT User Guide](https://help.sap.com/docs/abap-cloud/abap-development-tools-user-guide/about-abap-development-tools-user-guide)
- [ABAP Tools – Work with Eclipse (Transport) – Software-Heroes](https://software-heroes.com/en/blog/abap-tools-work-with-eclipse-transport)
- [End-to-End SAP Automation with ADT REST Services](https://medium.com/@onuryz.itu/end-to-end-sap-automation-with-adt-rest-services-and-ai-a-modern-alternative-to-gui-scripting-343ea86064ea)
- [Transporting ABAP and Non-ABAP Objects (SAP Community Call)](https://www.youtube.com/watch?v=FpAuj8QD-rM)
- [Version Management in ABAP in Eclipse - SAP Community](https://community.sap.com/t5/application-development-discussions/version-management-in-abap-in-eclipse/m-p/12611386)