星空LIVE配置教程

一、概述

星空LIVE是一个基于云星空的通用取数平台，并集成了单据查看，云之家分享，小K卡片以及云之家机器人等功能，目的是方便客户对星空的业务单据数据进行追踪、审阅，其目前功能结构大致如下图1-1：

                                                                 图1-1                                

二、LIVE后台配置

1 卡片配置

    卡片配置参数通过注入到星空LIVE的卡片引擎中生成一条或者多条执行的SQL进行取数，然后对这些数据根据计算表达式进行计算，最后生成最终的结果,其结构大致如图2-1

                                                                图2-1 

1.1 指标卡片

指标卡片主要用于根据业务领域的计算规则对数据进行一个展示，并且可以依次钻取对数据进行分组查询。已审批的卡片或者预制卡片不允许修改，未审批的卡片或者被禁用的卡片不会在移动端显示。

创建卡片时可以让卡片类型在单据卡片和指标卡片间进行切换，卡片标题目前允许重复，如果有重复，请勿分配在同一主题下。

1.1.1 数据源配置

                                                                       图2-2

•     数据源可以选择多个，选择数据源时会根据数据源类型进行过滤，数据源名称默认是选择的单据或者基础资料名称，该字段必须唯一

• 如果有需要可以添加一个单据体，但是单据体只能在聚合查询的时候使用，如表达式中的汇总，单据列表的汇总

• 过滤方案和过滤条件是取交集，且过滤方案中的高级配置不支持，请注意组织的选择。过滤条件最后会被追加到执行sql中，请根据数据库中实际有的字段进行编写，因为部分元数据有的字段可能数据库没有

• 日期字段默认是元数据中配置的日期字段，该字段可以为空，为空时数据引擎默认不支持日期相关功能的过滤

• 强调显示字段用于确定单据列表主体显示的字段

1.1.2 计算指标配置

                                                                       图2-3

• 计算指标分为汇总和表达式编辑，汇总无法对多个数据源进行处理，且会根据选择的汇总字段类型进行判断，只有数字类型的字段才会有合计等操作

• 表达式编辑的单个单位是 操作符([数据源].[数据源字段]) ，可以手动输入，也可以通过下面新增按钮进行添加。 【数据源】是指的数据源名称，不是业务对象或者基础资料的名称，再此基础上支持4则运算操作，同时当焦点移开输入框时会校验该表达式，验证的结果会在右边显示，保存卡片时也会验证，验证失败不能保存。

1.1.3 下查钻取配置

                                                                          图2-4

• 下查钻取方式，自由钻取会在主题卡片里提供当前配置的所有可钻取字段的选项，用户可以自由选择，按顺序钻取，用户不能自由选择，只会显示下一级可钻取字段的选项，不钻取，则不能进入到钻取首页

• 默认排序方式，排名数据的的排序方式

• 钻取时支持显示占比 ，用于控制钻取页面是否显示 “百分比占比” 按钮

• 钻取时支持显示较上期，用于控制显示钻取页面是否显示同环比数据 ，同环比的数据计算方式是通过改变当前数据引擎中的时间参数，重新计算出的数据和当前数据做对比，如果上期数据或者当前数据有为0的情况则只显示增加减少数字而不显示百分比

• 钻取比较上期显示规则，钻取时支持显示比较上期勾选时可用，用于控制钻取页面是否显示同比还是环比还是都显示

• 钻取字段只会显示绑定了数据库字段的字段，且每个数据源对应的字段都必须填完，如果无一个勾选默认钻取字段，则第一个是默认钻取字段

1.1.4 下查钻取配置

                                                                               图2-4     

• 可用日期范围，用于设置主题页面卡片上用户自定义日期的选项

• 默认日期范围，卡片取数时默认的时间过滤范围，“默认日期范围” 默认在 “可用日期范围”里面

• 显示单位、小数数字、不显示尾零、分隔符 用于对卡片中数据显示的约束

• 卡片支持显示比较上期和卡片比较上期显示规则 用于控制汇总数据的同环比显示 请参考 1.1.3 钻取字段同环比显示规则

  
  

1.1.5 下查钻取配置   

                                                                                图2-5

• 数据源，数据源名称和强调显示字段是代理字段，请参考1.1.1 数据源配置

• 单据列表中的字段顺序以这里字的序号为准， 如果是单据体字段必须要选择一种汇总方式

  
  

1.1.6 下查钻取配置   

                                                                                图2-6

• 卡片列表别名目前允许重复，但尽量不要重复，只有设置了别名且发布且有权限的卡片才会在小K那边查询到

  
  

  
  

1.2 单据卡片

单据卡片是指标卡片的简化版，用于快速定位条件范围内的业务单据数量，并对业务单据进行查看，所以其配置与指标卡片配置基本一致，其主要区别如下。

• 单据卡片相比于指标卡片，数据源只能选择一个且只能通过单据列表配置中的代理字段去添加

• 单据卡片会多两个代理字段，日期字段和过滤方案，对应数据源中的日期字段和过滤方案

• 不能添加计算表达式，后台会设置默认的表达式  计数（[数据源].[数据源主键]）

• 默认的显示设置，单位为张，去尾零，保留小数为0，默认末级联查单据列表

• 不显示同环比，不能进去钻取首页。

• 必须配置单据列表数据
  

2 主题配置

主题是星空LIVE展示的单位，主题会包含多张在业务上有关联的卡片，但是卡片可以单独展示，如分享和在小k中显示，卡片对用户的授权统一是在主题中进行的

                                                                                图3-1

• 可以新增一个分组对主题进行管理，目前只有分类的作用

• 公开主题  只有公开的主题且已审批非禁用状态的卡片才能被用户订阅

• 卡片明细 用于添加卡片，只能添加审批通过的卡片，卡片被禁用或者反禁用这里不会关联删除，但是在前端这张卡片不会再显示

• 已分配用户和已订阅用户会在主题已审批状态下显示， 对于非公开主题，主题创建人需要在主题审批通过后在已分配用户下添加目标人员，已订阅用户会显示当前已经订阅的人员，如果用户取消订阅，即使管理员对该用户进行了分配也不会在用户界面显示

  
  

  
  

  
  

二、消息机器人

消息机器人用于对将指定的卡片按照固定周期推送到云之家群里面，群成员可以点击该卡片进入到该卡片详情，如果进入时该用户无业务对象权限，则会提示无数据权限。

1 .云之家消息机器人配置

• webhook可以在对应云之家目标群的群设置里的群组机器人下找到，必须要是该群的管理员，如果没有可以新增一个机器人

• 发送间隔默认是1小时，且最低间隔也是1小时

• 对应权限用户 推送卡片时会以该用户的上下文进行推送，原因是不同的用户看到的数据可能不一样

• 最后一次执行时间和执行结果会显示上次执行的日期和结果，结果只会是成功或者失败，如果想知道详情，可以去日志中查看

2.消息机器人执行计划

在执行计划列表中搜索 云之家消息机器人 ，除修改时间间隔和查阅执行计划状态日志外，请勿随意修改该配置参数