如何通过Smartsheet API为列添加应用于整表的条件格式规则
Smartsheet API 实现工作表级条件格式规则说明
存在可用于添加工作表级条件格式规则的官方API,你在Row、Cell对象中看到的conditionalFormat字段是只读状态字段,作用是返回当前单元格命中条件规则后被应用的样式,不是用来定义全局规则的配置入口,无法通过修改该字段创建整张表生效的规则。
- 所有作用于整张工作表的条件格式规则,都作为Sheet资源的附属属性存在,通过工作表条件格式专属接口进行增删改查操作,规则创建后会自动对全表符合匹配逻辑的内容生效。
- 实现「当Column_name为空时高亮Column_name」效果的操作步骤:
- 先调用查询工作表列的接口,拿到
Column_name对应的唯一columnId,所有条件匹配、格式应用的目标指定都需要通过列ID完成,无法直接用列名配置 - 构造符合要求的条件格式规则对象,核心结构参考下方示例,将匹配条件设为目标列值为空,格式设为需要的高亮样式,应用范围指定为目标列
- 调用更新工作表条件格式规则的接口,提交构造完成的规则即可生效
- 先调用查询工作表列的接口,拿到
- 注意事项:不要尝试在新增/更新行、单元格的接口中传入
conditionalFormat字段值,该字段不支持写入,传入的参数会被接口直接忽略,不会生成任何条件格式规则。
对应空值高亮场景的规则核心结构示例:
{ "type": "CONDITIONAL_FORMAT", "name": "Column_name空值高亮", "conditions": [ { "columnId": "替换为Column_name对应的实际列ID", "operator": "IS_BLANK" } ], "format": { "backgroundColor": "#FFF2CC" // 此处配置高亮背景色,浅黄为例 }, "appliedTo": [ { "columnId": "替换为Column_name对应的实际列ID", "type": "COLUMN" } ] }
内容的提问来源于stack exchange,提问作者seitz_cisco
相关产品推荐
相关产品推荐

