定义看板

点击主页左侧导航菜单的【看板】菜单项,打开看板管理页面,点击【添加】按钮, 填写基本信息,点击【保存并设计】按钮,打开看板设计页面。 设计好看板后,点击【保存并展示】按钮,即可打开看板展示页面。
企业版支持扫码打开看板展示页面,在看板管理页面点击【展示】按钮右侧下拉箭头,在下拉菜单中点击【扫码展示】, 扫描面板中的二维码即可。

看板

一个看板中可以定义任意多个看板模板,一个看板模板即是一个原生的HTML页面。 在看板模板中,可以任意编辑HTML,也可以引入任意JavaScript/CSS库, 为其中任意<div>元素添加一个dg-chart-widget属性, 即可将此<div>定义为一个图表元素。 在展示看板时,所有的图表元素都将被绘制成它所选定类型的图表。
看板模板示例:
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
</head>
<body>
  <div dg-chart-widget="【图表部件ID】" style="width:300px;height:300px;"></div>
</body>
</html>
【图表部件ID】应设置为具体ID值(图表管理页面内的某行ID值)。
看板模板中还提供了很多dg-*元素属性, 详细参考看板源码设计模式章节、看板元素属性章节。

导入看板

在看板管理页面点击【添加】按钮右侧下拉菜单中的【导入】项,即可将任意HTML导入为看板。 导入文件可以是单个HTML文件,也可以是包含HTML文件及其依赖所有资源的ZIP压缩包。
示例:
index.html
或者
my-dashboard.zip
  |--index.html
  |--content.html
  |--style
      |--dashboard.css
  |--images
      |--bg.png
      |--icon.png
  |--script
      |--dashboard.js
导入ZIP压缩包前,确保看板文件、文件夹都直接位于压缩包根目录下,不要再内嵌一级目录。

API版本

在新建和导入看板时,需要设置看板API版本,用于指定看板展示页面加载和提供的API版本。 系统目前有2.01.0两个API版本,新建看板时应选用最新2.0的API版本, 1.0的API版本仅用于支持系统中已存在的旧版看板功能。
不同版本的API是不兼容的,在看板中插入的图表,其对应的图表插件必须声明了相同的API版本(通过apiVersion属性声明)。
也可以在看板源码设计模式中通过优先级更高的dg-api-version指定看板API版本。

设计看板

看板设计功能支持源码设计模式和可视设计模式,点击设计页面看板模板页签下的【源码模式】/【可视模式】可以互相切换,其中:

源码设计模式

HTML纯文本编辑模式,可以自由编辑HTML/JavaScript/CSS文本,也可以引入任意JavaScript/CSS库,能够使用全部看板功能, 适用于熟悉前端开发的技术人员,详细参考看板源码设计模式章节。

可视设计模式

HTML网页元素编辑模式,通过点选元素的方式插入图表、编辑样式、设计布局,所见即所得,仅能够使用部分看板功能, 适用于不熟悉前端开发的设计人员,详细参考看板可视设计模式章节。

管理看板资源

点击看板设计页面右侧【本地资源】下的【+】按钮,可以新建*.html*.js*.css文件, 点击上传按钮,可以上传*.html*.js*.css文件,以及任意其他资源文件(比如图片、视频、音频等)。
比如,上传jQuery库至lib/jquery-4.0.0.min.js目录,作为看板DOM操作支持库:
...
<script src="lib/jquery-4.0.0.min.js"></script>
<script>
$(()=>{
  $("#btn").click(()=>{ $("#panel").toggle(); });
});
</script>
...
<body>
<button id="btn">显示/隐藏图表</button>
<div id="panel">
...
</div>
...
</body>
...
上传一个名称为bg.png的图片后,将它设置为看板背景:
...
<style type="text/css">
.my-dashboard{
  background: url(bg.png);
}
</style>
...
<body class="my-dashboard">
...
</body>
...
上传一个名称为custom-map.jsonGeoJSON地图文件,将它设置为图表地图:
...
<div dg-chart-options="{mapName:'custom-map.json'}" dg-chart-widget="..."></div>
...

使用全局资源

点击看板设计页面右上角的【全局资源】按钮,可以打开系统全局看板资源对话框, 选中后点击【确定】按钮,全局资源URL将会被复制到剪切板,可以在看板模板中引入使用。
在看板模板中,全局资源是以global/前缀的方式引入使用的。
比如,对于全局资源:
css/common.css
img/logo.png
script/util.js
可以在看板模板中以如下方式引用:
<!DOCTYPE html>
<html>
<head>
<link type="text/css" href="global/css/common.css" rel="stylesheet" />
<script src="global/script/util.js"></script>
</head>
<body>
  <div class="logo">
    <img src="global/img/logo.png">
  </div>
  ...
  <div dg-chart-widget="..."></div>
  ...
</body>
</html>
global/前缀方式引入全局资源比较直观和易于理解,但是在浏览器端,可能无法对全局资源跨看板缓存,从而导致看板加载时间增加。 为了解决这个问题,可以使用../global/前缀方式引入全局资源,比如:
<!DOCTYPE html>
<html>
<head>
<link type="text/css" href="../global/css/common.css" rel="stylesheet" />
<script src="../global/script/util.js"></script>
</head>
<body>
  <div class="logo">
    <img src="../global/img/logo.png">
  </div>
  ...
  <div dg-chart-widget="..."></div>
  ...
</body>
</html>
管理员登录后,可在右上角设置菜单【数据分析 - 看板全局资源】中打开看板全局资源管理功能,新建或者上传全局资源。

内置看板库

在看板展示时,系统会自动为看板页面引入一些Javascript库, 主要封装在window.chartFactorywindow.dashboardFactory变量中,用于支持看板功能。
请勿在看板中使用这些内置库,它们没有版本兼容支持,每个版本都可能有破坏性更新。
企业版自1.3.0版本起,支持管理员自定义内置看板库, 登录后,点击主页面右上角设置菜单的【数据分析 - 看板全局库】项, 可设置看板全局库,它们也将在系统的所有看板展示页内自动引入。

分享看板

在看板管理页面,选中一条记录后,点击【分享】按钮,可以将看板分享给指定用户/角色。 如果看板加入了项目,将会继承项目的分享设置。
企业版增强了分享功能,可以详细设置看板的只读、编辑、删除分享权限,以支持多用户协同操作。
企业版自1.1.0版本起,支持将看板分享给指定组织机构。
 
京ICP备18055183号-1
© 2018-2024 datagear.tech 北京溪歌科技有限公司
登录