qiangayi/oracle-jump-query-public
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

补充BOS业务单据表单默认配置

Browse Source
This commit is contained in:
chen qiang
2026-09-30 14:21:52 +08:00
parent 209d27de59
commit 7c660980d8
7 changed files with 38 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files
references/query-and-business-rules.md
+22
View File
@@ -110,6 +110,28 @@ CREATE TABLE TableName (
- 不要把新增业务记录时的 `AD_CLIENT_ID=37`、`AD_ORG_ID=27` 或主键取号规则自动写成建表 `DEFAULT`；本最小模板只为 `ISACTIVE` 指定默认值，日期字段也不自动增加 `DEFAULT SYSDATE`。
- 这是新建表结构规则，不表示可以自动修改既有表。Skill 仅生成 DDL 并明确“未执行”，由用户或 DBA 确认后人工执行；不通过 `query` / `qperm` 建表，也不隐式写入 BOS 元数据。
## BOS 新建业务单据表单默认配置
新增 BOS 表单时，先判断是否为业务单据。通常包含 `DOCNO` 的表单可按业务单据理解，并结合实际用途核实；新建业务单据表单通常应包含 `DOCNO`、`STATUS`、`ISACTIVE`、提交时间和提交人。这些业务字段在上面的八个基础字段及 `ID` 主键之上补充，其中 `ISACTIVE` 已属于基础字段，不重复创建。本节是业务单据的默认约定，不要求所有基础资料表都增加单号或提交字段。
字段及 BOS 元数据配置：
| 字段 | 业务含义 | 读写方式 | 下拉框选项名称 | 字段翻译器 | 读写打印规则 | 默认值 |
| --- | --- | --- | --- | --- | --- | --- |
| `DOCNO` | 单据编号 | 单据编号 | 不适用 | 按目标环境单据编号配置核实 | `0010111111` | 按维护的单据编号生成器取号 |
| `STATUS` | 单据状态 | 下拉框选项 | `STATUS` | `nds.web.alert.LimitValueAlerter` | `0010111111` | `1` |
| `ISACTIVE` | 可用 | 下拉框选项 | `YESNO` | `nds.web.alert.LimitValueAlerter` | `0010111111` | `Y` |
| 提交时间 | 提交时间，常用字段名 `STATUSTIME` | 按目标表单配置核实 | 不适用 | 按实际配置核实 | 按实际配置核实 | 新增草稿时不赋值，由提交动作维护 |
| 提交人 | 提交人，常用字段名 `STATUSERID` | 按目标表单配置核实 | 不适用 | 按实际配置核实 | 按实际配置核实 | 新增草稿时不赋值，由提交动作维护 |
- `DOCNO` 必须维护单据编号生成器：`AD_COLUMN` 中该字段的 `SEQUENCENAME` 保存取号 CODE，CODE 的定义在 `AD_SEQUENCE`，取号表达式为 `Get_SequenceNo('<CODE>', AD_CLIENT_ID)`。生成器 CODE 按业务维护，不猜测具体名称，也不通过查询通道调用取号函数。
- `STATUS` 和 `ISACTIVE` 的字段翻译器配置位于 `AD_COLUMN`，值为 `nds.web.alert.LimitValueAlerter`。`ISACTIVE` 除选项名称为 `YESNO`、默认值为 `Y` 外，其余上述配置与 `STATUS` 相同；保留最小建表模板中的 `ISACTIVE CHAR(1) DEFAULT 'Y' NOT NULL`。
- 下拉框选项名称 `STATUS`、`YESNO` 是对应选项组名称，不是数据库实际值。生成具体元数据方案时，先定位目标环境的选项组，再用 `AD_COLUMN.AD_LIMITVALUE_GROUP_ID` 核实 `AD_LIMITVALUE` 的显示值与实际值，不猜测选项组 ID。读写方式为下拉框选项时，按目标环境核实 `OBTAINMANNER='select'` 等实际存储值。
- 所在表的读写规则默认是 `AD_TABLE.MASK='MDQSV'`，按该字符串维护：`M` 修改、`D` 删除、`Q` 查询、`S` 提交、`V` 作废。此默认值用于新建业务单据方案；分析既有表时仍以实际 `MASK` 为准。
- 表级读写规则 `MDQSV` 与字段级读写打印规则 `0010111111` 是不同配置。字段规则保留完整十位字符串及前导零，不转成整数，也不凭经验解释各位含义。
- 需要提交的业务单据必须包含提交时间和提交人，并核实 `AD_TABLE.PROC_SUBMIT` 对应提交逻辑。上述常用字段名、字段类型、关联方式和可空性需按目标环境或用户确认的方案确定；新增草稿只设 `STATUS='1'`，提交时由提交动作维护提交人和时间。
- 生成 BOS 元数据 SQL 时，先确认目标环境 `AD_COLUMN` 中“字段翻译器”“读写方式”“读写打印规则”“默认值”等配置项对应的实际列名，不凭中文标签猜测物理列名。建表 DDL 与表单元数据配置分别说明；这里仅记录默认规则并生成待人工确认的方案，不通过 Skill 查询通道创建表、维护生成器或写入 BOS 元数据。
## 新增业务记录 SQL 生成规则
当用户要求分析或生成新增业务表记录的 SQL 示例时，仍然保持只读安全边界：skill 可以生成 SQL 和说明，但不能直接通过查询通道执行 INSERT、UPDATE、DELETE、MERGE、DDL 等写操作。