小程序功能及接口调用说明
发布时间:2024.03.14
关于字体
小程序中的文本可以分为两种:静态文本和动态文本。静态文本指标签文本,不会变动;动态文本是指从后台取过来的文本。
小程序中的表单结构分两部分,台头数据和项目数据,项目数据以列表的形式展示。
字体可以分为如下几种:
1、台头静态文本字体
2、台头动态文本字体
3、项目静态文本字体
4、项目动态文本字体
5、标题文本字体
6、按钮文本字体
见下图:
每种字体可以在系统中预定义几种,以后可以让用户自己选择;
每个页面的各种字体使用用户当前选择的字体,用户没有选择的话使用默认字体。
关于信息提示
信息提示有三种:成功提示、错误提示、警告提示。
1、成功提示,表示提交给服务器后台接口返回成功信息,这种信息展示使用自动消失的Toast弹窗;
2、警告提示,提示用户缺乏某些必要的操作,一般是提醒用户需要输入或选择某些参数,使用模态对话框,需要用户关闭对话框才能进一步操作;
3、错误提示,表示提交给服务器后台接口返回错误信息,使用模态对话框,需要用户关闭对话框才能进一步操作;
0、小程序启动或重新进入
regid:注册ID,小程序中与微信账号一一对应,APP中与手机一一对应。
程序启动时,由接口api/qgetregid通过regid查询服务器,如果已经注册,会返回一条记录,包括账套编码mandt,账套名称mtext,登录账号bname,将这三个字段存入本地缓存,以备后续使用。
一、Logon-登录页面:
账套编码:从本地缓存的数据中取,字段mandt;
账套名称:从本地缓存的数据中取,字段mtext;
登录账号:从本地缓存的数据中取,字段bname;
登录密码:从本地缓存的数据中取,字段bcode;
功能:
登录:接口api/login,登录成功后将账号bname和密码bcode存储本地,失败则提示返回的错误信息。
登录成功后,会返回如下值,存入本地缓存数据
loginid-登录ID,也就是一个会话ID,后续的接口调用都需要它;
werks-工厂编码
wpnmr-车间编码
wsnmr-班组编码
pernr-员工编码
cname-员工名称
report_other-是否有代报工权限
bname-登录账户
password-登录密码
扫描按钮:扫描的是公司二维码,公司二维码由(账套编码mandt+空格+账套名称mtext)组成的字符串编制的二维码,扫码后把账套编码和账套名称解析出来,存入本地缓存,并更新UI显示。
然后通过接口api/mbrg,将账套(mandt)和注册ID(regid)进行绑定
二、Frame-首页:
首页的看板,为当前登录账户代表的员工或其下属车间的合计工资统计。
接口api/qgetpiecework,取得工资。
三、Corg-扎号上数:
1、在首页点击【扫菲报数】按钮后启动摄像头扫描二维码,将扫描得到的二维码传递给页面Corg的属性变量fpnmr,然后调用函数Refresh1,通过接口api/qcorgitems取菲票数据,提供如下参数:loginid、fpnmr,点击【继续扫码】后,重新扫描获取新的二维码赋值给fpnmr,然后调用函数Refresh1。
在项目中点击【上数】按钮,
2、上数:如果项目数量大于0,就可以上数,通过接口api/co11f提交数据:
四、CorgA-扎号上数详情页:
上数详情标签页,通过接口api/qscandetail获取菲票的上数记录,提供如下参数:loginid、fpnmr、pernr(从本地缓存取),封装在Refresh2函数中。
撤销:通过接口api/co11f,参数oper:"0",项目数据参数fpnmr、ktsch、posnr进行撤销报工。
五、CorgB-多工序批量上数:
通过接口api/co11f提交多条项目数据。
六、CorgC-整床上数:
通过接口api/corg提交多条项目数据,需提供loginid和aufnr2(工单)、tabno(床次)三个参数。
七、ZhanoSel-扎号选择:
通过接口api/qtableitems查询数据。
八、CorgD-工序上数:
通过接口api/qcorg查询数据,需提供loginid和aufnr2(工单)、tabno(床次)三个参数。
九、CorgD2-工序上数2:
通过接口api/qcorg查询工序数据,需提供loginid和aufnr2(工单)、tabno(床次)、ktsch(工序编码)四个参数。
通过接口api/qtableitems查询扎号数据,只需要提供loginid和aufnr2、ktsch三个参数。
提交数据,通过接口api/corg提交多条项目数据。
十、CorgD3-工序撤数:
通过接口api/qscandetail查询工序上数的数据,只需要提供loginid和aufnr2、ktsch三个参数。
提交数据,通过接口api/co11f提交数据:
台头数据:
loginid
oper:"0"//0代表删除撤销;
项目数据:
fpnmr、ktsch、posnr,这三个字段在api/qscandetail返回的项目数据中。
十一、Coma-生产上数:
通过接口api/qcozc查询床次数据,只需要提供loginid和datef、datet三个参数。
点击【上数】时,将项目数据中的aufnr2和tabno传递给下一页。
十二、Coma2-生产上数2:
通过接口api/qcoma查询床次数据,只需要提供loginid和aufnr2、tabno三个参数。
十三、Coma3-扎号撤数:
从上一个界面把项目的fpnmr传过来,
通过接口api/qcoma3查询菲票数据,只需要提供loginid和fpnmr两个参数。
每个列表项中的数据(fpnmr,ktsch,posnr)为撤数时要提交给服务器的关键字。
撤数:同第四条。
十四、Co11-整床报工:
点击扫描二维码得到工单编号aufnr2,然后通过接口api/qgetpoktschs查询工序数据,只需要提供loginid和aufnr2两个参数。
点击【上数】后,将aufnr2和ktsch以及type:1传递给下一个页面CorgD2。
生产报工会产生一条台头数据放在zutk里,而项目放在zuto中,项目为报工时选择的扎号也就是菲票数据。
十五、Co11A-整床报工详情:
通过接口api/qco11查询工单报工历史数据,需要提供loginid和选择的日期时间段datef,datet 参数。
撤销:使用接口api/wrcl提交数据,参数loginid、aufnr2、type:1、poscn。
十六、Com1-工单报数:
点击扫描二维码得到工单编号aufnr2,然后通过接口api/qgetpoktschs查询工序数据,只需要提供loginid和aufnr2两个参数。
点击【报数】后,将aufnr2和ktsch传递给下一个页面。
十七、Com1A-工单报数2:
根据从上一页传来的aufnr2和ktsch,通过接口api/qgetpoktschs查询工序数据,需要提供loginid和aufnr2、ktsch三个参数。
点击【确认】,api/co11f提交数据:
loginid:
aufnr2:工单号
ktsch:工序编码
pernr:员工编码
menge:数量
oper:'1'
rwtype:'Q'
十八、Com1B-工单报数详情:
点击扫描二维码得到工单编号aufnr2,然后通过接口api/qcom1查询工单报数历史数据,只需要提供loginid和aufnr2两个参数。
撤销:使用接口api/wrcl提交数据,参数loginid、aufnr2、type:2、ktsch、poskn。
十九、ComaA-生产上数(历史记录):
通过接口api/qscandetail获取上数记录,提供如下参数:loginid、datef、datet
二十、Comqr-公司二维码:
从本地缓存数据取出公司编码mandt和公司名称mtext, 把两者中间通过空格连接在一起组成一个字符串,显示为二维码。
二十一、Myqr-我的二维码:
取一个能代表当前登录微信账号的GUID字符串,显示为二维码。
二十二、Mbrg-手机注册:
通过接口api/qmbrg获取已经注册的手机,提供如下参数:loginid。
扫码注册:取得微信账号的唯一码 regid,调用接口api/mbrg,将注册码(regid)和登录ID(loginid)进行绑定
删除:同样的接口,参数oper设置为0
二十三、Ppra-生产进度:
调用接口api/ppra2,
二十四、Copz-薪资统计:
调用接口api/qscansum,
二十五、Ppr7-扫菲记录:
通过接口api/qscandetail获取上数记录,提供如下参数:loginid、datef、datet 、type:'P'。
二十六、Ppr72-扫菲记录:
通过接口api/qscandetail获取上数记录,从上一个页面传来工单号aufnr2以及日期datef和datet ,提供如下参数:loginid、aufnr2、datef、datet。
撤销:通过接口api/co11f,参数oper:"0",项目数据参数fpnmr、ktsch、posnr进行撤销报工。
二十七、Suvl-绑定工序:
通过接口api/qgetmyktschs获取工序列表,从上一个页面传来工单号aufnr2以及日期datef和datet ,提供如下参数:loginid、aufnr2、datef、datet。
二十八、Su01-用户管理:
通过接口api/qsu01获取登录账号列表。
二十九、Su01A-新增用户:
通过接口api/su01提交账号数据。
三十、SelRolnr-角色选择:
通过接口api/qrole获取角色列表。
三十一、SelWpnmr-车间选择:
通过接口api/qwpnmr获取车间列表。
三十二、Coz4-生产管理:
通过接口api/qco42获取工单列表。
三十三、Cozc-裁床列表:
通过接口api/qcozc获取裁床列表。
三十四、EditPWD-修改密码:
通过接口api/cngpwd修改密码。
三十五、Cobz-套装打包:
页面cobz
1、套装打包页
点击功能按钮时启动扫码程序扫描二维码,进入页面,通过接口api/qcobzitems查询菲票数据,显示在列表中。
【代报工】,参考CorgB中的【代扫菲】
【报工】,调用接口api/cobz提交数据
2、打包详情页
通过接口api/qcobz查询打包历史