TOPGP命名操作环境架构

TOPGP环境构架、操作、命名、介绍周迎春营运本部/中西营运区/T系列交付中心鼎捷软件2015年03月01日课程大纲•TOPGP相关软件安装配置•TOPGP基本操作•TOPGP5X开发环境介绍•TOPGP环境架构•TOPGP命名原则准备•安装CRT•安装GDC基本操作主画面基本操作说明•开启主目录方式–Telnet下执行命令udm7–exe2udm_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环境架构系统架构图4ad4tm4sm4tb4sttop.globalconfig4gl42m42r4fd42fpersddschrep各模組aap,abx,azz...4gl42m4fd42fpersdd系統模組sub,lib,qryreleaseschematoolds4gl2bintiptop.keydemodoclogouttmptriggertiptop系统架构说明•系统在配置时，均以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程序编译为42m–r.l2:读取程序连结数据并将42m程序连结至42r–r.r2:执行42r程序–r.d2+:呼叫Debugger（图形模式板）执行程序–r.f2:将4fd画面档编译成42f–r.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显示错误信息c