文档

案例演示

更新时间:

本文通过四个案例,演示如何使用全局变量功能。

前提条件

已进入画布编辑器

案例一:实现按日期查询

  1. 添加组件。

    1. 在画布编辑器上方单击搜索,输入通用标题时间选择器

    2. 单击将组件添加至画布中。

  2. 设置静态全局变量。

    1. 在画布编辑器左侧,选择全局变量页签。

    2. 单击新建变量,重命名为date,描述写日期值,设置初始值为2023-07-19image.png

  3. 设置通用标题数据源。

    1. 选中通用标题组件,选择数据源页签。

    2. 设置数据源类型为数据库,选择已有数据源。在SQL输入框中输入以下语句。

      select date as value
      说明

      此处需要使用英文冒号引入全局变量,详情请参见全局变量自动补全

    3. 查看数据返回结果和通用标题组件展示的即为全局变量设置的初始值。image.png

  4. 配置时间选择器交互。

    1. 选中时间选择器组件,选择高级页签。

    2. 打开交互事件开关,在time字段下选择变量dateimage.png

      说明

      此处设置表示在进行时间选择时,time改变都会更新date值。

  5. 预览展示结果。

    单击画布编辑器右上角的预览,验证设置结果。image.png

    说明

    预览页面打开后,首先展示全局变量的默认值,接着会展示时间选择器的默认值,这时候改变时间,通用标题就会展示已选中的时间值。

  6. 设置动态全局变量。

    1. 返回画布编辑器页面,修改全局变量date的来源为数据源请求

    2. 选择已创建的数据源,在SQL窗口中输入获取当前时间的查询代码。

    3. select cast(curDate() as char) as date
    4. 添加过滤器,获取date的值导入到通用标题。

      return data[0].date;
    5. 查看过滤器的输入值和输出值。image.png

    6. 查看通用标题组件的内容,即为动态获取的时间值。image.png

  7. 预览展示结果。

    单击画布编辑器右上角的预览,验证设置结果。image.png

    说明

    预览页面打开后,首先展示全局变量动态获取的时间值,此时改变时间,通用标题将同步展示已选中的时间值。

案例二:实现数据分发

  1. 添加组件。

    1. 在画布编辑器上方单击搜索,输入通用标题数字翻牌器

    2. 单击将组件添加至画布中。

  2. 设置静态全局变量。

    1. 在画布编辑器左侧,选择全局变量页签。

    2. 单击新建变量,重命名为x,设置初始值。

      [
        {
          "text": "我是文本",
          "number": 123
        }
      ]
  3. 设置蓝图交互。

    1. 单击左上角的image.png图标,进入蓝图编辑器。

    2. 拖拽图层节点和全局变量节点到蓝图主画布中。

    3. 单击逻辑节点,添加两个串行数据处理节点。

    4. 连接节点。image.png

    5. 设置串行数据处理节点处理方法。

      • 数字翻牌器

        return [{
          value: data[0].number
        }]
      • 通用标题

        return [{
          value: data[0].text
        }]
  4. 预览展示结果。

    单击画布编辑器右上角的预览,验证设置结果。image.png

案例三:实现动态数据加和

  1. 添加组件。

    1. 在画布编辑器上方单击搜索,输入数字翻牌器

    2. 单击将组件添加至画布中。

  2. 设置静态全局变量。

    1. 在画布编辑器左侧,选择全局变量页签。

    2. 单击新建变量,创建两个全局变量,分别重命名为yz,设置初始值为123234

  3. 设置蓝图交互。

    1. 单击左上角的image.png图标,进入蓝图编辑器。

    2. 拖拽图层节点和全局变量节点到蓝图主画布中。

    3. 单击逻辑节点,添加两个串行数据处理节点。

    4. 连接节点。image.png

    5. 设置串行数据处理节点处理方法。

      • 节点1

        return [{
          value: data + getCallbackValue(
            "z")
        }]
      • 节点2

        return [{
          value: data + getLocalValue(
            "y")
        }]
  4. 预览展示结果。

    单击画布编辑器右上角的预览,验证设置结果。image.png

  5. 设置动态全局变量。

    修改全局变量y的来源为数据源请求,并选择API或数据库等动态数据源。

  6. 设置蓝图交互。

    1. 单击逻辑节点,添加一个定时器

    2. 打开是否循环开关,设置定时器节点的延迟时间为3秒。image.png

    3. 连接节点。image.png

  7. 预览展示结果。

    单击画布编辑器右上角的预览,验证结果。每三秒数字翻牌器就会变化,从而实现动态数据加和。

案例四:实现数据筛选

  1. 添加组件。

    1. 在画布编辑器上方单击搜索,输入Tab列表折线图

    2. 单击将组件添加至画布中。

    3. 选中Tab列表,选择数据源页签。

    4. 修改静态数据。

      [
        {
          "id": 1,
          "content": "全部"
        },
        {
          "id": 2,
          "content": "类型A"
        },
        {
          "id": 3,
          "content": "类型B"
        }
      ]
  2. 设置静态全局变量。

    1. 选中折线图,选择数据源页签,复制全量静态数据。

    2. 在画布编辑器左侧,选择全局变量页签。

    3. 单击新建变量,创建一个全局变量,重命名为data,设置初始值为已复制的折线图全量数据。image.png

  3. 设置蓝图交互。

    1. 单击左上角的image.png图标,进入蓝图编辑器。

    2. 拖拽图层节点到蓝图主画布中。

    3. 单击逻辑节点,添加1个串行数据处理节点。

    4. 连接节点。image.png

    5. 设置串行数据处理节点处理方法。

      let result = getCallbackValue("data") //获取全局变量数据
      return result.filter(i => {
        if (data.content == "全部") {
          return result;//如果tab列表的内容为“全部”,则返回全部数据
        } else {
          return i.colorField == data.content;//如果tab列表的内容为“类型A”或“类型B”,则只返回对应的数据
        }
      });
  4. 预览展示结果。

    单击画布编辑器右上角的预览,验证设置结果。数据筛选_Trim.gif