TOP GP命名、操作、环境架构

TOPGP环境构架、操作、命名、介绍

周迎春营运本部/中西营运区/T系列交付中心鼎捷软件2015年03月01日课程大纲TOPGP相关软件安装配置TOPGP基本操作TOPGP5X开发环境介绍TOPGP环境架构TOPGP命名原则准备安装CRT安装GDC基本操作

主画面基本操作说明

开启主目录方式Telnet下执行命令udm7exe2udm_tree执行程序方式exe2aimi100（任何目录下都可使用此命令）r.r2aimi100（只能在程序所述模块的目录下使用此命令）主目录双击程序名称主目录录入作业编号主目录编辑我的最爱程序界面下快捷键ctrl-gaimi100建档类型类型功能参数更改单档录入、更改、删除、复制、无效、打印、查询、条件查询、条件储存单档多栏单身、打印、汇出EXCEL、查询、条件查询、条件储存双档录入、更改、删除、复制、单身、打印、查询、条件查询、条件储存批处理条件查询、条件储存查询查询、打印报表条件查询、条件储存系统按钮及功能键操作说明快捷键按钮名称功能说明Ctrl-l语言切换语言别F1录入单档建档或双档建档案新增一笔资料u更改单档建档案时为更改此笔资料

双档建档时为更改此笔单头资料F2删除单档建档或双档建档案删除一笔数据c复制单档建档或双档建档案复制一笔数据x无效单档建档或双档建档案标注此笔数据无效之功能钮b单身在双档建档或单档多栏进入单身录入或更改数据o打印在建档程序行印凭证或明细表e汇出Excel在双档建档或单档多栏将单身查询出的数据汇入Excel系统按钮及功能键操作说明快捷键图形按钮功能说明q查询查询已存在的数据Ctrl-q条件查询查询用户储存过的条件，带入画面中Ctrl-w条件存储储存用户画面上录入的条件f第一笔当数据查询出来后，移到查询出来的第一笔数据p上笔当数据查询出来后，移到当前数据的前一笔数据j指定笔当数据查询出来后，可录入指定跳到第几笔数据n下一笔数据查询出来后，移到当前数据的下一笔数据l末一笔当数据查询出来后，移到查询出来的最后一笔数据Ctrl-z必要字段在新增或更改数据时，检查有哪些是必须录入的字段系统按钮及功能键操作说明快捷键图形按钮功能说明Ctrl-h帮助在线说明Esc离开离开此支程序Return确定在新增、更改完成时按确定存盘Esc退出在新增、更改时可按放弃此笔资料Ctrl-o预设上笔资料在新增时，单一字段缺省当前数据与上一笔相同Ctrl-f开启字段说明在新增或更改时，看某个字段的说明查询条件的运用*：表示任何符合的字符，例：A*，表示要找出全部为A开头的资料。

?：表示任一符合的字符，例：A?，表示要找出第一码为

A，第二码为任何字符，但总共只有二码之数据。

注：以上二功能仅可在文字字段使用。

=：表示该字段为空白。

>n：表示大于数值n，例：>100。

<n：表示小于数值n，例：<100。

<>n：表示不等于某个值，例：<>100。或<>’A001’

n:m：表示介于n与m之间，例：100:200。

x|y：表示值为x或y，例：A|B、50|60。

[a-z]*：表示第一字符为由a到z的任一字母开头的数据。TOPGP5X开发环境介绍

正式区、测试区、标准区的画分

TOPGP在出货时会画分成三大区域，分别是正式区、测试区与标准区。正式区：客户正式运行环境。本区程序不可任意更改，以维护数据的安全性。程序要汇入本区前，必须在测试区域完成磨合测试，并经相关用户的认可后才可以执行汇入的工作。测试区：主要是提供给用户练习数据输入，或是有新程序汇入系统的磨合测试区，本区的数据将会定期由正式区覆盖进来，以保持测试的逼真度。标准区：标准系统环境，不客制，仅接受Patch更新。区域划分的目的提供客户独立的正式与测试环境拥有系统功能自动更新的机制【patch】完整记录客制功能项目TOPGP各区路径规划图/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/aooi010/cooi010/u1/topstd/标准区/topcust//tiptop/axm,aoo,lib,sub,qrycxm,coo,clib,csub/aooi010/cooi010模块编号程序编号tiptop目录下的程序，除测试进行中时期外，在正式区、测试区及标准区均应保持一致TOPGP数据库分区/u1/topprod正式区topprodds数据库/u1/toptest测试区toptestds数据库/u1/topstd标准区topstdds数据库每一区都有各自独立的Instance每个Instance皆有独立的ds数据库DBServer系统资源分配TOTALDatabase4GBTOTALHardDisk14GBINSTANCE1正式区2G正式区6GINSTANCE2测试区300M测试区6GINSTANCE3标准区200M标准区2GTOPGP环境架构

系统架构图

系统架构说明系统在配置时，均以tiptop做为最上层目录，在tiptop下挂上各种系统所需的工具、模块等目录。config目录

本目录下是置放程序执行时所需参照到的设定部份。top.global：整个系统中都会使用到的公用变量定义（如g_user：记录现行用户代码、g_plant：记录用户当前使用工厂代码）档案。4ad：存放每支程序Action代码与显示说明转换的数据（分系统别、语言别存放）。4tm：存放每支程序的TopMenu数据（分系统别存放）。4tb：存放各类程序的ToolBar设定数据。4st：存放屏幕显示的Style设定数据。4sm：存放系统StartMenu（分语言别存放）。系统架构说明程序模块目录

aim等：各模块目录lib：置放系统『标准公用程序（如：cl_xxx）』目录。sub：置放系统『标准公用副程序（如：s_xxx）』目录。qry：置放系统『标准查询程序（如：q_xxx）』目录。模块下目录4gl：程序原码置放目录，置于其下的程序命名均须依命名原则定名。42m：程序原码经编译后的结果置放处。各程序单独存在，未经连结前的程序不一定可以独立执行。42r：编译连结完成后的执行档置放处。4fd:FormDesigner使用的画面档。per：透过gsform工具将4fd档案转换成的画面对照档。42f：编译完成的画面文件数据。sch：由数据库汇出的数据结构文件。sdd:画面档案规格说明。系统架构说明工作目录

ds4gl2：置放程序执行时所必需的执行程序稿。bin：置放程序执行时所必需的执行程序稿。schema:由数据库汇出的数据结构文件。demo：置放参考用标准程序的目录。doc:存放图片，说明文件，流程文件的目录。log:程序错误讯息记录档。out:历史打印报表存放目录。tmp：存放数据库备份及其它暂存数据。系统工具

在TOPGP系统中提供一些系统工具，让用户在自行开发程序时能有标准的执行依循。r.c2:将4gl程序编译为42mr.l2:读取程序连结数据并将42m程序连结至42rr.r2:执行42r程序r.d2+:呼叫Debugger（图形模式板）执行程序r.f2:将4fd画面档编译成42fr.gf:预览编译后的42f档案系统工具用法允许使用目录r.f2r.f2xxx4fd/per/42fr.gfr.gfxxx0/2(0为繁体，2为简体)p/c(p表示标准目录，c表示客制目录)4fd/per/42fr.c2r.c2xxx4glr.l2r.l2xxx4gl/42m/42rr.r2r.r2xxx4fd/per/42f/4gl/42m/42rr.d2+r.d2+xxx4glTOPGP命名原则

内容列表系统命名原则程序命名原则共享程序命名原则子程序命名原则函数命名原则变量命名原则数据库表格命名原则系统命名原则第一码为标准或客制识别码：『A』：标准系统模块『G』：配合两岸三地相关规则调整模块『C』：客制化模块系统以三至四个英文字来命名

第二到三码以系统英文缩写为主，若遇到已使用的代码，则第二码以『X』字符或另以相关缩写取代。客制模块命名原则：原有模块客制化，替换掉前面的“A”变成“C”，后面不变；大陆版模块则直接在前面加上“C”，以避免重复。新建模块则以“C”开头后，以不重复为原则命名。范例序号系统代码中文说明英文名称备注1aim库存料件数据管理系统InventoryManagemen2gnm票据管理系统NotesManagement大陆版3cim库存料件数据管理系统客制4cgnm票据管理系统客制5lib共享程序CommonLibrary6sub一般子程序CommonSubfunction7qry查询子程序CommanQueryFunction程序命名原则

程序一般以四码英文及三位数字（共七码）组成。程序名称的前三码为模块代码，第四码为程序类型，第五码至第七码为作业代码。

格式：SSSQ999说明：SSS为模块代码，均以小写字母表示Q为程序类型，其意义如下：

『i』维护作业、『r』报表作业、『s』参数设置、『p』批处理、『t』交易处理、『q』查询作业999为流水号若程序中，包含了一个以上的副函式或子画面，则可以再加上第四码来表示归属于该主程序下的附属资料（画面或程序）。

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

在『AZZ系统管理』模块下，程序命名原则就不依照此方式进行。该模块下为依照『程序使用档案名称』或『程序用途两方面来进行命名』；此原则是因可让程序便于辨识用途，以提升资管人员于调校程序的效率。例如：『p_zz程序基本数据维护作业』，因使用『zz_file』记录。

『p_perlang画面组件多语言维护作业』，因在维护画面档案的『Language』数据。附加档名附加档案名称多分为三类：4gl原始程序部份4gl原始程序42m原始程序编译后的目标程序42r连结后可运行的目标程序屏幕格式4fdFormDesigner使用的画面档per透过gsform工具将4fd档案转换成的画面对照档42f编译完成的画面档案数据其它格式sch档案参考内容举例：aimi100.4gl,aimi100.42m,aimi100.42raimi100.4fd,aimi100.per,aimi100.42fima_file.sch共享程序命名原则

共享程序为在TIPTOPGP中可全系统通用的函式；格式：cl_xxxxxxx

说明：cl_表示该程序为共享程序（CommonLibrary）

xxxxxxx最少1个字符，最多允许17个字符【因为各维护作业录入限制】。必须以有代表意义的方式命名，可加上『_』（下划线）以资区隔。举例：

cl_err显示错误信息

cl_opmsg显示操作时的相关提示资料子程序命名原则

程序开发中，一般会将部份程序中，可共同使用的函式独立出来，另外写成一支程序，此即为『子程序』。共享程序与一般子程序的差别相同点：多个程序共通使用的特性。具易维护节省开发之特性。差异点：共享程序：每个子系统（模块）皆可适用。一般子程序：只针对某个或某几个子系统（模块）。子程序分为两类：一般子程序查询子程序一般子程序命名原则格式：s_xxxxxxx

说明：

s_表示该程序为一般用途子程序（Subfunction）

xxxxxxx最多可用18个字符，最少1个字符，需以有意义的方式命名，如：英文的缩写等。举例：

s_tlf为库存异动时，将异动资料写入异动历史纪录中的子程序。

s_upimg为库存中，更新img档案的子程序。查询子程序命名原则格式：q_xxxxxxx

说明：

q_表示该程序为查询类（Query）子程序

xxxxxxx最多18个字符，最少1个字符须以有代表意义的方式命名，多半以欲查询的档案（tablename）名称命名【参考附注】。若该档案名称已使用，则可于后方加上流水号。举例：

q_ima 为料件数据查询

q_ima02料件数据查询

q_gef 销售系统单据性质查询

函数命名原则

函数（Function）为程序中，具有独立性质，而能提供特殊功能的部份组成。格式：xxxx_yy

说明：

xxxx_为程序代码简称，多以程序名称的后4码表示

yy为该函数的功能说明

举例：

i100_a为i100作业的新增函数

特别注意：在同一个主程序名称下，不可使用相同的函式名称，以避免程序于连结或在运行阶段发生不可预期的错误。

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

变量命名原则

整体性变量（GlobalVaribles）

格式：g_xxxxxxx

区域性变量（LocalVaribles）

格式：l_xxxxxxx

传递性变数(ParameterVaribles)

格式：p_xxxxxxx

屏幕变量（ScreenVaribles）格式：s_xxxxxxx数据库表格命名原则

表格名称（TableName）格式：xxx_file

说明：

xxx以小写英文字符（可含数字）命名，可用2至4码表示。

_file为固定字，表示此为表格

。举例：

ima_file为料件主档

gen_file为员工姓名档

数据库表格字段命名原则

字段名称（FieldName）格式：xxx99

说明：xxx与该文件的档案代码相同的字符串，99为2码流水编号，如果流水号不足则可扩充为3至4码。举例：

ima01为料件主档的料件编号字段

gen01为员工姓名档员工编号字段

数据库表格字段命名原则字段名称（FieldName）·若有特殊用途栏位，则定义尾端用字以统一acti资料有效否post资料过账否mksg资料签核否conf资料结案否prsw资料列印次数prnt立即列印否Slip单别desc单据名称type单据性质Myno已用单号sign签核等机conf自动确认否User资料建立人modu资料修改人grup建立/修改人部门Date资料维护日数据库表格索引命名原则

索引名称（IndexName）格式：xxx_01

说明：xxx与该文件的档案代码相同的字符串，01为2码流水编号

。举例：

ima_01为料件主档的索引

gen_01为员工姓名档的索引数据库表格档案命名原则

Schema档案名称（SchFiles）格式：xxx_file.sch

说明：此为表格存在于系统中的档案名称xxx为相同于档案名称的英文或数字字符组合而成举例：

ima_file.sch为料件主档的Schema档案名称

gen_file.sch为员工姓名档的Schema档案名称

客制全新表格档命名原则客制一个不存在的表格档案(table)名称，须写

“tc_(固定用法)”+“三码英文（可含数字）流水号”+

“_file(固定用法)”例如：