标准组件做不到的查询、判断和跳转,可以在微页面上执行 APL。函数要先设置默认 Map 类型参数 Data,用来接收表单值和链接参数。
开始之前
[!IMPORTANT]
需要能新建微页面,并能新建、发布 APL 函数。下面两种接法沿用现有场景说明,查询和返回值按实际业务编写。
个性化场景举例
举例 1:提交表单后跳转
适用于核验手机号后再进入第三方页面,或按 CRM 中的付费、报名状态进入不同结果页。
- 新建微页面,加入收集手机号或其他唯一编号的表单。
- 将提交按钮的点击后动作设置为执行 APL。
- 新建 APL 函数,参数使用默认 Map 类型
Data。手机号从Data.phone读取。 - 在函数中查询 CRM。跳转第三方页面时返回
jumpAction;跳转微页面内的页面时,jumpPage必须使用该页面的名称。jumpType为redirect时,访客不能返回上一页。
配置和函数示例见如何在微页面通过手机验证后再跳转第三方网页。
举例 2:打开页面时按参数展示
适用于链接中已经带有工单号等身份参数,打开页面后直接显示处理进度。
- 在微页面上挂载 APL,设置为加载页面时执行。
- 函数仍使用 Map 类型参数
Data。可以读取会员 ID、小程序或公众号openid,以及链接上拼接的参数。 - 用该参数查询 CRM,把需要展示的字段放入返回结果。
- 在文本或图片组件中用
{{参数名}}显示返回值,或把参数拼进下一步链接。
链接上拼接工单参数,例如 gdid=ooiqweqwqeq。下图地址栏红框内的 gdid 就是拼接进去的工单 ID;页面打开时,函数通过它查询工单详情并展示。示例中的 ea 和 id 是测试环境的页面参数。
完整配置见如何在微页面上使用 CRM 业务数据做展示及逻辑判断。
预期结果与验证
- 用测试数据提交表单。满足条件时进入目标页面,不满足时进入对应提示页。
- 打开带
gdid等身份参数的微页面链接,确认页面展示的是该参数在 CRM 中查到的数据。 - 更换参数后再打开一次,确认展示内容随参数变化。
常见问题与故障排除
- 函数收不到提交值:检查是否已设置默认 Map 参数
Data,以及微页面动作是否选择了该函数。 - 站内跳转失败:检查
jumpPage是否与微页面内的页面名称完全一致。 - 页面不显示查询结果:检查返回字段名与组件中的
{{参数名}}是否一致。