按钮

内容简介

功能简介

按钮控件用于在表单中绑定并触发特定的业务动作。
用户在填写或查看表单时，通过点击按钮，可手动触发一次执行动作，用于调用外部能力、发送消息或执行自定义逻辑。

按钮本身不存储数据，仅在被点击时生效，适合用于需要用户主动确认后再执行的业务场景。

使用场景

• 触发第三方能力
• 执行业务辅助操作
• 消息与通知触发

示例：配置第三方连接的物流查询服务，再配置表单字段，填写表单时，点击按钮查询快递物流详情。

预期效果

设置步骤

功能入口

设计表单 > 表单设计 > 高级控件 > 按钮

功能详情

按钮支持以下两种方式之一：

• 专业版代码
• 扩展配置（插件）

💡 提示
同一个按钮仅支持配置一种调用方式，不支持同时使用。

扩展配置

当前支持的能力包括：

• 第三方连接：实名认证、物流查询、自定义模板文字识别、企业工商信息查询
• 在线支付：订单查询、订单退款
• 短信
• 邮件
• 发送消息至群机器人

权限与使用范围

控件限制

• 不支持放入子表控件

字段权限支持情况

• 表单
  • 支持：可见、可写、打印
• 开启流程的表单
  • 发起节点：支持可见、可写、打印
  • 审批节点：支持可见、可写、打印
  • 经办节点：支持可见、可写、打印
  • 抄送节点：不支持使用按钮控件
• 表单外链场景支持
  • 外链填单：支持可见、可写、打印
  • 数据分享：支持可见
  • 公开查询：仅支持可见，不支持作为查询条件

注意事项

• 按钮控件不存储数据，仅在被点击时触发对应动作。
• 按钮不支持参与公式计算、字段校验等逻辑。
• 按钮字段不可设置为必填，配置后不生效。
• 按钮未被点击时，其在消息、校验、规则中的取值均为空。
• 同一按钮不可同时配置专业版代码与扩展配置。
• 旧版表单按钮不支持扩展配置能力。