一、功能介绍
通过小程序“信息快速填写”组件auto-fill功能,小程序开发者可以获取用户首次填写的表单信息,并快速填充本次需填的表单,减少用户输入的压力。(即:自动填充表单,是在表单提交时,记住用户在input、textarea、picker控件填写的内容,下次填写时可快速填充。)
二、接入必读
2.1 小程序“信息快速填写”组件auto-fill功能,目前为demo阶段,通过内测邀请的方式,免费开放给需满足一定条件的小程序使用。即:小程序的主体以及类目,需要在限定的类目范围内,且使用场景与允许开放的业务场景一致(即2.2小节中所要求资质)。
2.2 目前,该组件功能开放给非个人开发者且完成了认证的小程序。开放的主体类目范围,如图所示:
2.3 使用该组件前,需通过邮件申请小程序及字段group权限。请根据场景所需,申请必要的group字段信息,并谨慎使用。若被用户举报较多,或被发现存在不合理使用的情况,微信有权永久回收该组件的权限。
三、接口申请方式
发送邮件至官方邮箱,说明所需的场景及group字段,申请开通小程序的该组件权限,及对应字段的group权限。
官方邮箱地址:wx_city@tencent.com。邮件内容参照下述列表:
邮件主题:
申请开通“信息快速填写”组件auto-fill权限
邮件内容:
- 小程序appid或原始id
- 小程序名称
- 小程序使用该组件的场景及必要性描述
- 小程序所需的字段(具体的字段解释,详见五节接口文档链接。原则上请申请必要的字段权限,不建议申请与功能或场景不相符的字段权限)
- 其他备注说明(如紧急程度、腾讯公司的对接人等)
发送邮件后,会在1-3个工作日内收到回复邮件,敬请关注。(符合开通条件的小程序,会回复 已开通对应小程序“信息快速填写”组件及group字段的权限 ,还有对应的接口文档。不符合开通条件的小程序,也会收到回邮。)
四、使用须知
4.1 该组件需在1.2.0版本以上的小程序基础库调用。在小程序基础库2.10.3以上版本,还可以支持自定义的输入控件。即:
- 小程序基础库版本>1.2.0:可支持本auto-fill组件功能。
- 2.10.3>小程序基础库版本>1.2.0:可支持本auto-fill组件功能,但仅支持原生的input、textarea、picker等输入控件;
- 小程序基础库版本>2.10.3:可支持本auto-fill组件功能,还可以支持自定义的input、textarea、picker等输入控件。对于小程序基础库2.13.0及以上版本,本组件将更新为新版本;
4.2 目前该组件的调起,仅支持通过input触发。暂时不能通过textarea和picker触发。
4.3 对目前涉及到的group字段,新旧版本的触发填充规则不一:
- 旧版本(1.2.0<小程序基础库<2.13.0):公共字段group中的子字段,不能多个同时填充,需要逐个触发填充。其他group中的子字段,可以同时填充。另外,目前多个group暂不支持同时填充。如果需要用到的子字段,分布在多个group,则需要逐个group填充。具体的group及子字段描述,详见第五部分接口文档。新版本支持全部同时填充。
- 新版本(小程序基础库2.13.0及以上):所有的group字段,均可同时填充。
五、接口文档及字段说明
具体的接口文档,及字段说明,可点击此处查看详情。
六、实现案例简介
目前已有小程序使用该组件,如广州华侨医院。实现截图如下(部分字段展示已掩码):
如在使用中遇到问题,可通过官方邮箱、社区、课程评论等方式反馈。
本课程内容不定期更新,敬请关注。
为什么按照官方的例子做了,组件也通过邮箱申请了,但是功能没有实现?
auto-fill官方文档的例子不可用,文档也没有说明具体使用方式。我昨天已经开通了该功能,但是还是没有效果
只有一条快速填写的信息,信息框把整个页面都占满了,而且无法拖动。好长时间了,能否加快修复
这个可以实现只带入选中行的信息,而不自动带入其他信息吗,我现在的业务需要在输入完成失去焦点后就进行校验
你好:
我在接入城市服务信息快速填写的时候操作如下:
一、下载官方demo
二、更改已申请好的appid 以下是申请的邮件内容
1、小程序appid:wx9dbef089806debd5
2、小程序名称:企鹅医生一家庭医生
城市服务快速填写权限已经开通,同时开通的字段group权限包括 基础信息、手机联系、社保卡。 可以满足小程序的字段需求。
接口功能说明:
1、以下是快速填写接口功能的“使用说明”、“接口文档”及“字段支持情况”等。
使用说明:
https://developers.weixin.qq.com/miniprogram/dev/framework/cityservice/cityservice-auto-fill.html
接口文档:
https://developers.weixin.qq.com/community/business/doc/0004c23556c43074dde973aeb5bc0d
2、目前此接口也还出于内测邀请阶段,可以根据接口文档情况参考了解,通过类似于引入小程序JS库的方式实现。
3、根据接口文档字段支持,可以根据对应group当中的字段,支持小程序需要录入的信息。
4、使用接口后,用户在授权同意的情况下,首次录入后,后续再使用,就无需手动录入,直接选择之前录入过的内容,用已录入过的信息将所需要填写的表单填充好。用户直接点击提交按钮即可。
另外,由于地址信息是textarea,单纯的textarea不一定能触发起快速填写。也可以选择微信地址组件,微信地址组件地址为:
https://developers.weixin.qq.com/miniprogram/dev/api/open-api/address/wx.chooseAddress.html
三、填写城市服务项的基础信息
微信路径:微信支付->城市服务->右上角(人形按钮)->我的常用信息
四、运行demo 未弹出授权提示信息框、点击输入框未有个人相关信息提示
结果:接入城市服务快速填写失败,麻烦给与我相关的技术指导
使用官方demo,换了appid,更换了授权的group.name。但是没有效果。
我已经按照文档申请成功组件权限了,然后根据文档的例子写了,但是没有反应,是少什么东西吗
开通“信息快速填写”组件auto-fill权限,申请已通过,但是按照官方文档的给的例子demo照做了,组件仍然没有起作用,是什么原因?(“微信城市服务-我的-我的常用信息”中已添加个人信息)