浦橙 - HOPESHOW应用系统在线帮助

最后修改人	陈英凤
最后修改时间	2024-11-01 10:35:39
创建人	陈英凤
创建时间	2022-12-12 15:39:19

该文档由陈英凤创建于 2022-12-12 15:39:19 ，陈英凤在 2024-11-01 10:35:39 修改了该文档。

[TOCM]

# 浦橙帮助文档
## 1. 入门
### 1.1 新增模块
![](/storage/16704854889403/16704856320750.jpg)
### 1.2 新增菜单
![-w300](/storage/16704854889403/16704871384572.jpg)
![](/storage/16704854889403/16704871614248.jpg)
### 1.3 新增主页
![](/storage/16704854889403/16704879533498.jpg)
（1）主页面设置数据源
![](/storage/16704854889403/16704879979587.jpg)
![](/storage/16704854889403/16704880083250.jpg)
![](/storage/16704854889403/16704880283170.jpg)
（2）添加字段
![](/storage/16704854889403/16704880647515.jpg)
### 1.4 新增子页
![](/storage/16704854889403/16704880884840.jpg)
（1）设置数据源、添加字段
（2）要求保存、编辑、取消编辑、审核通过、取消审核、附件、打印、提交审批、审批退回按钮都必须存在，并且命名都一样，否则页面会报错
### 1.5 主子页关联
（1）在主页面“新增”“修改”“删除”按钮，设置页面事件，关联子页面
（2）表格设置-页面事件，如双击行打开页面
#### 1.5.1 点击“新增”按钮打开子页
![](/storage/16704854889403/16704884324726.jpg)
```JS
$vm.open('com.pucheng.fastfashion.contract.edit',null,{openType:'new',mainTable:mainTable});// 新增保存后，结果立刻显示在主页面列表
```
```JS
$vm.open('com.pucheng.fastfashion.partsize.edit',null,'new'); //新增保存后，需要点击查询才能显示新增记录
```
#### 1.5.2 点击“修改”按钮打开子页
```JS
var row = mainTable.getRow(); // 获取当前选择的记录
if (!row) {
    gUtil.error('请选择需要编辑的记录'); 
    return;
}
var param = {};
param.MAINID = row.MAINID; 
$vm.open('com.pucheng.fastfashion.partsize.edit',param,'edit'); 
```
#### 1.5.3 删除按钮
```JS
var row = mainTable.getRow();
if (!row){
    $.alert("请选择需要删除的记录");
    return;
}
var param = {MAINID:row.MAINID};
$vm.remove('com.pucheng.fastfashion.partsize.edit',mainTable,param);
```
#### 1.5.4 主页列表双击行记录打开子页
主页-表格设置-页面事件
![](/storage/16704854889403/16704892580957.jpg)
#### 1.5.5 点击“新增”按钮打开弹窗
```JS
// 弹窗编辑页面，请调整pageId为编辑页面编码
$vm.openDialog('com.golden.bdp.tms.main.pagetemplate.dialog1',{},'new',true,function(row){
mainTable.addNewRow(row); // 立即在页面上新增一条新记录
});
```
#### 1.5.6 点击“修改”按钮打开弹窗
```JS
var row = mainTable.getRow(); // 获取当前选择的记录
if (!row) {
	gUtil.error('请选择需要编辑的记录');
	return;
}

var param = {};
// 添加查询条件
 param.AUTOINC = row.AUTOINC;

// 弹窗编辑页面，请调整pageId为编辑页面编码
$vm.openDialog('com.pucheng.fastfashion.bas.Productiontype.edit',param,'edit',false,function(row){
	mainTable.update(row); // 立即在页面上更新记录
});

/** 打开子窗口编辑页面，请调整pageId为编辑页面编码
$vm.open('com.golden.bdp.tms.main.pagetemplate.subpage1',param,'edit');
*/
```
#### 1.5.7 批量“结束”按钮

```js
product_code();

/** 
 * function : product_code 
 * create   : 2021-12-01 11:48:31 
 * des      : 此函数为原产品库代码 
 */

function product_code() {

var rows=mainTable.getSelectRows()

if(rows.length==0)
{
    $.alert("请选择需要结束的数据");
    return;
}
gUtil.confirm("确认结束操作？",function()
{
    var ids=[]
    for(var i=0;i<rows.length;i++)
    {
        ids.push(rows[i].AUTOINC)
    }

### 1.6 单据类型码
新增模块子页后，需要在“基础设置->单据类型管理” 创建单据类别码，否则保存时报错：单据类型码缺失，如下：
![](/storage/16704854889403/16704898951859.jpg)
添加或修改3处单据类型码
（1）
![](/storage/16704854889403/16704899135418.jpg)
（2）
![](/storage/16704854889403/16704899220005.jpg)
（3）
![](/storage/16704854889403/16704899288935.jpg)
### 1.7 字段设置
#### 1.7.1 页面添加字段
![](/storage/16704854889403/16704900878957.jpg)
#### 1.7.2 下拉选框字段
例1:
![](/storage/16704854889403/16704901341857.jpg)
例2，同时赋值给表单其他字段:
![](/storage/16704854889403/16704901517662.jpg)
例3:
![](/storage/16704854889403/16704901654283.jpg)
![](/storage/16704854889403/16704901832788.jpg)
业务代码：来源于【应用开发-下拉组件】；
常用代码：【基础设置-数据字典列表】，前台无菜单，后台写死，不存在修改情况时使用。
#### 1.7.3 字段添加按钮
![-w300](/storage/16704854889403/16704902705496.jpg)
![](/storage/16704854889403/16704902989709.jpg)
![](/storage/16704854889403/16704903067583.jpg)
效果:
![](/storage/16704854889403/16704903210435.jpg)

#### 1.7.4 单选默认值

```js
 gridForm.checkbox("字段名").check("1")
```

### 1.8 代码简介
前端，页面事件，语法：JavaScript；
后端，服务事件，语法：独立语法
## 2. 页面设置
![](/storage/16704854889403/16708088182410.jpg)

### 2.1 页面事件 - onOpen 
#### 2.1.1 定义明细计算方法
统一定义明细计算方法，供页面控件调用：onChange - 控件值改变事件
![](/storage/16704854889403/16704905196417.jpg)
![](/storage/16704854889403/16704905268489.jpg)
**常用命名定义：**
`//计算最大尺码到主表`
selfPage.setMainSizeRule
`//动态尺码`
selfPage.setListSize
`//导入款式明细`
selfPage.importClothingGoods
`//删除颜色尺码表处理`
selfPage.deleteColorSize
```js
//颜色尺码录入计算
selfPage.colorSizeChange = function(rowData,rowIndex)
{
    //汇总成衣小计
    var rowSumNum=0;
    for(var i=1;i<21;i++)
    {
        var inum=gUtil.toNumber(rowData["NUM"+ i])
        rowSumNum=rowSumNum + inum 
    }
    tabPage.tabPage1.detailTable.setDataValue(rowIndex,"NUM",rowSumNum) 
    selfPage.sumStyleNum()
}
```
`//汇总单款成衣总数量到主表`
selfPage.sumStyleNum
`//计算金额到主表`
selfPage.changeAmount
`//汇总金额计算税额`
selfPage.SumAmount
#### 2.1.2 页面打开显示默认值
![](/storage/16704854889403/16704911206237.jpg)
单选新增时默认勾选“是”：
```js 
inputForm.checkbox("ISTAX").check(1)
```
#### 2.1.3 初始化按钮状态
```js 
/**
 * 自定义按钮处理
 * name：按钮别名
 * vs :所有状态都是否显示 0隐藏，1显示
 * es :所有状态都是否启用 0禁用，1启用
 * vs或es后可加1-10,1-10代表STATUS【状态】值，表示不同状态下是否显示或启用
 * vs、es加1-10设置后的参数优先级大于vs或es
 */
selfPage.buts=[]
selfPage.buts.push(
{
    name:'biname1', 
    vs5:1,
    es5:1,
    vs:0,
    es:0,
},{
    name:'biname2', 
    vs5:1,
    es5:1,
    vs:1,
    es:1,
} 
) 
selfPage.CallbackStatusChange=function(stauts)
{ 
}

//处理初始化按钮状态事件（必须有）
Common.puc_onOpen(selfPage,inputForm,[tabPage],openType,args,self)
```
注意：按钮状态需要结合2.3控件初始化设置

#### 2.1.4 页面新增状态时按钮不可用，示例：
```js
if(!inputForm.get("MAINID"))
{
self.button('biactive').disabled();
self.button('print-button').disabled();
self.button('bifiles').disabled(); 
}
```
```js
selfPage.CallbackStatusChange=function(stauts)
{
    if(inputForm.get("ISMEET")==1)
        self.button('bimeeting').disabled(); 
}
```
#### 2.1.5 主页初始化查询条件
```js
searchForm.set("ISOVER",0)
```
#### 2.1.5 打开子页面为新增模式时，如何加载指定数据
新增模式true，新增是不会默认去加载数据的，需要open里面写load数据
![](/storage/16704854889403/16705647061611.jpg)
tabPage.tabPage0.detailTable.load(args)
### 2.2 页面事件 - onBeforeWinClose - 窗口关闭前触发
```js
// return 1 - 等待回调函数closeCallback回调后关闭 ； other - 立即关闭
```
* 方法一：
![](/storage/16704854889403/16705651818231.jpg)
```json
return Common.puc_onWinClose(selfPage,inputForm,[tabPage],null,self,closeCallback)
```
* 方法二：
```js
var isChange = self.getIsChange();
if (!isChange) return;
gUtil.confirm('当前窗口数据已修改，是否确认放弃修改的数据？',function(){
closeCallback();
})
return 1;
```
效果：
![-w500](/storage/16704854889403/16705653247634.jpg)
## 3. 控件设置
![](/storage/16704854889403/16708098619224.jpg)
###  3.1 页面事件
#### 3.1.1 onAfterLoad
1. 按钮状态
2. 表格数据加载,尺码动态横排
```js
setTimeout(function () {  
    let size=inputForm.get("SIZERULE") 
    if(size)
        selfPage.setListSize(tabPage.tabPage1.detailTable,size)
    Common.puc_onAfterLoad(selfPage,inputForm,[tabPage],self,data)
}, 200);
```

### 3.2 服务事件
#### 3.1.1 beforeLoad 
#### 3.1.2 AfterLoad - 数据加载后事件
```js
#set($param=$vs.util.newMap())
#set($param.form=$form)
#set($param.list=$list)
#set($param.BILLTYPE_CODE='BT1154')
$vs.proc.runServiceComp("com.pucheng.fastfashion.approve.check",$param)
```

### 3.3 示例：按钮“审核通过”
(1)控件设置 - 页面事件 - onAfterLoad - 数据加载到控件完成后触发
(2) 控件设置 - 服务事件 - AfterLoad
![](/storage/16704854889403/16708147227526.jpg)
![](/storage/16704854889403/16708147385922.jpg)
## 4. 按钮
### 4.1 保存按钮
#### 4.1.1 页面事件 - onClick
##### 1. 保存成功立即出现单据编码
保存”按钮onClick点击事件改为：
![](/storage/16704854889403/16708161244722.jpg)
```js
if(Common.puc_onBeforeSaveButton(selfPage,inputForm,[tabPage],self)==false) return
$vm.save(function(result){ 
    if(result.inputForm.BILLNO) 
        inputForm.set('BILLNO',result.inputForm.BILLNO) 
    if(result.inputForm.STATUSNAME) 
        inputForm.set('STATUSNAME',result.inputForm.STATUSNAME) 
    if(result.inputForm.STATUS) 
        inputForm.set('STATUS',result.inputForm.STATUS) 
    if(result.inputForm.INPUTDATE) 
        inputForm.set('INPUTDATE',result.inputForm.INPUTDATE) 
    if(result.inputForm.INPUT_USERID) 
        inputForm.set('INPUT_USERID',result.inputForm.INPUT_USERID) 
    if(result.inputForm.UPDATEDATE) 
        inputForm.set('UPDATEDATE',result.inputForm.UPDATEDATE) 
    if(result.inputForm.UPDATEUSERID) 
        inputForm.set('UPDATEUSERID',result.inputForm.UPDATEUSERID)
    
    Common.puc_onAfterSaveButton(selfPage,inputForm,[tabPage],self,result)
});
```
##### 2. 保存后，按钮留在编辑状态
原：
```js
Common.puc_onAfterSaveButton(selfPage,inputForm,[tabPage],self,result)
```
改为：
```js
Common.puc_onAfterSaveButton(selfPage,inputForm,[tabPage],self,result,null,1)
```
#### 4.1.2 服务事件 - beforeSave
##### 1. 单据默认值
![](/storage/16704854889403/16708152827402.jpg)
```java
//单据编号为空时，自动生成单据号
#if (!$inputForm.BILLNO)
    #set($inputForm.BILLNO=$vs.billNoTools.getBillNo($inputForm))
#end
//新增时，初始话默认值
#if ($isNew) 
    #set($inputForm.STATUSNAME='草稿')
    #set($inputForm.STATUS=1)
    #set($inputForm.MAINID=$vs.util.numberGUID())
    #set($inputForm.INPUTDATE=$vs.date.getDbDate())
    #set($inputForm.INPUT_USERID=$vs.user.USER_ID) 
    #set($inputForm.INPUT_USERNAME=$vs.user.USER_NAME)
    //设置部门信息
    #if($vs.util.isNull($inputForm.DEPTID))
        #set($inputForm.DEPTID=$vs.user.DEPT_CODE) 
        #set($inputForm.DEPTNAME=$vs.cache.getUserSessionCache("DEPT_NAME"))
    #end 
    //设置机构信息
    #if($vs.util.isNull($inputForm.COMPANYID))
        #set($inputForm.COMPANYID=$vs.user.ORG_CODE) 
        #set($inputForm.COMPANYNAME=$vs.cache.getUserSessionCache("ORG_NAME"))
    #end 
#end
#set($inputForm.UPDATEDATE=$vs.date.getDbDate())
#set($inputForm.UPDATEUSERID=$vs.user.USER_ID) 
```
##### 2. 明细表AUTOINC默认值
![](/storage/16704854889403/16708157172605.jpg)
```java
//为明细表设置主表关联字段值
@setDetailTableMainId($tabPage.tabPage1.detailTable,$inputForm.MAINID)
@setDetailTableMainId($tabPage.tabPage2.detailTable,$inputForm.MAINID)
#function setDetailTableMainId($tableRow,$mainId)
    #foreach ($row in $tableRow)
        #set($row.MAINID =$mainId )
        #if(!$row.AUTOINC) 
            #set($row.AUTOINC=$vs.util.numberGUID()) 
        #end
    #end
#end
```
### 4.2 自定义按钮
#### 4.1.1 页面事件 - onClick
##### 1. 多级子表新增默认2级表主键方法
```js
let newId=gUtil.getTimeStamp()//创建时间截
for(let i;i<length;i++)
{
    //注意long int 区分
    let newrow={}
    newrow.AUTOINC='100000' + (newId+i)//时间截+i 再转long类型
} 
```
##### 2. 自定义按钮状态变更

#### 4.1.2 自定义按钮示例
##### 1. 作废
![](/storage/16704854889403/16708204394842.jpg)
* 提交结案，点击按钮打开弹窗->录入结案原因 -> 保存 -> 改变按钮状态
![](/storage/16704854889403/16708205128235.jpg)
```js
var param = {};
// 添加查询条件
param.IDS = gridForm.get("MAINID");
$vm.openDialog('com.pucheng.fastfashion.exp.sorder.close.mf.batch',param,'edit',false,function(newrow){ 
    gridForm.set("ISCLOSE",newrow.ISCLOSE) 
    self.button('biclose').disabled(); 
});
```
##### 2. 转入成衣信息库
![](/storage/16704854889403/16708205762909.jpg)
##### 3.  点击按钮同步更新关联数据
![](/storage/16704854889403/16708206197820.jpg)

```js
    gUtil.request('com.pucheng.fastfashion.descb.select.linkdata2',param, function (result) {
        if (!result && result.code==0)
            $.alert("选择失败!");
        else { 
            tabPage.tabPage3.detailTable.load({MAINID:gridForm.get("MAINID")})
            tabPage.tabPage4.detailTable.load({MAINID:gridForm.get("MAINID")})
            $.alert("同步成功!");
        }
    });
```
##### 4. 插入按钮
![](/storage/16704854889403/16708214226340.jpg)
## 5. 子页明细
### 5.1 添加TAB页
![](/storage/16704854889403/16708215288616.jpg)
![-w500](/storage/16704854889403/16708216098873.jpg)
![](/storage/16704854889403/16708216394376.jpg)
### 5.2 TAB页表格
![](/storage/16704854889403/16708216588215.jpg)
### 5.3 Tab页数据源为主表，字段保存
1. 若需要修改保存，则Tab页字段必须为主表查询或隐藏字段
2. Tab页字段添加onChange事件，将值赋给主表
![](/storage/16704854889403/16708221461831.jpg)

## 6. 布局
### 6.1 设置窗口宽度
![](/storage/16704854889403/16708227877753.jpg)
### 6.2 设置窗口高度
![](/storage/16704854889403/16708227997080.jpg)

## 7. 主页
### 7.1 双击打开一行记录
```js
product_code();

/** 
* function : product_code 
* create : 2021-12-01 11:00:04 
* des : 此函数为原产品库代码 
*/

function product_code() {
var param = {}; 
param.MAINID = rowData.MAINID;
$vm.open('com.pucheng.fastfashion.pdt.shengc.edit',param,'edit'); 
}
```
### 7.2 初始化查询条件
```js
searchForm.set("ISOVER",0)
```
### 7.3 主页行弹窗修改后实时更新
![](/storage/16704854889403/16708226508888.jpg)

### 7.4 更新状态后从当前查询列表消失
同上7.3
## 8. 表格
### 8.1 显示动态尺码
1. 页面设置，onOpen 定义方法，参考2.1
2. 控件设置，调用方法，参考3.1
### 8.2 获取表格数据
* 获取选中行(一行)：tabPage.tabPage2.detailTable0.getRow()
* 获取选中行（多行）：tabPage.tabPage2.detailTable0.getSelectRows()
* 获取所有行数据：tabPage.tabPage2.detailTable0.getData()
* 获取所有行数据（已筛选）：tabPage.tabPage2.detailTable0.getFilterData()
* 上移：moveUpRow(tabPage.tabPage5.detailTable);
* 下移：moveDownRow(tabPage.tabPage5.detailTable);
> 示例：弹窗选择记录添加到表格
```js
let params={}
$vm.openDialog("com.pucheng.fastfashion.*",params,"select",true,function(rows){ 
//多级子表 新增默认2级表主键方法
let newid=gUtil.getTimeStamp()  //创建时间截
for(let i=0;i<rows.length;i++)
{ 
    //注意long int 区分
    let newrow={} 
    newrow.AUTOINC = '100000' + (newid+i)   //时间截+i 再转long类型
    newrow.TEAM = rows[i].TEAMNAME
    newrow.DETAILID = params.AUTOINC
    newrow.COLORCODE = params.COLORCODE;
    newrow.COLORNAME = params.COLORNAME;
    
    //只添加新数据，不重复添加
    let tmdata=tabPage.tabPage2.detailTable2.getFilterData()
    let iteam=[]
    for(let j=0;j<tmdata.length;j++)
    {
        iteam.push(tmdata[j].TEAM)
    }
    let isin=iteam.indexOf(rows[i].TEAMNAME);
    if(isin==-1) 
        //添加分配行
        tabPage.tabPage2.detailTable2.addNewRow(newrow)
}
``` 
### 8.3 添加表格数据处理限制
onClick选择单行:
```js
var row = mainTable.getRow(); // 获取当前选择的记录
if (!row) {
    gUtil.error('请选择需要编辑的记录'); 
    return;
}

var param = {};
// 添加查询条件
param.MAINID = row.MAINID;
// 打开子窗口编辑页面，请调整pageId为编辑页面编码
$vm.open('com.pucheng.fastfashion.pdt.shengc.edit',param,'edit');

onClick选择多行:
var rows=mainTable.getSelectRows()
if(rows.length==0)
{
    $.alert("请选择需要生成的数据");
    return;
}
var mainid;
for(var i=0;i<rows.length;i++)
{
    if(!mainid)
    {
        mainid=rows[i].MAINID
    }else if(mainid !=rows[i].MAINID)
    {
        $.alert("只允许选择相同生产单号数据生成！");
        return;
    }
}
```
### 8.4 表格单元格赋值
```js
tabPage.tabPage0.detailTable.setDataValue(rowIndex,"NUM",SumNum)
```
```js
tabPage.tabPage1.detailTable.update(row)
```
### 8.5 多级标题 Title
1. onOpen或者onCreate 定义方法
2. 控件设置onAfterLoad调用: selfPage.loadSizeTitle();
> 示例（待裁剪清单）：
```js
selfPage.MultiMeter = ()=>{
    //若主页查询条件选择统计尺码组，则按选项显示Title，否则自动取第一行统计尺码组
    let sizeParamName = searchForm.get("PARENTSIZENAME")
    let sizeSelData = []
    if(gUtil.isNull(sizeParamName)){
        if(gUtil.defstatsizerules){
            if(gUtil.defstatsizerules.length>0){
                sizeSelData = gUtil.defstatsizerules[0]//取第一行统计尺码组
            }
        }
    }else{
    if(gUtil.defstatsizerules){
        for(var j=0;j<gUtil.defstatsizerules.length;j++) {
            var getrow=gUtil.defstatsizerules[j]
                if(getrow.code==sizeParamName || getrow.name==sizeParamName){
                    sizeSelData=getrow;
                }
            }
        }
    }
    //end 获取统计尺码组console.log(sizeSelData)
    
    // 创建空白父级标题
    let columnDefs = [];
    let group={
        headerName: '',
        children: [] 
    }
    columnDefs.push(group)

}else if(itemName.startsWith("UNNUM")){
            //item.hide=false;
            let index = gUtil.toNumber(itemName.substr(5))
            if(index==1)
            {
                group=
                {
                    headerName: "待裁剪",
                    children: [] 
                }
                columnDefs.push(group)
            }
            var sizeName=sizeSelData["SIZENAME" + index]
            if(gUtil.isNotNull(sizeName))
            {
                item.headerName= sizeName
                item.headerTooltip= sizeName
                group.children.push(item)
                item.hide=false; 
        }else if(itemName=="UNNUM")
            { 
            group.children.push(item) 
            group={
            headerName: "",
            children: [] 
            }
            columnDefs.push(group)
            }else
            { 
            group.children.push(item)
            item.hide=true; 
            }
        }else
        {
            group.children.push(item)
        }
        api=mtColumns[i].gridApi;
    }
    api.setColumnDefs(columnDefs); 
}
////调用
selfPage.MultiMeter()
```
## 9. 弹窗
### 9.1 弹窗是否可编辑
> 要求效果：单据已审核时，弹窗只读不可编辑
tabPage.tabPage0.detailTable.disabledEdit(true)
1. 在编辑页可以通过selfPage.isEdit =1/0 取到当前页面状态，1编辑状态0非编辑状态；
2. 然后传给弹窗，在弹窗的onOpen里面取到，再是否禁用表格
![](/storage/16704854889403/16708224884243.jpg)
![](/storage/16704854889403/16708224985775.jpg)
### 9.2 Excel导入
1. 新建弹窗页面
2. 添加Form控件inputForm
![](/storage/16704854889403/16708256238098.jpg)

3. 添加数据源
```sql
SELECT 
'' AS FILEPATH,
'' AS FILENAME
FROM DUAL
```
4. 添加字段
![](/storage/16704854889403/16708256876944.jpg)
![](/storage/16704854889403/16708256927993.jpg)
5. excel模版文件设置
![](/storage/16704854889403/16708257093190.jpg)
6. FILEPATH字段添加onChange事件，调用服务组件读取Excel数据
![-w500](/storage/16704854889403/16708257393361.jpg)
页面设置onCreate｜onOpen事件：
![](/storage/16704854889403/16708257682749.jpg)
服务组件：
![](/storage/16704854889403/16708257746764.jpg)
7. 页面区域添加行，添加Tab控件，添加detailtable控件，呈现导入数据

## 10. 服务组件
### 10.1 常用语法
#### 10.1.1 后台打印服务日志
`$vs.log.info($form)`
#### 10.1.2 防sql注入如下
```java
#set($sql = "select * from VDOM_CUTLIST_PRODUCE where 1=1 and AUTOINC=#{AUTOINC}") //防sql注入
#set($sql = "select * from VDOM_CUTLIST_PRODUCE where 1=1 and " + $vs.sqlHelper.strIn($form.AUTOINC,"AUTOINC")) //防sql注入
```
```java
#set($sql = "select * from VDOM_CUTLIST_PRODUCE where 1=1 and AUTOINC in (" + $form.AUTOINC + ")") //不防sql注入
```
#### 10.1.3 sql返回唯一行结果
```java
#set($moRow= $vs.dbTools.uniqueResult($sql,$goods.get(0)))
//$goods.get(0)获取$goods数据源中第一行
```
#### 10.1.4 sql返回list
```java
#set($goods= $vs.dbTools.list($sql,$form))
```

#### 10.1.5 逻辑运算
```java
#if($goods.size eq 0)//判断$goods数据源的行数是否为0
    $vs.exception.throwException("没有需要生成的需求,请刷新数据后再操作")
#end
```
#### 10.1.6 字符串拆分数组
```java
// #set($sql = "select * from VDOM_CUTLIST where 1=1 " + $vs.sqlHelper.listIn($vs.util.split($form.AUTOINC,','),"AUTOINC")) 
#set($sizArr=$vs.util.split($setmain.SIZERULE,','))
```
#### 10.1.7 数组
```java
#set($allteams = $vs.util.newList())
#foreach($row in $mo)
    $allteams.add($row.TEAM)
#end
//判断数组是否为空
$vs.util.isNull($allteams)   
$vs.util.isNotNull($allteams)
$vs.util.listJoin($list,",")
```
#### 10.1.8 上游表相同列字段赋值
`$vs.util.mapCopy($src,$target)`
函数说明：将`$src`和`$target`中相同属性的值复制到`$target`中，若`$target`为空，则复制$src的所有属性（同）mapClone
#### 10.1.9 插入数据库
```java
#set($execount=$vs.dbTools.insert('PDT_DO',$setmain,false))//单行插入生产工单主表
$vs.dbTools.batchInsert($strTableName,$datas,false)//批量插入
```
#### 10.1.10 表更新 
```java
#set($sql = "update TableA set STATUS=5,STATUSNAME='通过' where MAINID=#{MAINID}") 
#set($result.execount=$vs.dbTools.execute($sql,$form))
```
#### 10.1.11 方法
```java
#function getSign($model)

#end
```
调用方法：
`@getSign($signItem)`
#### 10.1.12 时间相关函数
```java
// 获取当前时间并转换为DATETIME格式
newdata.INPUTDATE=gUtil.formatDate(new Date(),"yyyy-MM-dd HH:mm:ss")
//获取当前时间时间戳
var newid=gUtil.getTimeStamp();
```
### 10.2 语法示例
```java
//开始
#set($result.code=0)

//查询主表
#set($sql = "select * from EXP_SORTORDER_CLOTHING b where MAINID =#{MAINID}")
#set($row= $vs.dbTools.uniqueResult($sql,$form))

//数据校验
#set($sql = "select count(0) as cnt from PDT_MO_COLOR b where MAINID =#{MAINID")
#set($row=$vs.dbTools.uniqueResult($sql,$form))
#if ($row.CNT==0)
$vs.exception.throwException('款式明细为空,不允许审核!') 
#end

//审核通过
#set($sql = "update EXP_PURCONTRACT_CLOTHING set STATUS=5,STATUSNAME='通过' where MAINID="+ $form.MAINID) 
#set($result.execount=$vs.dbTools.execute($sql,$form))
#if($result.execount>0) 
#set($result.code=1)
#end

//处理插入数据
#set($setmain=$vs.util.newMap())
#set($setmain.MAINID=$vs.util.numberGUID())
//#set($setmain.BILLNO='')
#set($setmain.BILLNO=$vs.billNoTools.getBillNo('BT1042',$form))
#set($setmain.STATUS=1)
#set($setmain.STATUSNAME='草稿')
#set($setmain.INPUT_USERID=$vs.user.USER_ID)
#set($setmain.INPUTDATE=$vs.date.getDbDate()) 
#set($setmain.DEPTID=$vs.user.DEPT_CODE)
#set($setmain.COMPANYID=$vs.user.ORG_CODE)
#set($setmain.INPUT_USERNAME=$vs.user.USER_NAME)
#set($setmain.DEPTNAME=$vs.cache.getUserSessionCache("DEPT_NAME"))
#set($setmain.COMPANYNAME=$vs.cache.getUserSessionCache("ORG_NAME"))
……
#set($setmain.SOURCETYPE='排单')
#set($setmain.SOURCENO=$row.BILLNO)
#set($setmain.SOURCEID=$row.MAINID)
……

$vs.dbTools.insert('TableName',$setmain,false)

//处理批量插入数据begin
#set($setlist=$vs.util.newList())  
//$row为传入参数，$goods赋值：#set($goods= $vs.dbTools.list($sql,$form))
#foreach ($row in $goods) 
#set($setrow=$vs.util.newMap()) 
#set($setrow.AUTOINC=$vs.util.numberGUID())
#set($setrow.GOODSNO=$row.GOODSNO)
……
$setlist.add($setrow)
#end

#if($setlist.size()>0)
    #set($execount=$vs.dbTools.batchInsert('DOM_STORE_FRC',$setlist,false) )
    #if($execount>0) 
        #set($sql = "update STP_OUTSTORE_FRC set STATUS=5,STATUSNAME='通过' where MAINID=" + $form.MAINID) 
        $vs.dbTools.execute($sql,$form)
        #set($result.code=1)
    #end 
#else
    $vs.exception.throwException('未存在数据或数据错误!')
#end
//处理批量插入数据end
```

`$vs.dbTools.batchInsert('TableName',$setcutlist,false)`
如下：
```java
#if($setcutlist.size()>0)
    #set($execount=$vs.dbTools.insert('EXP_CUT_CLOTHING',$setmain,false))
    #if($execount>0)
        $vs.dbTools.batchInsert('EXP_CUT_CLOTHING_COLOR',$setcutlist,false)
        #set($result.code=1)
    #end 
#else
    $vs.exception.throwException('没有需要生成的需求!')
#end
```
### 10.3 页面事件调用服务组件
```js
let rows=..;
let params = {}
gUtil.request('com.pucheng.fastfashion.pdt.mo.qrpd',params, function (result) {
    rows.forEach((j)=>{j.PDSTATUSNAME="已排单"})
    tabPage.tabPage2.detailTable2.update(rows)
});
```
### 10.4 接口
#### 1. 接口供外部调用
![](/storage/16704854889403/16708300742786.jpg)

#### 2. 服务组件调用服务组件
![](/storage/16704854889403/16708300826724.jpg)
```js
#set($params=$vs.util.newMap())
#set($result.data=$vs.proc.runServiceComp("com.pucheng.api.in.jst.post",$params))//执行并返回结果
```
#### 3. 接口推送

#### 4. 请求外部接口，返回数据
![](/storage/16704854889403/16708301704321.jpg)
![](/storage/16704854889403/16708301766600.jpg)
测试调用：
![](/storage/16704854889403/16708301920609.jpg)

## 11. 页面事件JS
### 8.1 日志调试
```js
console.log('------start')
console.log(inputForm)
console.log('------end')
```
浏览器F12 - 控制台

### 8.2 JS常用语法
1. 日期格式
inputForm.set("INPUTDATE",gUtil.formatDate(new Date(),'yyyy-MM-dd HH:mm:ss'))
inputForm.set("IDATE",gUtil.formatDate(new Date(),'yyyy-MM-dd'))

2. JS字符串拆分
let maindata=inputForm.getData()
let sizes=maindata.SIZERULE.split(',')

3. 循环
```js 
    rows.forEach((i)=>{
        let newRow={
            COLORCODE:i.CODE,
            COLORNAME:i.BASNAME
        }
        tabPage.tabPage1.detailTable.addNewRow(newRow)
    })
```
## 12. MySQL
```sql
SELECT
PDTMOTEAMID AS AUTOINC,
DETAILID AS MAINID,
GOODSID,
GOODSNO,
COLORCODE,
COLORNAME,
SUM(IF( SIZERULE = 'XS', NUM, 0 )) AS NUM1,
SUM(IF( SIZERULE = 'S', NUM, 0 )) AS NUM2,
SUM(IF( SIZERULE = 'M', NUM, 0 )) AS NUM3,
SUM(IF( SIZERULE = 'L', NUM, 0 )) AS NUM4,
SUM(IF( SIZERULE = 'XL', NUM, 0 )) AS NUM5,
SUM(IF( SIZERULE = 'XXL', NUM, 0 )) AS NUM6,
SUM( NUM ) AS NUM 
FROM
PDT_DO_TEAM_SKU 
GROUP BY
PDTMOTEAMID,DETAILID,GOODSID,GOODSNO,COLORCODE,COLORNAME
```
## 13. HTML
![](/storage/16704854889403/16708304484338.jpg)
```html
<div class="puc_dlist_radio">
<label><input name="dcjqdlist" type="radio" value="" onclick='$vm.pageEvent("listRadio",null)' /> &nbsp;全部 </label> 
<label><input name="dcjqdlist" type="radio" checked='checked' value="0" onclick='$vm.pageEvent("listRadio",0)'/>&nbsp;待排单 </label> 
<label><input name="dcjqdlist" type="radio" value="1" onclick='$vm.pageEvent("listRadio",1)'/>&nbsp;已排单 </label>
</div>
```
![](/storage/16704854889403/16708304825705.jpg)
```js
if(type=='listRadio')
{
    if(args)
    {
        searchForm.set("ISOVER",args[0])
    }
    mainTable.load(); 
}
```  
初始化搜索框选项

![size:800,1000](/storage/2023/06-05/GWdrqyYDgGocYPcsk1mziyq4LJw5Mhji0lfrOW1H.png)
## 14. 报表
![-w300](/storage/16704854889403/16708305150170.jpg)
![-w600](/storage/16704854889403/16708305376146.jpg)
![-w600](/storage/16704854889403/16708305615136.jpg)
![](/storage/16704854889403/16708305799159.jpg)
![](/storage/16704854889403/16708305849919.jpg)