94 lines
4.5 KiB
Markdown
Executable File
94 lines
4.5 KiB
Markdown
Executable File
# [采购申请管理]
|
||
|
||
> 采购申请单的查询、筛选、批量物料维护、Excel 导入导出及金蝶采购订单/收料追溯模块。
|
||
|
||
## 基本信息
|
||
|
||
| 项目 | 内容 |
|
||
|------|------|
|
||
| 类型 | 接口 + 前端页面(系统二开) |
|
||
| 版本 | v1.1.0 |
|
||
| 负责人 | Damon |
|
||
| SVN路径 | svn://地址/路径 |
|
||
| .NET版本 | .NET Framework 4.7.2 |
|
||
| 对应文件 | Controllers/ProcurementController.cs、procurement.html、procurement_detail.html、multi_detail.html |
|
||
|
||
## 功能说明
|
||
|
||
对 OA 采购申请单(formtable_main_23 / formtable_main_23_dt1)进行管理,支持多维筛选、批量物料维护、Excel 模板导入导出,以及金蝶采购订单(PUR_PurchaseOrder)/收料通知(PUR_ReceiveBill)追溯。本轮新增明细级筛选、供应商空值筛选、物料维护表格的供应商前端筛选与物料编码块复制等功能。
|
||
|
||
## 配置项
|
||
|
||
> 敏感信息(密码/Token)不进 SVN,用 Web.config / 环境变量管理。
|
||
|
||
| 配置项 | 说明 | 示例 |
|
||
|--------|------|------|
|
||
| OAConnection | OA MySQL(ecology 库,泛微 OA) | server=39.100.72.102;database=ecology;user=ecology |
|
||
| GXWMS | GXWMS SQL Server | server=10.10.10.101;database=GXWMS |
|
||
| 金蝶 K3Cloud | 单据查询 API(Kingdee.BOS.WebApi.Client) | http://金蝶地址/api/K3Cloud/ExecuteBillQuery |
|
||
|
||
## 用法
|
||
|
||
# 检出
|
||
svn checkout svn://地址/路径
|
||
|
||
# 编译
|
||
msbuild GXWebApi.csproj /p:Configuration=Release
|
||
|
||
# 部署
|
||
部署到 IIS,访问 procurement.html
|
||
|
||
## 输入输出
|
||
|
||
- 输入:前端筛选条件、选中申请单 ID、Excel 文件(.xls XML 格式)
|
||
- 输出:申请单列表、明细数据、采购订单/收料追溯结果、导入导出结果
|
||
|
||
## 关键接口
|
||
|
||
| 接口 | 方法 | 说明 |
|
||
|------|------|------|
|
||
| /api/Procurement/GetRequestList | GET | 申请单列表(分页+多条件筛选) |
|
||
| /api/Procurement/GetRequestDetail | GET | 单申请单明细 |
|
||
| /api/Procurement/GetMultiRequestDetail | GET | 多选申请单明细(批量维护) |
|
||
| /api/Procurement/GetPurchaseOrders | GET | 金蝶采购订单追溯 |
|
||
| /api/Procurement/GetReceiveNotices | GET | 金蝶收料通知追溯 |
|
||
| /api/Procurement/GetTraceSummary | GET | 追溯汇总(含收料状态/延期天数) |
|
||
| /api/Procurement/ExportXlsx | POST | 导出 Excel(body 传 ids 数组) |
|
||
| /api/Procurement/ImportXlsx | POST | 导入 Excel |
|
||
|
||
## 本轮新增/更新(v1.1.0)
|
||
|
||
### 列表筛选增强
|
||
- 新增明细级筛选:**物料编码、策略采购负责人、研发采购负责人、供应商**
|
||
- 使用 `EXISTS (SELECT ... FROM formtable_main_23_dt1 WHERE mainid=S.id ...)`,只筛主表,不展开明细行
|
||
- 策略采购负责人/研发采购负责人/供应商 支持输入 `空` 筛选 IS NULL 或空字符串的数据
|
||
- 筛选条件改为 4 列 Grid 排版,标题纵向对齐
|
||
- 供应商筛选放在研发采购负责人后;业务状态(原单据状态)下拉移到供应商后
|
||
|
||
### 物料维护表格(procurement_detail.html)
|
||
- 新增**供应商前端筛选**(不调后端):下拉选择 全部/为空/不为空/指定值
|
||
- "指定值"输入供应商名称后,点击**查询**按钮生效(模糊匹配)
|
||
- 只过滤当前已加载的明细数据,不影响保存
|
||
- 新增**块复制物料编码**按钮:
|
||
- 按当前筛选条件从全量明细提取物料编码(不受分页影响)
|
||
- 不去重,每行一个编码、换行分隔,可直接块粘贴到金蝶云星空物料编码列
|
||
- 优先 `navigator.clipboard.writeText`,降级 `execCommand`
|
||
|
||
### 追溯兜底
|
||
- 采购订单页签兼容「无收料通知单时 traceDetails 为空」的场景:
|
||
- 从 `poList`(GetPurchaseOrders 直查)和 `trace.purchaseOrders`(GetTraceSummary 返回的 PO 号)兜底合并展示
|
||
|
||
## 注意事项
|
||
|
||
- 导出接口为 POST,参数放 Body(ids 数组),避免 URL 超长触发 maxQueryStringLength 限制
|
||
- 导入字段含多个 INT 类型(onebj/onezje/twobj/twozje/ywzt/jffxdj/jfjz),空值需置 0
|
||
- 日期字段(cnjhjfrq/yfjhjfrq)支持 yyyy-MM-dd 文本或 Excel 序列号(如 46260)
|
||
- 空值筛选标记为"空",物料编码不支持空值筛选
|
||
|
||
## 变更记录
|
||
|
||
| 版本 | 日期 | 改了什么 |
|
||
|------|------|----------|
|
||
| v1.0.0 | 2026-08-04 | 初始版本:列表筛选、批量维护、导入导出、金蝶追溯 |
|
||
| v1.1.0 | 2026-08-05 | 新增明细级筛选(物料/负责人/供应商)、供应商空值筛选、物料维护前端筛选与块复制、采购订单追溯兜底 |
|