ERP二次开发规学习手册

TIPTOP GP ERP 二次开发规范说明TIPTOP ERP共分三大区：topstd（标准区）+ toppord（正式区）+ toptest（测试区）标准区正式生产环境用户测试,MIS程序客制测试11目录结构和topprod完全一样标准 tiptop（$TOP） 客制 topcust（$CUST）Irrrr+1l-目录结构和$top完全一样，只不过模组目录都是 c 开头的了config doc ds4gl2 ora out schema 各模组目录axm、asf.截止 5.25 已经有 47 个模组+sub+lib+qry ） config :配置文件目录（top.global全局变量、4ad各程序ACTION列表、4st画面风格、4tb界面按钮风格、 等）doc :帮助文档+系统图片目录ds4gl2 :些脚本目录，如r.c2、r2等ora :下数据库应用查询脚本，如q_tabFREE等out :临时目录schema: 数据库 sch 文件目录各模组目录: 4fd 画面档目录、 per 画面档编译后 per 目录、 4gl 源码档、 42m、 42rGenero Studio 文件说明说明：$XXX表示各个模组；：服务器必须文件；X服务器可选文件4pw : Genero Studio项目工程文件（位于服务器目录：$XXX/4pw ）x4fd :画面档（位于服务器目录：$XXX/4fd ）Vper : gsform后4fd画面档对照文件（4fd经过gsform后的文件，位于服务器目录：$XXX/per ）V42f :编译后的画面档文件（4fd经过r.f2后的文件，位于服务器目录：$XXX/per ）V4gl :源码档（位于服务器目录：$XXX/4gl ）42m :编译后的源码链接档（4gl经过r.c2后的编译档，位于服务器目录：$XXX/42m ）42r :链接后的可执行文件（42m经过r.l2后的链接档，位于服务器目录：$XXX/42r ）V4rp :报表文件（位于服务器目录：$XXX/4rp ）xsch :数据库表结构文件（位于服务器目录：$XXX/sch ）xTIPTOP ERP客制规范命名原则程序命名原则:XXX（3码）X（2码）XXX（3-5 码）模组名 程序类型 流水号模组名：如果为标准程序，程序名一定是a开头，程序位于对应的$AXX模组目录 如果修改标准程序，有些公司是修改为c程序有些公司还是用原来的 a 程序但是目录一定都是对应的$CXX模组目录 如果是新增程序，程序名一定是c开头，程序目录一定是对应的$CXX模组目录程序类型:r报表类程序、i基础资料类程序、q查询类程序、t交易类程序、p批处理类程序、s参数类程序 流水号:一般随便编录，不重复就好；专业些就是同一作用的程序流水号一类$AZZ 程序都是 p_幵头，规则不同与上$UB为共用查询程序，都是cl_开头-$CUB为 客制共用查询程序，都是ccl_开头 $SUB为副程序，都是 s_开头-$CSUB为客制副程序，都是 cs_开头程序内部FUNCTION函数命名原则：x(2码)xxx(3-5码)功能0常见功能函数如下：_menu： action 功能菜单q：开始查询，调用_fetch查取第一笔资料_cs：QBE 条件查询 及 查询游标声明fetch：show：N、P、F、L、/处理下、上、第一笔、末笔、指定笔单头资料读取，并调用_show显示资料 显示单头资料，如需要并调用_b_fill填充单身资料a：i：新增，并先后调用(a)输入单头资料和_b输入单身资料 根据函数接受的参数 a 新增资料、 u 更新资料u：_b：更新，调用(u)更新资料 单身CRUD业务逻辑b_fill： 单身资料填充bp：显示单身资料，提供单身action功能选项_r：_out：删除整笔资料打印函数_x：pic：资料无效、有效处理 显示或刷新图片ef：EasyFlow 送签_y：_z：确认 取消确认_s：过账_w：过账还原_gen/_g：般为根据某action自动产生单身资料sub_y_chk 或 _y_chk ：一般为复杂逻辑 t 程序 确认动作时执行资料逻辑检查 sub_y_upd或_y_upd :般为复杂逻辑t程序确认动作时执行资料更新sub refresh：般为复杂逻辑t程序确认、取消确认、过账、过账还原动作更新后的资料刷新sub s：set entry：般为复杂逻辑t程序过账”设置单头栏位 可进入录入资料set no entry：设置单头栏位不可进入录入资料set entry b：设置单身栏位 可进入录入资料set no entry b：设置单身栏位不可进入录入资料_set_required：设置栏位为必须输入资料init：初始化程序栏位是否可视， ACTION 是否可视_a_default：新增资料时赋初值_b_move_to：单身栏位赋值、备份_b_move_back：单身栏位值还原修改数据库表栏位命名规则： 修改现有表现有列：表列名称不变，只是旗标会自动由标准变成客制 在现有表上增加列：表列规则ta_原表流水号，ex : ta_ima001 新增表：表名及表列规则都是tc开头，表tc_xxx_file，表歹0 tc_xxx流水号，ex : tcee_file，tc_lee001TIPTOP GP ERP 二次开发流程前提：熟悉基础的Linux命令+4GL基础语法+SQL语法，你可以看看本手册里面对应目录的相 关资料一、p_zta增加或修改表（如果不用改表，这步可以跳过）修改表要数据库DBA的权限，如果你的账号没有这个权限可以在Linux服务器上用root执行一下脚步 usermod -a -g dba Linux用户名（ex:为liyihui这个账号添加数据库dba组的权限usermod -a -g dba liyihui）（注意：是小 9不是大G，大G是标准组，会覆盖之前用户所在的组，而不是添加组了）1、登入 p_ztaDBA2、新增或修改表注意：你至少需要新增或修改ds库和程序业务使用的数据库，ds库是程序编译时参照的库（比如LIKEima_file.tc_ima01） 如果是新建表，先 建立p_zta资料后，然后点击；如果是修改表就不用做这步骤了 然后点击，根据是新增表还是修改表选择对应的选项操作非必须操作 .更新ds.sch，Linux服务器上执行命令r.s2 ds非必须操作，p_zta最后会自动r.s2 下我的技巧： 如果多个营运中心都需要建立同一张表，我是这么做的 .ds帐套在p_zta按上面的流程建立表 其他帐套在 PL/SQL 执行 SQL : CREATE TABLE 表 AS SELECT * FROM ds.表 复制出zta_file及ztb_file该表的信息（将所属者改为其他帐套，每个帐套一份） 再到p_zta里面，修改各个帐套的表的索引就OK 了二如果是将a标准程序修改为c客制程序，这里先做；如果是新增程序直接跳过本步骤为什么要先插入这一步：这样r.gf 客制程序 2 c后自动新增的p_perlang和p_per就不用维护什么资料了 1、p_perlang复制a标准程序的画面档资料为c客制程序的画面档资料p_perlang先查询出标准程序的资料- 再按c （拷贝）- 写入客制程序的代码+勾选客制栏位 ex :先查询asft620的资料，然后复制（按c）将asft620客制为csft6202、 p_per 同理三、新增或修改4fd画面档及4gl程序源码档1、Linux服务器上下载ds.sch （如果做的4fd不用参照表就不用下载了，比如一些报表）Linux 服务器上执行 sz $TOP/schema/ds.sch2、打开Genero Studio软件，开始绘制4fd画面档 .建立Genero Studio的工程项目（注意是.4pw的工程项目工程文件哟）点击Ctrl + S先保存项目文件，这是个人经常性按Ctrl+S保存文件的习惯人_人 导入前面下载的dS.Sch文件到工程文件中（否则等下做4fd画面档时会出现找不到表的情 将导入的ds.sch文件保存到工程文件中的Databases目录下面 新建或修改4fd画面档对于新建4fd画面档时我一般都是先摆好所有的控件,然后选择对应同一个表的所有控件（Ctrl可多选）, 再一起修改对应的表做画面档对于单身栏位，在单身列中间插入列时，该列在单身对应的 SR 变量里面一直摆在最后面,而不是 对应的位置，需要手动调整一下(选中上下拉就可以了)： .rz -y上传4fd档到服务器上对应的ERP模块4fd路径下面(Ex : $CSF/4fd ),编译且预览画面档r.f2 4fd 画面档 (Ex： r.f2 csft620)r.gf 4fd画面档(Ex : r.gf csft620 2 c ) (2:是语言别，表示中文简体；c:表示客制，如果是标准模块则换成 p) 新建或修改4gl源码档写4gl代码说明编辑器都可以，但个人还是喜欢用Genero Studio，因为有关键字着色、语法预警等功能 rz -y上传4gl源码档到服务器上对应的ERP模块4gl路径下面(Ex : $CSF/4gl)，编译4gl (暂不链 接)r.c2 源码档( Ex: r.c2 csft620) .p_link查询出原标准程序的链接档，然后按C (复制)出客制程序的链接档，修改对应的项为客制目录下 面的文件就可以了再新增p_zz里面的资料，注意p_zz里面的运行指令及模组都要改成客制目录 回到服务器，链接程序r.l2 源码档( Ex: r.l2 csft620) 回到p_zz，点击进入p_base_act程序后，一点要点击一下单身，然后退出，选择重新生成4ad档，才能在程序里面正确显示对应的 ACTION如果不是tiptop账号，你需要$TOP/config/4ad整个目录文件的权限才可以成功生成新的程序的4ad文根据需要，p_zm挂载程序到ERP目录里面及开通权限等p_zm执行时，如果不是tiptop账号，你需要$TOP/config/4sm目录及文件的权限才可以成功生成 menu.4sm 目录文件