---
title: Create Dashboard
tags: ThingsBoard
image: https://i.imgur.com/EvPzNax.png
disqus: hackmd
---

FindMe儀表板
===

[toc]

建立專屬儀表板 (Create Dashboard)
---
1. 點選功能列表**Dashboards**，單擊右上角的 **+** 小圖式。選擇 **Create new dashboard**。
2. 輸入儀表板名稱。例如: **FindMe**，點擊 **Add** ，新增儀表板。
3. 開啟 **FindMe 儀表板** dashboard
4. **No widgets configured**，點選畫面右下角白筆圖示，即可進入編輯模式。
在新空白儀表板，首先需要建立別名(Alias)，以便定義將使用實體(Entity)的數據。
5. 點選 **Entity aliases**，Add alias, 按圖索驥，**Add**，**Save**，**Apply changes (v)**。
6. **新增** ++地圖小工具++ (**Map Widget**)
Enter edit mode > + Add new widget > Maps
7. 我們選擇**Google Maps** (Latest values)，如果想呈現手機裝置移動軌跡，可選擇**Route Map**或動態的**Trip Animation**。
:::danger
完成上述步驟後，我們還是無法從**Google Map**地圖上，發現**我的手機**。
Why? Please tell me why?
:::
8. 推估問題可能出在TB地圖小工具看不懂手機上傳的位置資訊格式。
> 2021-06-28 14:19:48 sensors
[{"value0":24.95422503,"value1":121.5377656,"value2":64.94073486328125}]

規則引擎 (Rule Engine)
---
:::info
TB的規則引擎，是一個可高度訂製的系統。使用規則引擎，我們可以過濾或轉換由物聯設備和相關資產傳入的感測數據，進而觸發各種操作，達到即時報警並通知相關權責單位目的。
:::
1. 選擇 **Rule chains** > Root Rule Chain **Open rule chain**
2. 在**Post telemetry**與**save timeseries**之間，插入 **Transformation/script**與連結線(**Success**)。
3. 點選 **script** 編輯
> before

 return {msg: msg, metadata: metadata, msgType: msgType};

> after

var newMsg = {};

 if (typeof msg.sensors !== 'undefined') {
    newMsg.latitude = msg.sensors[0].value0;
    newMsg.longitude = msg.sensors[0].value1;
    newMsg.altitude = msg.sensors[0].value2;
    return {
        msg: newMsg,
        metadata: metadata,
        msgType: msgType
         };
 }
 else
    return {msg: msg, metadata: metadata, msgType: msgType};

4. 選擇 **Devices** > **我的手機** > **Telemetry**，確認位置資訊格式，是否如預期更新。

5. 選擇 **Dashboards** > **FindMe**, **Open dashboard** :100:

實體視圖 (Entity View)
---
Entity View是由多個Widgets構成，用於限定用户瀏覽特定設備或資產相關資訊的視圖。

Resource(s)
---
* [Facebook ThingsBoard Taiwan Group](https://facebook.com/groups/thingsboard)
* https://github.com/thingsboard/thingsboard/issues/923
* https://thingsboard.io/docs/user-guide/rule-engine-2-0/tutorials/function-based-on-telemetry-from-two-devices/
* https://github.com/thingsboard/thingsboard.github.io/blob/master/docs/samples/linkit-one/gps.md
* https://stackoverflow.com/questions/60862296/thingsboard-send-multiple-timeseries-in-one-post
* https://thingsboard.io/images/samples/abeeway/upLinkDecoder.txt
* https://witekio.com/blog/iot-dashboards-thingsboard-examples/
* https://www.instructables.com/LTE-Arduino-GPS-Tracker-IoT-Dashboard-Part-2/