华为云用户手册

操作步骤 参考如何登录AstroCanvas中操作，登录AstroCanvas界面。 在主菜单中，选择“数据中心”。 在左侧导航栏中，选择“连接器”。 在连接器管理页面，单击“新建连接器”。 设置基本信息。 图2 基本信息（无身份验证） 图3 基本信息（AK/SK） 图4 基本信息（API Key） 图5 API鉴权 连接器名称：输入新建连接器的名称，长度为1~32个字符，可包括中文、字母、数字及下划线。 类型：选择连接器类型，便于管理连接器。单击“新建类型”，可自定义连接器类型。 上传图标：单击，可设置连接器显示的图标。 描述：新建连接器的描述信息，可按需进行设置。 请求协议：设置连接器请求协议。 域名：请求的Host地址，不需要带上“http://”或“https://”协议头，同时也不需要“/”结尾。 域名参数：配置域名参数，包含字段名称、默认值和字段描述。 图6 配置域名参数 连接器配置中，当域名中配置“{字段名}”参数时，才会显示该参数。 接口鉴权方式：设置接口鉴权方式，支持API鉴权、AK/SK、API Key和无身份验证。 API鉴权：填写API鉴权信息后，可在连接器中选择其响应参数，作为连接器请求参数的值。 无身份验证：不需要任何验证信息，直接调用接口，通常用于访问一些公开的接口。 AK/SK：通过访问密钥进行接口鉴权。访问密钥即AK/SK（Access Key ID/Secret Access Key），是您访问系统的身份凭证，系统通过AK识别访问用户的身份，通过SK进行签名验证，通过加密签名验证可以确保请求的机密性、完整性和请求者身份的正确性。 API Key：使用API密钥进行授权，鉴权信息可以附加在Query或Header中。 鉴权信息：“接口鉴权方式”设置为“API鉴权”时，才会显示该参数。单击“新建鉴权信息”，设置鉴权信息。 图7 新建鉴权信息 API鉴权名称：设置API鉴权名称，长度为1~32个字符，可包括中文、字母、数字及下划线。 API鉴权描述：设置API鉴权描述信息。 API鉴权地址：设置API鉴权地址，通过输入字符“{xx}”可在请求参数Path列表中使用变量“xx”。 请求方式：设置接口请求方式，支持GET和POST。 请求参数：设置接口请求参数。 返回参数：设置接口返回参数。 参数位置：把鉴权信息附加在Query或Header中，请根据实际需求进行配置。“接口鉴权方式”设置为“API Key”时，才会显示该参数。 参数名称：API Key的名称，请根据实际需求进行配置。“接口鉴权方式”设置为“API Key”时，才会显示该参数。 设置执行动作。 图8 添加动作 动作信息 动作名称：设置新增动作的名称，长度为1~32个字符，可包括中文、字母、数字及下划线。 动作描述：新增动作的描述信息。 请求地址：设置请求地址，通过输入字符“{xx}”可在请求参数Path列表中使用变量“xx”。 请求方法：请根据接口类型，选择请求方法。 请求参数 Query：请求的参数，通常指的是URL中“?”后的附加参数。 Header：Header中需要的参数，目前是静态配置的。 Body：当请求类型为POST时，还需要设置Body，可以使用默认值也可以根据实际需求进行填写。 Path：URL中配置的带大括号的变量。例如{pathParam} ，其中pathParam会作为变量名。 返回参数：设置返回参数。在Body中，可以贴一段预期结果的json，使用时可以解析出字段格式。 认证信息设置完成后，单击“测试”，测试接口是否有效。 测试成功后，单击“保存”，完成连接器的创建。

图例 图例是指在多维度可视化图形表达中，用以区分不同维度可视化图形的提示标识。 图6 图例 显示图例：是否显示图例。图例文字内容来源于数据模型下“s”的取值。 图例标记：设置图例小图标形状和图例列表布局朝向。 图例宽高：设置图例的宽度和高度。 图例间隔：设置图例之间的间隔。 字体：设置图例的字体、颜色和大小。 文字风格：设置图例文字的风格，支持正常、斜体和倾斜体。 图例位置(左)：图例到饼图组件左侧距离占组件高度的百分比或图例位置的对齐方式设置。 左间距：图例到散点图组件左侧距离占组件高度。 上间距：图例到散点图组件顶部距离占组件高度。 图例类型：存在很多图例，导致图表中无法全部显示，此时可设置图例类型，即通过滚动翻页还是普通换行来查看图例。 自定义图例显示：开启后，可调整图例名称显示字符长度。默认关闭，即显示图例所有字符。

坐标轴 坐标轴是指对图表组件，进行坐标系相关样式、颜色、位置和行为的设置。 图9 坐标轴 x轴 X轴：是否显示X轴。 X轴坐标轴类型：设置X轴坐标轴类型，支持连续数据、类目轴和时间轴。 坐标轴分割段数：设置X轴坐标轴段数。 最大值：X轴线标签数据的最大值。 最小值：X轴线标签数据的最小值。 坐标轴名称：设置X轴坐标轴显示名称。 坐标轴名称字体：坐标轴字体、颜色、大小设置。 刻度标签旋转的角度：设置刻度标签旋转的角度。 轴线显示：是否显示轴线。 刻度显示：是否显示刻度线。设置为显示时，支持设置线的颜色。 刻度标签字体：设置标签的字体、颜色和大小。 网格线是否显示：是否显示网格线。设置为显示时，支持设置线的类型和颜色。 y轴 Y轴：是否显示Y轴。 Y轴坐标轴类型：设置Y轴坐标轴类型，支持连续数据、类目轴和时间轴。 最大值：Y轴线标签数据的最大值。 最小值：Y轴线标签数据的最小值。 坐标轴名称：设置X轴坐标轴显示名称。 坐标轴名称字体：坐标轴字体、颜色、大小设置。 轴线显示：是否显示轴线。 刻度显示：是否显示刻度线。设置为显示时，支持设置线的颜色。 刻度标签字体：设置标签的字体、颜色和大小。 网格线是否显示：是否显示网格线。设置为显示时，支持设置线的类型和颜色。

图形 图形是指组件中，实现 数据可视化 的具体图形表达元素，例如饼图的扇区、柱状图的柱子、折线图的线条、拐点等。 图5 图形 颜色：设置图表中图形的颜色。 统一配置 标记图形：设置标记的图形，如圆形、矩形、三角形等。 数据标签：是否显示数据标签，支持设置标签颜色。 数据标签最大值/最小值/平均值：设置数据标签的最大值、最小值或平均值。 数据系列 系列名称：原始数据中默认的系列名称，可通过设置“显示名称”，进行修改。 显示名称：自定义图表中系列的显示名称。 标记图形：设置标记的图形样式，如圆形、矩形、三角形等。 标记大小：设置标记的大小。 颜色设置：设置标记颜色样式，支持纯色、线性渐变和径向渐变。 颜色：设置标记的颜色。 边框颜色：设置标记边框颜色。 图形透明度：散点图散点的透明度，取值0~1。 数据标签：显示散点对应的数值标签。 图表标注和标线最大值：显示散点数据的最大值。 图表标注和标线最小值：显示散点数据的最小值。 图表标注和标线平均值：显示散点数据的平均值。

参考线 参考线是指为图表组件添加可视化的参考标准，为图表中数据提供具体的参考依据。 图10 参考线 统一配置：设置参考线两端的样式，如圆形、矩形和三角形等。 Y轴参考线 Y轴参考线：是否显示Y轴参考线。 参考线：设置已有参考线的颜色和线型，单击“新增Y轴参考线”，可新增参考线。单击对应参考线后的，可删除参考线。 X轴参考线 X轴参考线：是否显示X轴参考线。 参考线：设置已有参考线的颜色和线型，单击“新增X轴参考线”，可新增参考线。单击对应参考线后的，可删除参考线。

参考线 参考线是指为图表组件添加可视化的参考标准，为图表中数据提供具体的参考依据。 图9 参考线 统一配置：设置参考线两端的样式，如圆形、矩形和三角形等。 图10 Y轴参考线两端样式 Y轴参考线 Y轴参考线：是否显示Y轴参考线。 参考线：设置已有参考线的颜色和线型，单击“新增Y轴参考线”，可新增参考线。单击对应参考线后的，可删除参考线。 X轴参考线 X轴参考线：是否显示X轴参考线。 参考线：设置已有参考线的颜色和线型，单击“新增X轴参考线”，可新增参考线。单击对应参考线后的，可删除参考线。

图例 图例是指在多维度可视化图形表达中，用以区分不同维度可视化图形的提示标识。 图5 图例 显示图例：是否展示图例。图例文字内容来源于数据模型下“s”的取值。 图例标记：设置图例小图标形状。 图例宽高：设置图例的宽度和高度。 图例间隔：设置图例之间的间隔。 字体：设置图例的字体、颜色和大小等。图例文字内容来源于数据模型下“s”的取值。 左间距：图例到饼图组件左侧距离占组件高度的百分比或图例位置的对齐方式设置。 上间距：图例到饼图组件顶部距离占组件高度。 翻页按钮：设置翻页按钮颜色。 翻页按钮不激活：设置翻页按钮不激活时的颜色。 自定义图例显示：开启后，可调整图例名称显示字符长度。默认关闭，即显示图例所有字符。

指标 指标是指可视化组件中，对除可视化图形之外的具体补充，即主要以文字和数字的表现形式，为可视化组件提供具体数值的参考。 图11 指标 显示指标：是否显示指标。 指标内容：设置指标内容。 指标字体：设置指标内容的字体、大小、颜色等。 指标类型：设置指标类型，支持总和、平均值和自定义。 数值内容：“指标类型”设置为“自定义”时，支持自定义数值内容。 数值字体：设置数值字体、大小、颜色等。 数值位数：设置数值小数点后的位数。

坐标轴 在坐标轴中，设置图表的x轴和y轴，如是否显示x轴y轴、字体、字体颜色、是否显示刻度等。 图8 坐标轴 x轴 X轴：是否显示X轴。 轴标题：X轴标题。 字体：设置坐标轴字体、颜色和大小等。 标题偏移：标题相对于轴线的偏移。 轴线：是否显示轴线，支持设置轴线颜色。 刻度：是否显示刻度。 刻度标签：刻度标签样式，包括是否自动调节标签、显示所有标签。 刻度标签字体：刻度标签的字体、字体颜色、字体大小设置。 标签行为：标签字数过多时是否进行处理，包括标签字数过多换行、标签字数过多省略和标签字数过多不做处理。 标签旋转：标签旋转角度。 网格线：是否显示网格线。 y轴 Y轴：是否显示Y轴。 轴标题：Y轴标题。 字体：设置坐标轴字体、颜色和大小等。 标题偏移：标题相对于轴线的偏移。 轴线：是否显示轴线，支持设置轴线颜色。 刻度：是否显示刻度。 刻度标签字体：刻度标签的字体、字体颜色、字体大小设置。 最小间隔：坐标轴最小间隔大小。 标签行为：标签字数过多时是否进行处理，包括标签字数过多换行、标签字数过多省略和标签字数过多不做处理。 网格线：是否显示网格线。 轴起始值：设置Y轴的起始值。为方便数据展示，输入值为接入数据最大值时，图表Y轴起始值为最大值一半。 左Y轴单位：设置左侧Y轴的单位。 标签展示：设置Y轴标签的展示样式，如默认或计数单位。

卡片 卡片是指包裹图表组件的外层架构，可以理解为组件由卡片中基础元素（卡片标题、图表、卡片背景、卡片边框）和图表元素构成。 图3 卡片 卡片装饰：卡片装饰设置，可根据自身的业务需求选择不同的卡片样式。单击“清除样式”，可清除已设置的装饰样式。 标题 标题：是否显示该组件标题。 内容：组件标题内容。 字体：文字的字体、大小、颜色等设置。 对齐：标题相对于组件的对齐方式。 标题背景色：设置标题的背景颜色。 内边距：标题与组件框上下左右四个边界之间的距离，单位默认px。 标题偏移：组件标题与多折线图之间的偏移量。 背景 背景色：设置组件卡片的背景颜色。 边框：组件卡片边框设置，支持无边框、全边框和角边框三种样式。设置为全边框和角边框时，支持设置组件外圈边框的线型、圆角等。 样式：选择图片时，图片显示的样式，支持普通、居中、拉伸和平铺四种样式。 选择图片：使用本地的图片作为组件背景，支持新增目录和子目录，便于对图片进行分类管理。推荐使用JPG、JPEG、PNG或GIF格式的图片，且每张图片不能超过50MB。 特效：组件是否高亮显示，支持默认展示和跳转到页面时展示。 边距：组件中图表距离整个组件四边（上、下、左、右）的距离（参见图2），默认为0，即铺满整个组件。 上边距：图表到组件边框顶部的距离。 右边距：图表到组件边框右侧的距离。 下边距：图表到组件边框底部的距离。 左边距：图表到组件边框左侧的距离。 参考模板：系统预置的组件样式模板，如默认、带标记模板等。 图表背景：设置图表的背景颜色、圆角和内边距。

图形 图形是指组件中，实现数据可视化的具体图形表达元素，例如饼图的扇区、柱状图的柱子、折线图的线条、拐点等。 图4 图形 颜色：设置图表中图形的颜色。 统一配置 折线类型：设置图形中折线类型，包括平滑和不平滑。 折线宽度：设置图形中折线的宽度，取值范围0~100 拐点尺寸：设置拐点尺寸，取值范围0~100 数据标签：是否显示数据标签，支持设置标签颜色。 数据标签最大值/最小值/平均值：设置数据标签的最大值、最小值或平均值。 数据系列 系列名称：原始数据中默认的系列名称，可通过设置“显示名称”，进行修改。 显示名称：自定义图表中系列的显示名称。 折线类型：设置图形中折线类型，包括平滑和不平滑。 折线宽度：设置图形中折线的宽度，取值范围0~100。 折线颜色：设置折线颜色，支持单色和渐变色。如果开启了阈值线，渐变会随着阈值线值变化。 折线不透明度：设置折线的不同透明度。 拐点尺寸：设置拐点尺寸，取值范围0~100。 拐点颜色：设置拐点显示的颜色。 拐点不透明度：设置拐点不透明度。 区域颜色：设置折线图中区域颜色。 数据标签：是否显示数据标签，支持设置标签颜色、前缀和后缀。 数据标签最大值/最小值/平均值：设置数据标签的最大值、最小值或平均值。

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

配置 在配置中，设置组件的日期选择器的类型、输入框边框字体设置等。 图4 配置 日期选择器的类型：支持年选择器、月选择器、日选择器、多个日期选择器、周选择器和带时间的日选择器等。 输入框边框字体设置 输入框字体：输入框中字体的大小、颜色等设置。 输入框背景颜色：设置输入框背景颜色。 边框颜色：设置输入框边框的颜色。 边框聚焦颜色：设置鼠标选中输入框时，边框的颜色。 边框悬浮颜色：设置鼠标悬浮在输入框上时，边框的颜色。 输入框内容设置 选择范围时的分隔符：选择日期范围时，中间的分隔符，一般使用“-”。 范围选择时开始日期的占位内容：开始日期输入框中没有选择具体日期时，显示的文字内容。 例如：开始日期，效果图为 范围选择时结束日期的占位内容：结束日期输入框中没有选择具体日期时，显示的文字内容。 非范围选择时的占位内容：不是日期范围选择时，显示的文字内容。 日期弹出框设置 放大倍数：组件发布后，日期弹出框在页面占位相对于开发态中放大的倍数。在大屏页面中，放大倍数建议设置大一些。 背景颜色：设置日期弹出框的背景颜色。 选中态背景颜色：日期弹出框中，选中状态日期的背景颜色。 选中态字体颜色：日期弹出框中，选中状态日期的字体颜色。 前月后月的日期颜色：日期弹出框中，上个月日期和下个月日期的日期颜色。 选择范围的背景色：日期弹出框中，处于选择范围内日期的背景色。 日期弹出框内星期时间设置 星期背景色：日期弹出框内，星期几的背景色。 星期的字体颜色：日期弹出框内，星期几的字体颜色。 时间背景色：日期弹出框内，时间的背景色。 时间的字体颜色：日期弹出框内，时间的字体颜色。

注册自定义事件 自定义事件在{widget}.editor.js文件中的eventConfig配置项中注册，以global_SelectWidget组件为例： 在文件global_SelectWidget.editor.js中定义事件 eventConfig: { sendSelect: { desc: { zh_CN: "当选中选项时", en_US: "Select Choose" }, fields: [ { name: "selectValue", desc: { zh_CN: "选项值", en_US: "Select Choose" }, }, ], }, }, 在文件global_SelectWidget.js的init钩子中注册事件 * @params thisObj: 组件实例，等同于this * @params "sendSelect": 事件key值 * @params { "zh_CN": "当选中选项时", "en_US": "Select Choose" }: 事件描述，国际化 * @params []: 空数组，固定写法 （内部组件暂时没有用到过） */ Studio.registerEvents(thisObj, "sendSelect", { "zh_CN": "当选中选项时", "en_US": "Select Choose" }, []); 图1 配置后效果 表1 eventConfig字段说明 字段 类型 说明 sendSelect String 自定义事件的key值。 desc Object 自定义事件的中英文描述。 fields Array 自定义事件中，暴露给全局变量的内容。

图形 图形是指组件中，实现数据可视化的具体图形表达元素，例如饼图的扇区、柱状图的柱子、折线图的线条、拐点等。 图4 图形 颜色：设置图表中图形的颜色。 统一配置 是否展示：是否展示词云，默认为是。 词云形状：设置词云形状，如圆形、心形、三角形等。 字体：设置词云的字体。 字号范围：设置词云字号范围。 间距：设置词云间距。 倾斜角度范围：设置词云倾斜角度范围你，取值为[-90, 90]。 角度阶梯：设置词云角度阶梯。 数据系列：展示系列内容，支持修改系列颜色。 展开更多数据系列：单击，可新增数据系列。

卡片 卡片是指包裹图表组件的外层架构，可以理解为组件由卡片中基础元素（卡片标题、图表、卡片背景、卡片边框）和图表元素构成。 图3 卡片 卡片装饰：卡片装饰设置，可根据自身的业务需求选择不同的卡片样式。单击“清除样式”，可清除已设置的装饰样式。 标题 标题：是否显示该组件标题。 内容：组件标题内容。 字体：文字的字体、大小、颜色设置。 对齐：标题相对于组件的对齐方式，支持左对齐、右对齐和居中。 标题背景色：设置标题的背景颜色。 内边距：标题与组件框上、左、右三个边界之间的距离，下为标题与图表之间的距离，单位默认px。 标题偏移：组件标题与词云图表之间的偏移量。 背景 背景色：设置组件卡片的背景颜色。 边框：组件卡片边框设置，支持无边框、全边框和角边框三种样式。设置为全边框和角边框时，支持设置组件外圈边框的线型、圆角等。 样式：选择图片时，图片显示的样式，支持普通、居中、拉伸和平铺四种样式。 选择图片：使用本地的图片作为组件背景，支持新增目录和子目录，便于对图片进行分类管理。推荐使用JPG、JPEG、PNG或GIF格式的图片，且每张图片不能超过50MB。 特效：组件是否高亮显示，支持默认展示和跳转到页面时展示。 边距：组件中图表距离整个组件四边（上、下、左、右）的距离（参见图2），默认为0，即铺满整个组件。 上边距：图表到组件边框顶部的距离。 右边距：图表到组件边框右侧的距离。 下边距：图表到组件边框底部的距离。 左边距：图表到组件边框左侧的距离。 边框圆角：边框的圆角，四个角弧度取值范围为0~500，单位px。 图表背景：图表的背景颜色。 图表标题 显示图表标题：是否显示图表标题，默认为隐藏。 标题获取：设置标题获取方式，支持自定义和从系列名获取。 标题内容：“标题获取”设置为“自定义”时，可自定义标题的内容。 标题位置(上%)：设置标题距离组件上边界的距离。 标题位置(左%)：“标题获取”设置为“自定义”时，支持设置标题距离组件左边界的距离。 字体：设置标题字体、大小和颜色。

坐标轴 在坐标轴中，设置图表的x轴和y轴，如是否显示x轴y轴、字体、字体颜色、是否显示刻度等。 图6 坐标轴 x轴 X轴：是否显示X轴。 坐标轴分割段数：设置坐标轴的分割段数，需要注意的是这个分割段数只是个预估值，实际显示的段数会在这个基础上根据分割后坐标轴刻度显示的易读程度作调整。 最小值：设置坐标轴的最小值。 最大值：设置坐标轴的最大值。 刻度标签旋转的角度：控制刻度标签的旋转，在文字过长时可以避免重叠。 轴线显示：控制是否显示轴线。 刻度显示：控制是否显示刻度。 线的颜色：轴线的颜色。 标签显示：是否显示刻度标签。打开后需要设置刻度标签字体、字体颜色、大小、粗细。 刻度标签字体：刻度标签的字体、字体颜色、字体大小设置。 网格线是否显示：是否显示轴网格线、轴网格线的类型和颜色设置。 y轴 Y轴：是否显示Y轴。 最小值：设置坐标轴的最小值。 最大值：设置坐标轴的最大值。 轴线显示：控制是否显示轴线。 刻度显示：控制是否显示刻度。 线的颜色：轴线的颜色。 标签显示：是否显示刻度标签。打开后需要设置刻度标签字体、字体颜色、大小、粗细。 刻度标签字体：刻度标签的字体、字体颜色、字体大小设置。 网格线是否显示：是否显示轴网格线、轴网格线的类型和颜色设置。

配置示例 select配置示例如下，配置后效果如图1所示。 { "type": "select", "name": "commProps.mySelect", "value": "Border", "label": { "zh_CN": "边框", "en_US": "Border" }, "options": [{ "value": "Full", "label": { "zh_CN": "全边框", "en_US": "Full" } }, { "value": "Corner", "label": { "zh_CN": "角边框", "en_US": "Corner" } }, { "value": "No Border", "label": { "zh_CN": "无边框", "en_US": "No Border" } } ] } 图1 配置后效果

在组件中使用数据集 返回AstroCanvas项目列表页面。 进入大屏应用开发页面，拖拽所需组件（如水平基本柱图）到画布中。 图4 拖拽水平基本柱图到画布中 选中该组件，单击组件上方的，进入组件数据页面。 在“数据类型”下拉框中，选择“数据集”，选择创建HTTP连接器数据集中创建的数据集。 配置全局变量。 全局变量可以理解为参数变量，用于控制组件之间参数的传递，从而达到交互的目的，例如图表联动、自定义字段等功能。如何使用全局变量，可参考如何基于页面级的全局变量实现组件交互~如何通过全局变量，实现组件数据的动态变化。本示例不做配置。 在组件预览中，选择要展示的表字段，即从左边栏中拖入到右边栏中，单击“保存”。 图5 拖拽字段到坐标轴 表格字段：展示创建HTTP连接器数据集中，获取的数据。 配置：从表格字段中，拖拽所需的字段到X轴数据、Y轴数据和系列中。 刷新周期：每隔多少秒从HTTP连接器中读取一次数据，默认配置为“0”，表示只获取一次。 共享数据：是否共享数据。勾选后，如果多个组件调用了相同的桥接器URL请求，不会各自只调用，而是共享结果数据。 选中水平基本柱图组件，单击组件上方的，设置标题内容为“各功能操作频率统计”。 图6 设置图表标题 单击页面上方的，保存设置页面。 单击，进入预览页面，预览效果。 图7 最终呈现效果

操作步骤 参考如何登录AstroCanvas中操作，登录AstroCanvas界面。 在项目列表页面中，单击“导入项目包”。 图1 导入项目包 选择本地已创建好的项目包，单击“打开”，即可将项目导入到AstroCanvas。 导入成功后，在项目列表中，可查看到已导入的项目，并根据自身业务需求，进行二次开发。当所选项目与目标空间存在资产冲突时，如图2所示，此时请参考如何解决资产冲突问题？中操作进行处理。 图2 资产冲突

在组件中使用数据集 返回AstroCanvas项目列表页面。 进入开发页面，拖拽所需组件（如基本柱图）到画布中。 图4 拖拽基本柱图到画布中 选中该组件，单击组件上方的，进入组件数据页面。 在“数据类型”下拉框中，选择“数据集”，选中创建数据集中创建的数据集。 配置全局变量。 全局变量可以理解为参数变量，用于控制组件之间参数的传递，从而达到交互的目的，例如图表联动、自定义字段等功能。静态数据不支持配置全局变量。 在组件预览中，选择要展示的表字段，即从左边栏中拖入到右边栏中，单击“保存”。 图5 拖拽字段到对应的坐标轴 表格字段：展示创建数据集中，录入的静态数据。 配置：从表格字段中，拖拽所需的字段到X轴数据、Y轴数据或系列中。 刷新周期：每隔多少秒获取一次静态数据，默认配置为“0”，表示只获取一次静态数据。 共享数据：是否共享数据。勾选后，如果多个组件调用了相同的静态数据请求，不会各自只调用，而是共享结果数据。 选中基本柱图组件，单击组件上方的，设置标题内容为“各市农作物产量统计”。 图6 设置图表标题 单击页面上方的，保存设置页面。 单击，进入预览页面，预览效果。 图7 最终呈现效果

在组件中使用数据集 返回AstroCanvas项目列表页面。 进入大屏开发页面，拖拽所需组件（如基本柱图）到画布中。 图4 拖拽基本柱图到画布中 选中该组件，单击组件上方的，进入组件数据页面。 在“数据类型”下拉框中，选择“数据集”，选择创建DWS数据集中创建的数据集。 配置全局变量。 全局变量可以理解为参数变量，用于控制组件之间参数的传递，从而达到交互的目的，例如图表联动、自定义字段等功能。如何使用全局变量，可参考如何基于页面级的全局变量实现组件交互~如何通过全局变量，实现组件数据的动态变化。本示例不做配置。 在组件预览中，选择要展示的表字段，即从左边栏中拖入到右边栏中，单击“保存”。 图5 拖拽字段到坐标轴 表格字段：展示创建DWS数据集中，获取的数据。 配置：从表格字段中，拖拽所需的字段到X轴数据、Y轴数据和系列中。 刷新周期：每隔多少秒从DWS中读取一次数据，默认配置为“0”，表示只获取一次。 共享数据：是否共享数据。勾选后，如果多个组件调用了相同的桥接器URL请求，不会各自只调用，而是共享结果数据。 选中基本柱图组件，单击组件上方的，设置标题内容为“各班学科分数统计”。 图6 设置图表标题 单击页面上方的，保存设置页面。 单击，进入预览页面，预览效果。 图7 最终呈现效果

文件介绍 i18n.json为组件的国际化资源文件，用于配置多语言，目前支持的多语言包含中英文两种，相应的key值分别为['zh-CN','en-US']。多语言文件支持配置在多个Json中，在packageinfo.json中的配置示例如下： "i18n": [{ "name": "messages-en" // 组件的多语言文件,相应文件为messages-en.json }, { "name": "messages-zh" // 组件的多语言文件,相应文件为messages-zh.json } ],

文件示例 messages-zh.json配置示例 { "zh-CN": { "dataSetting.s": "系列", "setting": "EchartsWidgetTemplate配置" } } messages-en.json配置示例 { "en-US": { "dataSetting.s": "Series", "setting": "EchartsWidgetTemplate Setting" } }

初识AstroCanvas界面 图1 AstroCanvas界面 表1 AstroCanvas界面介绍 功能 功能介绍 项目列表 项目列表用于对系统中的项目进行集中管理，支持新建项目、删除项目和发布项目等。 新建一个项目 项目可以理解为是一种业务场景的集合，在项目中可以创建多个页面，详情请参见创建项目。 导入项目包 从本地导入已创建的项目包，实现离线迁移、部署项目，详情请参见导入项目。 添加项目分组 支持新建分组，用于集中管理项目。 试试从模板开始 展示系统推荐的模板，可以直接基于推荐的模板快速创建大屏页面。 单击“查看所有”，可查看系统预置的所有模板。 将鼠标放在对应的模板上，单击，可查看模板详情。 直接单击模板，可进入新建项目弹框，直接创建项目和页面。 数据中心 数据中心用于对页面的数据源进行集中的配置管理，支持多种数据源，如静态数据、调用AstroZero API接口、ROMA API接口和AstroZero报表等。 数据源管理：新增并管理关系型数据库、DWS、 DLI 和AstroZero等数据源。 数据集管理：新增并管理数据集，配置数据集后，在组件“数据”页签中可选择具体的数据集。 连接器管理：通过新建HTTP连接器，可引入第三方的API作为组件的数据来源。 转换器管理：转换器是对数据集数据的再加工，为了将数据和组件更好的结合，以达到最佳的视觉展示效果。 我的资产 显示当前用户的素材、组件、库、模板等，更多介绍请参见资产管理。 系统教程 系统教程中提供了一些AstroCanvas的相关视频教程，通过视频有助于您更快速的上手AstroCanvas。 默认团队空间 AstroCanvas支持按照团队空间进行资源隔离和授权，更多介绍请参见新建工作空间。 管理 业务大屏应用管理页面，用于管理大屏用户和页面资产等，更多介绍请参见管理页面。 父主题： AstroCanvas入门

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

配置 在配置中，设置翻牌器组件的样式和动画。 图4 配置 样式设置 字体：设置翻牌器字体、大小和颜色等。 数字背景色：设置翻牌器数字背景颜色。 数字间隔：设置翻牌器数字之间的距离。 卡片内边距：设置卡片距离组件边框的距离。 千分逗号：是否显示千分逗号，默认为显示。 标题：翻牌器标题是否显示，默认为隐藏。设置为显示时，支持设置标题的内容、大小、字体等。 单位：是否显示单位，默认为隐藏。设置为显示时，支持设置单位内容和单位字体等。 动画设置 动画类型：设置翻牌器动画类型，支持普通类型、滚动类型和翻牌类型。 动画时间：设置动画时间，单位为ms。 单次变换间隔：设置动画单次变换间隔时间，单位为ms。

参考线 参考线是指为图表组件添加可视化的参考标准，为图表中数据提供具体的参考依据。 图9 参考线 统一配置：设置参考线两端的样式，如圆形、矩形和三角形等。 Y轴参考线 Y轴参考线：是否显示Y轴参考线。 参考线：设置已有参考线的颜色和线型，单击“新增Y轴参考线”，可新增参考线。单击对应参考线后的，可删除参考线。 X轴参考线 X轴参考线：是否显示X轴参考线。 参考线：设置已有参考线的颜色和线型，单击“新增X轴参考线”，可新增参考线。单击对应参考线后的，可删除参考线。

图例 图例是指在多维度可视化图形表达中，用以区分不同维度可视化图形的提示标识。 图5 图例 显示图例：是否展示图例。图例文字内容来源于数据模型下“s”的取值。 图例标记：设置图例小图标形状和图例列表布局朝向。 图例宽高：设置图例的宽度和高度。 图例间隔：设置图例之间的间隔。 字体：设置图例的字体、颜色和大小等。 左间距：图例到柱图组件左侧距离占组件高度的百分比或图例位置的对齐方式设置。 上间距：图例到柱图组件顶部距离占组件高度。 翻页按钮：翻页按钮的颜色。 翻页按钮不激活：翻页按钮不激活时的颜色。 自定义图例显示：是否开启自定义图例显示设置。开启后，可调整图例名称显示字符长度。默认关闭，即显示图例所有字符。

指标 指标是指可视化组件中，对除可视化图形之外的具体补充，即主要以文字和数字的表现形式，为可视化组件提供具体数值的参考。 图10 指标 显示指标：是否显示指标。 指标内容：设置指标内容。 指标字体：设置指标内容的字体、大小、颜色等。 指标类型：设置指标类型，支持总和、平均值和自定义。 数值内容：“指标类型”设置为“自定义”时，支持自定义数值内容。 数值字体：设置数值字体、大小、颜色等。 数值位数：设置数值小数点后的位数。