如何使用PDF端口生成标签Label？

发表于 2020年3月11日作者知行软件

前面小编已经介绍了帮助客户对接他们合作伙伴的EDI系统，详细介绍了每个项目的需求和实施方案，相信对于EDI及一些常用的解决方案应该都比较了解了。本文小编将带您了解一个新的需求：在EDI项目实施过程中，有些客户需要将订单、发货通知等业务报文中的主要业务数据进行打印，或者有些客户需要打印Label（标签），发货时贴在箱子上进行发货，一般客户需要打印的文档格式为PDF，那么如何将需要的业务数据写入PDF文档中呢？接下来小编将带您借助知行EDI系统的PDF端口来实现这个需求。

PDF 端口简介

在知行EDI系统FLOWS页面左侧的常用端口列表，选择PDF端口拖拽到右侧工作区，拖拽后需要设置Port ID（端口名称），测试示例中命名端口名称为“PDF_Test”，点击“Create Port”便可在右侧的工作间创建一个名为“PDF_Test”的PDF端口。

如下图是创建的一个名为“PDF_Test”的PDF 端口:

如上图每一个PDF Port都有Settings、Input、Output、Events四个标签页：

Settings 选项卡：PDF 端口基础配置页面，在这里必须要配置“Template File”（PDF模板），模板文件需要是一个PDF文件，实现将业务数据写入到这个PDF文件中。同时在这里还可以定义Local Folders（本地文件目录）：该端口文件的待发送目录（Input Folder（Send））、已发送目录（Processed Folder（Sent））、接收文件目录（Output Folder （Receive）），系统默认指定的是RSSBus Connect安装目录下该Port的Send、Sent、Receive目录。当您希望输入的文件可以自动被转换为PDF格式时，可以在Automation Settings中勾选“Send”设置自动处理功能。
Input 选项卡：需要转换为PDF文档的原始输入文件列表页面，原始输入文件必须是符合要求的XML文件。
Output 选项卡：转换成功的PDF文件列表页面。
Events 选项卡：在执行过程中需要触发的一些事件脚本。

了解上述PDF 端口的介绍后，您应该会有这样的疑问：Template File如何生成？原始输入的XML文件是什么样的呢？下文小编将用一个示例Label（标签）文件来解答您的这些疑问。

生成PDF文件

将业务数据写入PDF文件进行打印，我们只需要以下三个步骤：

创建原始输入的XML文件
创建PDF模板并配置在Template File中
发送XML文件生成PDF文件

创建原始输入的XML文件

PDF 端口对原始输入的XML文件有一定的格式要求，下面是小编帮客户实现Label（标签）打印时设置的XML格式，可以参考了解下：

<Items>
  <Item Name="final_recipent_company">某仓库</Item>
  <Item Name="final_recipent_street">中国某省某市某街道1号</Item>
  <Item Name="delivery_no">ASN0000001</Item>
  <Item Name="delivery_no_bar" type="CODE128">ASN0000001</Item>
  <Item Name="buyer_item_number">BYItem001</Item>
  <Item Name="buyer_item_number_bar" type="CODE128">BYItem001</Item>
  <Item Name="quantity_per_pack">100.000</Item>
  <Item Name="quantity_per_pack_bar" type="CODE128">100.000</Item>
  <Item Name="ETA_datetime_date">02.06.2020</Item>
  <Item Name="buyer_pack_number">PackNumber001</Item>
  <Item Name="buyer_pack_number_bar" type="CODE128">PackNumber001</Item>
  <Item Name="final_recipent_city">某市</Item>
  <Item Name="storage_location">STORE01</Item>
  <Item Name="final_recipent_plant">PLANT01</Item>
  <Item Name="item_desc">Item desc text</Item>
</Items>

<Items>

<Item Name="final_recipent_street">中国某省某市某街道1号</Item>

<Item Name="buyer_item_number">BYItem001</Item>

<Item Name="buyer_item_number_bar" type="CODE128">BYItem001</Item>

<Item Name="buyer_pack_number">PackNumber001</Item>

<Item Name="buyer_pack_number_bar" type="CODE128">PackNumber001</Item>

<Item Name="storage_location">STORE01</Item>

<Item Name="final_recipent_plant">PLANT01</Item>

</Items>

XML格式最外层需要一对标签作为父节点，业务数据值存放在每一个标签中，在每一个标签中需要定义这个标签的名称，比如上述示例中的“final_recipent_company”、“delivery_no”等。当需要生成条形码或者二维码时，需要指定这个Item的类型，比如上述“delivery_no_bar”是将“delivery_no”以条形码的方式显示，其类型（Type）为CODE128，表示生成的条形码符合Code128条码规则，注意条形码和二维码的类型需要和合作伙伴确认，确保可以进行正常扫码。

创建PDF模板并配置在Template File中

创建PDF模板，可以借助Word和Adobe Acrobat X Pro（PDF转换软件）设计您期待或者合作伙伴要求的PDF格式，在设计过程需要注意一些细节的部分，比如PDF打印时要求的纸张大小、每一块业务值区域的大小，这些都需要严格按照双方沟通的参数进行设计。

下面是小编设计Label PDF模板的过程：在Word中根据客户的要求设计模板大小（长、宽、每个值区域的大小）和一些固定值的部分，如下示例：设计好Word格式的Label模板后，将文件导出为PDF格式保存。

将上面导出的PDF格式文件用Adobe Acrobat X Pro（PDF转换软件）工具打开，通过添加“域”来存放业务数据，注意域的名称需要与上面示例XML中的Item名称一致，如下PDF模板是将上面示例XML中每一个Item对应到每一个域之后的结果：

设置完成后关闭表单编辑，将文件保存。

以上操作便创建好了Label PDF模板，将创建好的PDF模板上传到PDF Port的Template File中（在Template File选择框中点击“Upload Template”，选择需要上传的PDF模板，上传的PDF模板可自动保存在该PDF Port目录下），即可配置完成，接下来便可以将XML文件转换为PDF格式了。

发送XML文件生成PDF文件

将需要生成PDF格式的XML文件上传到PDF Port的Input界面（点击“More”，选择“Upload Files”上传文件），或者您可以直接将该XML文件放在PDF Port目录中的Input Folder目录下，刷新页面之后Input页面会显示这条待发送的XML文件，选中待发送文件左侧的复选框，点击“Send”按钮即可发送。