feat: add empty filters to ERP inventory search
This commit is contained in:
parent
eda824cea7
commit
66a1f60428
@ -51,6 +51,10 @@ namespace HHWMS.Web
|
||||
.CheckContain(Searcher.NextBatch, x=>x.Lot)
|
||||
.CheckContain(Searcher.SuFigureNo, x=>x.SupplierCode)
|
||||
.WhereIf(Searcher.UploadFlag != null,x => x.UploadErpFlag == Searcher.UploadFlag)
|
||||
.WhereIf(Searcher.CompanyIsEmpty == true, x => x.CompanyCode == null || x.CompanyCode == "")
|
||||
.WhereIf(Searcher.CompanyIsEmpty == false, x => x.CompanyCode != null && x.CompanyCode != "")
|
||||
.WhereIf(Searcher.OrderIsEmpty == true, x => x.SourceCode == null || x.SourceCode == "")
|
||||
.WhereIf(Searcher.OrderIsEmpty == false, x => x.SourceCode != null && x.SourceCode != "")
|
||||
.Select(x => new InventoryApi_View
|
||||
{
|
||||
ID = x.ID,
|
||||
|
||||
@ -29,6 +29,17 @@ namespace HHWMS.Web
|
||||
public int? UploadFlag { get; set; }
|
||||
|
||||
public string NextBatch { get; set; }
|
||||
|
||||
/// <summary>
|
||||
/// 公司是否为空:不传不筛选,true为空,false非空
|
||||
/// </summary>
|
||||
public bool? CompanyIsEmpty { get; set; }
|
||||
|
||||
/// <summary>
|
||||
/// 订单号(SourceCode)是否为空:不传不筛选,true为空,false非空
|
||||
/// </summary>
|
||||
public bool? OrderIsEmpty { get; set; }
|
||||
|
||||
protected override void InitVM()
|
||||
{
|
||||
}
|
||||
|
||||
67
docs/ERP事项三-ERP查看库存接口优化-方案记录.md
Normal file
67
docs/ERP事项三-ERP查看库存接口优化-方案记录.md
Normal file
@ -0,0 +1,67 @@
|
||||
# ERP事项三:ERP查看库存接口优化——实施方案
|
||||
|
||||
## 1. 范围与确认结果
|
||||
|
||||
- 接口:`POST /api/Inventory/Search`
|
||||
- 订单号字段:已确认使用 `Inventory.SourceCode`。
|
||||
- 新参数:已确认使用 `CompanyIsEmpty`、`OrderIsEmpty`。
|
||||
- 兼容要求:两个参数都不传或传 `null` 时,不增加任何筛选条件,旧ERP调用结果不受影响。
|
||||
|
||||
## 2. 最小修改方案
|
||||
|
||||
只修改请求模型和原查询链:
|
||||
|
||||
1. `InventoryApiSearcher` 增加两个 `bool?` 参数。
|
||||
2. `InventoryApiListVM` 在参数有明确值时追加空/非空条件。
|
||||
3. 不修改Controller、接口地址、请求方式、分页、响应模型和数据库结构。
|
||||
4. 不修改 `default` / `cp` 数据连接选择逻辑。
|
||||
|
||||
| 参数 | 值 | 行为 |
|
||||
| --- | --- | --- |
|
||||
| `CompanyIsEmpty` | 不传/`null` | 不筛选公司 |
|
||||
| | `true` | `CompanyCode` 为 `NULL` 或空字符串 |
|
||||
| | `false` | `CompanyCode` 非 `NULL` 且非空字符串 |
|
||||
| `OrderIsEmpty` | 不传/`null` | 不筛选订单号 |
|
||||
| | `true` | `SourceCode` 为 `NULL` 或空字符串 |
|
||||
| | `false` | `SourceCode` 非 `NULL` 且非空字符串 |
|
||||
|
||||
仅包含空格的值按非空处理,本次没有增加 `Trim` 或数据清洗,避免扩大影响。
|
||||
|
||||
## 3. 请求示例
|
||||
|
||||
旧请求保持不变:
|
||||
|
||||
```json
|
||||
{"WareHouse":"xb","Page":1,"Limit":20}
|
||||
```
|
||||
|
||||
查询公司为空且订单号非空:
|
||||
|
||||
```json
|
||||
{
|
||||
"WareHouse": "xb",
|
||||
"CompanyIsEmpty": true,
|
||||
"OrderIsEmpty": false,
|
||||
"Page": 1,
|
||||
"Limit": 20
|
||||
}
|
||||
```
|
||||
|
||||
## 4. 双数据库说明
|
||||
|
||||
该接口仍使用当前实例的 `default` 数据连接;`WareHouse` 只参与库区筛选,不负责把连接切换到 `cp`。因此:
|
||||
|
||||
- 线边库实例的 `default` 指向线边库数据库;
|
||||
- 成品库实例的 `default` 指向成品库数据库;
|
||||
- 本事项不做跨库查询或动态连接改造。
|
||||
|
||||
## 5. 代码、SQL与回退
|
||||
|
||||
代码只涉及:
|
||||
|
||||
- `InventoryApiSearcher.cs`
|
||||
- `InventoryApiListVM.cs`
|
||||
|
||||
本事项没有DDL和数据更新。上线前可分别在两库执行只读脚本 [20260717_inventory_empty_filters_verify.sql](../sql/20260717_inventory_empty_filters_verify.sql),用于预览空/非空数据分布。
|
||||
|
||||
回退只需恢复上述两个代码文件,不需要数据库回退。
|
||||
45
docs/ERP事项三-ERP查看库存接口优化-测试报告.md
Normal file
45
docs/ERP事项三-ERP查看库存接口优化-测试报告.md
Normal file
@ -0,0 +1,45 @@
|
||||
# ERP事项三:ERP查看库存接口优化——测试报告
|
||||
|
||||
## 1. 测试信息
|
||||
|
||||
- 日期:2026-07-17
|
||||
- 接口:`POST /api/Inventory/Search`
|
||||
- 方式:分别以线边库和成品库作为当前实例的 `default` 连接进行只读HTTP测试
|
||||
- 测试数据:现有本地库存;未新增、修改或删除业务数据
|
||||
|
||||
## 2. 线边库结果
|
||||
|
||||
| 场景 | Count | 结果 |
|
||||
| --- | ---: | --- |
|
||||
| 旧请求,不传新参数 | 853 | 通过 |
|
||||
| 两参数显式为 `null` | 853 | 通过,与旧请求一致 |
|
||||
| `CompanyIsEmpty=true` | 853 | 通过,逐行公司为空 |
|
||||
| `CompanyIsEmpty=false` | 0 | 通过 |
|
||||
| `OrderIsEmpty=true` | 845 | 通过,逐行 `SourceCode` 为空 |
|
||||
| `OrderIsEmpty=false` | 8 | 通过,逐行 `SourceCode` 非空 |
|
||||
| 两个空值条件同时为 `true` | 845 | 通过 |
|
||||
| `OrderIsEmpty=true` 第2页、每页20条 | 总数845,返回20 | 通过,分页正确 |
|
||||
|
||||
## 3. 成品库结果
|
||||
|
||||
| 场景 | Count | 结果 |
|
||||
| --- | ---: | --- |
|
||||
| 旧请求,不传新参数 | 1635 | 通过 |
|
||||
| 两参数显式为 `null` | 1635 | 通过,与旧请求一致 |
|
||||
| `CompanyIsEmpty=true` | 1543 | 通过,逐行公司为空 |
|
||||
| `CompanyIsEmpty=false` | 92 | 通过,逐行公司非空 |
|
||||
| `OrderIsEmpty=true` | 1523 | 通过,逐行 `SourceCode` 为空 |
|
||||
| `OrderIsEmpty=false` | 112 | 通过,逐行 `SourceCode` 非空 |
|
||||
|
||||
所有请求均为HTTP 200、业务 `Code=200`,原响应字段 `Code`、`Count`、`Data`、`Msg`、`Page`、`PageCount` 均未改变。
|
||||
|
||||
## 4. 其他验证
|
||||
|
||||
- 最终项目构建:通过,0错误;15个现有编译警告(含.NET 6停止支持提示)。
|
||||
- 两个参数不传与显式 `null` 的数量完全一致,旧调用兼容成立。
|
||||
- 两参数可独立使用、同时使用,并可与原分页条件组合。
|
||||
- [20260717_inventory_empty_filters_verify.sql](../sql/20260717_inventory_empty_filters_verify.sql) 仅包含 `SELECT`,无DDL/DML。
|
||||
|
||||
## 5. 测试结论
|
||||
|
||||
线边库和成品库实例均通过空/非空、兼容和分页验证。本事项没有数据库变更及操作流程变化,可随代码直接发布;ERP只需按需增加可选参数,不改也不受影响。
|
||||
11
sql/20260717_inventory_empty_filters_verify.sql
Normal file
11
sql/20260717_inventory_empty_filters_verify.sql
Normal file
@ -0,0 +1,11 @@
|
||||
-- ERP事项三:ERP查看库存接口空值筛选
|
||||
-- 本事项没有数据库结构和数据变更,本脚本仅用于上线前只读核对基准数量。
|
||||
-- 可在 default、cp 数据库分别执行;不会修改任何数据。
|
||||
|
||||
SELECT
|
||||
COUNT(*) AS TotalCount,
|
||||
SUM(CASE WHEN `CompanyCode` IS NULL OR `CompanyCode` = '' THEN 1 ELSE 0 END) AS CompanyEmptyCount,
|
||||
SUM(CASE WHEN `CompanyCode` IS NOT NULL AND `CompanyCode` <> '' THEN 1 ELSE 0 END) AS CompanyNotEmptyCount,
|
||||
SUM(CASE WHEN `SourceCode` IS NULL OR `SourceCode` = '' THEN 1 ELSE 0 END) AS OrderEmptyCount,
|
||||
SUM(CASE WHEN `SourceCode` IS NOT NULL AND `SourceCode` <> '' THEN 1 ELSE 0 END) AS OrderNotEmptyCount
|
||||
FROM `Inventory`;
|
||||
Loading…
x
Reference in New Issue
Block a user