Files
GX.O3.WMS/WebApi/docs/03-采购物料交付状态看板.md
T

4.0 KiB
Executable File
Raw Blame History

[采购物料交付状态看板]

按研发项目汇总物料交付状态(未转单/无交付目标/无交付计划/进行中/延期中/需求取消),并下钻到负责人、时间范围、明细的看板模块。

基本信息

项目 内容
类型 接口 + 前端页面(系统二开)
版本 v1.2.0
负责人 Damon
SVN路径 svn://地址/路径
.NET版本 .NET Framework 4.7.2
对应文件 Controllers/ProcurementController.cs、delivery_dashboard.html、delivery_dashboard_L21/L22/L31/L32.html、delivery_dashboard_noorder2/3/4.html

功能说明

针对今年的采购申请单(YFCGSQ 前缀),按研发项目(uf_gxyfxm)汇总各项交付状态数量,支持多条下钻链路:未转单 → 时间范围 → 负责人 → 明细;无交付目标/无交付计划 → 负责人 → 明细;进行中/延期中 → 供应商 + 时间范围 → 明细。交付时间基于计划交付日期(研发采购,yfjhjfrq)与当前日期差值计算。

配置项

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

配置项 说明 示例
OAConnection OA MySQL(ecology 库) server=39.100.72.102;database=ecology;user=ecology

用法

检出

svn checkout svn://地址/路径

编译

msbuild GXWebApi.csproj /p:Configuration=Release

部署

部署到 IIS,访问 delivery_dashboard.html

输入输出

  • 输入:研发项目、状态类型、时间范围、负责人/供应商等参数
  • 输出:交付状态汇总、各级明细数据

关键接口

接口 方法 说明
/api/Procurement/GetDeliveryDashboard GET 一级:按研发项目汇总 7 列状态
/api/Procurement/GetDeliveryNoOrder2 GET 未转单二级:按研发项目+时间范围汇总
/api/Procurement/GetDeliveryNoOrder3 GET 未转单三级:按研发采购负责人汇总
/api/Procurement/GetDeliveryNoOrder4 GET 未转单四级:明细数据
/api/Procurement/GetDeliveryLevel21/L31 GET 1号 二级/三级(无交付目标/计划 → 负责人)
/api/Procurement/GetDeliveryLevel22/L32 GET 2号 二级/三级(进行中/延期 → 供应商)

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

未转单四级下钻链路(全新)

  • 一级"未转单"列改为超链接,点击进入 delivery_dashboard_noorder2.html
  • 未转单二级:按研发项目统计 1天以内 / 1-3天 / 3天以上
  • 未转单三级:点击某时间段数量,按研发采购负责人汇总
  • 未转单四级:点击负责人数量,展示采购申请明细数据

无效日期处理(关键修复)

  • 数据库中 yfjhjfrq 存在 0000-00-00 等无效值,DATEDIFF 返回 NULL 导致记录漏算
  • 修复:空值/无效日期归入"3天以上",并加 DATEDIFF IS NULL 判断,确保每条未转单记录恰好落入一个区间,二级 r1+r2+r3 之和 = 一级未转单数

时间计算

  • 交付时间 = DATEDIFF(yfjhjfrq, CURDATE())(计划交付日期 - 当前日期)
  • 未转单分段:1天以内 / 1-3天 / 3天以上
  • 交付分段:0-3天 / 3-7天 / 7-14天 / 14天以上

需求取消口径调整

  • 由 ywzt IN ('7','8')(撤回+取消)改为 ywzt IN ('8','9')(研发-采购申请取消 + 研发-量产复用件)

全量分页

  • 一级/二/三/四级列表均支持每页条数选择(20/50/100/200)+ 页码导航

一级统计条件

  • 增加 lcbh LIKE 'YFCGSQ%' 过滤,只统计采购申请类数据

统计口径

  • 未转单:LEFT JOIN formtable_main_39_dt1(采购订单明细)无匹配(S2.id IS NULL)
  • 只统计 YEAR(sqrq)=YEAR(CURDATE()) 且 lcbh LIKE 'YFCGSQ%'

变更记录

版本 日期 改了什么
v1.0.0 2026-08-04 初始版本:交付状态看板 + 多条下钻链路
v1.2.0 2026-08-05 新增未转单四级下钻、无效日期处理、需求取消口径调整、全量分页