「置顶」插件说明书下载：1_P_D_J_NiuMenChaJian_Help.pdf → 鼠标右键·另存为

2022年12月4日更新升级：
导入或者更新的时候，如果系统有事先设置了价格，系统可以自动计算出运费。
但是！因为注意一点，你每次在Emmis软件修改过燃油费率或者其他影响价格的选项之后，记得要把服务器的www服务重启一下，不然这个插件导入数据的时候，计算价格还会按修改之前的燃油来计算价格。【重启云服务器的www服务的方法：https://www.ems-help.com/ems-help/856/d.htm】
# ——————————————————
2022年12月5日更新升级：
导入模板的表头里【客户账号】和【客户名称】至少要有1个存在。插件会去识别。哪个有数据，就认哪个。
如果2个字段都有数据，优先识别【客户账号】，如果【客户账号】能识别出来，就以【客户账号】数据为准，直接就不理会【客户名称】里的数据了。
# ——————————————————
2022年12月5日更新公告：
（1）这个插件的应用场景是睿云系统导出的固定模板，然后导入钮门系统，更新一票多件的分单包裹尺寸（长宽高）以及分单重量信息。应用场景非常有限，如需其他格式的导入模板，需额外付费定制增加导入模板的格式。
（2）Excel模板的表头是固定死的。导入的时候插件会自己识别数据的表达方式上具体有什么错误，并提示出来。
（3）这个是（录入+更新）一体化操作，开发基于钮门旧系统的PDA接口。如果单号不存在，系统会当作新记录直接录入系统，如果单号存在，系统会更新基本数据。
（4）针对这个模板的表头字段做一下说明↓
因为PDA接口支持字段有限。所以这个模板的部分字段是无法更新的，所以这个插件把你的模板里的某几个字段是导入到备用字段留个记录。以下分别针对每个表头字段做出说明：
序号 →钮门系统PDA接口没有这个字段，所以这个序号是存放在钮门系统的【留用串】字段里。
客户名称 → 钮门系统PDA接口导入和更新，都没有这个字段，只支持识别“客户账号”。如果你的模板里有“客户名称”，实际是需要你把钮门系统的报表里的“全部客户档案”一键保存在系统盘，并文件名命名为“客户档案”4个汉字。里面的格式不用改，我的插件会自己识别。然后你的导入模板如果只有“客户名称”这1列，插件会读取本地的“客户档案.xls”或“客户档案.xlsx”，匹配出“客户账号”，最终再提交到PDA接口里。
客户账号 → 直接匹配钮门系统客户档案里的“客户账号”。
业务日期 → 钮门PDA接口里，没有“业务日期”这个字段的录入和更新，你导入的时候，系统直接取你本地电脑的日期时间，录入到钮门系统的“业务日期”字段里。而你的导入模板里的“业务日期”，我的插件是给你导入到“备注3”这个字段里，作为备份记录。
内单号 → 正常识别。

这个插件包含2个动作：新数据录入、和 旧数据更新。
支持【新数据录入】的字段是：转单号、目的地、件数、重量（1票多件）、长宽高（1票多件）、网络渠道、类型、费用、备注1、备注2、备注3、备注4、备注5

支持【旧数据更新】的字段是：转单号、件数、重量（1票多件）、长宽高（1票多件）、备注1、备注2、备注3、备注4、备注5

备注 → PDA接口不支持“备注”，所以录入和更新都是导入到“备注4”。
插件界面的最后1列“程序运行记录” → 这个我是录入和更新到“备注5”。
# ——————————————————

【先说功能】

这个插件的作用就是：将你的钮门系统的“快录”界面，以及“复重”界面，这2个界面的功效，合成在1个界面处理，你导入的Excel数据。按下面预定的Excel导入模板表头的样子↓

(这个模板是按客户自己的习惯和指定要求提前商量好，设计好的。)

（↑点击看大图↑）

 

模板支持格式：2003的xls格式，或者2005或以上版本的xlsx格式、都支持

 

 

【再说操作步骤】

然后导入到这个一体化操作插件里，插件的样子↓

先点击红色按钮【】把excel数据导入，

先由软件进行初审，如果你的excel模板缺少什么关键的表头字段，

系统会提示导入失败，

如果导入成功，系统会根据表头的汉字导入对应的excel数据进来。

（↑点击看大图↑）

↓

这个时候再点击绿色的开始按钮【】。

点击以后，程序开始1票1票的去更新，更新的过程中都会有提示

（↑点击看大图↑）

↓

插一句，这个是一体化操作插件。

如果你的excel表格里的单号，在钮门系统并未入库，插件直接帮你入库。

如果你的excel表格里的单号，已经入库、插件帮你更换表格里的转单号，更新1票多件的称重信息、1票多件的长宽高信息。

↓

更新完成以后，系统会有提示

 

背景颜色也会发生变化。

红色背景就是失败的。

绿色的就是成功的。

不管是成功或者失败，系统的最后1列都会有详细的接口运行记录（这个记录是存在系统的备用5字段里的）。

 

↓

这个插件我加入了大量的校验逻辑。基本上你导入以后。剩下的一体化操作全部交给插件批量处理。

每个关键的程序接口运行环节，都会记录运行日志。

↓

我们点开1票绿色的、运行成功的单号的日志记录↓

 

提示里说到不支持更新客户运费。后来我优化过了。（如果你的系统设置了运费计算公式），客户运费是会自动计算的。但是有个注意的点，我后面会提到。

至于这个提示，我懒得改了。。

↓

再看看另外几单失败记录的日志：

（这个是长宽高数据集合）与总件数不符。

 

（这个是客户不可以为空！）

 

(↓这个是长宽高数据不合规范，比如只有：长*宽、没有“高”)

 

 

↓

其他绿色的都是成功，而且您的Emmis系统里已经将1票多件尺寸信息更新好了。

 

【再说基本设置】

（1）插件授权，永久授权

 

（2）这个需要用到钮门系统的PDA接口。其中把本机MAC网卡作为PDA编号。而PDA密钥是写死在插件代码里。然后右边设置服务器IP加冒号加端口（如果默认是80端口，就只写IP地址即可。）。

 

这个本MAC网卡地址是自动读取本机的物理网卡，而且是灰色不让修改的。

这个设定的目的是：只有在钮门系统添加了员工账号，并且员工账号（系统用户管理这个位置的PDA编号填写了这个MAC网卡地址，这个员工才能在他自己的电脑上使用这个插件。）

这个是为了客户自己的数据安全考虑。

当员工第一次打开这个插件。点击蓝色的“复制网卡”，发给公司老板或者负责人。

然后负责人把这个网卡地址照着上面描述的方法，设置到系统里，如下图：

 

# 

 

这个时候员工还要服务器IP设置到这个位置。

点击“设置并校验”。如果校验通过，这个IP就缓存在你的本地电脑了。

下次这个插件再次重新打开的时候，插件会先读取本地缓存，你就不需要每次打开插件都要设置一次了。比较方便，

↓

我这个插件是基于钮门的PDA接口开发的。

PDA接口目前不支持直接识别“客户名称”，只支持识别客户账号。

但是客户要求方便一点，需要模板支持客户名称识别。

所以我就变通让把客户档案的全部资料。一键导出到C盘的根目录。并取名叫“客户档案”4个字。

 

这个格式也是xls或者xlsx都行。

最好是xlsx，这样我的插件就不用临时转换了。

# ——————————

我这个插件为了提高读取识别速度，也是照顾到客户的机密信息，也考虑到程序的效率和服务器的负载。就不直接读取客户数据库了。不让这个数据在网络中传输。

# ——————

这个客户档案资料，由客户自己从钮门系统的报表界面一键导出。

模板里面的格式什么都不用改，我已经做好识别代码。

只需要把这个模板导出的时候，修改一下文件名即可。

这个一键导出全部客户资料的方法：https://www.ems-help.com/ems-help/75/d.htm

↓

然后这个插件导入excel以后，系统会同时读取本地C盘的“客户档案.xlsx”

 

根据客户导入模板里的客户名称，去对应的读取识别出“客户账号”。

然后再通过PDA接口，更新到服务器里。

↓

最后这个插件界面的更新数据，也可以导出excel表格。我加了1个按钮

。

导出的数据，直接给你强制默认保存在系统盘的C盘，

 

↓

有详细的年月日时分秒。

 

打开看看样子

 

最后1列程序运行日志，也导出了

 

↓

本教程的链接，也加在本插件的这个按钮上了

 

点击这个按钮就打开本教程了。

↓

这个插件只适合本公司的核心员工使用。不建议普通员工。

因为涉及到重要的数据更新录入、以及公司客户资料的导出。

功能不多，在某个生产环节提高效率。应用场景有限。

↓

这个是我用python的tkinter库写的1个widows的exe程序界面。完全按客户需求来。

 

就是1个exe程序，免安装。

直接双击就可以打开使用了。

 

这个插件上提到的C盘，不是固定死的。 我的插件会默认识别你的系统盘。 比如有的人的电脑可能系统盘不是C盘。而是叫别的盘符比如D盘是系统盘。 我这个插件加了识别代码。这个盘是1个变量，由我的插件代码识别和控制。

还有，在win10系统或者win11系统某种安全控制的情况下。直接双击打开这个exe，可能会导致功能异常，因为安全性导致本插件无法在系统盘（默认C盘）创建临时缓存文件。万一你不小心遭遇到这个情况，很简单，打开这个exe的时候不要直接双击打开它！而是点击鼠标右键，然后选择“管理员运行”就行了！