Automação de Relatórios SAP com Claude
AsToHot/sap-report-automation-workflow
Automação completa SAP ABAP: spec → código → testes → ativação
Ver no GitHubSkill de automação end-to-end para desenvolvimento de objetos ABAP no SAP: desde especificação funcional até ativação no sistema, incluindo geração de código, testes e validação de dados. Integra RFC, ADT, MCP e inclui scripts para diagnóstico, deploy, unlock de objetos e verificação com dados reais.
Instalação
npx convez-ai AsToHot/sap-report-automation-workflow1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Gerar relatórios ALV SAP automaticamente a partir de especificações funcionais
- Validar relatórios contra dados reais em sistemas SAP de desenvolvimento e produção
- Desbloquear objetos travados e diagnosticar problemas de conectividade RFC/ADT
- Acelerar ciclo de desenvolvimento ABAP reduzindo tarefas manuais de codificação e testes
Veredito

Ferramenta robusta para especialistas SAP/ABAP que buscam automatizar o fluxo completo de desenvolvimento. Exige infraestrutura SAP configurada (RFC, ADT, MCP) e conhecimento técnico profundo; não é plug-and-play, mas economiza dias em ciclos repetitivos de desenvolvimento.
README
A tradução para o português deste README ainda está na fila.
SAP 报表自动化工作流(Claude Skill)
端到端 SAP ABAP 开发对象自动化工作流:从功能规格(FS)到 SAP 系统激活的 AI 驱动闭环。
支持对象类型:REPORT、CLAS、FUGR/FM、INTF、Include。
包含内容
- Claude Skill (
.claude/skills/sap-report-automation-workflow/):阶段门禁、字段契约、元数据驱动规范、ABAP 语法速查 - 自动化脚本 (
scripts/)test_rfc.js— RFC 环境诊断(DLL、连接、PING)test_mcp_login.js— MCP + RFC 代理端到端连通测试fetch_metadata.js— 批量拉取透明表 DDIC 元数据perf_estimate.js— 主表 COUNT 预估与性能建议deploy_rfc.js— 主部署脚本(创建主程序 + Include / 语法检查 / 激活)deploy_includes_only.js— 仅更新 Include(主程序已存在时)verify_report.js— 通用报表真实数据校验(动态字段展示,多参数范围并行测试)release_locks.js— 应急释放当前用户在 SAP 中的所有锁unlock_prog.js/unlock_includes.js/unlock_includes_v2.js— 应急解锁指定对象extract-docx.js— DOCX 功能说明书文本提取modules/— ADT 原子操作模块(env、sap-connection、lock/unlock、create/upload、syntax-check、activate 等)
- 根目录辅助脚本
rfc-proxy-server.js— RFC ADT 代理服务器(HTTP → RFC 转发)mcp-launcher.js— MCP 启动包装器(自动设置 SAPNWRFC_HOME + PATH)
- SAP NW RFC SDK (
NW-RFC-SDK/):已解压就绪,开箱即用 - 配置:
.mcp.json(MCP 服务器注册)、.env/.env.data(SAP 连接凭据,不纳入版本控制;文件名不编码客户端编号)
当前架构
Claude Code → mcp-abap-abap-adt-api (MCP) → HTTP localhost:9876
→ rfc-proxy-server.js → node-rfc → SADT_REST_RFC_ENDPOINT → SAP
- MCP 包:
mcp-abap-abap-adt-api(内置,无需 clone) - 连接方式:RFC via
SADT_REST_RFC_ENDPOINT(支持 SAP Router) - 双系统架构:
.env(开发)通过abap-adt→.env.data(数据)通过abap-adt-data。文件名不编码客户端编号,由用户按实际环境配置 - 配置位置:项目根目录
.mcp.json(不是.claude/settings.json)
快速开始
- 构建 MCP 服务器:
cd mcp-abap-abap-adt-api npm install npm run build cd .. - 安装根目录依赖:
npm install(安装node-rfc) - 配置 SAP 连接:在项目根目录创建
.env(开发系统)和.env.data(数据系统),填入真实 SAP 地址、凭据、Router(字段见下方.env.example) node scripts/test_rfc.js— 检查 RFC 环境node rfc-proxy-server.js— 启动代理(后台运行)- 在 Claude Code 中触发报表开发工作流
.env / .env.data 字段清单
参见 .env.example 完整示例。.env 用于开发系统(创建/修改/激活),.env.data(或用户自定义名称如 .env.test)用于数据系统(runQuery/tableContents/verify_report)。
SAP_URL=http://<your-sap-host>:8000
SAP_CLIENT=<client>
SAP_USERNAME=<username>
SAP_PASSWORD=<password>
SAP_LANGUAGE=ZH
SAP_SID=<sid>
SAP_SYSNR=<sysnr> # 可选;未设置时从端口推导(80XX→XX)
SAP_ROUTER=<router-string>
SAP_CONNECTION_TYPE=rfc
所有参数按用户实际环境配置,脚本不提供硬编码默认值。
产物目录(按对象名隔离)
output/<object>/
spec/
functional-spec-raw.md
functional-spec-ai.md
metadata/
tables/<TABNAME>.json
performance-estimate.md
docs/
tech-design.md
fs-coverage.md
template-mapping.md
deployment-config.md
stage-gate.md
smoke-test.md
abap/sources/
<name>.abap # REPORT: 主程序
<name>T01.abap # REPORT: TOP Include(类型定义)
<name>SEL.abap # REPORT: 选择屏幕
<name>F01.abap # REPORT: 逻辑处理
<name>.clas.abap # CLASS: 类定义+实现
<name>.intf.abap # INTF: 接口定义
<name>.fugr.abap # FUGR: 函数组
冒烟测试流程(V0.2 硬性规则)
正确顺序(不可颠倒):
- 先查源表:
runQuery(数据系统)取具体科目的原始列值(HSLxx/TSLxx),手工计算预期输出 - 再跑程序:
verify_report.js执行报表,获取实际输出 - 逐项比对:实际值 = 预期值 → PASS;不一致 → 查代码 Bug
三条铁律:
- 金额为 0 ≠ Bug(数据可能在该期间无活动)
- 子范围 = 全范围 ≠ Bug(数据可能集中在该子范围)
- 预期值必须来自源表手工计算,不准用程序输出倒推
# 多组参数并行测试
node scripts/verify_report.js <程序名> P_xxx=<值> "S_xxx=范围1,范围2,范围3"
工作流阶段
| 阶段 | 产物 | 门禁 |
|---|---|---|
| S0 | MCP 双系统联通 | abap-adt(开发) + abap-adt-data(数据) 均通 |
| S1 | output/<object>/spec/functional-spec-ai.md | 功能规格就绪 |
| S1.5 | SAP 对象名存在性检查 | 目标对象名在 SAP 中不存在(或用户确认覆盖) |
| S2 | output/<object>/metadata/tables/*.json | 透明表元数据落盘 |
| S2.5 | output/<object>/metadata/performance-estimate.md | 主表 COUNT + 分页建议 |
| S3 | output/<object>/docs/tech-design.md | 字段契约 + 关联 + WHERE |
| S3.5 | output/<object>/docs/fs-coverage.md | FS 字段与代码逐项对齐 |
| S3.6 | output/<object>/docs/deployment-config.md | 开发包 / 请求号 / 模板确认 |
| S4 | output/<object>/abap/sources/*.abap | 按模板 + 契约 + 元数据生成代码 |
| S5 | 激活记录 | deploy_rfc.js 部署 + 语法检查 + 激活 |
| S5.5 | output/<object>/docs/smoke-test.md | 冒烟测试通过(含数据抽样验证) |
FUGR / Function Module 创建(V0.3 新增)
ADT REST + SADT_REST_RFC_ENDPOINT 完整支持函数组和 Function Module 的创建与部署。
已验证的 FM 参数类型:
| 参数类型 | 源码写法 | 说明 |
|---|---|---|
| IMPORTING | VALUE(iv_x) TYPE string | 导入参数 |
| EXPORTING | VALUE(ev_x) TYPE int4 | 导出参数 |
| TABLES | it_x LIKE rfc_db_opt OPTIONAL | 表参数(引用 DDIC 结构) |
| RFC 远程 | PUT XML: processingType="rfc" | 元数据,非源码关键字 |
FM 源码格式(ABAP 原生声明,禁止 *"*" 注释块):
FUNCTION zfm_example
IMPORTING VALUE(iv_input) TYPE string
EXPORTING VALUE(ev_output) TYPE string
TABLES it_data LIKE rfc_db_opt OPTIONAL.
... implementation ...
ENDFUNCTION.
部署流程:POST FUGR → POST FM → Lock → PUT metadata + source → Activate
新增脚本模块:create-fugr.js、create-fm.js、upload-fm-source.js、deploy_fm_test.js
冒烟测试(V0.3 强化)
执行 verify_report.js 前,数据系统必须部署 ZREPORT_EXEC_VERIFY FM(代码见 docs/ZREPORT_EXEC_VERIFY.txt)。若未部署,代理应按 FM 部署流程辅助部署(询问包类型 → 创建 FUGR → 创建 FM → 上传源码 → 激活)。
已知限制
- MCP 直接写 Include:当前 MCP
setObjectSource工具硬编码PROG/P,若直接传入 Include 名称会把对象创建为同名的可执行程序(类型错位)。阶段 5 部署请使用scripts/deploy_rfc.js。 - 激活主程序即可:主程序激活时 SAP 会自动处理其引用的 Include。
- 文本元素 / GUI Status:ADT REST API 不支持自动写入,部署后需在 SE80 手动维护。GUI Status 使用 SAPLKKBL 标准工具栏。
- FM 参数
*"*"注释块:ADT REST 明确拒绝此格式。参数必须用 ABAP 原生内联声明语法。 - 部分 ADT 端点:
datapreview/freestyle等端点在SADT_REST_RFC_ENDPOINT通道下不支持。
版本历史
| 版本 | 日期 | 变更 |
|---|---|---|
| v0.3 | 2026-06-10 | 增加完整的 FM 创建过程(IMPORTING/EXPORTING/TABLES + RFC,ADT REST 实战验证);冒烟测试真实数据测试(ZREPORT_EXEC_VERIFY 部署说明);环境配置去硬编码(.env.300→.env.data,env.js 集中管理,SAP_SYSNR 显式优先);所有脚本统一 RFC 参数构建 |
| v0.2 | 2026-06-09 | 冒烟测试方法论修正(先查源表→手工预期→跑程序→比对);verify_report.js 动态字段;去硬编码敏感信息 |
| v0.1 | 2026-04-27 | 初始版本:REPORT 全流程、双系统架构、RFC 代理模式 |