# SEP Dashboard with Superset platform setting rules document
###### tags: `Document` `SEP`

#### Change Logs

##### Logs
| Description | Date | Author |
| -------- | -------- | -------- |
| Add Markdown block rules | 2022-10-14 | Wen Wang ([e-mail]) |
| Update Content with Announcement | 2022-06-15 | Wen Wang ([e-mail]) |
| Update Content with charts config | 2022-06-14 | Wen Wang ([e-mail]) |
| Update Content with settings | 2022-06-07 | Wen Wang ([e-mail]) |
| Modified Content | 2022-03-03 | Wen Wang ([e-mail]) |
| Initial | 2021-12-28 | Wen Wang ([e-mail]) |

##### Detail logs

* 所有系列圖表Time Grain只支援以下五種：==年(Year) | 季(Quater) | 月(Month) | 週(Week) | 日(Day)== `@2022-06-07`
* 因應Datahub 2022的升級，有些許圖表規則改變，支援以下幾種類型的圖表，會針對這些圖表做每個圖在Superset平台做該設定的維度條件規則，樣式設定以SEP最後呈現為主。*`@2022-03-03`*
* 目前只支援以下幾種類型的圖表，會針對這些圖表做每個圖在Superset平台做該設定的維度條件規則，**樣式設定以SEP最後呈現為主**。 *`@2021-12-28`*

##### Superset Official Announcement
* `FilterBox` and `Time Series percentage change` will be deprecated. `@2022-06-15`

## Settings
### Basic
- 左側Dashboard & Folder名稱限制12字
- 這部分後續會再console做限制處理
- Dashboard Name SEP系統名稱限制32字
- Chart Title SEP系統名稱限制32字
- 若SEP未支援的圖表類型，將會有UI說明提示

### Filter Component
- 會從SEP右上角進行面板show/hide
- 目前支援 ==**value** | **time range**== 的設定
- 其中time range在SEP讓使用者選擇區間，並無進階細節篩選
- value可進行多選，且選很多格子會往下增長
- 呈上述，也可以設定單選
- 要Apply按下去才會觸發資料連動
- Scoping的部分目前不支援
- ==多個篩選條件是AND==

#### Filter datahub platform細節設定
- 必填一樣都得填入
- Basic選項支援 **default | multiple(value)** 設定
- 進階選項不支援

> 請從以下入口點擊展開並編輯Filter設定

### Chart Basic
- legends數量太多會有左右按鈕可以拉動選取(附圖)

---
:::danger
**:exclamation: Hint**
- Datahub新增圖表至Datahub Dashboard，必須新增一個**Row**或**Column**的空間來放置圖表，SEP才會同步畫面。
- 目前SEP不支援在Datahub component: **Row/Column** 以外的的建置
- 若 Dashboard 在已綁定於 SEP 後，圖表 (Chart) 後續有進行任何修改，請於 Datahub 的該 Dashboard 中先將該圖表 (Chart )移除，再重新將已更新的圖表拖曳至 Dashboard，SEP 前台才會對應更新至最新圖表。
:::

## Big Number
> *大數據呈現結果。*

### Rules
- [DATA] Options
- NUMBER FORMAT : 僅支援 `Adaptaive formating` `,d (四捨五入至整數)`
- TIMESTAMP FORMAT 選項不支援
- [CUSTOMIZE] 目前不支援此分類的任何配置

## Big Number with Trendline
> *大數據呈現結果且畫出趨勢線。*

### Rules
- [DATA] Options
- NUMBER FORMAT : 僅支援 **Adaptaive formating**
- SHOW TREND LINE 請務必勾選。
- TIMESTAMP FORMAT 不支援，依照SEP統一格式 `YYYY-MM-DD`
- [DATA] Advanced Analytics 目前不支援此分類的任何配置
- [CUSTOMIZE] 目前不支援此分類的任何配置

## Bar Chart
> *柱狀圖，X軸維度為category較適用。*

:::info
:bulb: 建議若X軸分類較多，可將可視範圍拉長一點，呈現上也會較清楚。
:::

### Rules
- [DATA] Query
- BREAKDOWNS: 不支援
- CONTRIBUTION: 不支援
- SORT BY: 不支援
- [CUSTOMIZE] 目前不支援此分類的任何配置

### SEP Style Format
- x軸字太長會折行(8字為一組)，且會隔行顯示

## Line Chart
> *折線圖。*
>
:::info
:bulb: 建議若X軸分類較多，可將可視範圍拉長一點，呈現上也會較清楚。
:::

### Rules
- [DATA] Query
- CONTRIBUTION: 不支援
- GROUP BY: 僅支援設定一組
- [DATA] Advanced Analytics 不支援
- [DATA] Annotations and Layers 不支援
- [CUSTOMIZE] 目前不支援此分類的任何配置

## Dual Line Chart

>*雙Y軸(不同單位)折線圖。*
:::info
:bulb: 建議若X軸分類較多，可將可視範圍拉長一點，呈現上也會較清楚。
:::
:::warning
:exclamation: 兩個Y軸都需要在平台進行設定。
:::

### Rules
- [DATA] Y軸設定選項不支援BOUNDS的設定
- [DATA] Annotations and Layers 不支援。
- [DATA] Yaxis
- AXIS FORMAT 僅支援 `Adaptaive formating`

## Histogram

> *直方圖，是一組連續數字資料的次數分配圖。*
:::info
:bulb: 建議若X軸連續數字較多，可將可視範圍拉長一點，呈現上也會較清楚。
:::
:::warning
:exclamation:SEP在計算bins數量採用Excel算法 [Reference](https://en.wikipedia.org/wiki/Histogram#Square-root_choice)，會與平台呈現的bins數量不太相同，但數字是正確的。
:::

### Rules
- [DATA] Query
- COLUMNS 只支援一組設定。
- GROUP BY 不支援。
- [CUSTOMIZE] 目前不支援此分類的任何配置

## Pie (Donut) Chart
> *圓餅 (甜甜圈)圖。*

### Rules
- [CUSTOMIZE] 僅支援將 "DOUNT" 選項打勾，呈現甜甜圈圖樣式。

## Table
> *資料表格。*
:::info
:bulb: 建議若欄位數較多，可將可視範圍拉長一點，呈現上也會較清楚。
:::

### Rules
- [DATA] Query
- 不支援 PERCENTAGE METRICS
- 不支援 SHOW TOTAL | INCLUDE TIME | SORT DESCENDING
- 不支援 SORT BY
- 但可以在SEP點擊表頭做升降冪排序
- [CUSTOMIZE] 目前不支援此分類的任何配置

## Funnel Chart

> *漏斗圖。*

### Rules
- [CUSTOMIZE] 目前不支援此分類的任何配置

## Bullet Chart

> *子彈圖。*

### Rules
- [DATA] Chart Options
- 只支援 RANGES, MARKER LINES 設定

## Sankey Diagram

> *桑基圖，是一種特定類型的流程圖，圖中延伸的分支的寬度對應數據流量的大小。*

:::info
:bulb: 建議若分類眾多複雜，可將可視範圍調大一點，此圖表呈現會更具體。
:::

### Rules
- [DATA] Query
- SOURCE/TARGET 務必要設定來源&目標，不然桑基圖無法正確畫出起點與終點。
- [CUSTOMIZE] 目前不支援此分類的任何配置

## Bubble Chart

> *泡泡圖。*

### Rules
- [CUSTOMIZE] 目前不支援此分類的任何配置

## Graph Chart

*關係圖。*

### Rules
- [DATA] Query
- SOURCE CATEGORY 不支援
- TARGET CATEGORY 不支援
- [CUSTOMIZE] 目前不支援此分類的任何配置

## Gauge Chart

> *儀表板圖*

### Rules
- [DATA] Query
- GROUP BY 不支援。
- [CUSTOMIZE] Chart Options
- General 底下的 min/max/start angle/end angle 可自由設定
- [CUSTOMIZE] 除上述其他尚不支援

## Area Chart

> *區域圖*

### Rules
- [DATA] Query
- CONTRIBUTION: 不支援
- [DATA] Advanced Analytics 不支援
- [DATA] Annotations and Layers 不支援
- [CUSTOMIZE] 目前不支援此分類的任何配置

## Time-series Bar Chart

> *時間序列的柱狀圖*

### Rules
- [DATA] Query
- CONTRIBUTION: 不支援
- GROUP BY: 不支援
- SORT BY: 不支援
- [DATA] Advanced Analytics 不支援
- [DATA] Annotations and Layers 不支援

## Time-series Chart

> *時間序列的折線圖*

### Rules
- [DATA] Query
- CONTRIBUTION MODE: 不支援
- GROUP BY: 不支援
- SORT BY: 不支援
- [DATA] Advanced Analytics 不支援
- [DATA] Annotations and Layers 不支援
- [DATA] Predictive Analytics 不支援
## Time-series Table

> *時間序列的表格 (含趨勢線)*

### Rules
- [DATA] Query
- TIME SERIES COLUMNS
- Type 僅支援 `Sparkline` `Time Comparsion`
- 其中 `Time Comparsion` 是會顯示最近時間的值

## Markdown區塊
> 使用md語法做呈現

### Rules
- 一樣要將區塊放置一個Row/Column裡
- 樣式有些許不同，這邊參照此[規範](https://sindresorhus.com/github-markdown-css/)做樣式處理，不特別做處理是為了讓md區塊編譯出來的語法跟SEP系統本身的樣式不要有過多的差異。
- 若要使用 "-----" or "=====" 請都與上下段落隔一行，避免語法錯誤。
- 不需使用`<br></br>`語法，避免語法錯誤。