自增表格外部扩展功能说明

  • 485 views

一、功能概述:

与字段同步功能类似,自增表格的外部扩展功能为工单与外部系统实现数据对接的方式之一,在配置了外部扩展规则后,在编辑自增表格字段时,点击【添加数据】,可将指定的字段值作为入参调用所配置的接口/页面,在拿到了接口/页面返回信息后,可选择所需数据行,并将所选数据一键填充至自增表格中。

二、适用场景:

当工单中所需的一些信息需要从外部系统实时获取,且返回数据为数据行的形式时,可使用自增表格的外部扩展功能,来确保填写效率和信息的准确性。

  • 场景1:

客户通过400电话发起售后报修流程,客服在创建报修单时,需要获取客户的详细订单信息,而客户的订单有可能是多个,这种场景下就可将【关联订单】设置为自增表格字段,并将【客户电话】设置为【入参字段】,当客服填写客户电话后,点击【添加数据】,即可根据客户电话查询客户在订单系统的全部订单并返回,此时客服在查看了订单列表后,可选择本次报修关联的订单并确认,此时所选订单信息可自动回填至自增表格的对应的字段中,以节省客服的填写时间。

  • 场景2

若日常需要处理很多客户的退款/退票/退单业务,可创建工单插件后,将插件嵌入至公众号中,方便用户自助提单。用户在提单过程中,需录入自己的手机号,并选择要退单的订单。因订单系统为独立的系统,未与售后服务系统进行打通,此时可将订单信息设置为自增表格字段,并开启外部扩展功能,在用户填写了自己的手机号后,点击【添加数据】,即可从订单系统查询客户在订单系统的全部订单并返回,此时客户在查看了订单列表后,可选择本次需退款/退票/退单的订单并确认,此时所选订单信息可自动回填至自增表格的对应的字段中,以节省客户的填写时间。

三、功能表现:

  • 接口对接-自动查询
    • 开启了扩展配置后,在自增表格的底部会展示【添加数据】的按钮。
  • 点击【添加数据】,在触发字段有值的情况下,会出现添加数据的弹窗,并自动从第三方接口拉取数据并回显,此时可勾选所需数据,点击【确定】。
  • 点击确定后,可将所选数据行回填至自增表格中。
  • 接口对接-手动查询
    • 开启了扩展配置后,在自增表格的底部会展示【添加数据】的按钮。
  • 点击【添加数据】,会出现添加数据的弹窗,此时需要手动输入查询字段的值,并按Enter键手动执行一次查询。
  • 勾选所需数据,并点击确定后,可将所选数据行回填至自增表格中。
  • 页面对接

对接一个定制页面,数据查询与展示在定制页面中执行,勾选定制页面的数据后,可将所选数据自动回填到自增表格中。

四、功能配置

外部扩展开关

在表单模版中配置自增表格字段的属性时,可将【外部扩展】开关开启,开启后,可展示外部扩展配置入口。

外部扩展配置

  • 基本信息:可选择接口对接和页面对接两种对接方式
    • 接口对接:调用第三方接口获取数据,并以列表方式展示返回值,在此页面选择数据后,可将返回的数据回填至自增表格中。
    • 页面对接:调用第三方定制页面,在第三方页面中选择数据后,可将返回的数据回填至自增表格中。
  • 接口配置/页面配置
    • API地址:配置外部对接接口地址,可选数据将从此接口中进行获取。
    • 页面地址:配置所对接的外部页面地址,配置后,点击添加数据,可在弹窗中展示该外部页面。
  • 交互配置
    • 查询方式:可选【自动查询】和【手动查询】两种方式
      • 自动查询:将表单中指定字段的值作为入参来查询接口数据,指定字段来自于当前表单或属性表单,点击【添加数据】后,系统可自动带入字段值并执行一次数据查询。
      • 手动查询:将指定字段的值作为入参查询接口数据,查询字段来自于自增表格,点击【添加数据】后,需在弹窗中手动输入或选择字段值后才会查询接口数据。
    • 入参字段:调用外部接口时,将该字段的值作为入参查询接口数据。
    • 匹配规则:配置自增表格字段与接口返回参数间的匹配关系,数据回填至自增表格时,将遵循该匹配规则。

五、接口示例与体验接口:

接口示例

请求地址:http: //<url>?param=<param>

其中url为接口地址,参数名的解释如下:

参数名类型说明
paramString请求模糊查询的参数名,也是自增表格外部扩展接口入参的参数名

自增表格外部扩展-接口返回示例:

体验接口

为方便您更好的理解功能的配置方式及交互效果,我们为您提供了体验接口,您可以按上文中的配置说明,将体验接口配置在您的系统中,真实感受功能的使用方式

  1. 接口地址:https://ticket-sh.clink.cn/api/field_sync/demo/getTableData
  2. 入参参数名:param
  3. 入参字段值:输入任意值均可返回结果
  4. 接口返回值

匿名

发表评论

匿名网友 填写信息

:?: :razz: :sad: :evil: :!: :smile: :oops: :grin: :eek: :shock: :???: :cool: :lol: :mad: :twisted: :roll: :wink: :idea: :arrow: :neutral: :cry: :mrgreen: