1. 简介

1.1 功能概述

用户可以输入快递单号、快递公司代号与手机后四位，通过物流查询插件，查询到对应的物流信息并填入表单中。

通过物流查询插件，用户可查询到的信息如下，其中历史物流信息以子表方式返回：

查询范围	查询内容
当前物流信息	快递公司
	物流状态
	运输时长
	最新物流
	最新物流变化时间
	快递员
	快递员电话
历史物流信息	地区
	时间
	物流状态
	详细信息

1.2 插件说明

本插件为收费服务，单次查询费用为 0.01云币。
每次调用插件时，系统将自动扣除对应云币。
云币余额不足时，插件将无法使用。用户可以进入企业管理充值云币，具体操作详见：云币。

2. 插件安装与启用

2.1 插件安装

在工作台中的“为您推荐”组件中，选择“精选插件”，点击右下角的“进入开放平台”，即可进入英雄云插件页面。

点击“插件市场”，选择“物流查询插件”插件，进入插件详情页。

进入详情页后，点击“安装”即可安装插件。在插件详情页中，用户还可以查询到该插件的付费方案。

2.2 启用插件

插件安装完成后，需要启用插件，才能在表单中正常使用。
点击“插件管理”，在“已安装插件”中找到刚安装的插件，将开关按钮打开即可。

3. 表单搭建

用户需要输入快递单号与手机号后四位才能对快递信息进行查询。添加“单行文本”字段存放上述信息。同时添加“按钮”字段用于触发前端事件。

添加字段，用于存放查询到的数据。用户可以根据自身需求添加并修改字段名称。
此处添加“单行文本”字段以放置“快递公司”、“物流状态”、“运输时长”、“最新物流变化时间”、“快递员”、“快递员电话”六个参数。由于返回的“最新物流”信息是一个长文本，因此适合使用“多行文本”字段来存放。

由于返回参数历史浏览信息是一个子表，添加“子表单”字段存放该信息，在子表单中设置“地区”、“时间”、“物流状态”、“详细信息”字段。

“地区”参数可以用“地址”字段或“单行文本”字段存放；

“时间”参数返回的是时间戳，因此使用“日期时间”或“时间”字段存放；

“物流状态”使用单行文本字段存放；

“详细信息”返回的是一个长文本，可以使用“多行文本”已显示全字段。

4. 前端事件配置

4.1 添加前端事件

搭建好表单后，需要在“表单属性”中配置前端事件。
点击右边栏选择“表单属性”选项卡，对前端事件进行设置。

点击右上角的“＋添加前端事件”，进入前端事件设置页面。

4.2 设置前端事件

4.2.1 事件名称与说明

用户可以根据企业需求自定义事件名称与说明，便于用户在使用时区分各前端事件。

4.2.2 触发字段

前端事件的触发字段就是触发前端事件的条件，当触发字段的值被手动修改时，会触发前端事件。
此处设置触发字段为“物流查询按钮”字段。

4.2.3 触发插件

触发插件就是当前前端事件需要使用的插件。此处选择“物流查询”插件。

4.2.4 插件发送参数

插件发送参数就是调用插件时输入的数据。此处需要输入快递单号，快递公司代号，手机号后四位的数据，选择表单中对应的字段。

快递单号：必填；
手机号后四位：当查询顺丰/跨境速运/中通时，必填；若为其他快递，选填，点击参数旁问号可以查看说明；

4.2.5 数据填充

数据填充是指当插件被调用并返回查询结果后，系统自动将获取到的数据填入当前表单的对应字段中。
点击“新增”，选择需要查询的信息，或者全选所有返回信息。

并选择将查询后的结果存储到表单已有字段中。

4.2.6 保存或调试

设置好前端事件后，用户可以选择直接保存前端事件，或选择保存并调试前端事件。

在推出表单前记得保存。

更多前端事件操作详见：前端事件。