convez.ai
SkillAutomaçãoAvançado
AsToHot

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 GitHub
InicialPluginScore · de 0 a 100

Skill 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-workflow

1 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

Estrelas
7
Forks
1
Acompanhando
1
Saúde
28%
Último commit
há 3 meses
Versão
—
Issues abertas
1
Contribuidores
1

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)

快速开始

  1. 构建 MCP 服务器:
    cd mcp-abap-abap-adt-api
    npm install
    npm run build
    cd ..
    
  2. 安装根目录依赖:npm install(安装 node-rfc)
  3. 配置 SAP 连接:在项目根目录创建 .env(开发系统)和 .env.data(数据系统),填入真实 SAP 地址、凭据、Router(字段见下方 .env.example)
  4. node scripts/test_rfc.js — 检查 RFC 环境
  5. node rfc-proxy-server.js — 启动代理(后台运行)
  6. 在 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 硬性规则)

正确顺序(不可颠倒):

  1. 先查源表:runQuery(数据系统)取具体科目的原始列值(HSLxx/TSLxx),手工计算预期输出
  2. 再跑程序:verify_report.js 执行报表,获取实际输出
  3. 逐项比对:实际值 = 预期值 → PASS;不一致 → 查代码 Bug

三条铁律:

  • 金额为 0 ≠ Bug(数据可能在该期间无活动)
  • 子范围 = 全范围 ≠ Bug(数据可能集中在该子范围)
  • 预期值必须来自源表手工计算,不准用程序输出倒推
# 多组参数并行测试
node scripts/verify_report.js <程序名> P_xxx=<值> "S_xxx=范围1,范围2,范围3"

工作流阶段

阶段产物门禁
S0MCP 双系统联通abap-adt(开发) + abap-adt-data(数据) 均通
S1output/<object>/spec/functional-spec-ai.md功能规格就绪
S1.5SAP 对象名存在性检查目标对象名在 SAP 中不存在(或用户确认覆盖)
S2output/<object>/metadata/tables/*.json透明表元数据落盘
S2.5output/<object>/metadata/performance-estimate.md主表 COUNT + 分页建议
S3output/<object>/docs/tech-design.md字段契约 + 关联 + WHERE
S3.5output/<object>/docs/fs-coverage.mdFS 字段与代码逐项对齐
S3.6output/<object>/docs/deployment-config.md开发包 / 请求号 / 模板确认
S4output/<object>/abap/sources/*.abap按模板 + 契约 + 元数据生成代码
S5激活记录deploy_rfc.js 部署 + 语法检查 + 激活
S5.5output/<object>/docs/smoke-test.md冒烟测试通过(含数据抽样验证)

FUGR / Function Module 创建(V0.3 新增)

ADT REST + SADT_REST_RFC_ENDPOINT 完整支持函数组和 Function Module 的创建与部署。

已验证的 FM 参数类型:

参数类型源码写法说明
IMPORTINGVALUE(iv_x) TYPE string导入参数
EXPORTINGVALUE(ev_x) TYPE int4导出参数
TABLESit_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.32026-06-10增加完整的 FM 创建过程(IMPORTING/EXPORTING/TABLES + RFC,ADT REST 实战验证);冒烟测试真实数据测试(ZREPORT_EXEC_VERIFY 部署说明);环境配置去硬编码(.env.300→.env.data,env.js 集中管理,SAP_SYSNR 显式优先);所有脚本统一 RFC 参数构建
v0.22026-06-09冒烟测试方法论修正(先查源表→手工预期→跑程序→比对);verify_report.js 动态字段;去硬编码敏感信息
v0.12026-04-27初始版本:REPORT 全流程、双系统架构、RFC 代理模式
Ver o original no GitHub

Bom para

Relacionados