华为云用户手册

基本柱图对接呈现效果 返回Astro Canvas项目列表页面。 进入大屏/小屏开发页面，拖拽所需组件（如基本柱图）到画布中。 图2 拖拽基本柱图到画布中 选中该组件，单击组件上方的，进入组件数据页面。 图3 进入基本柱图数据页面 在“数据类型”下拉框中，选择“数据集”，选择已创建的数据集。 图4 使用已创建的数据集 配置全局变量。 页面组件之间需要共享数据时，才需要设置全局变量。 在组件预览中，选择要展示的表字段，即从左边栏中拖入到右边栏中，单击“保存”。 图5 设置后效果 表2 基本柱图数据集配置说明 参数 参数说明 表格字段 展示创建数据集中，获取的数据。 配置 从表格字段中，拖拽所需的字段到数据、数据类别中。 刷新周期 每隔多少秒从AstroZero中读取一次数据，默认配置为“0”，表示只获取一次。 共享数据 是否共享数据。勾选后，如果多个组件调用了相同的桥接器URL请求，不会各自只调用，而是共享结果数据。 单击页面上方的，保存设置页面。 单击，进入预览页面，预览效果。 图6 最终呈现效果

创建数据集 参考如何登录Astro Canvas中操作，登录Astro Canvas界面。 在主菜单中，选择“数据中心”。 在左侧导航栏中，选择“数据集管理”。 在数据集管理页面，单击“新增数据集”。 在新增数据集页面，“数据来源”选择“AstroZero”。 参照表1，配置数据集参数。 图1 创建数据集 表1 数据集配置说明 参数 说明 数据源连接 可选配置，请根据自身业务需求进行设置。 不配置，表示调用当前AstroZero环境的接口。 选择具体的AstroZero数据源，表示调用指定AstroZero环境的接口 数据集名称 新建数据集的中文名称，用于标识该数据集。 分类 数据集所属的分类，配置为新建分类中新建的分类，也可以直接单击分类后的“新建分类”，新建一个分类。 应用 选择AstroZero中具体的应用。 对象 选择要展示数据关联的对象。 刷新数据预览 单击该按钮，可预览数据。 单击“保存”，完成数据集的创建。

操作步骤 参考关系型数据库数据源中操作，新建关系型数据库数据源。 图1 新建关系型数据库数据源 参考关系型数据库中操作，新建关系型数据库数据集（新建变量value）。 图2 新建关系型数据库数据集 新建全局变量。 参考使用空白画布新建页面中操作，新建大屏空白页面。 在大屏开发页面，单击，新建全局变量，如hotSelect。 图3 新建全局变量hotSelect 在画布中，拖入地图组件和下拉选择框组件。 图4 拖入地图组件和下拉选择框组件 配置地图组件。 选中组件，单击组件上方的，选择百度地图，输入地图密钥（请提前到对应官网申请）。 图5 地图基本配置 选中组件，单击组件上方的，设置组件数据来源。 图6 选择数据集 在全局变量中，选择3中创建的全局变量hotSelect。 图7 选择全局变量hotSelect 在组件预览中，从表格字段中，拖拽对应的字段到配置中。 图8 拖拽字段到配置中 设置完成后，单击“保存”。 选择地图组件，单击组件上方的，显示热力图层，数据标题设置为“子公司完成率”，显示类型设置为“区间显示”，并设置填充颜色。 图9 热力图层配置 配置下拉选择框组件。 选中组件，单击组件上方的，进入组件数据配置页面。 数据类型选择“静态数据”，并输入如下示例数据。 { "dataValue": [{ "value": "子公司A完成率", "label": "子公司A完成率" }, { "value": "子公司B完成率", "label": "子公司B完成率" }, { "value": "子公司C完成率", "label": "子公司C完成率" } ]} 其中，“value”字段需要和数据列名保存一致。 设置完成后，单击“保存”。 图10 设置后效果 配置下拉选择框交互动作。 选中下拉选择框组件，单击组件上方的，进入组件交互设置页面。 在“作为触发器”中，单击“+ 交互事件”，选择“当选中选项时”。 在“响应动作”中，单击“+ 响应动作”，选择“赋值全局变量”。 在“动作详情”中，选择3中定义的全局变量。 图11 选择全局变量 单击“确定”后，单击“完成”。 保存页面后，单击，预览效果。 图12 效果预览

配置 在配置中，设置组件的年月日、背景颜色和时间条颜色等。 图5 配置 统一配置 是否显示未来天气预测：是否展示未来一周的天气预报。 背景颜色：天气预报的背景颜色。 今日温度 是否显示：是否显示今日温度。 字体：今日温度的字体、大小和颜色等设置。 天气图标 是否显示：是否显示天气图标。 图标大小：天气图标的大小。 图标颜色：天气图标的颜色。 城市名字 是否显示：是否显示城市名字。 字体：城市名字的字体、大小和颜色等设置。 今日天气 是否显示：是否显示今日天气。 字体：今日天气的字体、大小和颜色等设置。 当前星期 是否显示：是否显示当前星期。 字体：今日星期的字体、大小和颜色等设置。 当前日期 是否显示：是否显示当前日期。 字体：今日日期的字体、大小和颜色等设置。 当前时间 是否显示：是否显示当前时间。 字体：当前时间的字体、大小和颜色等设置。 今日其他指标 是否显示：是否显示今日其他天气指标。 字体：今日其他天气指标的字体、大小和颜色等设置。 未来天气图标 是否显示：是否显示未来天气图标。 图标大小：未来天气图标的大小。 图标颜色：未来天气图标的颜色。 未来最高温度 是否显示：是否显示未来几天的最高温度。 字体：未来几天最高温度的字体、大小和颜色等设置。 未来最低温度 是否显示：是否显示未来几天的最低温度。 字体：未来几天最低温度的字体、大小和颜色等设置。 未来星期展示 是否显示：是否显示未来几天星期。 字体：未来几天星期的字体、大小和颜色等设置。 未来日期展示 是否显示：是否显示未来几天的日期。 字体：未来几天日期的字体、大小和颜色等设置。

卡片 卡片是指包裹图表组件的外层架构，可以理解为组件由卡片中基础元素（卡片标题、图表、卡片背景、卡片边框）和图表元素构成。 图4 卡片 背景 背景颜色：设置组件卡片的背景颜色。 边框：组件卡片边框设置，支持无边框、全边框和角边框三种样式。设置为全边框和角边框时，支持设置组件外圈边框的线型、圆角等。 样式：选择图片时，图片显示的样式，支持普通、居中、拉伸和平铺四种样式。 选择图片：使用本地的图片作为组件背景，支持新增目录和子目录，便于对图片进行分类管理。推荐使用JPG、JPEG、PNG或GIF格式的图片，且每张图片不能超过50MB。 特效：组件是否高亮显示，支持默认展示和跳转到页面时展示。 边距：组件中图表距离整个组件四边（上、下、左、右，如图3）的距离，默认为0，即铺满整个组件。 上边距：图表到组件边框顶部的距离。 右边距：图表到组件边框右侧的距离。 下边距：图表到组件边框底部的距离。 左边距：图表到组件边框左侧的距离。

数据 在数据中，设置天气组件的数据来源，更多介绍请参见数据接入。 图6 设置组件数据源 图7 选择桥接器预置-静态数据 静态数据中，“dataNow”对应今日天气，“dataForecast”对应未来几天天气预报。 Astro Canvas预置了一套漂亮的天气图标，用于在天气组件上使用图标展示天气状况，并用字段“icon”表示今日天气图标，“iconDay”表示未来日期的天气图标。例如取值为“100”，表示晴天，界面会展示天气图标；取值为“307”，表示大雨，界面会展示天气图标。取值和天气的对应关系请参见表1。 表1 图标字段“icon”、“iconDay”的取值和天气对照表 icon/iconDay 取值 天气状况（中文） 天气状况（英文） 100 晴 Sunny 101 多云 Cloudy 102 少云 Few Clouds 103 晴间多云 Partly Cloudy 104 阴 Overcast 150 晴 Clear 153 晴间多云 Partly Cloudy 154 阴 Overcast 300 阵雨 Shower Rain 301 强阵雨 Heavy Shower Rain 302 雷阵雨 Thundershower 303 强雷阵雨 Heavy Thunderstorm 304 雷阵雨伴有冰雹 Thundershower with hail 305 小雨 Light Rain 306 中雨 Moderate Rain 307 大雨 Heavy Rain 308 极端降雨 Extreme Rain 309 毛毛雨/细雨 Drizzle Rain 310 暴雨 Storm 311 大暴雨 Heavy Storm 312 特大暴雨 Severe Storm 313 冻雨 Freezing Rain 314 小到中雨 Light to moderate rain 315 中到大雨 Moderate to heavy rain 316 大到暴雨 Heavy rain to storm 317 暴雨到大暴雨 Storm to heavy storm 318 大暴雨到特大暴雨 Heavy to severe storm 399 雨 Rain 350 阵雨 Shower Rain 351 强阵雨 Heavy Shower Rain 400 小雪 Light Snow 401 中雪 Moderate Snow 402 大雪 Heavy Snow 403 暴雪 Snowstorm 404 雨夹雪 Sleet 405 雨雪天气 Rain And Snow 406 阵雨夹雪 Shower Snow 407 阵雪 Snow Flurry 408 小到中雪 Light to moderate snow 409 中到大雪 Moderate to heavy snow 410 大到暴雪 Heavy snow to snowstorm 499 雪 Snow 456 阵雨夹雪 Shower Snow 457 阵雪 Snow Flurry 500 薄雾 Mist 501 雾 Foggy 502 霾 Haze 503 扬沙 Sand 504 浮尘 Dust 507 沙尘暴 Duststorm 508 强沙尘暴 Sandstorm 509 浓雾 Dense fog 510 强浓雾 Strong fog 511 中度霾 Moderate haze 512 重度霾 Heavy haze 513 严重霾 Severe haze 514 大雾 Heavy fog 515 特强浓雾 Extra heavy fog 900 热 Hot 901 冷 Cold 999 未知 Unknown

编辑桥接器 参考如何登录Astro Canvas中操作，登录Astro Canvas界面。 在主菜单中，选择“我的资产”。 在左侧导航栏中，单击“我的桥接器”。 将鼠标放在对应的桥接器上，单击。 图6 编辑组件 在桥接器编辑页面，单击右上角的，获取锁。 图7 获取锁 按需在线修改桥接器文件，单击。 在弹出的提示框中，单击“确定”。 在桥接器更新页面，按需设置桥接器参数（如修改桥接器名称为桥接器-Update），单击“更新”。 图8 更新桥接器 返回我的桥接器页面，可查看到桥接器名称变为桥接器-Update。 图9 新桥接器 在桥接器上，单击，可查看到桥接器的新版本。 图10 桥接器新版本

更新桥接器 更新桥接器前，请先获取锁，否则更新按钮置灰不可用。 参考如何登录Astro Canvas中操作，登录Astro Canvas界面。 在主菜单中，选择“我的资产”。 在左侧导航栏中，单击“我的桥接器”。 将鼠标放在对应的桥接器上，单击，获取锁。 将鼠标放在对应的桥接器上，单击，进入更新桥接器页面。 图4 进入更新桥接器页面 在桥接器更新页面，上传新的桥接器、设置桥接器参数，单击“更新”。 图5 设置桥接器信息 将鼠标放在对应的桥接器上，单击，可查看到桥接器的新版本。 ：单击该图标，可下载当前版本桥接器。 ：单击该图标，可在线编辑该版本桥接器。

批量复制自定义桥接器到其他工作空间 参考如何登录Astro Canvas中操作，登录Astro Canvas界面。 在主菜单中，选择“我的资产”。 在左侧导航栏中，单击“我的桥接器”。 选中多个桥接器，单击“复制到工作空间”。 您可以通过鼠标框选、“Ctrl+单击”、“Ctrl+A”或“Ctrl+Shift+框选”，来选择多个桥接器。 图15 复制多个桥接器到目标工作空间 在弹出的页面，选择目标工作空间，单击“确认”。

更新组件 更新组件前，请先获取锁，否则更新按钮置灰不可用。 参考如何登录Astro Canvas中操作，登录Astro Canvas界面。 在主菜单中，选择“我的资产”。 在左侧导航栏中，单击“我的组件”。 将鼠标放在对应的组件上，单击，获取锁。 图7 获取锁 将鼠标放在对应的组件上，单击，进入更新组件页面。 图8 进入更新组件页面 在组件更新页面，上传新的组件、设置组件参数，单击“更新”。 图9 设置组件信息 将鼠标放在对应的组件上，单击，可查看到新版本的组件（如1.0.1）。 图10 查看组件版本 ：单击该图标，可下载当前版本组件。 ：单击该图标，可在线编辑该版本组件。

批量复制自定义组件到工作空间 参考如何登录Astro Canvas中操作，登录Astro Canvas界面。 在主菜单中，选择“我的资产”。 在左侧导航栏中，单击“我的组件”。 选中多个组件，单击“复制到工作空间”。 您可以通过鼠标框选、“Ctrl+单击”、“Ctrl+A”或“Ctrl+Shift+框选”，来选择多个组件。 图20 复制多个组件到目标工作空间 在弹出的页面，选择目标工作空间，单击“确认”。

编辑组件 参考如何登录Astro Canvas中操作，登录Astro Canvas界面。 在主菜单中，选择“我的资产”。 在左侧导航栏中，单击“我的组件”。 将鼠标放在对应的组件上，单击。 图11 编辑组件 在组件编辑页面，单击右上角的，获取锁。 图12 获取锁 按需在线修改组件文件，单击。 在弹出的提示框中，单击“确定”。 在组件更新页面，按需设置组件参数（如修改组件名称为TabsWidget_Update），单击“更新”。 返回我的组件页面，可查看到组件名称变为TabsWidget_Update。 图13 新组件 在组件上，单击，可查看到新版本的组件（如1.0.2）。 图14 组件新版本

更新库 更新组件前，请先获取锁，否则更新按钮置灰不可用。 参考如何登录Astro Canvas中操作，登录Astro Canvas界面。 在主菜单中，选择“我的资产”。 在左侧导航栏中，单击“我的库”。 将鼠标放在对应的库上，单击，获取锁。 图4 获取锁 将鼠标放在对应的库上，单击，进入更新库页面。 图5 进入更新库页面 在库更新页面，上传新的库、设置库参数，单击“更新”。 图6 设置库信息 将鼠标放在对应的库上，单击，可查看到新版本的库。 ：单击该图标，可下载当前版本库。 ：单击该图标，可在线编辑该版本库。

编辑库 参考如何登录Astro Canvas中操作，登录Astro Canvas界面。 在主菜单中，选择“我的资产”。 在左侧导航栏中，单击“我的库”。 将鼠标放在对应的库上，单击。 图7 编辑库 在库编辑页面，单击右上角的，获取锁。 图8 获取锁 按需在线修改库文件，单击。 在弹出的提示框中，单击“确定”。 在库更新页面，按需设置库参数，单击“更新”。 返回我的库页面，在组件上单击，可查看到新版本的库。

自定义动作参数说明 在自定义动作中，支持直接使用的参数如下： eventParam：组件传递出的参数。 以日期选择器组件为例，介绍如何获取eventParam。 在页面中，拖入一个日期选择器组件到画布中。 图2 拖拽日期选择器到画布中 选中日期选择器，单击，进入交互设置页面。 按照下图，设置自定义动作。 图3 设置自定义动作 /* * 可以像示例这样获取到组件对象，然后编写js代码 * 示例中表示，触发当前事件后，会隐藏组件widget16 * 帮助文档：https://support.huaweicloud.com/usermanualcanvas-astrozero/astrozero_05_7025.html * 可以直接使用的参数 * eventParam: 组件传递出的参数 * data: 交互动作信息对象 * $pageStore: 保存页面中全局变量的对象 * 你可以用$pageStore.setItems([{key:'id',value:'123'}])来批量更新全局变量 */// {widget16}.hideWidget()console.log(eventParam);console.log(data);console.log($pageStore); 单击页面上方的，保存页面。 单击，在预览页面，设置日期选择器的开始时间和结束时间。 设置完成后，按F12，在“Console”页签，即可获取eventParam（第一个Object中）。 data：保存最详细的动作信息对象。 “Console”页签中的第二个Object，即为data。 $pageStore：保存页面中全局变量的对象。 如果在全局变量中，配置了一个field变量，并设置默认值为1。在自定义动作中，通过打印$pageStore（如图3），可以获取到全局变量。 图4 定义全局变量field “Console”页签中的第三个Object，即为$pageStore。 $pageStore.setItems([{key:'id',value:'123'}])：批量更新全局变量。其中，key为全局变量名，value为全局变量的值。 图5 全局变量

复制组件到其他工作空间 复制组件到目标工作空间时，请确保当前用户已添加到目标工作空间，否则会提示无权限。 参考如何登录Astro Canvas中操作，登录Astro Canvas界面。 在主菜单中，选择“我的资产”。 在左侧导航栏中，单击“我的收藏”。 将鼠标放在待复制的组件上，单击。 图2 复制组件到其他工作空间 在弹出的页面，选择目标工作空间，单击“确定”。 组件默认复制到，目标工作空间的“我的收藏”目录下。

背景信息 用户开启了Token签名验证功能，系统返回用以生成签名的Token（用于生成签名的token不可公开），例如token=j5TZLK1DQ*****Ntquo/ErqonR0=。 假设，某用户系统嵌入了Astro Canvas大屏页面，通过Token计算签名，最终得到的分享页面链接为（如果对该分享链接进行了篡改，那么页面将无法访问）： https://dmax.huaweicloud.com/magno/render/share/xxx?_dmax_time=1669621495545&name=cloud&age=36&dept=huaweicloud&_dmax_signature=DVX7Qy******o5rs%3D 其中： _dmax_time=1669621495545：为Astro Canvas页面用户分享链接生成时间戳。如果开启了有效期设置，_dmax_time值要小于有效期值，单位为毫秒时间戳。 _dmax_signature=DVX7Qy******o5rs%3D：为Token对URL进行计算得出的签名，用于身份验证。 name=cloud&age=36&dept=huaweicloud：为用户自定义扩展参数。

分享URL签名说明 Token签名校验，是针对整个URL计算并得出的签名。其中，“_dmax_time”为签名生成时的时间戳（该参数值可自定义，默认为计算签名时的时间）。“_dmax_signature”为最终对URL进行计算得出的签名。 在计算签名时，会对参数按照key升序排序，且将多个相同key的参数值进行合并。 例如，用于计算签名的URL输入如下： https://dmax.huaweicloud.com/magno/render/share/xxx?_dmax_time=1669621495545&name=cloud&age=35&dept=huaweicloud&age=36 则通过对参数排序，相同参数合并后（例如age），得到的用于计算的URL为： https://dmax.huaweicloud.com/magno/render/share/xxx?_dmax_time=1669621495545&age=35,36&dept=huaweicloud&name=cloud

操作步骤 参考如何登录Astro Canvas中操作，登录Astro Canvas界面。 在编辑页面状态下，选中组件，单击组件上方的。 图1 单击数据 在配置流程中，选择“AstroZero API”，在右侧单击“+ 新建数据源”。 图2 新建AstroZero API 参照表1，配置数据源参数。 表1 数据源配置说明 参数 说明 数据源名称 新建数据源的名称，用于标识该数据源。 域名 AstroZero环境的域名，需要携带“https://”。 client_id 调用AstroZero接口前，需要配置“客户端模式”OAuth鉴权的客户端ID，获取方法请参考客户端模式接入认证。 OAuth认证过程中，新建认证密钥时授权类型需选择“客户端模式”，用户建议选择具有管理员权限（System Administrator Profile）的用户。 client_secret 调用AstroZero接口前，需要配置“客户端模式”OAuth鉴权的客户端鉴权密钥，获取方法请参考客户端模式接入认证。 描述 新建数据源的描述信息。 单击“连接测试”，显示“连接成功”，表示数据源可以调通。 单击“保存”，完成数据源的创建。 在左侧选择“配置流程”节点，在右侧参考表2，配置数据集参数。 表2 配置流程节点参数说明 参数 说明 应用 选择调用自定义接口所属的应用。 API接口 选择待调用的API接口，下拉框中的选项取值为接口的标签，若接口标签取值为中文，则这里“API接口”显示为中文标签。如果接口标签未定义，则显示接口的操作名称。 请求类型 API接口的请求类型，系统会自动填入。 展开(n) 变量配置 接口入参，当有入参时，系统会自动展示，需要设置参数默认值等。 单击“展开”，设置该API的入参，支持设置复杂结构参数。 在“SQL”模式中可直接写入SQL语句，支持引入全局变量，变量定义格式为“${变量名}”。 测试API接口 用于测试该接口，单击“测试API接口”，“样例报文”中会显示输出结果。 样例报文 对应API接口的响应样例报文数据格式，数据集的元数据结构由该样例报文经转换器处理后的数据结构确定。 单击“格式化”，可对样例报文进行格式化处理。 转换器 选择转换器，用于对数据进行转换处理。 数据预览 单击“数据预览”，在右侧可直观展示经过转换器处理后的样例报文。 在左侧流程图中单击“+”，可根据需要添加其他节点，如过滤、排序、限制行数等。 设置完成后，单击“保存”。

配置 在配置中，设置按钮快捷样式和基础样式。 图2 配置 快捷样式设置：设置按钮的样式，如常规按钮、强调按钮、文字按钮等。 基础样式设置 按钮：按钮状态，分为启用和禁用。 内容：按钮显示文字，如保存。 默认文字：按钮显示文字的字体、文字粗细、文字大小、文字颜色。 默认背景色：处于默认状态下的背景色。 悬浮文字颜色：鼠标悬浮在按钮上时，按钮显示文字的颜色。 悬浮背景色：鼠标悬浮在按钮上时，按钮的背景色。 选中文字颜色：选中当前按钮时，按钮显示文字的颜色。 选中背景色：选中当前按钮时，按钮的背景色。 圆角：按钮边框的圆角，四个角弧度取值范围为0~500，单位px。 内边距：图表和组件边框之间的内边距，单位px。

操作步骤 参考如何登录Astro Canvas中操作，登录Astro Canvas界面。 在主菜单中，选择“数据中心”。 在左侧导航栏中，选择“数据源管理”。 在数据源管理页面，单击“新建数据源”。 选择“DWS”，并参照表1，配置数据源参数。 图1 新建DWS数据源 表1 DWS数据源配置说明 参数 说明 数据源名称 数据源的名称，用于标识该数据源。 域名 数据库所在的域名。 端口 数据库端口。 取值范围为：0-65535 用户名 登录数据库的用户名。 密码 数据库用户密码。 数据库名称 数据库实例名称。 描述 新建数据源的描述信息。 单击“连接测试”，显示“连接成功”，表示DWS数据源可以调通。 单击“保存”，完成数据源的创建。

玫瑰花饼图对接呈现效果 返回Astro Canvas项目列表页面。 进入大屏/小屏开发页面，拖拽所需组件（如玫瑰花饼图）到画布中。 图2 拖拽玫瑰花饼图到画布中 选中该组件，单击组件上方的，进入组件数据页面。 图3 进入玫瑰花饼图数据页面 在“数据类型”下拉框中，选择“数据集”，选择已创建的数据集。 图4 使用已创建的数据集 配置全局变量。 页面组件之间需要共享数据时，才需要设置全局变量。 在组件预览中，选择要展示的表字段，即从左边栏中拖入到右边栏中，单击“保存”。 图5 设置后效果 表2 玫瑰花饼图数据集配置说明 参数 参数说明 表格字段 展示创建DWS数据集中，获取的数据。 配置 从表格字段中，拖拽所需的字段到数据、数据类别中。 刷新周期 每隔多少秒从DWS中读取一次数据，默认配置为“0”，表示只获取一次。 共享数据 是否共享数据。勾选后，如果多个组件调用了相同的桥接器URL请求，不会各自只调用，而是共享结果数据。 单击页面上方的，保存设置页面。 单击，进入预览页面，预览效果。 图6 最终呈现效果

使用说明 数据湖探索 （Data Lake Insight，简称 DLI ）是完全兼容Apache Spark、Apache Flink、openLooKeng（基于Apache Presto）生态，提供一站式的流处理、批处理、交互式分析的Serverless融合处理分析服务。用户不需要管理任何服务器，即开即用。支持标准SQL/Spark SQL/Flink SQL，支持多种接入方式，并兼容主流数据格式。数据无需复杂的抽取、转换、加载，使用SQL或程序就可以对云上CloudTable、RDS、DWS、 CSS 、OBS、E CS 自建数据库以及线下数据库的异构数据进行探索。更多关于DLI的介绍，请参见DLI产品文档。

创建DLI数据集 参考如何登录Astro Canvas中操作，登录Astro Canvas界面。 在主菜单中，选择“数据中心”。 在左侧导航栏中，选择“数据集管理”。 在数据集管理页面，单击“新增数据集”。 在新增数据集页面，“数据来源”选择“DLI”。 参照表1，配置数据集参数。 图5 新建DLI数据集 表1 DLI数据集配置说明 参数 说明 数据源连接 选择DLI数据源中，创建的DLI数据源。 数据集名称 数据集的名称，用于标识该数据集。 分类 数据集所属的分类，配置为新建分类中新建的分类，也可以直接单击分类后的“新建分类”，新建一个分类。 标签 SQL作业的标签。单击“标签”后的“展开”，设置标签的键“key”和标签的值“value”，即在DLI构建数据中设置的标签。 设置标签：从设置标签的SQL作业中，获取数据（48小时内的数据，作业超过48小时会过期）。 不设置标签，默认从最后执行的作业中获取数据。 刷新数据预览 单击该按钮，可预览数据。 单击“保存”，完成DLI数据集的创建。

步骤2 开发告警监控大屏页面 新建一个空白的大屏页面。 在Astro Canvas界面上方，单击“项目列表”。 单击页面右上角的“新建项目”，输入项目名称，单击“新建”，新建一个大屏&PC端项目。 在新建的大屏&PC端项目中，单击“新建页面”。 单击“新建空白页面”，输入页面标题“全局变量示例页面”，单击“新建”。 在页面上方单击，新建并设置页面级全局变量。 新增全局变量“status”，设置默认值为“1”，设置变量说明为“告警服务状态码，1为待派单，2是已派单，3是处理中，4是已关闭”。 图5 设置页面变量 在页面中拖入并设置下拉选择框组件。 从左侧全部组件中，搜索并拖拽“下拉选择框”组件到页面画布中。 图6 拖入下拉选择框 参考图7，设置占位符为“请选择要筛选的告警状态”。 图7 设置占位符 在组件上方单击，配置组件数据源为静态数据，单击“保存”。 在输入数据中，输入如下静态数据示例： {"dataValue": [{"value": "1","label": "待派单"},{"value": "2","label": "已派单"},{"value": "3","label": "处理中"},{"value": "4","label": "已关闭"}]} 图8 配置组件数据源 在组件上方单击，配置组件交互事件。 在作为触发器中，单击“交互事件”，选择“当选中选项时”事件。单击“响应动作”，选择“赋值全局变量”，“赋值到变量”设置为“status”，单击“确定”。单击“完成”，设置后用户在下拉框选择相应告警状态时，全局变量“status”的值会随着进行相应变化。 图9 配置组件交互事件 在页面中拖入并设置多区域折线图组件。 从左侧全部组件中，搜索并拖拽“多区域折线图”到页面画布中。 图10 拖入多区域折线图 参考图11，设置组件标题为“告警分布情况”。 图11 设置组件标题 参考图12，将x轴、y轴的轴标题设置为空。 图12 设置轴标题为空 在组件上方单击，配置组件数据源。 数据配置中选择“数据集”，选择8配置的“getWarnDetailByStatus”数据集。 图13 选择数据集 全局变量中选择2配置的“status”，给接口入参“statusCode”告警状态绑定页面全局变量“status”。 图14 选择全局变量 步骤1 新建数据源中已设置过转换器，这里直接单击“下一步”，不用再添加转换器。 设置多区域折线图数据集展示，x轴数据拖入“hab_RegionName_CST”（地区），y轴数据拖入“WarnAmount_CST”（告警数量），单击“保存”。 图15 设置数据集展示 设置完成后，单击页面上方的，保存页面。 单击页面上方的，进行页面发布设置。 发布链接：单击发布链接后的图标，将显示页面地址，单击该地址进入发布页。 图16 获取发布链接 单击，可生成新的链接，原链接将不可访问。单击，可复制该链接。 版本管理：通过管理页面版本，设置发布具体哪个版本的页面或者回退到具体哪个版本的页面进行开发。更多介绍，请参见管理页面版本。 图17 版本管理 分享码设置：设置页面分享码和分享码有效期，设置后，只能通过分享码来访问页面，提高安全性。更多介绍，请参见如何设置分享码。 图18 分享码设置 ：单击该图标，可查看设置的分享码。 有效期设置：设置分享码的有效期。若不设置有效期，分享码将永久有效。 设置Token认证：通过设置Token认证，可对大屏交互时传递的参数进行签名鉴权，保证大屏的URL访问链接的参数不能被篡改，从而提高大屏数据及用户信息的安全性。如何设置Token认证，请参见如何设置Token认证。 图19 设置Token认证信息 ：打开Token认证开关后，Astro Canvas会生成一个Token。单击该图标，可复制Token。 签名地址只允许打开一次：开启后，签名地址仅允许打开一次，再次访问时需要重新获取签名地址。若不开启，不限制访问次数，但支持设置有效期。 有效期设置：设置Token认证有效期。若不设置有效期，Token认证将永久有效。 设置内容安全策略：大屏页面以iframe形式嵌入第三方系统时，如果涉及跨域访问，请开启内容安全策略。设置内容安全策略的主要目的是减少和报告XSS攻击，缓解跨站脚本攻击。除限制可以加载内容的域，还可指明哪种协议允许使用，缓解数据包嗅探攻击。如何设置内容安全策略，请参见如何设置内容安全策略。 图20 设置内容安全策略 开启“内容安全策略”时，若在浏览器无痕模式下预览页面，请确保“阻止第三方Cookie”已关闭，否则无法正常预览页面。 图21 关闭阻止第三方Cookie 打开页面成功发布网址，选择下拉框数据为“已派单”、“处理中”或者“已关闭”，发现多区域折线图数据进行实时更新变化，符合预期。 图22 告警监控页面

操作步骤 进入已开发好的页面。 在页面工具栏中，单击，保存页面。 保存成功后，单击，打开“发布链接”开关。 图1 打开发布链接 单击，可生成新的链接，原链接将不可访问。单击，可复制该链接。 打开“分享码访问”开关，按照规则要求设置分享码，单击。 图2 设置分享码 打开“设置分享码有效期”开关，设置分享码有效期。 图3 分享码有效期 设置完成后，访问页面时，需要输入分享码，才能正常进入页面。 图4 输入分享码

如何在页面URL参数中给全局变量赋值 如何基于页面级的全局变量实现组件交互中实现的场景是：用户在“下拉选择框”中选择某个告警状态时，通过配置的交互事件将告警状态赋值给全局变量，“多区域折线图”组件呈现的数据来源于封装了AstroZero某API接口的数据集，将该接口的入参与全局变量绑定，则“多区域折线图”组件呈现的告警数据会随着全局变量值变化而变化。 如图1所示，也可以不使用“下拉选择框”组件，直接在发布的页面URL末尾加上“?全局变量名=值”，给页面全局变量赋值，查看组件的数据变化。 图1 在URL参数中给全局变量赋值 父主题： Astro Canvas学堂

创建数据集 参考如何登录Astro Canvas中操作，登录Astro Canvas界面。 在主菜单中，选择“数据中心”。 在左侧导航栏中，选择“数据集管理”。 在数据集管理页面，单击“新增数据集”。 在新增数据集页面，“数据来源”选择“AstroZero API”。 参考表1，配置数据集参数。 图1 设置数据集和接口入参 图2 给入参变量设置默认值 表1 数据集配置说明 参数 说明 数据源连接 可选配置，请根据自身业务需求进行设置。 不配置，表示调用当前AstroZero环境的接口。 选择具体的AstroZero数据源，表示调用指定AstroZero环境的接口。 数据集名称 新建数据集的名称，用于标识该数据集。 分类 数据集所属的分类，配置为新建分类中新建的分类，也可以直接单击分类后的“新建分类”，新建一个分类。 应用 选择调用自定义接口所属的应用。 API接口 选择待调用的API接口，下拉框中的选项取值为接口的标签，若接口标签取值为中文，则这里“API接口”显示为中文标签。如果接口标签未定义，则显示接口的操作名称。 请求类型 API接口的请求类型，系统会自动填入。 展开(n) 变量配置 接口入参，当有入参时，系统会自动展示，需要设置参数默认值等。 单击“展开”，设置该API的入参，支持设置复杂结构参数，如图1。 单击“变量配置”，可给变量设置默认值，如图2。 { "warnname": "", "warnstatus": { "name": ${code}, "id": ${ID}, }} 测试API接口 用于测试该接口，单击“测试API接口”，“样例报文”中会显示输出结果。 样例报文 对应API接口的响应样例报文数据格式，数据集的元数据结构由该样例报文经转换器处理后的数据结构确定。 单击“格式化”，可对样例报文进行格式化处理。 转换器 选择新建转换器中创建的转换器或Astro Canvas预置的转换器，用于对数据进行转换处理。 API测试数据预览 单击“API测试数据预览”，在右侧可直观展示经过转换器处理后的样例报文。 单击“保存”，完成数据集的创建。

基本折线图对接呈现效果 返回Astro Canvas项目列表页面。 进入大屏应用开发页面，拖拽所需组件（如基本折线图）到画布中。 图3 拖拽基本折线图到画布中 选中该组件，单击组件上方的，进入组件数据页面。 图4 进入基本折线图数据页面 在“数据类型”下拉框中，选择“数据集”，选择已创建的数据集。 图5 使用已创建的数据集 配置全局变量。 页面组件之间需要共享数据时，才需要设置全局变量。 在组件预览中，选择要展示的表字段，即从左边栏中拖入到右边栏中，单击“保存”。 图6 设置后效果 表2 基本柱图数据集配置说明 参数 参数说明 表格字段 展示创建数据集中，获取的数据。 配置 从表格字段中，拖拽所需的字段到数据、数据类别中。 刷新周期 每隔多少秒从AstroZero中读取一次数据，默认配置为“0”，表示只获取一次。 共享数据 是否共享数据。勾选后，如果多个组件调用了相同的桥接器URL请求，不会各自只调用，而是共享结果数据。 单击页面上方的，保存设置页面。 单击，进入预览页面，预览效果。 图7 最终呈现效果

创建ROMA连接器数据集 参考如何登录Astro Canvas中操作，登录Astro Canvas界面。 在主菜单中，选择“数据中心”。 在左侧导航栏中，选择“数据集管理”。 在数据集管理页面，单击“新增数据集”。 在新增数据集页面，“数据来源”选择“Roma连接器”。 参照表1，配置数据集参数。 图1 ROMA连接器配置示例 表1 ROMA连接器类型数据集配置说明 参数 说明 数据源连接 选择ROMA连接器数据源中，创建的ROMA连接器。 数据集名称 新建数据集的中文名称，用于标识该数据集。 分类 数据集所属的分类，配置为新建分类中新建的分类，也可以直接单击分类后的“新建分类”，新建一个分类。 API接口 API请求路径。 请求类型 请求的类型，如GET、POST。 参数 输入参数，请根据实际请求进行配置。 消息头 消息头入参。 样例报文 对应API接口的响应样例报文数据格式，数据集的元数据结构由该样例报文经转换器处理后的数据结构确定。例如，输入下方示例中内容，单击“测试API接口”，显示效果如图2。 [{"姓名":"张三","年龄":"33","身高":"180","性别":"男"},{"姓名":"李四","年龄":"34","身高":"170","性别":"男"},{"姓名":"王五","年龄":"24","身高":"175","性别":"男"},{"姓名":"赵六","年龄":"22","身高":"160","性别":"女"}] 转换器 选择新建转换器中创建的转换器或Astro Canvas预置的转换器，用于对数据进行转换处理。 API测试数据预览 预览测试数据。 图2 测试API接口 单击“保存”，完成数据源的创建。