采购申请单明细账/汇总账页面编写
业务需求和功能
1、功能：编写采购申请页面和采购申请管理页面。在申请单界面添加常用的查询条件，如单品、申请单等。在采购申请管理页面以单品维度去展示采购申请单的汇总信息，添加一个默认查询时间为7天，并对查询出来的不同状态申请单的做数量的自动汇总。
2、具体实现：编写两个订单的实体类，并通过@IOC注解将实体类交给系统容器管理，。在service层中编写业务逻辑，html做页面的静态页面，c#做动态界面与后端进行交互，。
3、特殊说明：为了页面美观，做了以下两点优化。使用内置标签函数如@Columns，绑定app页面中的表头，使得打开页面默认展示表头。并对后端查询到的特殊数据做客户端转换，方便客户观看。如申请单的状态，后端查到的是10，前端需要显示状态为编辑中。
具体代码实现
创建html作为采购申请明细账的静态界面
下面是具体代码：
**
![]()
**
需要注意上面中的两个按钮功能：
1、btn_search
搜索
这是一个按钮，点击可触发搜索操作 ，与c#中的点击事件方法调用交互。
点击搜索按钮触发该标记下方的void OnClickSearch()回调函数。
[Click("#btn search")]
void OnClickSearch()
2、flat_bar
可以后期查询中获取页面输入信息作为搜索条件。下面是c#中使用的代码：
当前实例对象中匹配选择器"flat bar"的元素转为后续查询的参数
var queryParams = this.ToQueryParam(",flat_bar");
C#创建采购申请单明细的交互窗口
该窗口中包括页面的初始化，时间的回调函数调用、还有加载数据库的缓存配置信息，在此处没有用到。下面定义了一个简单的交互窗口，通过点击事件调用后端的statistic,Purchasestatistic,purchaseApplyDetail方法，将查询结果绑定到页面的表格元素 #goods sell list 中，并可能进行分页显示。需要注意的是#goods sell list相当于一个标签，需要提前在html文件中定义好表格元素。
[Window(Title="采购申请单明细账", View="statistic/sta_purchase/purchase_apply_detail.html", Style=Style.WS_VISIBLE|Style.WS_CHILD|Style.WS_CLIPCHILDREN, Width=960, Height=640)]
public class PurchaseApplyDetailWindow : BaseWindow需要注意，每次在加载新页面的时候，都需要先运行onload方法加载一些初始的配置。如这里通过 .Xcall 函数获取函数中定义的表头元素，并将其绑定在页面元素#goods_sell_list中。
java创建Java实体类，并交给系统容器中管理
@IoC
public class PurchaseApplyEntry
{@Inject
PurchaseApplyService purchaseApplyService;/**
* 查询采购申请单明细
*/
@Export
@Columns("(purchase_apply_no,申请单号)(status,状态)(creator_id,申请人)(warehouse_id,仓库)(main_remark,主单备注)(expected_time,期望到货时间)(modified,修改时间)(created,创建时间)(goods_name,货品名称)(goods_no,货品编号)(short_name,货品简称)(spec_name,规格名称)(spec_no,商家编码)(provider_id,供应商)(num,申请采购数量)(ref_num,已引用数量)(detail_remark,明细备注)")
@BindAttributes("rec_id,brand_id,class_id,apply_id")
@Transforms("(status,purchaseapply_status)(num,goods_count)(ref_num,goods_count)")
@ServerTransforms("warehouse_name(warehouse_id<),employee_name(creator_id<),provider_name(provider_id<),goods_brand(brand_id<),goods_class(class_id<)")
public Response queryApplyDetail(Session session, Map params, Pager pager) throws SQLException
{
return purchaseApplyService.queryApplyDetail(session, params, pager);
}
这是一个 Java 类。它使用了一些注解，如 @IoC 和 @Inject，这表明它可能与一个依赖注入框架（如Spring）相关联，用于管理对象之间的依赖关系和实例化。以下是这个类的一些关键部分和功能的解释：
1、@IoC注解: 这个注解通常用于表示该类是一个由依赖注入容器管理的组件，容器会负责实例化和维护该类的对象。
2、@Inject’注解: 这是一种依赖注入的注解，用于注入PurchaseApplyService’类的实例到purchaseApplyService'字段中。
3、queryApplyDetai方法: 这个方法用于查询采购申请单明细。它接受一个会话(Session) 对象、参数(params) 和一个分页器 (Pager) 作为输入，并返回一个Response’对象。具体的功能包括:
3.1、使用@Export注解定义了查询返回的列，以及这些列在查询结果中的显示名使用~@BindAttributes*注解定义了一些属性，如 rec_id’、brand_idclass_idapply_id'
3.2、使用@Transforms注解定义了一些列的转换，将查询结果中的列进行重命名或转换成其他列。
3.3、使用ServerTransforms注解定义了一些服务端转换，可能用于获取与仓库、创建者、供应商、品牌等相关的信息。
3.4、调用purchaseApplyService.queryApplyDetail’方法，将输入的参数传递给该方法然后返回方法的结果。
设计采购申请单明细表service层的页面逻辑
public Response queryApplyDetail(Session session, Map params, Pager pager) throws SQLException
{
DbSession db = session.db(false);
Where where = new Where(params, session)
{
{
equal("warehouse_id", "pa.warehouse_id");
equal("purchase_apply_no", "pa.purchase_apply_no");
equal("spec_no", "gs.spec_no");
equal("goods_no", "gg.goods_no");
equal("creator_id", "pa.creator_id");
like("remark", "pad.remark");
equal("provider_id", "pad.provider_id");
in("status", "pa.status");
condition("pad.real_num > pad.ref_num");
}
}.orderBy("pad.apply_id");
Table table = new Table("purchase_apply_detail pad", "pad.rec_id", where)
{
{
innerJoin("purchase_apply pa", "pa.rec_id = pad.apply_id", "pa.,pad.");
innerJoin("goods_spec gs", "gs.spec_id = pad.spec_id", "gs.,gg.");
innerJoin("goods_goods gg", "gg.goods_id = gs.goods_id", "gg.");
}
}
.extraJoin("purchase_apply pa", "pa.rec_id = pad.apply_id")
.extraJoin("goods_spec gs", "gs.spec_id = pad.spec_id")
.extraJoin("goods_goods gg", "gg.goods_id = gs.goods_id");
String fields = "pad.rec_id, pa.rec_id AS apply_id, pa.purchase_apply_no, pa.status, pa.creator_id, pa.warehouse_id, pa.remark AS main_remark, pa.expected_time, pa.modified, pa.created, "
+ " gg.goods_name, gg.goods_no, gg.short_name, gg.class_id, gg.brand_id, gs.spec_name, gs.spec_no, pad.num, pad.ref_num, pad.remark AS detail_remark, pad.provider_id";
table.setOutputFields(fields);
return SqlUtils.pageQuery(db, pager, table, where);
}
此处需要注意，我们使用了inner join来根据页面填写的信息过滤所需要的采购申请单明细。使用了extra Join作为外连接，来补充展示除了采购申请表明细中的别的信息，如商品id。下图是整个表的关系图
下图为分别输入单品id和货品id的结果。可以看到，如果添加了单品信息，因为该信息在pad表中能找到，所以在innerjoin中就不会进行对gg和gs的连表。如果添加了商品查询条件，就会触发gg和gs的连表。
以上采购申请单明细账任务结束。
第二个功能：采购申请单汇总账编写
功能说明:编写采购申请单汇总页面，用于展示以单品为维度的汇总信息
要求:
编写采购申请单汇总账页面
具备针对申请单、货品、单品的常用查询条件，可参考采购申请单管理页面
具备创建时间搜索条件，默认值设置为最近7天
具备申请数量汇总，已引用量汇总，编辑中数量汇总，待确认数量汇总，单据数量汇总列
汇总账c#代码
[Window(Title="采购申请单汇总账", View="statistic/sta_purchase/purchase_apply_collect.html", Style=Style.WS_VISIBLE|Style.WS_CHILD|Style.WS_CLIPCHILDREN, Width=960, Height=640)]
public class PurchaseApplyCollectWindow : BaseWindow解释：
1、OnLoad() 方法在窗口加载完成后被调用，可以用来执行一些初始化操作或加载数据（这里设置页面属性的开始时间为距今天7天以前，结束时间为当前时间）
2、在窗口加载完成后，加载表头。通过Xcall绑定后端statistic.PurchaseStatistic.purchaseApplyCollectBySpec方法定义的表头
3、设计搜索按钮被单击时的回调函数。当前实例对象中匹配选择器".flat_bar"的元素转换为查询参数形式，通过DbPageBind2将其传入到purchaseApplyCollectBySpec方法中，并将结果保存在页面元素#goods_sell_list中
汇总账java代码
@Export
@Columns("(spec_name, 单品名称)(spec_code, 规格码)(spec_no, 商家编码)(goods_no, 货品编号)(goods_name, 货品名称)(sum_num, 申请数量)(ref_sum_num, 引用数量)(editing_num, 编辑中数量)(noConfirm_num, 待确认数量)(apply_num, 单据数量)(class_name, 分类)(brand_name, 品牌)")
@Transforms("(sum_num,goods_count)(ref_sum_num,goods_count)(noConfirm_num,goods_count)(editing_num,goods_count)")
@ServerTransforms("goods_class(class_id+class_name),goods_brand(brand_id+brand_name)")
public Response purchaseApplyCollectBySpec(Session session, Map params, Pager pager)
throws SQLException, AppException
{
return purchaseStatisticService.purchaseApplyCollect(session, params, pager);
}
public Response purchaseApplyCollect(Session session, Map params, Pager pager) throws SQLException
{
DbSession db = session.db(false);
Where where = new Where(params, session)
{
{
// 根据申请单号搜索
equal("purchase_apply_no", "pa.purchase_apply_no");
// 根据申请单状态搜索
equal("status", "pa.status");
// 根据货品编号搜索
equal("goods_no", "gg.goods_no");
// 根据单品编号搜索
equal("spec_id", "pad.spec_id");
// 根据申请人ID搜索
equal("creator_id", "pa.creator_id");
// 根据商家编码搜索
equal("spec_no", "gs.spec_no");
// 根据货品简称搜索(考虑需求。考虑是否需要模糊查询)
equal("short_name", "gg.short_name");
// 根据单品名称搜索
equal("spec_name", "gs.spec_name");
// 根据期望到货日期搜索
dateBetween("excepted_begin", "excepted_end", "pa.expected_time");
// 根据申请日期搜索
dateBetween("create_begin", "create_end", "pad.created");
// 根据仓库搜索
equal("warehouse_id", "pa.warehouse_id");
}
}.groupBy("pad.spec_id").orderBy("pad.spec_id");
String innerFields = "pad.spec_id,IFNULL(SUM( pad.num ),0) AS sum_num, IFNULL(SUM( pad.ref_num ),0) AS ref_sum_num, sum(if(pa.status='10', pad.num, 0)) as editing_num, sum(if(pa.status='20',pad.num, 0)) as noConfirm_num, count(*) as apply_num";
// 没有用的表不要连接
Table table = new Table("purchase_apply_detail pad", innerFields, where)
{
{
innerJoin("purchase_apply pa", "pad.apply_id = pa.rec_id", true);
innerJoin("goods_spec gs", "pad.spec_id = gs.spec_id", "gs.,gg.");
innerJoin("goods_goods gg", "gs.goods_id = gg.goods_id", "gg.");
}
}.extraJoin("goods_spec gs", "tmp.spec_id = gs.spec_id")
.extraJoin("goods_goods gg", "gs.goods_id = gg.goods_id");
// 返回的列中，第一个要是能唯一标识一条记录的列
String fields = "gs.spec_id, gs.goods_id, gs.spec_no , gs.spec_code , gs.provider_id , gs.barcode , gs.spec_name , gs.wms_process_mask , gs.is_not_need_examine , gs.goods_label, gs.prop1, gs.prop2," + "gg.goods_type , gg.goods_no , gg.goods_name , gg.short_name , gg.alias , gg.spec_count , gg.class_id , gg.brand_id,";
fields += "sum_num, ref_sum_num, editing_num, noConfirm_num, apply_num";
table.setOutputFields(fields);
return SqlUtils.pageQuery(db, pager, table, where);
}
总的来说，这个就是根据输入条件信息，对数据库做一个查询操作，并通过pageQuery函数分页展示结果
至此，两个界面的创建任务完成。