全局参数2024.3+

全局参数是可以添加一些看板内通用的参数，实现看板内的数据传递，其数据来源既可以来自看板内卡片的字段值，也可以接受来自于浏览器或者从 PPT 通过 postMessage 传递过来的数据。

概览

全局参数的入口在看板设置的右侧高级属性内，此区域展示当前看板内已添加的全局参数列表及对其的基本管理。

• 1、参数配置按钮

  点击该按钮则打开全局参数配置弹窗，可以实现对全局参数的新增删除及修改。也可以点击列表内的某条全局参数进入对该参数的快速查看及编辑界面。

• 2、清空按钮

  点击按钮则会将所有的全局参数全部删除，请谨慎操作。

• 3、删除按钮

  鼠标悬停在列表内的某条全局参数上时，其右上角会出现x按钮，点击该按钮则删除此条全局参数。

配置弹窗

点击参数配置按钮或者列表内的某条全局参数后，会打开一个新的弹窗，弹窗内可以对所有全局参数进行维护。

弹窗包含左右两个区域：左侧为参数定义区，实现参数的添加、删除和名称的修改等操作；右侧为参数设置区域，实现参数的基本设置和参数的使用规则。

• 1、添加按钮：点击后在左侧列表新增一行，输入合法的名称后则会新增一条全局参数。

• 2、参数选择区域：点击每一条参数名称，则右侧参数设置区域变更为该选中参数的详细设置；双击则变更为文本输入框，可以对该全局参数进行名称修改。

• 3、删除按钮：鼠标悬停在某一条参数上，则该行右侧出现该按钮，点击即删除该全局参数。

• 4、参数基本设置区域：对选中的全局参数进行基本设置

  • 标题：默认与参数名一致，可以修改为其他合法字符串，使用到全局参数的地方会优先展示标题而非参数名。

  • 类型：目前支持文本、数值和布尔的选择，当参数值被修改时会按照此类型对数据进行转化。

  • 默认值：当全局参数无值时，则取默认值为全局参数值。

  • 接收请求参数：默认开启，开启后会接受 url 中与全局参数名相同的参数的值为全局参数值。

• 5、关联资源设置区域

  全局参数会与哪些组件的那些字段产生映射关系，都会在此区域进行详细设置。

  • ① 数据资源选择区：此处展示看板使用到的全部数据资源，可在下拉列表里进行切换

  • ② 组件筛选框：对标号 6 处的组件列表展示区域的组件列表进行筛选。

  • ③ 全选按钮：勾选后标号 6 处的组件列表展示区域的组件列表全部被选中，取消选中，则区域 6 处的组件列表全部取消选中（可以和组件筛选框组合使用）。

  • ④ 删除按钮：删除该关联资源。

  • ⑤ 联动字段区域：该区域指定当前选中的全局参数会对选中组件的哪些字段或查询参数产生映射。

  • ⑥ 组件列表展示区域：该区域指定当前选中的全局参数会对哪些组件产生影响。

• 6、添加关联资源按钮：点击即在关联资源设置区域新增一条关联资源。

批量修改

全局参数支持使用 postMessage 批量传入，传入格式为

{hetu: {params: {key1: value1, key2: value2}}}

对应的看板接收到 message 后，会将其内的参数 key1 赋值为 value1，参数 key2 赋值为 value2。