快递100参数配置 启用日志 简介

    金蝶云.星空供应链领域销售模块对接了快递100和快递管家功能，如果遇到相关功能有问题，客户可以借助快递100参数'启用日志'排查问题，此参数默认不显示，需要扩展让其显示，本帖子以PT-146894 [7.7.0.202111]之后的版本为准（BOS IDE里面快递100参数配置如果有'启用日志'复选框的版本都有日志记录功能，但可能不全，比如物流详情的日志就是后面添加的），大致介绍下如何借助此参数排查问题。

    1，首先在BOSIDE里扩展快递100参数配置，对'启用日志'复选框设置为可见，如下图1-1所示：

图1-1

    2，使用有权限的账号(一般是Administrator)登录业务系统，打开快递100参数配置，勾选'启用日志'复选框，然后保存参数，如下图1-2所示：

图1-2

    3，对于有问题的快递100对接功能，重复操作一遍(参数保存成功后需要重新打开操作界面)，比如客户可能是手工查询物流时有问题，或者在'获取电子面单'操作界面中的申请电子面单操作进遇到异常，则重新打开'销售物流信息'界面或'获取电子面单'界面，然后重新查询物流或重新申请电子面单。操作完毕后，相关日志文件（快递100和快递管家接口数据包会记录在日志文件中）会记录在客户星空服务器上（如果是公有云，请联系金蝶运维获取日志文件），目录一般为：X:\Program Files (x86)\Kingdee\K3Cloud\WebSite\App_Data\Log，在此目录下有以日期为名的子目录，可查看当时操作的日期下的文件Cloud.log(也有可能是数字为后缀的文件，比如Cloud.log.1,Cloud.log.2，主要看文件对应的修改日志)。可在此文件中搜索关键字'快递管家','快递100'或'快递'等。

举个例子：有客户提出在快递管家官网打印时没有把物流单号回填到销售模块相关单据上，且只有当客户是在Oracle库下，并使用了签回单或子单功能导入时才有此问题（母单号已经回填到星空'电子面单'基础资料单体头上，子单号未能回填到'电子面单'基础资料子单据体中）。经过上述步骤启用日志可以看到Cloud.log文件有如下图1-3所示的错误信息：

图1-3

    像一些比较容易从字面上看出问题的日志，客户基本可以自行解决，比如获取电子面单时日志提示Key已过期，物流查询时提示无权限，这些基本上都是没有充值；如果没有记录到任何管家导入或打印订单或推送物流的关键字，很可能就是快递管家官网配置的回调地址错误或者快递管家无法访问回调地址。对于上面的日志，客户一般很难懂，在提单时尽量要将类似的文件附在提单上以供给金蝶研发分析(上面的报错是星空的程序错误，仅在Oracle库下特定的操作下才会有此问题，因此是比较少的反馈，后续通版将修复此问题)，研发一般也是跟踪客户服务器上此类日志文件才能分析出问题。另外上图1-3中的 url:https://b.kuaidi100.com/v6/open/api/send   中的URL地址指出了某个接口功能，比如前面的URL指示了这个操作是V6版本（启用了多用户打单）的快递管家订单导入功能，如果是其它URL地址，可参阅论坛：

https://vip.kingdee.com/article/139768891005427456  了解它对应的接口功能 。最后如果问题排查完了，尽量要把那个参数'启用日志'复选框去掉勾选，这样可以精简日志文件。

    另外，如果是想对快递100相关执行计划启用日志，则上面BOS IDE配置的操作不适用，快递100相关执行计划可通过配置执行计划的参数字段值为大写的 DEBUG 达到启用日志的目的，如下图2-1和图2-2所示：

图2-1

图2-2

如果在快递100申请电子面单或者快递管家订单导入操作后星空的电子面单基础资料没有保存，则可能是由于一些字段超长导致的校验不通过（或者一些二开的校验失败），间接导致电子面单保存不成功。默认情况下，这种操作不会记录日志，如果要分析失败原因，则需要升级到 PT-146915 [8.0.0.202206] 补丁，并按上文启用日志才能记录相关日志。