枢搭云帮助中心

效果与作用

按钮组件用于在表单中放置一个可点击按钮，点击后按配置执行动作。它属于表单字段组件，通常用于在填写或查看数据时触发某个内部方法、把返回值写入字段，或为表单内的业务操作提供入口。它和「表单设置」中的自定义按钮不同：自定义按钮主要出现在数据列表或详情操作区，按钮组件则放在表单布局中。

配置项

属性面板可以设置「标签名」「显示标签名」「按钮文字」「执行动作」。标签名用于字段管理和布局识别；显示标签名控制运行态是否展示字段标签；按钮文字是成员在页面上看到的按钮文案。

「执行动作」中可以选择可用动作。当前表单内主要支持调用已开放的内部方法，配置时需要选择「模块」和「方法」。如果方法有说明，会在「方法说明」中展示。方法参数可以选择值来源，支持「表单变量」和「固定值」；表单变量包含记录 ID、页面编码、当前表单值以及当前表单字段。方法存在返回值时，可以在「返回值写入字段」中把返回结果写入指定字段。

按钮还提供描述编辑区域，可用于在按钮附近展示操作说明或提示信息，帮助成员理解点击按钮会产生什么结果。

应用场景

按钮组件适合在表单内部触发计算、查询、同步、生成内容、调用业务方法等操作。例如根据当前字段生成某段说明、调用内部能力获取结果后写回字段，或在特定表单中提供辅助操作入口。

注意事项

按钮动作需要结合当前租户和系统开放能力配置，不是所有表单都一定有可选动作。预览状态下按钮只验证展示效果，不执行真实动作，避免误改业务数据。若只是想在列表中增加“批量处理”“生成数据”等操作，应到「表单设置」的「自定义按钮」中配置，而不是把按钮组件放入表单。按钮会改变字段值或触发业务方法时，建议在字段说明或按钮描述中写清楚影响范围。