圖表註解

圖表擅長顯示某項變動，但無法告訴你原因。圖表註解正是用來記錄這些原因的地方：點擊 Dashboard 圖表上的某個點，並記錄當時的情況，這樣下個月你仍能清楚了解那次激增的原因。

註解是針對特定時間點的測量值所做的標記，而非針對單一圖表。如果您在血糖數據上添加註解，該註解將會顯示在所有血糖圖表上，無論該圖表顯示的細緻程度為何。

撰寫註解

點擊圖表上的任意一點。此時會開啟一個小型編輯器，顯示日期、該點的數值，以及供您輸入註解的文字框。輸入發生了什麼事，然後按下「儲存」。

記錄的日期是您點擊的區間，而非點擊的瞬間。在月線圖上標註的內容是關於該月份的，因此它會保持在您標註的位置，而非移動到今天。

您可以在同一個點上寫下多條註解。再次開啟該點時，系統會在現有註解下方提供一個新的註解框。

註解會顯示在哪裡

註解會以小型方塊的形式顯示在圖表下方的欄位中，並與其對應的資料點對齊。將游標懸停在方塊上即可閱讀完整的註解，或點擊該方塊進行編輯或刪除。

當多個註解緊密相鄰時，它們會合併成一個顯示總數的圖示。點擊該圖示，編輯器便會列出所有註解，如此一來，即使工作繁忙的一週也不會讓圖示堆疊成一排。

一項註解，適用於每張圖表

註解位於測量數據之後。由此可得出兩點結論，兩者皆屬刻意為之：

• 在日線圖上寫下的註解，也會出現在相同時間尺度的週線圖或月線圖中，位於包含該註解的區塊內。只需輸入一次，無論您在何處查看該資料，都會顯示該註解。
• 單位並不重要。以英里為單位標註在圖表上的註解，也會出現在以公里為單位繪製的相同圖表上；而標註在 mg/dL 血糖圖表上的註解，也會出現在 mmol/L 圖表上。

隨閱讀材料附帶的註解

某些來自您資料來源的讀數會附帶註解；至於僅記錄單一數值的測量項目（例如血糖、氧氣和溫度），該註解也會以註解的形式顯示。

這些標記被歸類為屬於測量本身，因為它們是讀數的一部分，而非圖表上所寫的內容。若要修改其中一項，請在您的 FitnessSyncer Notebook 中編輯該讀數。您仍可在同一點上添加自己的註解。

哪些圖表支援註解功能

任何橫軸為時間的圖表——包括線圖、面積圖、帶範圍的線圖、柱狀圖、堆疊柱狀圖、流圖及箱線圖——皆可添加註解。

在圖表底部未以時間為軸的圖表不會顯示註解，因為沒有日期可供附加註解。這類圖表包括散點圖、直方圖、熱力圖、「日」圖表、圓餅圖與環形圖、儀表圖以及 KPI 磁磚。

計算得出的數值同樣不接受註解。估算的 A1C、達標百分比或睡眠欠債是根據其他讀數計算得出的，而非直接記錄的，因此該處沒有讀數可供註解。請改在下方讀數處撰寫註解。

如果您希望某個圖表不顯示註解，且您是 FitnessSyncer Pro 使用者，請在 Dashboard 編輯器中開啟該圖表的設定 ，並為該圖表關閉此功能。

您的註解

Dashboard 工具列上的註解圖示 會開啟「您的註解」視窗，該視窗會將您所撰寫的所有註解以表格形式列出，每次顯示一百則。

在那裡，日期和文字都可以編輯。修改一個儲存格後，按下「儲存」，該註解在所有出現的位置都會隨之移動或顯示不同的內容。註解所對應的測量值無法更改，因為這樣一來，該註解可能會被移動到您從未選取的圖表上。

匯出與匯入

「您的註解」頁面還設有「匯出」按鈕及用於匯入的下拉式選單，因此您可以保留註解的副本，或先在其他地方撰寫一批註解，再將其匯入。

匯出時會將每項註解以 CSV 檔案格式下載，該檔案包含四欄：

• 日期：註解適用的時間，以 UTC 格式的 ISO 日期與時間表示。
• DataField：註解所指的測量值，採用 FitnessSyncer 系統內部使用的格式，例如 GLUCOSE_MMOL_PER_L。
• 測量值：該測量值的易讀名稱。此欄位僅供您在閱讀檔案時參考，匯入時將被忽略。
• 註：您的文字。

「匯入」功能會讀取一個與原始檔案形狀相同的檔案。註解是透過其日期和測量值來識別，而非透過 ID，因此當您匯出、編輯並再次匯入檔案時，系統會更新該檔案所描述的註解，而非為每個註解建立第二份副本。

無法讀取的資料列不會導致檔案處理中斷。若資料列中包含系統無法辨識的測量名稱 FitnessSyncer、攜帶無法解析的日期，或註解欄位為空，該資料列將會被跳過；匯入過程會告知您共建立多少筆資料、更新多少筆、跳過多少筆，以及具體是哪些資料列。 長度超過一千個字元的註解會被縮短，而非被拒絕。

在應用程式中

在 FitnessSyncer 應用程式的 iOS 和 Android 圖表上會顯示註解，且在該處為唯讀狀態。請透過網頁進行寫入與編輯。