Files
GX.O3.WMS/WebApi/docs/04-研发采购看板.md

4.2 KiB
Executable File
Raw Permalink Blame History

[研发采购看板]

研发采购申请单列表看板,按多条件筛选(流程编号/申请人/专项名称/研发项目等),并可进入只读明细追溯界面。

基本信息

项目 内容
类型 接口 + 前端页面(系统二开)
版本 v1.1.0
负责人 Damon
SVN路径 svn://地址/路径
.NET版本 .NET Framework 4.7.2
对应文件 Controllers/ProcurementController.cs、dashboard.html、dashboard_detail.html

功能说明

面向研发角色(YF01)的采购申请单列表看板,展示流程编号、申请日期、物料、申请人、专项名称、业务状态、策略/研发采购负责人、计划交付日期(策略/研发)等字段,支持多条件组合筛选与列宽拖动。点击行进入只读明细页,查看物料维护、采购订单/收料通知追溯与收货汇总。本轮新增业务状态多选、拆分搜索条件、4 列 Grid 排版、列宽拖动不压列。

配置项

敏感信息(密码/Token)不进 SVN,用 Web.config / 环境变量管理。

配置项 说明 示例
OAConnection OA MySQL(ecology 库) server=39.100.72.102;database=ecology;user=ecology
金蝶 K3Cloud 单据查询 API http://金蝶地址/api/K3Cloud/ExecuteBillQuery

用法

检出

svn checkout svn://地址/路径

编译

msbuild GXWebApi.csproj /p:Configuration=Release

部署

部署到 IIS,访问 dashboard.html(需 YF01 角色)

输入输出

  • 输入:筛选条件(流程编号/申请人/专项名称/研发项目/物料/负责人/业务状态)
  • 输出:看板列表、只读明细(物料维护 + 采购订单/收料追溯 + 收货汇总)

关键接口

接口 方法 说明
/api/Procurement/GetDashboardList GET 研发采购看板列表(多条件筛选+分页)
/api/Procurement/GetTraceSummary GET 追溯汇总(含采购订单/收料/延期)
/api/Procurement/GetPurchaseOrders GET 金蝶采购订单追溯
/api/Procurement/GetReceiveNotices GET 金蝶收料通知追溯

本轮新增/更新(v1.1.0)

搜索条件拆分

  • 原单一"关键字"搜索拆分为 4 个独立字段:流程编号 / 申请人 / 专项名称 / 研发项目
  • 加上原有 物料编码 / 物料名称 / 策略采购负责人 / 研发采购负责人,共 8 个筛选框

4 列 Grid 排版

  • 搜索栏改为 CSS Grid grid-template-columns: repeat(4, 1fr),每行 4 个,标题纵向对齐
  • 每组 label+input 用 <span class="field"> 包裹(inline-flex),折行不分离
  • "共 N 条"显示在搜索栏第三行最右侧,与查询/重置按钮同行

业务状态多选(自定义下拉)

  • 原单选 <select> 改为自定义多选下拉框(复选框列表)
  • 选项:全部 + 9 个业务状态,勾选"全部"清空其他,全部取消自动回勾"全部"
  • 选中多个状态框内显示前 2 个 + "等",筛选结果持久化到 sessionStorage
  • 后端 GetDashboardList 的 ywzt 参数支持逗号分隔多值 → IN ('1','2')

列宽拖动 + 水平滚动

  • 列宽拖动不压其他列:mousedown 记录 st._origW,mousemove 同步撑宽表格
  • table{min-width:100%} 使列宽超容器时出现水平滚动条

列表字段调整

  • 去掉"项目经理审批时间"列
  • 新增"计划交付日期(策略采购)"和"计划交付日期(研发采购)"两列
  • 数据源新增 cnjhjfrq / yfjhjfrq 字段

明细追溯兜底

  • 采购订单页签兼容「无收料通知单时 traceDetails 为空」的场景,从 poList / trace.purchaseOrders 兜底

注意事项

  • 只读界面不提供保存/报价修改
  • 业务状态多选下拉 .list-card 需 overflow: visible,避免下拉被裁切
  • 多选复选框使用原生 accent-color 渲染,"全部"与具体状态用独立 onchange 处理避免互相覆盖

变更记录

版本 日期 改了什么
v1.0.0 2026-08-04 初始版本:看板列表 + 只读明细追溯
v1.1.0 2026-08-05 搜索条件拆分、4列Grid排版、业务状态多选、列宽拖动不压列、字段调整