PBP+API,高效巡店不迷路

图片

文/杨舒涵 陈江浩 潘娟

编辑/杜逸敏

一、需求场景

在实体行业中,线下巡查是常见的工作场景,尤其是对于连锁快消门店。某企业旗下有上千家线下门店,需要运营经理定期到每个店铺里检查安全、卫生和业务情况。门店太多,巡店经理逐渐产生了“巡店找路”的需求:巡检人到达门店附近后,能够通过实时定位,在众多门店中快速筛选出附近门店,并按导航到达对应门店。

二、实现方式

该场景的实现方式不难,主要通过工作表和工作流来构成,再搭配PBP(封装业务流程)和集成中心来实现。

1.工作表

定位表

建立定位表,必须配置的基本字段包括:

  1. 定位
  2. 自定义函数GETPOSITION获取经纬度数值(x、y)
  3. 定位名称

在定位表中录入所有门店定位,不仅起到了维护门店基础信息的作用,在后续流程中也能够通过此表查找经纬度在相应范围内的数据,从而实现返回附近门店列表的效果。

查询表

建立查询表,必须配置的基本字段包括:

  1. 当前定位
  2. 自定义函数GETPOSITION获取经纬度数值(x、y)
  3. 当前定位名称
  4. 距离范围(单位:千米)
  5. 距离转换为经纬度(单位:度)
  6. API查询(具体配置见后文)
  7. 目标地点经纬度(返回的x、y)
  8. 目标地点名称(返回的name)

距离需要根据千米转换为经纬度差值,我们可以使用公式字段自动运算得出。输入范围单位为千米,计算结果单位为度。

在纬度相等的情况下,经度每隔0.01度,距离相差约1000米;在经度相等的情况下,纬度每隔0.01度,距离相差约1111米;例如:距离范围输入5千米,自动换算出经纬度差值约为0.05度(大于5千米)。对应字段配置如下图。

2.封装业务流程

创建一个新的PBP工作流,配置输入参数类型与名称。在这个环节输入的x、y即为对应定位的经纬度,d为前文工作表中利用公式字段自动计算得出的经纬度差值。

参数类型需要配置正确:注意在赋值时,需要对应的字段类型才能用;名称必须以字母开头,可以包含数字和下划线。

将工作表中的经纬度与距离差值的参数传入PBP,并对范围区间进行运算。

拿到运算结果后,在定位表中进行数值比较,获取定位在范围内的门店数据表。

插入代码块节点,计算门店定位与巡检人实时定位的距离,并将获取到的多个符合条件的定位记录转化为数组对象形式输出。

最后,利用JSON解析节点配置输出参数类型与名称。

明道云封装业务流程会自动生成一套API接口,和定义的输入和输出参数完全对应,供外部系统调用。因此,我们能够将已配置完成的封装业务流程添加到明道云API集成中心内,在工作表内调用API查询接口使用对应的PBP能力。

其中,API响应方式仅旗舰版和私有部署版支持直接返回结果给请求地址, 其他版本需通过回调地址接受返回参数。

3.API设置

在集成中心中配置PBP对应的接口,需要输入的连接参数(例如APIKey等)在明道云自动生成的API开发文档中可以直接查询。本文为简化流程,在配置时选择了无需授权的方式。

在工作表中的API查询字段里配置经纬度输入参数与返回数组设置。

三、实现效果

在工作表中输入当前定位和需要查找的距离范围,点击API查询后,下拉框中会出现定位表中在范围内的所有门店记录。

本功能的实现不仅满足了前文提出的需求场景,做到在多个店铺数据中快速筛选出附近门店,还能够通过配合其他字段权限的配置,确保巡店的真实性,例如距离过远的情况下无法选择到门店,即本条巡店记录无效。

四、导航功能

在实现上文功能的基础上,我们还可以利用两地点的定位信息,调用高德开放平台,在网页中嵌入H5地图,添加导航能力。同时还可以通过URI API直接调起高德地图APP,来达成其他的地图功能。

将本功能添加至【查找表】即可。需要用到的参数包括:两个定位的经纬度、地点名称、出行方式等。这里的拼接方式选择了文本字段的自定义函数拼接。选择文本字段,将默认值设置为函数计算,配置如下。

其中出行方式用单选字段+自定义函数的IF语句控制。单选字段如下,可供用户手动更改。

添加文本字段,默认值为函数计算,配置如下。

在业务规则设置界面调整好相应的字段显隐后,就能做到自动显示导航地图了,在移动端,如有需要可以切换到高德地图APP查看。

文中配置可供参考,其中还存在一些待完善的细节,大家在实际配置中根据需要优化即可。

关于HAP

HAP(Hyper Application Platform)超级应用平台可以帮助用户零代码构建企业应用,用户不需要代码开发就能够搭建出用户体验上佳的销售、运营、人事、采购等核心业务应用,打通企业内部数据。HAP还具备超自动化引擎,可以全面自动化复杂和重复的业务流程。运用HAP的集成中心与完整的API对接能力,用户可以轻松地将HAP与外部系统集成。除此之外,HAP还具备很高的可组合性,国际化支持,并支持云原生架构,实现了多云部署能力。通过插件架构,HAP正在逐步建立起繁荣的实施与开发生态。

HAP可以帮助企业大大节省软件费用、降低定制开发的成本和时间,拥有一个极度灵活和易用的数字化平台,是企业数字化建设的重要工具。目前已有上百万用户使用,付费企业超过4000家,包括可口可乐、复星集团、广汽本田、赛力斯汽车、中国移动、中石化、中铁集团、银鹭食品、民生银行、迪卡侬、艾默生电气、泰科电子、四川航空、东方证券、洲际酒店、科大讯飞、柳工集团、沃尔玛、中国烟草、三菱银行等知名客户。

2021年5月,明道云获得海纳亚洲近亿元投资。公司目前有超过130名员工,产品研发团队过半,总部位于上海漕河泾开发区,在北京、广州、深圳、成都、郑州、武汉、西安和宁波设有分支机构。公司为高新技术企业,上海市专新特精认定企业。