1.概述
1.1.应用场景
为方便用户计算同期/前期，Smartbi提供向导创建同期前期，Smartbi提供 向导 创建同期/前期的功能，也支持通过 函数 模式创建，参数模式可参考：数据模型-环比系列、数据模型-环比系列。 模式创建。
1.2 定义
若分析区域维度栏包含 时间层次 字段，则时间层次支持的计算类型如下所示：
| 使用条件 | 支持计算内容 | 说明 |
|---|
| 分析区域维度栏包含 时间层次字段情况下使用。 | 同期值 | 指标设置所属周期对应的值 |
| 同比 | 1+(同比增长值/同期值) |
| 同比增长 | 当前值-同期值 |
| 同比增长率 |
| 同比增长/同期值 | |
| 前期值 | 指标设置所属周期对应的值 |
| 环比 | 1+( |
| 环比增长/ |
| 前期值) |
| 环比增长 | 当前值- |
| 前期值 |
| 环比增长率 |
| 环比增长/环期值 |
时间层次 | 支持计算类型 |
|---|---|
| 年 | 年前期、年环比，年环比增长值、年环比增长率年前期、年环比，年环比增长、年环比增长率 |
| 年季度 | 季前期、季前比增长值、季前比增长率、年同期、年同比、年同比增长值、年同比增长率 |
| 年月 | 月前期、月环比、月环比增长值、月环比增长率、年同期、年同比、年同比增长值、年同比增长率月前期、月环比、月环比增长、月环比增长率、年同期、年同比、年同比增长、年同比增长率 |
| 年周 | 周前期、周环比、周环比增长值、周环比增长率、年同期、年同比、年同比增长值、年同比增长率周前期、周环比、周环比增长、周环比增长率、年同期、年同比、年同比增长、年同比增长率 |
| 年月日 | 上述均支持 |
2
...
示例
2.1 同期系列
| 信息 | ||||
|---|---|---|---|---|
| 注：求同期为计算上一时间维度中当前时间点的数据值，且具体的时间层次不同时获得的同期数据也不一样。当时间层次维度为 ”年月“，年同期为去年同月的数据；当分组为”年月日“，年同期为去年同日的数据。||||
1、同期 依赖时间层次，需要先在模型中创建好时间层次，详情查看：创建时间层次。 2、求同期：计算上一时间维度中当前时间点的数据值，且具体的时间层次不同时获得的同期数据也不一样。 当时间层次维度为 ”年月“，年同期为去年同月的数据，当时间层次维度为”年月日“，年同期为去年同日的数据。 3、同期类的计算，存在一个基准 例如，2020年2月，如果：
4、在报表层也支持向导创建向导计算度量：仪表盘创建计算度量、透视分析创建计算度量。 5、还支持在报表层通过快速计算的方式创建同期值：快速计算。 |
例如：
- 年同期：已知 2021 年 1 月的合同金额，去年（2020年） 1月份的 合同金额 为它的年同期数据。
- 月同期：已知 7 月 28 日的合同额，则 上个月 6 月 28 日的合同金为它的月同期数据。
示例: 使用 产品自带的 指标数据库的合同维、合同事实维等构建 毛利主题，计算每个月份的年同期数据。
最终效果如下：
以向导创建同期值、同比、同比增长值、同比增长率 ，下面以”同期值“作为示意
新增：在计算类型选择”同期值“，会自动长出需要输入的参数，如下图,
基值：一般是指，度量或计算度量
时间层次：可以拖入具体的时间层次，比如年、年季、年月、年月日等
偏移数：必填，只能输入正整数，默认1；在行/列轴上，当前时间层次是【年】代表上一年；如果是【年季】,代表上一季度；如果是【年月】，则是上个月；如果是【年月日】则是上一天； 填2则代表上2年指标数据库 的“合同维”、“合同事实维“等构建 毛利主题，计算每个月份的年同期数据。
具体操作步骤如下：
1、创建数据模型，并且加入”合同维”、“合同事实维“等创建数据模型"毛利主题",并且创建时间层次，如下图：
2、创建计算度量：命名为：“ 同期值(合同金额)”，并且计算类型选择”同期值“，选择之后会自动长出需要输入的参数：
| 选项 | 内容 |
|---|---|
| 入口 | 在数据模型、报表层都可以添加计算度量，详细可查看：仪表盘创建计算度量。 |
| 创建方式 | 支持向导、函数模式创建。
|
| 计算类型 |
|
| 基值 |
|
| 时间层次 |
|
| 偏移数 |
|
...
填充了参数的效果如下,如果拖拽错了参数还可点击X删除，进行重拖：
当切换到高级模式时，可以查看对应的运行语句, 根据业务需要，可以需求调整语句,如果调整了运行语句
| 注意 |
|---|
如果由【高级】模式切换回去【简单】模式 1.运行语句已经改变，切换回去之后之前拖入的基值、时间层次等参数会清空，需要重新拖入； 2. 如果没有改变运行语句，切换回【简单】模式会保留之前拖入的参数； 注意：运行语句换行或者格式化都会判断为已改变状态。 |
点击【确定】，在仪表盘会自动生成在【自定义度量】目录下，如果该仪表盘第一次创建，则会在度量区自动创建“自定义度量”目录，如下图：
如果发现拖错了基值或者时间层次，可选中计算度量，右键菜单“编辑”或者“删除”如下：
同比、同比增长值、同比增长率 ， 与同期值的输入参数一致，操作也是一致的,只是计算公式不一样，这里不再重复描述。
查询：最终拖入到组件中展示:
2.1 前期系列
求前期表示求相对于当前时间粒度的前一周期的值。例如今天的前一天，这个月的前一个月对应的值都是前期值。
在维度拖入时间层次字段，且为年月日、年周、年月、年季度、年等，才可以使用。
1）维度中拖入[年月]，在行/列区拖入两个[合同金额]，对后一个[合同金额] 字段求[前期]，如下图所示：
新增：在计算类型选择”前期值“，会自动长出需要输入的参数，如下图,
基值：只能拖入度量或者计算度量，拖入其他是拖入不进去的。
时间维度：只能拖入时间维度目录，无法拖入具体的时间层次； 这个跟同期系列以及同期累计只能拖入具体的时间层次有所不同。
| 注意 |
|---|
前期类的计算（包括前期和环比），它所依赖的时间层次是固定的，即当前成员所在的层次。 例如，2020年2月，它的前期，只需要知道找到哪个维度就好，找到之后就是当前成员所在层次，因此指定维度就好，偏移1就是2020年1月，偏移2就是2019年12月。 同期类的计算，存在一个基准，例如，2020年2月，偏移数1，如果按年同期，则是2019年2月，按季度同期，是2019年11月，按月同期，则退化为前期，就是2020年1月，所以同期类必须要要选择基准层次。 |
...
| 切换创建方式 | 如果发现 向导 没办法满足业务需求，可切换 函数 模型，根据向导模式生成的多维表达式，再调整成符合业务需求的计算需求。
|
| 定位 | 通过 |
| 删除 | 点击 |
3、用上面的方式、方法创建同比、同比增长值、同比增长率 。
4、保存数据数据模型并且创建交互式仪表盘，拖入组件，效果如下图：
2.2 前期系列
| 信息 | ||
|---|---|---|
| ||
1、前期：表示求相对于当前时间粒度的前一周期的值。 2、在维度拖入时间层次字段，且为年月日、年周、年月、年季度、年等，才可以使用；例如今天的前一天，这个月的前一个月对应的值都是前期值。 3、前期类的计算（包括前期/环比/环比增长/环比增长率），它所依赖的时间层次是固定的，即当前成员所在的层次；例如：2020年2月，它的前期，偏移1就是2020年1月，偏移2就是2019年12月。 4、在报表层也支持向导创建计算度量：仪表盘创建计算度量、透视分析创建计算度量。 |
示例: 使用 产品自带的 指标数据库 的“合同维”、“合同事实维“等构建 毛利主题，计算每个月份的前期数据。
1、在2.1章节 创建的“毛利主题”中添加“前期值(合同金额)”、环比(合同金额)、环比增长(合同金额)、环比增长率(合同金额); 以”前期值(合同金额)“为示例：
- 时间维度：只能拖入 时间维度目录，无法拖入具体的时间层次； 这个跟同期系列以及同期累计只能拖入具体的时间层次有所不同。
- 偏移数：必填，只能输入正整数，默认1；在行/列轴上，当前时间维度是“年”代表上一年；如果是“年季”,代表上一季度；如果是“年月”，则是上个月；如果是“年月日”则是上一天;填2则代表上2年/年月...，依次类推。
如果切换成 高级模式也可查看对应的运行语句并且还可以预览数据，如下图：
其他操作与 2、用上面的方式、方法创建环比(合同金额)、环比增长(合同金额)、环比增长率(合同金额)。
3、保存数据数据模型并且创建交互式仪表盘，拖入组件，并且拖入“前期值(合同金额)”、环比(合同金额)、环比增长(合同金额)、环比增长率(合同金额)，效果如下图：
其他操作与 同期一致！
