FB01/FB02之外：利用SmartForm自动生成PDF并挂接到SAP会计凭证的实战教程-编程阁

FB01/FB02之外：利用SmartForm自动生成PDF并挂接到SAP会计凭证的实战教程

在SAP财务模块的日常操作中，会计凭证的创建与附件管理是高频且关键的业务场景。传统方式依赖FB01/FB02的事务码操作，不仅效率低下，还容易因人工操作导致附件遗漏或错误。本文将深入探讨如何通过SmartForm技术实现从业务数据到PDF附件的全自动化处理，为ABAP开发者和财务流程优化专家提供一套完整的解决方案。

1. 自动化附件集成的核心架构设计

1.1 技术组件选型与交互逻辑

实现自动化PDF附件集成需要以下核心组件协同工作：

SmartForm引擎：负责将业务数据转换为标准格式文档
OTF转换服务：将打印输出格式(OTF)转换为PDF二进制流
附件管理API：处理文档与会计凭证的关联关系
存储服务：支持SAP服务器本地存储或OpenText等企业内容管理系统

典型的数据流转路径如下：

业务数据 → SmartForm设计器 → OTF中间格式 → PDF转换 → 二进制存储 → 凭证关联

1.2 关键函数模块解析

系统实现依赖以下几个核心函数模块：

函数模块	作用描述	关键参数
SSF_FUNCTION_MODULE_NAME	生成SmartForm对应的函数模块	FORMNAME, FM_NAME
CONVERT_OTF	OTF格式到PDF的转换	FORMAT='PDF', BIN_FILE
SCMS_XSTRING_TO_BINARY	XSTRING类型转换为二进制表格	BUFFER, BINARY_TAB
BINARY_RELATION_CREATE	创建业务对象与文档的关联关系	OBJ_ROLEA, OBJ_ROLEB

2. SmartForm设计与数据准备

2.1 票据模板开发要点

设计适用于票据打印的SmartForm时需注意：

字段映射关系：确保每个数据元素与后台结构字段精确对应
多页处理逻辑：通过MAIN窗口与CONTINUE窗口实现分页控制
公司标识集成：自动载入LOGO图片和公司联系信息
条形码生成：利用SSF_BARCODE函数生成票据唯一标识码

提示：使用事务码SMARTFORMS开发时，建议先创建表单样例再绑定数据源，可显著提高开发效率。

2.2 数据提取与格式化

从财务凭证提取数据的典型代码结构：

DATA: lt_bkpf TYPE TABLE OF bkpf, lt_bseg TYPE TABLE OF bseg. SELECT * FROM bkpf INTO TABLE lt_bkpf WHERE belnr = lv_belnr AND bukrs = lv_bukrs AND gjahr = lv_gjahr. IF sy-subrc = 0. SELECT * FROM bseg INTO TABLE lt_bseg FOR ALL ENTRIES IN lt_bkpf WHERE belnr = lt_bkpf-belnr AND bukrs = lt_bkpf-bukrs AND gjahr = lt_bkpf-gjahr. ENDIF.

3. PDF生成与二进制处理

3.1 从SmartForm到PDF的转换流程

完整的PDF生成过程包含以下步骤：

调用SSF_FUNCTION_MODULE_NAME获取表单函数名
执行表单函数生成OTF数据
使用CONVERT_OTF转换为PDF格式
通过SCMS_XSTRING_TO_BINARY处理二进制流

关键转换代码示例：

CALL FUNCTION 'CONVERT_OTF' EXPORTING format = 'PDF' max_linewidth = 132 IMPORTING bin_filesize = lv_bin_size bin_file = lv_bin_file TABLES otf = lt_otf_data EXCEPTIONS err_format = 1 OTHERS = 2.

3.2 二进制数据优化策略

处理大型PDF附件时需考虑：

内存管理：分块处理超过10MB的文件
压缩处理：使用SCMS_COMPRESS函数减小存储空间
加密需求：通过SSEC_*系列函数实现文档加密
版本控制：在文件名中加入时间戳实现版本区分

4. 附件关联与异常处理

4.1 凭证关联的两种实现方式

方案一：SAP标准附件服务

CALL FUNCTION 'BINARY_RELATION_CREATE_COMMIT' EXPORTING obj_rolea = ls_obj_bkpf "会计凭证对象 obj_roleb = ls_obj_pdf "PDF文档对象 relationtype = 'ATTA' "附件关系类型 IMPORTING binrel = ls_binrel TABLES binrel_attrib = lt_attrib.

方案二：OpenText集成方案

CALL FUNCTION 'ZRFC_ARCHIV_CREATE_FILE' EXPORTING iv_bustype = 'FI_DOC' "业务类型 iv_bukrs = lv_bukrs "公司代码 iv_ref_no = lv_doc_key "凭证关键字 iv_doc_type = 'PDF' "文档类型 iv_filename = lv_filename "显示文件名 iv_filelength = lv_filesize "文件大小 IMPORTING ev_att_no = lv_att_no "返回附件编号 TABLES it_bin = lt_bin_data. "二进制内容

4.2 健壮性设计要点

为确保系统可靠性，必须实现以下异常处理机制：

重复提交检查：通过BOR对象关系表检查已有附件
事务一致性：在BDC会话中集成完整的错误回滚逻辑
日志追踪：记录每个处理阶段的系统状态和关键参数
通知机制：通过ALE/IDOC或直接邮件通知处理结果

典型错误处理代码结构：

IF sy-subrc <> 0. CALL FUNCTION 'BAL_LOG_MSG_ADD' EXPORTING i_msgty = 'E' i_msgid = sy-msgid i_msgno = sy-msgno i_msgv1 = sy-msgv1 i_msgv2 = sy-msgv2. RAISE EXCEPTION TYPE zcx_fi_attachment_error EXPORTING textid = zcx_fi_attachment_error=>processing_error. ENDIF.