T100开发避坑指南：从模组命名到表格字段，新手必知的命名规范与实战技巧
T100开发避坑指南：从模组命名到表格字段，新手必知的命名规范与实战技巧
第一次接触T100开发时，我因为一个简单的命名错误导致整个模块无法编译。那天晚上十点，我盯着屏幕上"Invalid table name"的报错信息，才真正理解命名规范的重要性。在T100这个庞大的ERP系统中，命名不仅是标识符，更是系统架构的DNA，一个字符的差异可能意味着标准模块与客制模块的天壤之别。
1. 命名规范的核心逻辑与常见陷阱
T100的命名体系看似复杂，实则遵循着清晰的商业逻辑和技术架构。理解这套逻辑，比死记硬背规则更重要。
1.1 前缀与后缀的哲学
标准与客制的分界：
a前缀：标准模块（如aao、axm）c前缀：客制模块（如cxm、cgl）_t后缀：标准表格_uc后缀：完全客制表格_ua后缀：标准表格扩展字段
提示：在测试区开发时，误用标准前缀可能导致正式区数据污染
典型错误案例：
# 错误示范 - 在客制模块中使用标准前缀 CREATE TABLE xmaa_t (xmaa001 VARCHAR(20)); # 应使用xmaauc_t # 正确示范 - 客制表格规范 CREATE TABLE xmaauc_t (xmaauc001 VARCHAR(20));1.2 字段命名的三段式结构
T100字段命名采用"表格基名+类型标识+流水号"结构：
| 字段类型 | 示例 | 适用场景 |
|---|---|---|
| 标准字段 | xmaa001 | 核心业务数据 |
| 弹性字段 | xmaaud001 | 产品预留扩展位 |
| 客制字段 | xmaaua001 | 标准表扩展字段 |
| 全客制 | xmaauc001 | 完全新建的客制表字段 |
常见错误：
- 混淆
ua和uc的使用场景 - 在标准表中直接添加非
ud字段 - 流水号位数不足（必须3位）
2. 模块化开发中的命名实践
2.1 程序编号的语义化设计
程序编号aimi100的解剖：
aim：模块代号（如销售模块）i：程序类型（I类作业）100：流水号
程序类型标识符对照表：
| 字母 | 程序类型 | 示例 |
|---|---|---|
| i | 基本作业 | aimi100 |
| m | 维护作业 | aomm200 |
| r | 报表作业 | axmr402 |
| q | 查询作业 | aoqq150 |
2.2 子程序与子画面的命名延伸
主程序aimi100的衍生命名：
aimi100_01 → 通用子程序 aimi100_g01 → 凭证报表子程序 aimi100_x01 → 查询报表子程序 aimi100_s01 → 子画面程序注意：子程序注册必须通过
azzi901作业，否则无法被主程序调用
3. 表格设计器(adzi140)的实战技巧
通过r.t命令调用的表格设计器是T100开发中最常用的工具之一，但90%的新手会在这几个地方栽跟头。
3.1 安全新增字段的操作流
进入目标模块目录
cd $TOP/erp/cxm/4gl # 假设是cxm客制模块启动设计器并锁定表格
r.t xmaauc_t # 对客制表格进行操作添加字段时的规范检查清单：
- [ ] 确认表格类型（标准/客制）
- [ ] 验证字段后缀是否符合规范
- [ ] 检查流水号连续性
- [ ] 设置正确的数据类型和长度
3.2 多环境下的表格同步问题
测试区→正式区的迁移陷阱：
- 字段命名不一致导致同步失败
- 未登记的弹性字段(
ud)被意外覆盖 - 客制前缀(
c)在正式环境被误认为测试数据
解决方案：
-- 在测试区执行结构比对 EXEC adzp210.compare_table_structure('xmaauc_t','TEST','PRD');4. 命名规范的自动化检查方案
4.1 使用预提交钩子验证命名
在.git/hooks/pre-commit中添加检查脚本：
#!/bin/bash # 检查4GL文件中的表名规范 if grep -q -E "CREATE TABLE [^a-z_]*_" *.4gl; then echo "错误：检测到非标准表名" grep -E "CREATE TABLE [^a-z_]*_" *.4gl exit 1 fi4.2 常用验证命令速查
| 命令 | 用途 | 示例 |
|---|---|---|
r.dg <程序名> | 编译程序并检查命名合规性 | r.dg cxmi100 |
azzq171 | 函数命名规范查询 | 输入aimi100_insert |
adzp270 | 程序复制时的命名自动转换 | 源程序aimi100→cimi100 |
5. 复杂场景下的命名例外处理
5.1 多语言资源的特殊约定
在lng目录下的多语言文件必须遵循：
aimi100.zh_CN.lng → 简体中文 aimi100.en_US.lng → 英文错误示例：
aimi100_chinese.lng # 不符合规范5.2 Web Service的命名空间
WSS模块的特殊规则：
- 端点URL必须包含模块前缀
/wss/cxm/orderQuery # 正确 /wss/orderService # 错误 - 传输对象需带
WS_前缀DEFINE WS_OrderDetail RECORD LIKE xmaauc_t.*
6. 从报错信息反推命名问题
当遇到这些错误时，首先检查命名：
Table xmaaa_t not found- 可能混淆了
xmaa_t和xmaaa_t
- 可能混淆了
Invalid field name xmaa001 in table xmaauc_t- 在客制表中错误引用了标准字段
Module axm not accessible- 在客制环境中误用标准模块前缀
在T100开发中，好的命名习惯能减少80%的低级错误。记得第一次独立完成客制模块时，我养成了在每个程序头添加命名规范检查注释的习惯：
-- 模块: cxm -- 类型: 查询作业(q) -- 表格: xmaauc_t (全客制) -- 字段规范: xmaauc001-999 (标准), xmaaucua001-999 (扩展)这种自律后来帮我避免了许多深夜调试的煎熬。当你真正理解T100命名体系背后的设计哲学时，那些看似繁琐的规则反而会成为开发效率的助推器。