如何生成标签Label?
在EDI项目过程中,需要将订单、发货通知等业务报文中的主要业务数据进行打印,或者需要打印Label(标签),发货时贴在箱子上进行发货,一般需要打印的文档格式为PDF,那么如何将需要的业务数据写入PDF文档中呢?
PDF 端口简介
在系统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格式,可以参考了解下:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
|
<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>
|
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”按钮即可发送。
文件发送成功后,在PDF 端口的Output页面会显示对应生成的PDF文件,点击PDF文件的文件名(File Name)会弹出下载文件的提示框,点击“Download”下载生成的PDF文件,或者您可以在PDF Port目录中的Output Folder目录下查看。
下面是最终生成的PDF文件,您可以直接进行打印。