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

title, created, tags, parent, prev

title	created	tags	parent	prev
提交与传输 - 原理	2026-05-18	SAP ADT transport CTS version-management REST	sap-cli/README	sap-cli/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 = 已发布

响应

<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 自动化示例

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.修改代码-原理 — 代码修改 → 传输请求
• sap-cli/04.检查代码-原理 — ATC 检查与传输发布集成

📚 参考来源

• SAP Help Portal - ADT User Guide
• ABAP Tools – Work with Eclipse (Transport) – Software-Heroes
• End-to-End SAP Automation with ADT REST Services
• Transporting ABAP and Non-ABAP Objects (SAP Community Call)
• Version Management in ABAP in Eclipse - SAP Community