快递100电子面单套打配置打印图片试例

    星空供应链领域的快递100电子面单接口包含三个，在快递100参数配置中如果没有配置模板和设备码，则会使用电子面单HTML接口（此接口会在生成电子面单时有一个电子面单链接地址，可以在浏览器中预览和打印），如果配置了模板但没有配置设备码，则会使用电子面单图片接口，如果配置了模板和设备码，则使用电子面单打印机接口。当生成电子面单图片接口时，打开星空系统中的 电子面单 基础资料时是会在右下角显示出一张图片，此图片就是一个控件，此控件只支持下载图片到本地，或者删除图片，或者上传图片，但不支持打印，如下图1-1所示：

图1-1

    因此客户如果使用的是快递100电子面单图片接口，则必须先打开生成的电子面单基础资料，下载图片到本地电脑，然后通过本地电脑的图片编辑软件打开图片并打印，这一系列操作下来就比较繁琐。针对此问题，客户可以购买快递100的打印机，并在星空系统中配置好模板及设备码(设备码就是快递100的打印机后面的一串标识)，这样在申请电子面单时可以直接打印。如果客户不想购买打印机，也可以使用星空的套打功能，下面演示下操作步骤：

    步骤1，打开BOS套打设计器，创建一个套打，上边放个数据表格控件(数据表格控件不是必须的，这里只是演示，客户一般只需要配置图片控件即可)，在数据表格控件中根据需要配置好表头及相关数据字段，下边再放个图片控件，配置好图片控件的相关绑定信息，如下图1-2和图1-3所示：

图1-2

图1-3

   步骤2， 在BOS套打设计器保存后，登录星空系统中打开电子面单列表，打开菜单'选项->套打设置'，配置成上图中创建的套打模板，如下图2-1所示：

图2-1

    步骤3，双击由电子面单图片接口生成的电子面单，进入电子面单编辑界面，什么都不做，只需要点 保存 菜单，即相当于在上图1-1界面中点击 保存 即可，每个电子面单都要进入编辑界面，然后什么都不操作再点保存（这里是重点，在预计2023年1月的版本后可以不用此操作，稍后的节点会备注其中的原因）。

   步骤4，以上步骤完毕后，返回电子面单列表，勾选要打印的电子面单，再通过菜单'选项->套打->连续套打所选单据'进行打印，如下图3-1所示：

图3-1

    由于本人电脑没有真实打印机，套打时采用 Foxit Reader PDF Printer 虚拟打印机，客户可根据实际需要选择相应打印设备，此处演示连续套打两个电子面单和只勾选一个电子面单的打印，分别如下图3-2和图3-3所示：

图3-2

图3-3

注意事项

    如果跳过上面的步骤3，即使是电子面单图片接口的电子面单，套打时会有不显示图片的问题（如果是电子面单HTML接口或打印机接口的生成电子面单，由于没有图片的返回，即使有步骤3时，电子面单HTML和打印机接口也同样是会有不显示图片的问题），如下图4-1所示：

图4-1

    上面图4-1出现不显示图片的原因是因为在星空2022.12月版本之前，通过快递100电子面单图片接口申请到的电子面单，不会在表T_SAL_KUAIDIBILL 中保存 FIMAGE 字段的内容，只会在表T_SAL_KUAIDIBILL 中的 FBASE64 字段中保存图片的字符串格式。但是当打开一个有图片的电子面单时，插件 Kingdee.K3.SCM.Sal.Business.PlugIn.Kuaidi.KuaidiBillEdit 会在其中的方法 AfterBindData 中将FBASE64 字段中的信息加载进 FIMAGE 字段(加载了只代表编辑界面上的数据包中 FIMAGE 有对应内容，不代表数据库表中保存了内容，只有当点击保存时才会真正保存到数据库表中)。这样就能够在电子面单编辑界面一打开时其右下角就能显示出母单图片。当存在签回单图片情况下，在电子面单编辑界面中点击'显示回单图片'时会将表T_SAL_KUAIDIBILL 中的FBASE64RETURN 字段加载进 FIMAGE 字段。当存在子单情况下时，选中子单详细信息中的某行后点击'显示子单图片'时，会将表 T_SAL_KUAIDIBILLENTRY（注意是子表）中对应记录的 FBASE64 字段加载进表头的 FIMAGE 字段。也是说在电子面单编辑界面中，不管要显示的是母单，还是子单或者是签回单，都是仅通过一个图片控件(标识为FImage)来实现的，在插件的按钮事件处理程序中动态更新其中的图片内容。因此，默认情况下表T_SAL_KUAIDIBILL中的FIMAGE字段没有东西，当打开一个电子面单时 FIMAGE 内容被填充了母单的图片内容，此时如果保存了，那么表T_SAL_KUAIDIBILL 中的FIMAGE就是母单图片内容，如果是打开电子面单后，点击了'显示回单图片'后再保存，那么表 T_SAL_KUAIDIBILL 中的FIMAGE就是签回单图片内容，这个时候如果点套打，就会打印签回单而不是母单，同理也适用于子单的情况。

    预计在2023年1月补丁中，会在申请电子面单图片后，将表T_SAL_KUAIDIBILL 中的FIMAGE字段内容默认填充为母单图片内容，这样套打母单时就不需要步骤3，仅在需要打印签回单或子单时，才需要打开电子面单基础资料并点击'显示回单图片'或者点击'显示子单图片'按钮后再点保存，这样套打就能打印签回单或子单。