【实习之T100开发】T100 基础架构、命名原则

左手的ㄟ右手 2023-01-08 08:24 389阅读 0赞

### T100学习笔记 ###

*  执行程序的方法
 *  T100基础架构
 *   *  基本环境变量
     *  基本执行 Shell
 *  命名原则
 *   *  模组（module）命名原则
     *  表格（Table）命名原则
     *  字段（field）命名原则
     *  特殊定义字段
     *  程序 / 作业编号定义（包括子程序、子画面）
     *  报表样板编号
     *  Web Service 程序编号
     *  函数（Function）命名原则
     *  变量命名规则
 *  一些作业编号记录
 *  文档中常见台湾用语
 *  学习资料

> [【实习】T100开发学习笔记][T100]

# 执行程序的方法 #

假设你现在已经通过 Xshell 或某种工具连上公司的 Linux服务器

--------------------

**方法一**：在 Xshell 命令行：`r.r 作业单号` 即可

例如：`r.r aimi100`  
![在这里插入图片描述][20210119165838408.png]

--------------------

**方法二**：利用 `menu` 指令调出 T100系统首页，这个界面又有两种方法执行程序  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzczNDA5NQ_size_1_color_FFFFFF_t_70]  
①上方搜索框输入作业单号，回车或点搜索即可执行。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzczNDA5NQ_size_1_color_FFFFFF_t_70 1]

② `ctrl + g` 调处一个画面，输入作业编号点击运行  
![在这里插入图片描述][20210119165615953.png]

# T100基础架构 #

**T100 数据库结构**  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzczNDA5NQ_size_1_color_FFFFFF_t_70 2]  
T100分为4个区

*  正式区：上线前会在正式区进行开发和模拟
 *  测试区：上线后二次开发在测试区做，还可以测试功能
 *  标准区：产品出货最干净的区
 *  验证区：上patch，做验证然后再去正式区patch

**T100 安装目录**  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzczNDA5NQ_size_1_color_FFFFFF_t_70 3]  
`cd $TOP` 可以回到正式区最上层目录，即 **/topprd目录**下  
`cd $ERP` 可以直接进入 topprd/erp 目录下

**T100系统架构图**  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzczNDA5NQ_size_1_color_FFFFFF_t_70 4]  
com

*  sub：公共程序、子程序
 *  lib：例如报错 cl\_err，cl\_ask
 *  qry：所有开窗作业
 *  lng：多语言
 *  inc：全局变量
 *  wss：集成  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzczNDA5NQ_size_1_color_FFFFFF_t_70 5]

**erp下各个模组文件夹**（`a`开头的是 **标准模组**，如aao、axm、aim…）

*  4gl：源程序，编译后产生42m，再经过链接产生42r
 *  4fd：源画面，编译后产生42f
 *  sch：数据表
 *  4rp：凭证报表的主程序
 *  fr：帆软报表
 *  dzx：设计资料  
    ![在这里插入图片描述][20210119180447855.png]  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzczNDA5NQ_size_1_color_FFFFFF_t_70 6]![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzczNDA5NQ_size_1_color_FFFFFF_t_70 7]

## 基本环境变量 ##

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzczNDA5NQ_size_1_color_FFFFFF_t_70 8]

## 基本执行 Shell ##

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzczNDA5NQ_size_1_color_FFFFFF_t_70 9][]  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzczNDA5NQ_size_1_color_FFFFFF_t_70 10]  
`r.d` 可以在任意目录下执行，`r.dg` 必须在 `模组/4gl` 目录下执行，`r.d` 不成功就用 `r.dg`

# 命名原则 #

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzczNDA5NQ_size_1_color_FFFFFF_t_70 11]

## 模组（module）命名原则 ##

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzczNDA5NQ_size_1_color_FFFFFF_t_70 12]  
示例：

*  a开头标准模组（axm、apm、asf、agl）
 *  c开头客制模组（cxm、cpm、csf、cgl）
 *  lib - clib 标准-客制 （公共程序）
 *  sub - csub 标准-客制（公共子程序）
 *  qry - cqry 标准-客制（开窗程序）
 *  lng - clng 标准-客制（数据表多语言）
 *  wss - cwss 标准-客制（webservices 继承）

## 表格（Table）命名原则 ##

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzczNDA5NQ_size_1_color_FFFFFF_t_70 13]  
示例：

*  标准：axm 建立订单表 ——> xmaa\_t 表；字段编号 xmaa001
 *  客制：cxm 建立订单表 ——> xmaauc\_t表；字段编号 xmaauc001

## 字段（field）命名原则 ##

> **字段重要规范**  
> ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzczNDA5NQ_size_1_color_FFFFFF_t_70 14]

**标准字段命名原则**

*  字段编号  
    \[表格编号（去除\_t）\] + \[3位流水号\]
 *  行业包辅助字段命名原则  
    \[表格编号（去除\_t）\] + \[2位行业编号\] + \[3位流水号\]
    
     *  标准表格的域名如果为：表格名称 + \[ud\]，即为**弹性字段**，仅供客制开发使用。  
        tiptop账号是无法建立ud字段的，只能用这些产品来做**二次开发**

**客制字段命名原则**

*  从标准表格加客制字段  
    \[表格编号（去除\_t）\] + \[ua\] + \[3位流水号\]
 *  全新客制表格字段必须按照标准命名(表格已经包含uc)  
    \[表格编号（去除\_t）\] + \[3位流水号\]

r.t (adzi140) 表格设计器：新增修改表，以及表结构，表字段

*  标准表字段：xmaaud001，ud表示**弹性字段(产品留给tiptop账号做二开)**
 *  客制表字段：xmaaua001，ua表示**标准表转客制的字段(tiptop账号自己新增做二开)**
 *  全新客制的表：xmaauc001，uc表示**完全客制的表字段**

## 特殊定义字段 ##

若有**特定用途字段**，则标准或客制表格均使用如下定义尾部用字以统一。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzczNDA5NQ_size_1_color_FFFFFF_t_70 15]![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzczNDA5NQ_size_1_color_FFFFFF_t_70 16]  
**特殊定义字尾栏位**  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzczNDA5NQ_size_1_color_FFFFFF_t_70 17]  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzczNDA5NQ_size_1_color_FFFFFF_t_70 18]  
**总结**：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzczNDA5NQ_size_1_color_FFFFFF_t_70 19]

## 程序 / 作业编号定义（包括子程序、子画面） ##

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzczNDA5NQ_size_1_color_FFFFFF_t_70 20]  
![在这里插入图片描述][20210120111148599.png]  
相关作业：

*  azzi900：程序基本数据设定作业
 *  azzi901：子程序及组件基本数据设定作业

示例：作业名称为 aimi100

*  前3位【aim】是 **模块名**
 *  第4位【i】表示 **I类作业**
 *  最后3位【100】是 **流水号**

--------------------

**子程序、子画面编号**

若主程序需要另外写函数，则会增加子程序。  
![在这里插入图片描述][20210120113326762.png]  
示例：主程序名称为 aimi100

aimi100\_01：为一般用途的子程序  
aimi100\_g01、aimi100\_g02、… 为 **凭证报表（Genero Report）** 的子程序  
aimi100\_x01、aimi100\_x02、… 为 **查询报表（Xtra Grid）** 的子程序

--------------------

程序开发过程中需要一个以上的画面时，可以额外制作子画面。  
![在这里插入图片描述][20210120113305887.png]  
示例：主程序名称为 aimi100  
aimi100\_s01、aimia100\_s02 … 为子画面

> 程序注册 —— azzi900  
> 子程序注册 —— azzi901

## 报表样板编号 ##

一份报表可允许应用多份报表样板，若有多样版需求时，命名 主要样板＋两位数字流水号

子报表样式：主要样板＋「\_subrep」＋ 流水号

示例：  
主报表：axmr402\_g01.4rp（单一样板）  
主报表：axmr403\_g01\_02.4rp（多样板）  
子报表：axmr402\_g01\_subrep01.4rp

## Web Service 程序编号 ##

在 $COM/WSS 模块内提供了 Web Service 主程序专用的相关子程序。  
提供给一般 ERP程序进行链接呼叫。  
![在这里插入图片描述][20210120120246663.png]

## 函数（Function）命名原则 ##

函数名称须为「程序名称」＋「此函数功用」，同一程序中不可使用相同的函数名称。

主程序中通常由下列函数：

*  \_insert() 新增数据
 *  \_delete() 删除数据
 *  \_show() 展示数据
 *  \_fetch() 从数据库中取得数据
 *  \_modify() 修改数据
 *  \_input() 输入数据
 *  \_query() 查询数据
 *  \_set\_entry() 处理字段的动态开启
 *  \_set\_no\_entry() 处理字段的动态关闭（需含判断式）

## 变量命名规则 ##

以下用于 4gl程序中

*  全局变量（Global Variable）或 模块变量（Module Variable）  
    `g_` \+ 功能名称
 *  区域变量（Local Variable）  
    `l_` \+ 功能名称
 *  传递用的变量（Passive Variable）  
    `p_` \+ 功能名称

以下用于 4fd画面中

*  屏幕数组变量 (Screen Array Variable)  
    以 `s_` 开头命名  
    s\_detailN 或 s\_detailN\_info 或 s\_browser，N为流水号

# 一些作业编号记录 #

azzi800 使用者账号设定：设置用户登录（密码设置，可拜访营运据点，角色设置）  
azzi500 企业编号维护作业  
azzi085 数据库连接设置作业：查看数据用户名对应的数据库id  
azzi920 系统信息维护作业  
**azzi908 程序全局变量设置维护档案**：新增全局变量inc  
azzq171 函数说明查询作业  
**azzi070 模块代号维护作业**

**adzi140 表格设计器**：新增修改表，以及表结构，表字段；**助记码`r.t`**

--------------------

程序基本资料设定作业：azzis00  
作业基本资料设定作业：azz910  
子程序设定：azzi901  
画面数据设定：azzi902  
多语言数据维护：azzi912  
整批导入excel作业：axct305  
流程打印：azzr551  
报表单头设置：azzi330  
系统分类码维护作业：azzi600  
应用分类维护作业：azzi650  
程序复制与规格：adzp270  
新增企业编号作业：azzi500  
组织基本维护作业：aooi100  
lba数查询作业：azzq171  
报核作业：aooi900

# 文档中常见台湾用语 #

两码流水号 ——> 两位流水号  
函式 ——> 函数

# 学习资料 #

网络：

[T100规格设计器画面产生器操作（一系列文章）][T100 1]

[4GL+T100程序设计开发常用方法、技巧总结：][4GL_T100]

--------------------

《T100 技术手册》

[T100]: https://blog.csdn.net/weixin_43734095/article/details/112873495
[20210119165838408.png]: /images/20221119/fb1fa68dd08144d09d89768a7d473432.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzczNDA5NQ_size_1_color_FFFFFF_t_70]: /images/20221119/1cc6e6ac8d4b408b8a20c79f6bf3dc83.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzczNDA5NQ_size_1_color_FFFFFF_t_70 1]: /images/20221119/f2c7907b0d50402ab9e5f928f6e84892.png
[20210119165615953.png]: /images/20221119/5676c47d69b14e328bbae8ea9b76e6ee.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzczNDA5NQ_size_1_color_FFFFFF_t_70 2]: /images/20221119/8397703e14f14f1890d9761ca132e524.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzczNDA5NQ_size_1_color_FFFFFF_t_70 3]: /images/20221119/60c73111eb554d95b9d7d78df32ea58d.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzczNDA5NQ_size_1_color_FFFFFF_t_70 4]: /images/20221119/f4354bef688e4932b77700050388744a.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzczNDA5NQ_size_1_color_FFFFFF_t_70 5]: /images/20221119/5c0170f56dec4a3894c1d6a4720a0665.png
[20210119180447855.png]: /images/20221119/8c78d685227f45d8a6cf23d51c97d95b.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzczNDA5NQ_size_1_color_FFFFFF_t_70 6]: https://img-blog.csdnimg.cn/2021011918080140.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzczNDA5NQ==,size_1,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzczNDA5NQ_size_1_color_FFFFFF_t_70 7]: /images/20221119/644719489fa04a62910c6ce3ea67e928.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzczNDA5NQ_size_1_color_FFFFFF_t_70 8]: /images/20221119/4066fc17be5345ae94c20bfe1d6bd5e3.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzczNDA5NQ_size_1_color_FFFFFF_t_70 9]: /images/20221119/86d9147007e44777908a876581d45431.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzczNDA5NQ_size_1_color_FFFFFF_t_70 10]: /images/20221119/1d5bcb83f704408080dda3c49bd4eb13.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzczNDA5NQ_size_1_color_FFFFFF_t_70 11]: /images/20221119/12832d15d0264d9da7b2db565f2d14a9.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzczNDA5NQ_size_1_color_FFFFFF_t_70 12]: /images/20221119/6ae7f61a6f10437484e748048f859a7d.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzczNDA5NQ_size_1_color_FFFFFF_t_70 13]: /images/20221119/f950c05d815f4e07b59ae012577077d6.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzczNDA5NQ_size_1_color_FFFFFF_t_70 14]: /images/20221119/57eaf6f3acb64c5994858e3bc0a0e9ff.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzczNDA5NQ_size_1_color_FFFFFF_t_70 15]: https://img-blog.csdnimg.cn/20210120102207554.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzczNDA5NQ==,size_1,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzczNDA5NQ_size_1_color_FFFFFF_t_70 16]: /images/20221119/2b6da27a10c641b28e10cae8ca68be19.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzczNDA5NQ_size_1_color_FFFFFF_t_70 17]: /images/20221119/43ff653b0c4f4fe499d3ed64af360631.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzczNDA5NQ_size_1_color_FFFFFF_t_70 18]: /images/20221119/63423bcb2a6b4a6d8ee2e491818c06d6.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzczNDA5NQ_size_1_color_FFFFFF_t_70 19]: /images/20221119/b0d990c63c0f4c809ce17128c44b9fa5.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzczNDA5NQ_size_1_color_FFFFFF_t_70 20]: /images/20221119/a22547e2c77246fb8932a74018e780d5.png
[20210120111148599.png]: /images/20221119/e661a46cbd0547b88f9aef118fd52880.png
[20210120113326762.png]: /images/20221119/c4aa3e2fe4e04803a232953f434f2052.png
[20210120113305887.png]: /images/20221119/af8c491be20a4b48a865c963ff7f9713.png
[20210120120246663.png]: /images/20221119/5bf80da9405e47e3b55bba38284902b6.png
[T100 1]: https://www.hefeiyu.com/?p=7095
[4GL_T100]: https://blog.csdn.net/ZhangYongWei1955/article/details/83543109