如何在微页面中使用 APL 完成个性化业务场景搭建

标准组件做不到的查询、判断和跳转,可以在微页面上执行 APL。函数要先设置默认 Map 类型参数 Data,用来接收表单值和链接参数。

开始之前

[!IMPORTANT]
需要能新建微页面,并能新建、发布 APL 函数。下面两种接法沿用现有场景说明,查询和返回值按实际业务编写。

个性化场景举例

举例 1:提交表单后跳转

适用于核验手机号后再进入第三方页面,或按 CRM 中的付费、报名状态进入不同结果页。

  1. 新建微页面,加入收集手机号或其他唯一编号的表单。
  2. 将提交按钮的点击后动作设置为执行 APL。
  3. 新建 APL 函数,参数使用默认 Map 类型 Data。手机号从 Data.phone 读取。
  4. 在函数中查询 CRM。跳转第三方页面时返回 jumpAction;跳转微页面内的页面时,jumpPage 必须使用该页面的名称。jumpType 为 redirect 时,访客不能返回上一页。

配置和函数示例见如何在微页面通过手机验证后再跳转第三方网页。

举例 2:打开页面时按参数展示

适用于链接中已经带有工单号等身份参数,打开页面后直接显示处理进度。

  1. 在微页面上挂载 APL,设置为加载页面时执行。
  2. 函数仍使用 Map 类型参数 Data。可以读取会员 ID、小程序或公众号 openid,以及链接上拼接的参数。
  3. 用该参数查询 CRM,把需要展示的字段放入返回结果。
  4. 在文本或图片组件中用 {{参数名}} 显示返回值,或把参数拼进下一步链接。

链接上拼接工单参数,例如 gdid=ooiqweqwqeq。下图地址栏红框内的 gdid 就是拼接进去的工单 ID;页面打开时,函数通过它查询工单详情并展示。示例中的 ea 和 id 是测试环境的页面参数。

地址栏中的 gdid 工单参数与打开的微页面

完整配置见如何在微页面上使用 CRM 业务数据做展示及逻辑判断。

预期结果与验证

  1. 用测试数据提交表单。满足条件时进入目标页面,不满足时进入对应提示页。
  2. 打开带 gdid 等身份参数的微页面链接,确认页面展示的是该参数在 CRM 中查到的数据。
  3. 更换参数后再打开一次,确认展示内容随参数变化。

常见问题与故障排除

  • 函数收不到提交值:检查是否已设置默认 Map 参数 Data,以及微页面动作是否选择了该函数。
  • 站内跳转失败:检查 jumpPage 是否与微页面内的页面名称完全一致。
  • 页面不显示查询结果:检查返回字段名与组件中的 {{参数名}} 是否一致。
2026-11-16
0 0