企业级产研文档库

外观

自定义按钮管理 ​

为对象配置专属业务操作。

概述 ​

自定义按钮用于在对象页面上执行特定业务动作。按钮可以放在详情页、列表页、相关列表、新建页或编辑页。

自定义按钮管理

按钮类型 ​

类型说明
业务按钮用于操作数据或同步第三方系统
UI 按钮用于跳转自定义组件、自定义页面或第三方页面

按钮位置 ​

按钮可配置在：

  • 详情页。
  • 列表页单条操作。
  • 列表页批量操作。
  • 列表页通用操作。
  • 相关列表页单条操作。
  • 新建页。
  • 编辑页。

配置步骤 ​

  1. 在 对象管理 中，打开目标对象。
  2. 进入 按钮管理。
  3. 点击 新建按钮。
  4. 选择按钮类型。
  5. 选择按钮位置。
  6. 配置显示条件。
  7. 配置前验证。
  8. 配置执行动作。
  9. 配置执行成功后的提醒或邮件。
  10. 保存按钮。

显示条件 ​

显示条件用于控制按钮在什么数据状态下展示。若勾选 数据锁定态也显示自定义按钮，按钮会在锁定数据上展示。若按钮动作会修改当前数据，不建议开启该设置。

列表页批量操作按钮需要特别注意：批量按钮通常一直显示，显示条件会在执行时判断。不满足条件的数据会执行失败，并在执行结果中体现。

按钮显示条件

批量按钮显示条件

按钮入参 ​

按钮可要求用户点击后填写字段。入参可以选择对象下已有字段，也可以添加仅用于按钮的临时字段。

不建议或不支持作为按钮入参的字段类型包括：

  • 计算字段。
  • 主从关系。
  • 自增编号。
  • 引用字段。
  • 统计字段。
  • 支付组件。
  • 签到组件。
  • 业务类型。
  • 协同富文本、长文本、富文本。
  • 外部人员、外部部门。

按钮入参设置

执行动作 ​

按钮动作通常包含三个阶段：

阶段说明
前验证执行动作前运行自定义函数，校验不通过可阻断
执行动作执行字段变更或自定义函数
执行动作成功后发送 CRM 提醒或邮件

通过按钮修改字段时，需要确认字段支持被按钮更新，并且当前用户拥有字段编辑权限。按钮字段变更可以设置为变量或常量。

按钮动作设置

权限设置 ​

如需限制按钮使用范围，请为按钮设置角色权限。只有授权角色可以看到或执行按钮。

注意事项 ​

  • 批量按钮通常在执行时判断显示条件。
  • 通过按钮修改数据时，可能不经过验证规则。
  • 通过按钮编辑查找关联字段时，字段数据范围规则可能不生效。
  • 一个自定义按钮通常只能配置一个自定义函数。
  • 自定义按钮最多数量受版本和资源包限制，当前限制需以产品版本为准。

常见问题 ​

自定义按钮不显示，如何排查？ ​

  1. 确认按钮显示位置是否与当前页面一致。
  2. 确认按钮是否启用。
  3. 检查按钮显示条件是否满足。
  4. 检查数据是否锁定，以及按钮是否允许锁定态展示。
  5. 检查按钮是否被布局隐藏。
  6. 检查角色是否有按钮权限。
  7. 如果是移动端 UI 按钮，确认是否开启移动端独立布局。

执行按钮后字段没有更新成功，如何排查？ ​

请检查字段是否只读、当前用户是否有字段编辑权限、按钮动作是否配置了字段更新、显示条件是否满足。如果字段更新通过函数完成，请检查函数执行日志。

相关主题 ​