在Sugar中,您可以自定义一些宏变量,这些宏定义可以嵌入到之后使用的 API 中,使用宏定义的目的是方便以后的 API 服务迁移,例如您的 API 从 A 域名变更到 B 域名,使用宏定义的话就会非常方便。宏定义必须是大写字母和下划线。
Sugar提供空间级别的宏定义,以及报表、大屏级别的宏定义。
空间级别宏定义
您可以在空间设置中自定义一些宏变量,这些宏变量可以在这个空间的任意大屏、报表的 API 中使用,设置如下:
大屏、报表级别宏定义
您可以在大屏、报表的编辑页面中自定义一些宏变量,这些宏变量可以在当前大屏、报表中的任意图表的 API 中使用。设置如下图所示,点击大屏或报表标题,在右侧控制面板中找到宏定义变量设置,进行设置后点击保存按钮,即可在该大屏、报表中的图表 API 中使用。
使用宏定义
在使用 API 方式绑定图表数据时,就可以这样使用$API_HOST
、$API_CHART
,注意必须使用$
开头:
点击上图中的「调试」按钮,就能看到宏定义被替换之后真正访问的 url: