TOPGP命名、操作、环境架构

1、周迎春营运本部/中西营运区/T系列交付中心鼎捷软件2015年03月01日准备 安装CRT 安装GDC基本操作基本操作主画面基本操作说明主画面基本操作说明 开启主目录方式 Telnet下 执行命令 udm7 exe2 udm_tree 执行程序方式 exe2 aimi100 （任何目录下都可使用此命令） r.r2 aimi100 （只能在程序所述模块的目录下使用此命令） 主目录双击程序名称 主目录录入作业编号 主目录编辑我的最爱 程序界面下快捷键 ctrl-g aimi100建档类型类型类型功能功能参数更改单档录入、更改、删除、复制、无效、打印、查询、条件查询、条件储存单档多栏单身、打印、汇出E

2、XCEL、查询、条件查询、条件储存双档录入、更改、删除、复制、单身、打印、查询、条件查询、条件储存批处理条件查询、条件储存查询查询、打印报表条件查询、条件储存系统按钮及功能键操作说明系统按钮及功能键操作说明快捷键 按钮名称 功能说明 Ctrl-l 语言切换语言别 F1 录入单档建档或双档建档案新增一笔资料 u 更改单档建档案时为更改此笔资料双档建档时为更改此笔单头资料 F2 删除单档建档或双档建档案删除一笔数据 c 复制单档建档或双档建档案复制一笔数据 x 无效单档建档或双档建档案标注此笔数据无效之功能钮 b 单身在双档建档或单档多栏进入单身录入或更改数据 o 打印在建档程序行印凭证或明细表

3、e 汇出Excel在双档建档或单档多栏将单身查询出的数据汇入Excel 系统按钮及功能键操作说明系统按钮及功能键操作说明快捷键 图形按钮 功能说明 q 查询查询已存在的数据 Ctrl-q 条件查询查询用户储存过的条件，带入画面中 Ctrl-w 条件存储储存用户画面上录入的条件 f 第一笔当数据查询出来后，移到查询出来的第一笔数据 p 上笔当数据查询出来后，移到当前数据的前一笔数据 j 指定笔当数据查询出来后，可录入指定跳到第几笔数据 n 下一笔数据查询出来后，移到当前数据的下一笔数据 l 末一笔当数据查询出来后，移到查询出来的最后一笔数据 Ctrl-z 必要字段在新增或更改数据时，检查有哪些是

4、必须录入的字段 系统按钮及功能键操作说明系统按钮及功能键操作说明快捷键 图形按钮 功能说明 Ctrl-h 帮助在线说明 Esc 离开离开此支程序 Return 确定在新增、更改完成时按确定存盘 Esc 退出在新增、更改时可按放弃此笔资料 Ctrl-o 预设上笔资料在新增时，单一字段缺省当前数据与上一笔相同 Ctrl-f 开启字段说明在新增或更改时，看某个字段的说明 查询条件的运用 *：表示任何符合的字符，例：A*，表示要找出全部为A开头的资料。?：表示任一符合的字符，例：A?，表示要找出第一码为 A，第二码为任何字符，但总共只有二码之数据。注：以上二功能仅可在文字字段使用。=： 表示该字段为空

5、白。n： 表示大于数值n，例：100。n： 表示小于数值n，例：100。n： 表示不等于某个值，例：100。或A001n:m： 表示介于n与m之间，例：100:200。x|y： 表示值为x或y，例：A|B、50|60。a-z*：表示第一字符为由a到z的任一字母开头的数据。 正式区、测试区、标准区的画分正式区、测试区、标准区的画分 TOP GP在出货时会画分成三大区域，分别是正式区、测试区与标准区。 正式区：客户正式运行环境 。本区程序不可任意更改，以维护数据的安全性。程序要汇入本区前，必须在测试区域完成磨合测试，并经相关用户的认可后才可以执行汇入的工作。 测试区：主要是提供给用户练习数据输入，

6、或是有新程序汇入系统的磨合测试区，本区的数据将会定期由正式区覆盖进来，以保持测试的逼真度。 标准区：标准系统环境，不客制，仅接受Patch 更新。区域划分的目的 提供客户独立的正式与测试环境 拥有系统功能自动更新的机制【patch】 完整记录客制功能项目TOP GP 各区路径规划图各区路径规划图/u1/topprod/正式区/topcust/tiptop/axm,aoo,lib,sub,qrycxm,coo,clib,csub/aooi010/cooi010/u1/toptest/测试区/topcust/tiptop/axm,aoo,lib,sub,qrycxm,coo,clib,csub/a

7、ooi010/cooi010/u1/topstd/标准区/topcust/tiptop/axm,aoo,lib,sub,qrycxm,coo,clib,csub/aooi010/cooi010模块编号程序编号tiptop 目录下的程序，除测试进行中时期外，在正式区、测试区及标准区均应保持一致TOP GP 数据库分区/u1/topprod正式区topprodds 数据库/u1/toptest测试区toptestds 数据库/u1/topstd标准区topstdds 数据库每一区都有各自独立的Instance每个Instance皆有独立的ds数据库DB Server 系统资源分配TOTAL Dat

8、abase 4GBTOTAL Hard Disk 14GBINSTANCE 1正式区2G正式区6GINSTANCE 2测试区300M测试区6GINSTANCE 3标准区200M标准区2G系统架构图系统架构图 4ad4t m4sm4t b4stt op. gl obalconfi g4gl42m42r4fd42fpersddschrep各模組aap, abx, azz. . .4gl42m4fd42fpersdd系統模組sub, l i b, qr yrel easeschem at oolds4gl 2bi nt i pt op. keydem odocl ogoutt m pt ri gge

9、rt i pt op系统架构说明 系统在配置时，均以tiptop做为最上层目录，在tiptop下挂上各种系统所需的工具、模块等目录 。 config目录 本目录下是置放程序执行时所需参照到的设定部份。 top.global：整个系统中都会使用到的公用变量定义（如g_user：记录现行用户代码、g_plant：记录用户当前使用工厂代码）档案。 4ad：存放每支程序Action代码与显示说明转换的数据（分系统别、语言别存放）。 4tm：存放每支程序的TopMenu数据（分系统别存放）。 4tb：存放各类程序的Tool Bar设定数据。 4st：存放屏幕显示的Style设定数据。 4sm：存放系统S

10、tart Menu（分语言别存放）。系统架构说明 程序模块目录 aim等：各模块目录 lib： 置放系统标准公用程序（如：cl_xxx）目录。 sub：置放系统标准公用副程序（如：s_xxx）目录。 qry：置放系统标准查询程序（如：q_xxx）目录。 模块下目录 4gl：程序原码置放目录，置于其下的程序命名均须依命名原则定名。 42m：程序原码经编译后的结果置放处。各程序单独存在，未经连结前的程序不一定可以独立执行。 42r：编译连结完成后的执行档置放处。 4fd : Form Designer使用的画面档。 per：透过gsform工具将4fd档案转换成的画面对照档。 42f：编译完成的画

11、面文件数据。 sch：由数据库汇出的数据结构文件。 sdd: 画面档案规格说明。 系统架构说明 工作目录 ds4gl2：置放程序执行时所必需的执行程序稿。 bin：置放程序执行时所必需的执行程序稿。 schema:由数据库汇出的数据结构文件。 demo：置放参考用标准程序的目录。 doc: 存放图片，说明文件，流程文件的目录。 log: 程序错误讯息记录档。 out: 历史打印报表存放目录。 tmp：存放数据库备份及其它暂存数据。系统工具系统工具 在TOP GP系统中提供一些系统工具，让用户在自行开发程序时能有标准的执行依循。 r.c2 : 将4gl程序编译为42m r.l2 : 读取程序连结

12、数据并将42m程序连结至42r r.r2 : 执行42r程序 r.d2+ : 呼叫Debugger（图形模式板）执行程序 r.f2 : 将4fd画面档编译成42f r.gf : 预览编译后的42f档案系统工具用法用法 允许使用目录允许使用目录r.f2r.f2 xxx4fd/per/42fr.gfr.gf xxx 0/2(0为繁体，2为简体) p/c(p表示标准目录，c表示客制目录)4fd/per/42fr.c2r.c2 xxx4glr.l2r.l2 xxx4gl/42m/42rr.r2r.r2 xxx4fd/per/42f/4gl/42m/42rr.d2+r.d2+ xxx4gl内容列表A：标

13、准系统模块G：配合两岸三地相关规则调整模块C：客制化模块 v原有模块客制化，替换掉前面的“A”变成“C”，后面不变；v大陆版模块则直接在前面加上“C”，以避免重复。v新建模块则以“C”开头后，以不重复为原则命名。范例序号 系统代码中文说明英文名称备注1aim 库存料件数据管理系统 Inventory Managemen 2gnm 票据管理系统 Notes Management 大陆版 3cim库存料件数据管理系统客制4cgnm票据管理系统客制5lib 共享程序 Common Library 6sub 一般子程序 Common Subfunction7qry 查询子程序 Comman Query

14、 Function 程序命名原则程序命名原则 范例 客制化程式码调整客制化程式码调整有需要进行客制化程式码调整，请勿在标准（package）目录下面进行，请将要客制的作业复制到对应的客制目录下面再修改客制原来就有的作业：保持原来的作业名称新增加入的客制作业：请遵循命名原则例：Aimi100需要客制-将此作业由$AIM复制到$CIM下新增一支aim作业-检查确认原来系统没有此作业，在$CIM下新 增，依规定命名，如cimt345当4gl需客制时，对应的per也需要复制到客制目录aimi100为料件基本数据维护作业。aim为系统名称，i为维护作业，100为该作业的编号。aimi1001表示附于程序

15、aimi100的子档案。例外情况： 在AZZ系统管理模块下，程序命名原则就不依照此方式进行。该模块下为依照程序使用档案名称或程序用途两方面来进行命名；此原则是因可让程序便于辨识用途，以提升资管人员于调校程序的效率。 例如：p_zz程序基本数据维护作业，因使用zz_file记录。 p_perlang画面组件多语言维护作业，因在维护画面档案的Language数据。附加档名 附加档案名称多分为三类： 4gl原始程序部份 4gl 原始程序 42m 原始程序编译后的目标程序 42r 连结后可运行的目标程序 屏幕格式 4fd Form Designer使用的画面档 per 透过gsform工具将4fd档案

16、转换成的画面对照档 42f 编译完成的画面档案数据 其它格式 sch 档案参考内容举例：aimi100.4gl, aimi100.42m, aimi100.42r aimi100.4fd, aimi100.per, aimi100.42f ima_file.sch共享程序命名原则共享程序命名原则 子程序命名原则子程序命名原则 一般子程序命名原则一般子程序命名原则 查询子程序命名原则查询子程序命名原则 函数命名原则函数命名原则 函数（Function）为程序中，具有独立性质，而能提供特殊功能的部份组成。 函数命名原则函数命名原则 程序中通常有下列函数：_a： 处理数据新增_r： 处理数据取消_b

17、： 处理多栏单身数据_rep： 处理报表格式_copy： 处理数据复制_show： 将数据显示于画面_cs（或 _curs）： 处理画面上给QBE条件_x： 切换资料有无效_fetch： 处理从数据库中取得数据_u： 处理数据更改_i： 处理数据录入_out： 处理简表打印_menu： 单档案程序的功能选择_bp: 双档或单档多栏（有单身的）程序之功能选择_q： 处理数据查询_ima01： 处理字段检查（名称同字段名称）_set_entry: 处理字段的动态开启_set_no_entry: 处理字段的动态关闭（须含判断式） 变量命名原则变量命名原则 整体性变量（Global Varibles）

18、 格式：g_xxxxxxx 区域性变量（Local Varibles） 格式：l_xxxxxxx 传递性变数(Parameter Varibles) 格式： p_xxxxxxx 屏幕变量（Screen Varibles ） 格式：s_xxxxxxx 数据库表格命名原则数据库表格命名原则 表格名称（Table Name） 数据库表格字段命名原则数据库表格字段命名原则 字段名称（Field Name） 的料件编号字段 gen01 为员工编号字段数据库表格字段命名原则数据库表格字段命名原则 字段名称（Field Name）若有特殊用途栏位，则定义尾端用字以统一acti资料有效否 post 资料过账否

19、 mksg 资料签核否conf资料结案否 prsw资料列印次数 prnt 立即列印否 Slip 单别 desc 单据名称 type单据性质Myno已用单号 sign签核等机 conf自动确认否User资料建立人 modu资料修改人 grup建立/修改人部门Date资料维护日数据库表格索引命名原则数据库表格索引命名原则 索引名称（Index Name） 的索引 gen_01 为的索引数据库表格档案命名原则数据库表格档案命名原则 Schema档案名称（Sch Files） ima_file.sch 为料件主档的Schema档案名称 gen_file.sch 为员工姓名档的Schema档案名称 客制全新表格档命名原则 客制一个不存在的表格档案(table)名称，须写 “tc_(固定用法)”+“三码英文（可含数字）流水号”+ “_file(固定用法)” 例如： tc_ima_file 辅助ima_file用 tc_gae_file 辅助gae_file用 取用时应由该模组特定区段优先选用 如im*_file区段属aim模组 客制aim模组时，可先以tc_ima_file编起客制新表格的栏位命名原则客制新表格的栏位命名原则 栏位（filed）名称，须写