Tiptop与Easyflow电子签核集成：跨系统事务状态协同实战指南

简介本资源是一份面向ERP与OA系统集成开发工程师、企业信息化实施顾问及高级运维人员的技术实践指南聚焦Tiptop与Easyflow在单据电子签核场景下的深度对接方案。文档系统梳理了从环境配置、数据表校验、Schema更新、AWS模块开发含公共服务与作业级抛转程序到集成测试的12个关键步骤并详解AWS模块中aws_efcfg、aws_efsrv等核心4GL文件及aws_aapt110等业务作业的协同逻辑附有XML数据格式规范、Columnset.xml维护要点及常见错误排查提示。资源为单文件PDF大小1.94MB内容结构清晰涵盖概述、Tiptop/Easyflow双端实施细节、集成示意图与配置样例如.profile参数设置、IP与WSDL地址定义便于快速落地部署。目前已有1517人学习下载适合需在生产环境中实现审批流闭环、提升跨系统协同效率的中高级集成开发者参考使用。1. Tiptop 与 Easyflow 单据签核集成不是调个 API 就完事而是两套系统在事务边界上重新划线你手头正卡在一个“审核按钮点下去没反应”的工单作业上——Tiptop 里点了“审核”界面上弹出“送签中”但 Easyflow 收件箱空空如也或者更玄学的是Easyflow 里签完了Tiptop 数据库里的ta_ogaefstat字段死活不变成1日志里连 SOAP 请求都看不到。这不是网络不通、也不是权限没开而是你还没真正理解Tiptop 和 Easyflow 的集成本质是一场跨系统事务状态的协同对齐不是单向数据推送更不是简单封装一个 HTTP 调用。它要求你在 Tiptop 的 4GL 逻辑里精准插入签核状态跃迁点在 Easyflow 的 XML Schema 中严丝合缝地映射字段语义在数据库层确保pmkmksg是否签核和pmk25签核状态这两个字段像齿轮一样咬合转动。这份《TiptopEasyflow集成说明_新单据集成样例.pdf》不是操作手册而是一份“事务边界重定义协议”——它告诉你在哪打断原有审核流、在哪注入签核钩子、在哪拦截回写结果。适合正在落地制造/销售模块电子签核的 Tiptop 二次开发工程师、熟悉 4GL 但没碰过 AWS 模块的系统维护人员以及需要快速验证 Easyflow 表单与 Tiptop 单据双向联动的集成顾问。别急着改代码先看清这张状态流转图开立0→送签中S→核准1→结案6每一步背后都是 Tiptop 的 SQL UPDATE、Easyflow 的 SOAP 调用、以及两者间 XML 字段的精确投递与解析。2. Tiptop 端集成从环境变量到 4GL 钩子12 步里藏着 7 个必须亲手敲进数据库的字段Tiptop 端的集成不是“配置一下就能跑”它是一套嵌入式改造工程从操作系统级的环境变量到数据库表结构再到 4GL 源码的每一行逻辑全部需要人工介入。下面拆解这 12 步中真正决定成败的硬核环节每一步都附可执行命令、关键参数说明及避坑逻辑。2.1 环境变量与 Appserver 启动.profile里的三个 IP 决定通信生死线Tiptop 与 Easyflow 的所有交互都走 Appserver 的 SOAP 客户端因此第一步必须确认 Appserver 已就绪且环境变量指向正确的 Easyflow 服务端点。# 检查 Appserver 是否运行以典型路径为例 ps -ef | grep startweb | grep -v grep # 若未运行启动 Appserver需在 Tiptop 安装目录下执行 ./startweb # 编辑 .profile 文件通常位于 $INFORMIXDIR/etc 或 $HOME/.profile vi $HOME/.profile提示.profile修改后必须重新登录终端或执行source $HOME/.profile生效否则后续所有export变量均为无效状态。关键三行环境变量必须严格按格式填写IP 地址、主机名、WSDL 地址三者必须完全匹配 Easyflow 服务器实际部署情况# EasyFlow Server IP注意必须是 Easyflow Web 服务监听的 IP非数据库 IP EFSITEIP192.168.0.250; export EFSITEIP # EasyFlow Server Name必须与 EF2Kweb.xml 中 serverName 标签值一致 EFSITENAMEEF2KWeb; export EFSITENAME # EasyFlow SOAP Location必须是 EF2KGateWay.WSDL 的完整 HTTP URL末尾不能漏 .WSDL EFSOAPhttp://192.168.0.250/EF2KGateWay/EF2KGateWay.WSDL; export EFSOAP参数说明EFSITEIPEasyflow Web 服务IIS/Apache绑定的 IP不是数据库 IP也不是负载均衡 VIP。若 Easyflow 部署在 Docker 容器内此处应填宿主机映射端口后的 IP。EFSITENAME该值会作为 SOAP Header 中的ServerName传给 EasyflowEasyflow 用它来路由到对应租户/工厂。若填错Easyflow 日志会报Unknown server name。EFSOAP必须是可被 Tiptop 服务器 curl 通的 URL。测试方法curl -I http://192.168.0.250/EF2KGateWay/EF2KGateWay.WSDL返回200 OK且内容为 WSDL XML 才算有效。2.2 数据表字段补全7 个签核栏位缺一不可pmkmksg和pmk25是状态引擎的双活塞Tiptop 的签核能力不是靠配置开关驱动的而是由数据表中特定字段的存在性与语义共同构成。任何一张要走电子签核的单据其主表单头档必须包含以下 7 个字段且命名规范、数据类型、默认值均需符合约定。以请购单pmk_file为例字段名类型必填说明典型值示例pmkmksgCHAR(1)✓是否签核Y/N是整个签核流程的总开关无此字段则aws_efcfg无法启用Ypmk25CHAR(2)✓签核状态核心状态机字段所有业务逻辑围绕它跳转0(开立),S(送签中),1(核准)pmksignCHAR(2)✗签核等级多级审批时使用单级审批可设为 NULL 或0101,02pmkdaysINTEGER✗签核完成天数系统自动计算初始为 00,3pmkpritCHAR(1)✗签核优先顺序影响收件箱排序H(高),M(中),L(低)HpmksseqINTEGER✗已签核顺序系统维护无需手动赋值1,2pmksmaxINTEGER✗应签核顺序系统维护表示该单据需几人审批1,2创建字段的实操命令以 Informix 为例-- 进入数据库假设数据库名为 tiptopdb dbaccess tiptopdb - -- 为 pmk_file 表添加 pmkmksg 字段CHAR(1)允许 NULL加注释 ALTER TABLE pmk_file ADD pmkmksg CHAR(1); COMMENT ON COLUMN pmk_file.pmkmksg IS 是否签核(Y/N); -- 添加 pmk25 字段CHAR(2)允许 NULL ALTER TABLE pmk_file ADD pmk25 CHAR(2); COMMENT ON COLUMN pmk_file.pmk25 IS 签核状态; -- 设置默认值可选但强烈建议 UPDATE pmk_file SET pmkmksg N, pmk25 0 WHERE pmkmksg IS NULL OR pmk25 IS NULL;注意pmkmksg和pmk25是强制字段其他 5 个为可选。但若pmkmksg不存在aws_efcfg维护界面将直接报错退出若pmk25不存在aws_efcli()函数在生成 XML 时会因字段缺失而抛出SQL error -1207。2.3aws_efcfg维护不是填表而是用字段映射生成 XML 的“编译器”aws_efcfg是 Tiptop 端集成的中枢配置窗体它的作用远不止“设置单据名称”。它本质是一个 XML 生成规则的可视化编辑器——你在此处定义的每一个单头/单身字段都会被翻译成aws_xxx.4gl中的 SQL JOIN 逻辑和 XML 标签拼接语句。2.3.1 单头栏位维护JOIN 表与字段替换的底层逻辑进入aws_efcfg后选择对应作业如asfi301点击“维护单头栏位”左边“字段”栏填写你要传递到 Easyflow 的字段名例如sfb01工单号、sfb02客户编码。右边“参照字段”栏填写该字段的语义化值来源。例如sfb02客户编码 →occ02客户名称系统会自动在 SQL 中JOIN occ_file ON sfb02 occ04并在 XML 中sfb02客户A/sfb02而非sfb02001/sfb02。sfb05币种代码 →cur02币种名称同理JOIN cur_file ON sfb05 cur01。关键逻辑aws_efcfg生成的aws_asfi301.4gl中l_sql语句会自动包含这些 JOIN并在LET赋值时用occ02替换sfb02。如果你漏填“参照字段”XML 里传的就是原始编码Easyflow 表单显示为乱码或空值。2.3.2 “产生范式程序”生成的是骨架不是成品90% 的修改都在这里点击“产生范式程序”后系统在$TIPTOP_HOME/aws/4gl/下生成aws_asfi301.4gl。打开它你会看到类似结构FUNCTION aws_efcli_cf() DEFINE sr RECORD ( sfb01 CHAR(10), sfb02 CHAR(10), occ02 CHAR(40), -- 注意这是参照字段不是原表字段 sfb05 CHAR(3), cur02 CHAR(20) ) ... LET l_sql SELECT s.sfb01, s.sfb02, o.occ02, s.sfb05, c.cur02 FROM sfb_file s JOIN occ_file o ON s.sfb02 o.oga04 JOIN cur_file c ON s.sfb05 c.cur01 WHERE s.sfb01 ? ... FOREACH LET g_strXMLInput g_strXMLInput CLIPPED, sfb01, sr.sfb01 CLIPPED, /sfb01, ASCII 10, sfb02, sr.occ02 CLIPPED, /sfb02, ASCII 10, -- 看这里用了 occ02 sfb05, sr.cur02 CLIPPED, /sfb05, ASCII 10 END FOREACH END FUNCTION血泪经验生成的代码中sr.occ02是安全的但sr.sfb02是危险的——如果occ_file中没有匹配记录sr.occ02会是 NULL导致 XML 中sfb02/sfb02Easyflow 解析失败。必须加空值判断-- 在 FOREACH 循环内XML 拼接前加入 IF sr.occ02 IS NULL THEN LET sr.occ02 sr.sfb02 -- 回退到原始编码 END IF2.4 标准作业改造在axmt620里植入签核钩子xxx_ef()函数是状态跃迁的唯一入口标准作业如出货单axmt620的改造是集成成败的临门一脚。核心是新增t600_ef()函数函数名需与作业代号一致并将其无缝嵌入原有审核流程。2.4.1t600_ef()函数封装了aws_efcli()调用与状态更新的原子操作该函数必须放在axmt620.4gl的FUNCTIONS区域其核心逻辑是FUNCTION t600_ef() DEFINE l_title CHAR(30) LET l_title 出货单送签 -- 关键调用 aws_efcli传入单据号等参数 IF aws_efcli(l_title, g_oga.oga01[1,3], -- 工厂代号前3位 g_oga.oga01, -- 单据号主键 , , , , ) -- 其余参数留空按需填 THEN -- 成功更新状态为“送签中” LET g_oga.ta_ogaefstat S -- 状态字段 LET g_oga.ogaconf Y -- 审核状态字段标记已触发签核 -- 更新界面显示图标 CALL cl_set_field_pic(g_oga.ogaconf, Y, g_oga.ogapost, N, N, ) -- 将状态写回数据库必须否则 Easyflow 回写时找不到上下文 UPDATE oga_file SET ta_ogaefstat S, ogaconf Y WHERE oga01 g_oga.oga01 COMMIT WORK LET g_success Y ELSE -- 失败回滚保持原状态 ROLLBACK WORK LET g_success N END IF END FUNCTION参数说明g_oga.oga01[1,3]提取单据号前 3 位作为工厂代号Easyflow 用它确定审批流归属工厂。g_oga.oga01单据主键Easyflow 用它作为ColumnSet.xml中key字段的值用于回写定位。ta_ogaefstat和ogaconf这两个字段必须在oga_file表中存在且t600_ef()中的UPDATE语句必须与之严格对应。2.4.2 原有审核函数的“外科手术”在事务提交前插入签核判断找到axmt620.4gl中原有的confirm()函数或类似名称在所有业务校验通过、但尚未执行任何UPDATE或INSERT之前插入签核判断逻辑-- 原有 confirm() 函数中校验完成后、UPDATE 前插入 IF g_success Y THEN -- 判断是否开启签核 当前未审核 IF g_oga.ta_ogamksg Y AND g_oga.ogaconf N THEN CALL t600_ef() -- 调用签核钩子 IF g_success N THEN ROLLBACK WORK -- 签核失败回滚所有校验结果 END IF RETURN -- 关键签核成功则直接退出不走后续审核逻辑 END IF END IF -- 原有 UPDATE 逻辑仅当不走签核时才执行 IF g_success Y THEN UPDATE oga_file SET ... WHERE oga01 g_oga.oga01 COMMIT WORK END IF玄学提醒RETURN必须放在CALL t600_ef()之后且不能有任何UPDATE在它前面。否则会出现“单据已送签但数据库里状态还是N”的诡异现象Easyflow 回写时因找不到ta_ogaefstatS的记录而失败。3. Easyflow 端集成从 Forms 目录克隆到 ColumnSet.xmlXML 字段顺序不重要但语义必须零误差Easyflow 端的集成工作看似是“复制粘贴”实则是对 Tiptop XML 结构的镜像重建。它不关心你的 SQL 怎么写只认你aws_xxx.4gl里拼出来的 XML 字符串。任何字段名拼写错误、大小写偏差、或必填字段缺失都会导致表单加载失败或签核结果无法回写。3.1 Forms 目录克隆与文件重命名ASP 文件中的字符串替换是第一道过滤网Easyflow 的表单文件存放在Program Files\EF2Kweb\ASP\CHT\Forms\下。以新建工单TT_WO1为例# 进入 Forms 目录 cd C:\Program Files\EF2Kweb\ASP\CHT\Forms\ # 克隆现有模板如 TT_SO1 xcopy TT_SO1 TT_WO1 /E /I # 进入新目录批量替换所有 TT_SO1 为 TT_WO1Windows PowerShell Get-ChildItem TT_WO1\*.asp | ForEach-Object { (Get-Content $_.FullName) -replace TT_SO1, TT_WO1 | Set-Content $_.FullName }必须替换的 4 个 ASP 文件TT_WO1_Approve_Init.ASP签核动作初始化TT_WO1_Create_Init.ASP新建表单初始化TT_WO1_Display_Init.ASP只读查看初始化TT_WO1_Grid.ASP单身表格初始化注意替换必须是全字匹配。若TT_SO1是某个字段名的一部分如TT_SO1_STATUS则不能简单全局替换需人工检查。否则会导致TT_WO1_STATUS变成TT_WO1_STATUS无变化但TT_SO1单独出现时被误替换成TT_WO1引发 JS 错误。3.2 Forms.ASP 表单设计ID 命名规则是 Easyflow 解析 XML 的唯一依据Forms.ASP是表单的 HTML 骨架Easyflow 通过控件 ID 与 XML 字段名建立映射。ID 命名规则是硬性标准违反即解析失败标签 ID字段名_1如span idsfb01_1工单号/span控件 ID字段名_2如input typetext idsfb01_2 /单身表格使用 OCX 控件ID 为Grid_2无需为每个字段单独设 ID。实操要点所有idxxx_1和idxxx_2中的xxx必须与aws_asfi301.4gl中 XML 拼接的字段名完全一致包括大小写。xxx_1和xxx_2的xxx必须相同否则 Easyflow 无法将标签文字与输入框关联。xxx不能含特殊字符如-,., 只能是字母、数字、下划线。!-- 正确sfb01 字段 -- span idsfb01_1工单号/span input typetext idsfb01_2 readonly / !-- 错误大小写不一致 -- span idSFB01_1工单号/span !-- Easyflow 会找 sfb01_1找不到 -- input typetext idsfb01_2 / !-- 错误ID 不匹配 -- span idsfb01_1工单号/span input typetext idsfb01_text / !-- Easyflow 只认 xxx_2 --3.3 ColumnSet.xml 配置不是 XML 文件而是 Easyflow 的“数据库 Schema 映射表”ColumnSet.xml位于EF2KwebPackages\tiptop\目录下它是 Easyflow 理解 Tiptop XML 结构的“字典”。它不定义表单样式只定义字段类型、长度、是否主键、是否回写。3.3.1 新增 Program 节点必须与 Tiptop 作业代号、XML 根节点严格对应在ColumnSet.xml的ColumnSets根节点下新增一个ProgramProgram idTT_WO1 name工单 tableTT_WO1 keysfb01 Column namesfb01 typestring length10 keytrue / Column namesfb02 typestring length10 / Column nameocc02 typestring length40 / Column namesfb05 typestring length3 / Column namecur02 typestring length20 / !-- 必填字段资料所有者不显示在表单但 Easyflow 用它找审批人 -- Column namesfbuser typestring length20 / /Program关键参数说明idTT_WO1必须与 Tiptop 作业代号asfi301对应TT_WO1、EF2Kweb.xml中Form的id、以及aws_efcfg中设置的“单据代号”三者完全一致。keysfb01指定主键字段Easyflow 回写时用它WHERE sfb01 ?更新 Tiptop 数据库。Column namesfbuser ... /绝对不可省略。该字段值来自 Tiptop XML 中的sfbuser439/sfbuserEasyflow 用它确定“谁填的单”进而匹配审批流中的“填单人”角色。若缺失审批流无法启动。3.3.2 字段类型与长度必须与 Tiptop 数据库字段定义一致否则回写时报Data truncationtypestring对应 CHAR/VARCHARtypeinteger对应 INTEGER/SMALLINTtypedate对应 DATE格式必须为YYYY-MM-DDlength必须 ≥ Tiptop 字段定义长度。若 Tiptop 中sfb02是CHAR(10)此处length10若为VARCHAR(20)此处length20。验证方法在 Easyflow 的“管理程序清单”→“表单性质维护”中打开TT_WO1表单点击“测试连接”系统会校验ColumnSet.xml与数据库表结构是否匹配。4. 避坑指南7 条血泪教训每一条都曾让项目延期三天以上集成过程中的问题90% 都不是技术难题而是文档没写、经验没传、细节没抠。以下是我在多个制造客户现场踩过的坑按发生频率和杀伤力排序每条都附带复现方式、根因分析和可立即执行的修复方案。4.1 现象Easyflow 收件箱无新单Tiptop 日志显示aws_efcli: SOAP call failed原因EFSOAP环境变量中的 WSDL URL 无法被 Tiptop 服务器访问或 Easyflow Web 服务未启动。排查在 Tiptop 服务器上执行curl -v http://192.168.0.250/EF2KGateWay/EF2KGateWay.WSDL若返回Connection refused检查 Easyflow IIS 是否运行、端口默认 80是否被防火墙拦截。若返回404 Not Found检查EF2KGateWay虚拟目录是否在 IIS 中正确配置物理路径是否指向EF2Kweb\GateWay。解决重启 IIS (iisreset)或重新部署EF2KGateWay目录。4.2 现象Easyflow 表单能打开但所有字段显示为空或显示undefined原因Forms.ASP中控件 IDxxx_2与ColumnSet.xml中Column namexxx不一致或aws_xxx.4gl生成的 XML 中字段名拼写错误。排查用浏览器开发者工具F12打开 Easyflow 表单查看 Network 标签找到TT_WO1_Create_Init.ASP的响应搜索sfb01。若 XML 中是SFB01大写而ColumnSet.xml中是Column namesfb01则不匹配。若 XML 中有sfb01但Forms.ASP中控件 ID 是sfb01_text则 Easyflow 找不到目标。解决统一所有地方的字段名为小写且xxx_2与Column name完全一致。4.3 现象Easyflow 签核成功但 Tiptop 数据库ta_ogaefstat仍为S未变成1原因Easyflow 回写时WHERE条件找不到记录因为ColumnSet.xml中key字段值与 Tiptop XML 中key值不一致。排查查看 Easyflow 日志EF2Kweb\Logs\搜索Update failed for TT_WO1。日志中会显示WHERE sfb01 WO1-0001 末尾有空格而 Tiptop XML 中是sfb01WO1-0001/sfb01无空格。解决在aws_xxx.4gl的 XML 拼接中对主键字段使用CLIPPED sfb01, sr.sfb01 CLIPPED, /sfb01, ASCII 104.4 现象Tiptop 点“审核”后弹出“送签中”但 Easyflow 收件箱无单且 Tiptop 界面卡住原因aws_efcli()函数中l_sql查询返回空集FOREACH未执行导致g_strXMLInput为空字符串SOAP 调用发送空 XML。排查在aws_xxx.4gl的FOREACH前加日志CALL cl_log(DEBUG: sql result count , COUNT(*)) -- 需先定义 COUNT若日志显示count 0说明l_sql的WHERE条件不匹配。解决检查l_sql中的WHERE子句确保g_oga.oga01的值与数据库中真实记录匹配注意大小写、空格、前导零。4.5 现象Easyflow 签核后Tiptop 界面不刷新ta_ogaefstat已变1但用户看不到原因标准作业中DISPLAY BY NAME未包含ta_ogaefstat字段或cl_set_field_pic()调用后未REFRESH。排查检查axmt620.per文件确认ta_ogaefstat字段已定义在 form 中。检查t600_ef()函数末尾是否有DISPLAY BY NAME g_oga.ta_ogaefstat。解决在t600_ef()成功分支末尾添加DISPLAY BY NAME g_oga.ta_ogaefstat, g_oga.ogaconf REFRESH SCREEN5. 集成测试与验证从单据开立到状态回写用四步断点法锁定故障域集成测试不是“点一点看看行不行”而是用断点法把整个链路切成四段逐段验证。我一般会强制走一遍这四个检查点哪怕客户说“已经测过了”因为 80% 的线上问题都源于某一段的“以为没问题”。5.1 断点一Tiptop 端 XML 生成验证 —— 抓住g_strXMLInput的原始快照在aws_xxx.4gl的FOREACH循环结束后、aws_efcli()调用前插入日志输出 XML-- 在 FOREACH 后CALL aws_efcli 前 CALL cl_log(XML to send: , g_strXMLInput[1, 500]) -- 只打前500字符防日志爆炸然后在 Tiptop 日志$TIPTOP_HOME/log/中搜索XML to send你会看到真实的 XML 字符串。验证三件事sfb01等字段名是否与ColumnSet.xml一致sfbuser是否存在且值为有效用户编号如439所有字段值是否非空特别是sfb01主键和sfbuser填单人后悔药若 XML 有误立刻停在这里改aws_xxx.4gl不要往下走。因为 Easyflow 只认这个 XML改别的都是白费。5.2 断点二Easyflow 接收日志 —— 确认 SOAP 请求已抵达网关Easyflow 的EF2Kweb\Logs\Gateway.log是第一手证据。当 Tiptop 发起调用后立刻查看此日志[2023-10-05 14:22:31] INFO Gateway: Received request for TT_WO1 [2023-10-05 14:22:31] DEBUG Gateway: XML payload: rootsfb01WO1-0001/sfb01sfbuser439/sfbuser/root [2023-10-05 14:22:31] INFO Gateway: Saved to Forms\TT_WO1\WO1-0001.xml关键指标若无Received request说明网络或 WSDL 问题回到 4.1。若有Received但无Saved说明ColumnSet.xml配置错误Easyflow 拒绝解析。若Saved的 XML 文件中sfbuser为空则aws_xxx.4gl没传该字段。5.3 断点三Easyflow 表单状态 —— 用数据库直查确认审批流是否激活Easyflow 的审批流状态存在 SQL Server 的EF2Kweb数据库中。直接查表比看界面更可靠-- 查看 TT_WO1 表单的待办任务 SELECT TaskID, FormID, Status, Assignee, CreatedDate FROM EF2Kweb.dbo.Tasks WHERE FormID TT_WO1 AND Status Pending -- 查看该任务的审批步骤 SELECT StepID, StepName, Approver, Status FROM EF2Kweb.dbo.TaskSteps WHERE TaskID TASK-001验证逻辑若Tasks表无记录说明sfbuser值不匹配任何审批人检查sfbuser是否为有效用户编号。若TaskSteps中Status Completed但 Tiptop 未更新说明回写失败查EF2Kweb\Logs\Update.log。5.4 断点四Tiptop 回写结果 —— 绕过应用层直击数据库Easyflow 回写是通过调用 Tiptop 提供的 WebServicep_efupdate最终执行 SQL。最狠的验证是-- 在 Tiptop 数据库中查该单据的最终状态 SELECT sfb01, sfb02, ta_sfbefstat, sfbuser FROM sfb_file WHERE sfb01 WO1-0001 -- 同时查日志表如果有 SELECT * FROM sfb_log WHERE sfb01 WO1-0001 ORDER BY log_time DESC终极判断若 ta_sfbefstat本文还有配套的精品资源点击获取