Davinci使用说明文档

背景
Refer
功能详解
- 用户能力
- - 用户注册
  - 用户权限
  - - 组织能力编辑
    - 项目信息编辑
    - 成员信息编辑
    - 角色信息编辑
    - 组织信息编辑
- 用户能力
- - 基础使用顺序
  - 数据源-Source
  - - JDBC
    - CSV
  - 数据视图-View
  - - 编辑
    - 变量
  - 可视化组件-Widget
  - - 数据配置
    - 可视化样式
    - 其他配置
    - 组件配置
  - 仪表板-Dashboard
  - - 分享
    - 联动
    - 控制器
  - 大屏-Display
  - 定时任务-Schedule

背景

针对目前Davinci的基础能力进行归纳和整理，针对过往的能力不支持部分进行整理满足，此外参考用户手册进行文档整理。建议先仔细研读官方用户手册而后可以探索性的进行测试，该文章会在探索性测试环节给予一些帮助

Refer

Davinci 官方用书手册
Davinci用户手册

功能详解

用户能力

用户注册

初次使用Davinci的用户需要使用邮箱注册，按照要求输入对应的账号/邮箱/密码等信息即可收到Davinci发送的激活邮件，点击即会跳转到Davinci登录成功的页面。

用户权限

普通用户在首次使用Davinci产品时可以自定义自己的组织等相关信息，也可依赖其他项目或组织的负责人进行的邀请以进入其对应的组织中。针对组织的负责人可以在项目模块管控其下的BI项目的配置，在成员模块邀请或清除对应的组织成员，在角色模块创建角色，配置角色对应的成员信息，在设置模块对组织基础信息进行变更配置。

组织能力编辑

组织是用户的基本聚合单元，在组织中可以创建多个项目及角色，可以通过邀请用户加入组织来管理角色。组织内部通过项目——>用户——>角色来进行权限模型管理，也就是基础属性包括用户，角色，权限，通过对该关系的维护来保障不同角色的用户（不同用户的不同角色）的权限关系，包含一对一，多对多等多种关系。
通过用户图表——>用户设置进入个人页中的“我的组织”，用户自己创建和受邀请参与的组织都会显示在列表中

项目信息编辑

项目信息包括对用户创建的项目的各种基础信息及所能看到项目的用户及角色的权限配置等。
基础信息的设置：可见性（公开 / 授权）描述，当可见选“公开”时，任何组织成员都可以看到该项目，并拥有项目 Viz 模块的只读权限；选“授权”时，只有该项目所关联角色关联的成员才能看到项目。此外移交项目是描述用户可以将项目归属权移交给另一个自己所在的组织，需要注意的是，如果用户在另一个组织里不是拥有者，项目移交过去之后用户将不再拥有项目的管理权限。除了在这里，还可以在首页点击项目卡片右上角的小图标来移交项目。
角色信息的设置：主要配置该项目内关联的拥有权限的角色及该类角色可以使用该项目中的那些功能或位置，如RBAC权限管理中相同，在角色在项目中的不同权限除功能外还配置了不同的可视化权限（可查看路径）。

功能权限中除了基础的 5 个功能模块之外，还有包括分享和下载权限的设置。基础功能权限选项的意义如下：

隐藏：该功能模块对角色不可见
只读：角色仅拥有该功能模块的访问权限
修改：角色拥有该功能模块的访问、编辑权限
删除：角色拥有该功能模块的访问、新增、编辑和删除权限

管理员的设置：管理员拥有项目内的最大权限

成员信息编辑

用于处理成员的邀请和相关信息，只能邀请已登录过的用户，存在登录信息的用户可以通过用户名 / 邮箱 / 用户姓名进行搜索，也可以选择是否需要邮件确认

参与组织的用户都是组织成员。组织成员有两种类型：

拥有者——>可以改变成员类型和移除成员：可视为组织管理员，拥有以下权限创建、编辑和删除项目邀请和移除成员，改变成员类型创建、编辑和删除角色，给成员关联角色给项目关联角色，分配角色在项目中的权限添加和移除项目管理员编辑组织设置默认拥有所有项目管理员权限
普通成员——>可以查看组织中其他成员的角色列表：在关联角色之后，拥有所关联角色在项目中的权限可以被指定为项目管理员，拥有所指定项目的最大权限

角色信息编辑

在一个组织中可以创建多个角色，当角色与项目关联后即可以配置角色在对应项目中的功能和可视化的权限。并在该页面可以配置角色关联的用户。
注：如果同一个用户关联了多个角色，在一个项目中又同时关联了这多个角色，那么用户在该项目中拥有权限将是这多个角色权限的并集

组织信息编辑

组织信息的配置信息见明知意，故暂且不提

用户能力

基础使用顺序

BI能力实质上是通过对数据源进行处理并可视化的过程，那么便带出了BI处理的入口与出口，也就是数据源（Source）和看板（Dashboard）或大屏（Display）。但是在对数据的处理过程中，实际上我们不会真正变更原始数据，所以借助指计算机数据库中的视图二字可以很清晰的描述该部分能力，视图是一个虚拟表（内容由查询定义，且其仅是存储在数据库中的查询的SQL 语句的实现），故在数据源（Source）后存在数据视图（View）。另外，我们的看板或报表的展示，是需要使用模块化的能力进行组装，那么每一个模块或每一个螺丝钉，实际上就是可视化组件（Widget）。所以可以理解整体上是顺序的，数据源（Source）——>数据视图（View）——>可视化组件（Widget）——>仪表板（Dashboard）。

数据源-Source

数据源的接入是用于管理用户对多种多样的数据库连接配置的，常见的可通过JDBC连接的数据源如MySQL，Mongo，Oracle，Hive等。此外，针对常规的基础能力即CSV，Davinci也提供该能力（仍然需要设置数据库连接，主要作为表格数据的承接）。

JDBC

针对JDBC连接，首先需要数据库连接驱动的jar包，默认支持且存在的是MySQL的jar包，这边还插入了Hive的jar包可供使用，基础路径与程序调用相同，新增方式也比较简易，暂且不提。

CSV

CSV数据源是供给给非数据库使用者的数据展示或供给能力，那么基础的CSV的文件规范包括：

第一行为字段名称，建议使用英文
第二行为字段类型，使用大写字母
第三行之后为明细数据
CSV 文件需要保存为 UTF-8 格式

CSV数据源新增流程：

新增数据源——>填写配置与上传CSV文件

在配置CSV文件的上传和配置时需要注意

表名：CSV文件内容在数据库中生成的表名称
键和索引键为可选项，选择适当的导入方式新增：在数据库中新建表并上传数据，当库中有相同名称表时会报错
替换：清空表原始数据并上传新数据
追加：在表原始数据基础上增量追加新数据
覆盖：重建表结构、清空表原始数据并上传新数据

其中“替换”和“覆盖”都会清空表原始数据，但区别在于，“替换”不改变表结构，“覆盖”会按照 CSV 文件中的字段信息重建表结构
数据源导入成功则可以在MySQL数据库中看到该数据表的内容，后续操作则是基于该份数据进行操作。

数据视图-View

编辑

在针对数据表的编辑页面中是纯SQL编写，对于不同数据源的SQL使用遵循各数据源的版本，如MySQL若是5.7，则不会支持窗口函数等复杂聚合，Hive版本若是1.1.0，也存在部分函数无法使用。完全依赖集群的版本，这点是毋庸置疑的。

变量

Davinci目前支持两种变量类型，查询变量和权限变量。查询变量主要是通过与 Widget 和 Dashboard 中的控制器关联，起到动态变化 SQL 模板的作用。权限变量则是通过对角色赋值的方式进行控制（实质上是在查询过程中带入where条件中）

系统变量用于做用户粒度权限控制，Davinci 内置了以下5个系统变量

$DAVINCI.USER.ID$：登录用户ID
$DAVINCI.USER.NAME$：登录用户姓名
$DAVINCI.USER.USERNAME$：登录用户用户名
$DAVINCI.USER.EMAIL$：登录用户邮箱
$DAVINCI.USER.DEPARTMENT$：登录用户部门

权限控制后对应权限的用户则会通过where条件筛选对应选项，展示不同的信息及内容
注意：权限变量所在的条件判断片段一定要使用小括号包裹
例如这里我使用了valid做基础的权限控制，那么可以看到，管理员是可以看到所有的数据，也就是下右，有权限角色则仅可以看到下左的部分数据聚合
Auth权限变量的配置时在“编辑数据模型和权限”步骤中，针对不同的角色，简单的可以通过权限变量值的设置来配置对应角色可见的部分，如下可见，对于有一部分权限的角色可以看到valid为1的数据的聚合值

可视化组件-Widget

Widget主要是对项目内的不同数据的组件的配置，除正常新建外，还可以复制组件信息创建新的组件。在组件中首先选择对应的数据源视图，在选定视图后会按照维度型变量和数值型变量进行数据字段区分，该变量类型的变更或分类在数据视图创建过程中配置的。可选择的图表包括透视Excel图表和各种基础图形图表。在数据组件的配置信息中包括数据配置，样式配置和其他配置来保障数据，可视化的相关信息

数据配置

主要针对数据指标的展现形式包括总计，平均数，计数，去重计数，最大值，最小值等，格式则能使得数据能够按照其正确的格式，如货币，百分比的形式展示。此外可以使用排序的方式对基础数据进行数据对应的图形排序。

可视化样式

主要是数据指标的可视化展示形式的设置，如长宽高等基础信息，标题分割线等辅助信息

其他配置

主要是参考线（包括对基础数据的常量值，平均值等基础信息的参考线或区间配置），控制器（包括对数据指标的筛选条件的配置信息等），是否使用缓存进行数据库基础数据的内存缓存机制等
针对控制器所需的关联字段，即为筛选字段，如日期筛选则关联某一日期字段等

组件配置

在右上角保存命令旁边的设置信息中主要是对可视化组件的基础信息配置，如查询触发方式主要描述数据视图的查询方式，默认为立即触发，即拖拽字段到数据页签后立即查询并刷新右侧图表。如果数据视图的查询时间较长，可以尝试设置查询触发模式为手动来缓解数据库压力；设置为手动之后，图表配置区中间会显示一个查询按钮，拖拽字段不再触发查询，需要点击按钮触发。多选拖拽则是在对维度或指标类型数据的选择时是否可以通过多选的方式进行配置。

仪表板-Dashboard

Davinci对外提供的分享包括三类（普通口令分享，即输入有效期后，点击生成分享链接，在任意浏览器打开链接即可查看分享页，分享页的数据权限与分享者一致；口令分享，即输入有效期后，点击生成分享链接和口令，在任意浏览器打开链接，需要输入正确口令才能查看分享页，分享页的数据权限与分享者一致；授权分享，即将仪表板分享给所属组织里的角色和成员，仅有授权的角色及成员登录后才能查看分享页，还可以在配置界面中筛选授权的对应权限的角色等信息）

联动

联动在某种程度上是与触发器相似的，但是触发器只能选择图表所用到的字段，联动图表可以选择数据视图模型中的任意字段和变量；触发器与联动图表所选的字段类型必须一致。联动通过对输入条件在另一图表中作为条件过滤为手段进行动作关联

控制器

控制器可以在可视化组件Widget处进行配置，在Widget中配置结果如左下所示，会在Widget中进行展示，也可以在仪表板中配置全局控制器，如左上所示，会在顶端展示，不过全局控制器实质上也是可以通过筛选图表进行图表的分开展示，在关联字段时也可以配置不同图表的不同字段进行数据对齐。

大屏-Display

大屏的功能实现类似PPT的展示形式，通过多页及组件或辅助模型的输出，展示对应的数据及说明等信息

定时任务-Schedule

定时任务主要是用户对制作完成的可视化应用来配置发送事件，也就是将看板或大屏通过邮件或企业微信来发送给对应的用户或用户群体。

邮件类型定时任务的设置有：

邮件主题
文件类型：图片：附件及邮件正文中添加所选仪表板/大屏截图，可以设置图片宽度，高度为自适应Excel：附件中添加所选仪表板/大屏明细数据 Excel 文件，其中每个组件对应一个 sheet 页图片 + Excel
收件人：支持多人，输入 Davinci 系统用户邮箱前缀时会有列表提示
抄送、密送：支持多人
内容：邮件正文，可富文本编辑，支持插入图片

Davinci使用说明相关推荐

AM335x 如何修改phy及双网络使用说明（精华！！！）
本文主要描述如何在 AM335x 的 Linux 系统上修改网络 phy 芯片,以及双网络的配置及使用. 包括 uboot 和内核里 phy 的初始化,以及内核里的双网络配置及 phy 的初始化. 本 ...
DaVinci Resolve Studio v18.0.0.10 达芬奇调色软件安装说明
前言 DaVinci Resolve是一款在同一个软件工具中,将剪辑.调色.视觉特效.动态图形和音频后期制作融于一身的解决方案!它采用美观新颖的界面设计,易学易用,能让新手用户快速上手操作,还能提供专 ...
DaVinci Resolve Studio v18.0.0.10 达芬奇调色专业剪辑、调色、特效和音频后期制作
前言 DaVinci Resolve是一款在同一个软件工具中,将剪辑.调色.视觉特效.动态图形和音频后期制作融于一身的解决方案!它采用美观新颖的界面设计,易学易用,能让新手用户快速上手操作,还能提供专 ...
centos下部署davinci
davinci安装部署(centos7.4环境) Davinci官方用户手册: https://edp963.github.io/davinci/docs/zh/1.1-deployment 博客使用 ...
abaqus高性能服务器怎么用,高性能计算平台ABAQUS任务调度使用说明作者陈林E-Mailchenlin.PDF...
高性能计算平台ABAQUS任务调度使用说明作者陈林E-Mailchenlin.PDF 高性能计算平台ABAQUS 任务调度使用说明作者:陈林 E-Mail:chenlin@ 日期:2017-1-10 ...
linux 文件拷贝并替换,Linux_cmd replace 文件替换使用说明，帮助信息：复制代码代码如 - phpStudy...
cmd replace 文件替换使用说明帮助信息: 复制代码代码如下: 替换文件. REPLACE [drive1:][path1]filename [drive2:][path2] [/A] [ ...
Simple Dynamic Strings(SDS)源码解析和使用说明二
在<Simple Dynamic Strings(SDS)源码解析和使用说明一>文中,我们分析了SDS库中数据的基本结构和创建.释放等方法.本文将介绍其一些其他方法及实现.(转载请指明出于 ...
Delphi开发的IOCP测试Demo以及使用说明。
Delphi开发的IOCP,此为压力测试Demo和使用说明.
oracle database link mysql_oracle database link使用说明
oracle database link使用说明作用: 将多个oracle数据库逻辑上看成一个数据库,也就是说在一个数据库中可以操作另一个数据库中的对象. 简易语法: CREATE [PUBLIC] ...

Davinci使用说明

Davinci使用说明文档

背景

Refer

功能详解

用户能力

用户注册

用户权限

组织能力编辑

项目信息编辑

成员信息编辑

角色信息编辑

组织信息编辑

用户能力

基础使用顺序

数据源-Source

JDBC

CSV

数据视图-View

编辑

变量

可视化组件-Widget

数据配置

可视化样式

其他配置

组件配置

仪表板-Dashboard

分享

联动

控制器

大屏-Display

定时任务-Schedule

Davinci使用说明相关推荐

最新文章

热门文章