SKILL.md
openerp-discovery — 发现任意业务对象的查询方式
先读 [
../openerp-shared/SKILL.md](../openerp-shared/SKILL.md)（鉴权、退出码、输出契约）。
金蝶业务对象上千个。发现层让你在运行期查到任意对象，无需等领域命令封装。高频对象已有领域命令（见 [../openerp-domains/SKILL.md](../openerp-domains/SKILL.md)），其余一律走这套三步发现。
三步发现工作流
# 1) 找对象 FormId（搜 BOS_ObjectType）
openerp objects --keyword 销售订单
# → 行含 [FID, FName, FSubSystemId]，FID 即 FormId（如 SAL_SaleOrder）
# 2) 查该对象的可用字段
openerp schema SAL_SaleOrder --fields-only
# → 各 entry 的字段 key/中文名/类型/关联对象(lookUpForm)
# 3) 用发现到的字段查数据
openerp query --form-id SAL_SaleOrder \
--fields "FBillNo,FDate,FCustId.FName,FMaterialId.FNumber,FQty" \
--filter "FBillNo='XSDD000006'" --top 20发现前先回忆、发现后即沉淀：三步发现前先
ls ~/.config/openerp/object-notes/看该 FormId 有无既往经验；查通后把已验证的字段/过滤/陷阱写回object-notes/{FormId}.{profile}.md。约定见 [../openerp-shared/SKILL.md](../openerp-shared/SKILL.md) §6「对象经验」。
关键规则（实测坐实，务必遵守）
- 字段 key 不要带 entry/分录前缀。 ExecuteBillQuery 把表头与分录字段拉平在同一命名空间：用分录字段就直接写它的 key（如
FMaterialId、FQty），不要写FEntity.FMaterialId/FSaleOrderEntry.FQty（会报“标识为 FEntity 的字段不存在”）。 - 关联字段用点号下钻：
FSupplierId.FName、FMaterialId.FNumber、FCustId.FNumber。schema输出里字段的lookUpForm非空即表示它是关联字段，可点号取关联对象的字段。 - 字段名大小写敏感，以
schema实测为准（同一概念在不同单据可能是FMaterialId/FMATERIALID/FMaterialID）。 - 查询要带过滤或 --top，避免全表扫描；超过 2000 行用
--page-all。 - 某字段整列为
null：多为无数据权限或字段名拼错 → 回到schema核对。
命名陷阱与不支持项
- 即时库存现量用
STKInventory（现存量余额对象），不是STKInventoryQuery（后者是查询界面，无字段模型）。已封装为openerp inventory balance list。 - 报表/账表（模型类型 900、GUID 命名，如“销售订单执行明细表/销售明细表”）：仍不支持，需
GetSysReportData；或改用对应单据（如SAL_OUTSTOCK出库明细）复现。 - 个别对象
QueryBusinessInfo返回空模型（如车间成本计算CB_SFCCostCalBill）→ 无可查字段，不能走通用查询。
objects 命令
openerp objects --keyword <名称关键词> # 必须给收敛条件
openerp objects --subsystem <子系统> # 按子系统过滤
openerp objects --keyword 委外 --top 30schema 命令
openerp schema <FormId> # 完整元数据
openerp schema <FormId> --fields-only # 精简字段清单（推荐）