野外調查 App(暫定)

目標
#

這是一款專為野外調查資料記錄設計的行動裝置應用程式。用戶可根據自訂模板，快速將其轉化為符合特定調查計畫的資料記錄工具，擺脫紙本記錄，實現資料即時數位化並支援遠端備份。此外，應用程式充分利用行動裝置功能，自動填入記錄時間、GPS 位置、調查範圍，並支援附加環境照片、影片和錄音等功能。其核心特色在於模板化設計：只需編寫一份模板，調查團隊的所有成員即可直接套用，簡化工作流程。

快速入門
#

本章將引導您快速上手「野外調查」應用程式，從建立模板、匯入應用程式，到開始收集資料並匯出結果。以下步驟適用於目前的預覽版（Pre-Alpha），讓您能立即體驗核心功能。

建立您的模板（僅適用於預覽版）
#

在預覽版中，您需要手動編寫 XML 模板來定義調查專案的結構。以下提供兩個範例模板（ fish_diary_sample.xml 與 generic_fresh_water_survey_sample.xml ），您可根據需求修改。未來 Beta 版或後續版本將內建完整工具，讓您在應用程式內輕鬆建立並分享專案模板。

步驟：
#

準備 XML 文件
- 複製範例模板：參考「釣魚日記」或「淡水域魚蝦蟹調查」XML 檔案。
- 使用文字編輯器（如 Notepad++、VS Code）開啟並調整內容。
結構說明
- 專案層級 ：每個 XML 文件以 <Project> 標籤開始，定義專案名稱和描述。
  - <Name> ：專案名稱，例如「釣魚日記」或「淡水域魚蝦蟹調查」。
  - <Description> ：專案描述，說明調查目的。
- 區段（Section ：用 <Section> 標籤定義資料收集的分類。
  - <Name> ：區段名稱，如「釣魚日」、「戰積」、「地點」、「魚」。
  - <Parent> ：父區段名稱，指定層級關係。若為根區段，設為 “Project” ；否則設為其他區段的名稱（如「戰積」的父區段為「釣魚日」）。
  - <Importance> ：重要性（數字，越大越優先），用於排序顯示，範例中為 0 到 5。
- 變數（Variable ：在區段內用 <Variable> 標籤定義資料欄位。
  - <Name> ：變數名稱，如「日期」、「地點」、「體長」。
  - <Type> ：變數類型，支援以下選項：
    - Date ：日期（如「日期」）
    - Time ：時間（如「開始時間」）
    - DateTime ：日期與時間（如「調查時間」）
    - Option ：選項（單選或多選，如「總結」、「物種」）
    - LocationMap ：地理位置（如「位置」）
    - PathMap ：路徑地圖（ 目前版本未實作 ）
    - PolygonMap ：多邊形地圖（ 目前版本未實作 ）
    - Float ：浮點數（如「體長」、「水文資料 1」）
    - String ：文字（如「地點」、「標題」）
    - Markdown ：格式化文字（如「心得」、「備註」）
    - Picture ：圖片（如「照片?」）（ 目前版本未實作 ）
    - Audio ：音訊（ 目前版本未實作 ）
  - <Importance> ：重要性（數字，越大越優先），用於排序顯示，如 0 到 10。
  - <Overview> ：若存在此標籤，該變數顯示於概覽畫面（可選）。
  - <Default> ：預設值，如「點位名稱」預設為 “A”，或留空。
  - <NotRequired> ：若存在此標籤，表示非必填；否則預設為必填（ 目前版本未實作 ）。
  - <Tip> ：幫助提示文字，提供使用者指引，如「心得」的提示（ 目前版本未實作，未來將支援 Markdown 格式撰寫 ）。
  - <Args> ：進階設定，包含：
    - <Options> ：選項列表，用逗號分隔（如 “打龜,還可以,大豐收” 或 “FishA,FishB,FishC,FishD”）。
    - <Flags> ：功能標記，用逗號分隔，支援：
      - AutoNow ：自動填入當前時間，僅適用於 Time 、 Date 、 DateTime 變數（如「日期」、「上鉤時間」）
      - Expandable ：允許使用者新增選項，僅適用於 Option 變數（如「物種」、「調查人員」）（*目前版本未實作*）
      - SmartDefault ：自動填入上一筆記錄的數值，僅適用於 Option 變數（如上一筆「調查方法」填入 “電”，新增下一筆時，「調查方法」自動填入 “電”）（ 目前版本未實作 ）
      - MultipleChoice ：允許多選，僅適用於 Option 變數（如「調查人員」、「註記」）
範例調整
- 修改 fish_diary_sample.xml ：例如，將「總結」的選項從 “打龜,還可以,大豐收” 改為 “失敗,普通,成功”，或新增「天氣」變數（類型 Option ，選項 “晴,陰,雨”）。
- 修改 generic_fresh_water_survey_sample.xml ：例如，調整「魚」區段的「物種」選項，新增 “FishE,FishF”，或更改「水文資料 1」的 <Importance> 為 5。
儲存檔案
- 儲存為 XML 格式（例如 my_survey.xml ），確保結構正確無誤。

*注意*：在 Beta 版或後續版本中，本應用程式將內建完整工具，讓您直接在應用程式內建立專案模板，並輕鬆分享給團隊成員。

匯入應用程式
#

將自訂模板匯入「野外調查」應用程式，以開始使用您的調查專案。

步驟：
#

準備模板檔案
- 將您編輯好的 XML 檔案（例如 =my_survey.xml=）傳輸到行動裝置，例如透過 USB、電子郵件或雲端儲存（如 Google Drive）。
開啟應用程式
- 啟動「野外調查」應用程式，進入主畫面。
選擇匯入
- 點擊右下角的「+」浮動按鈕，開啟「匯入新專案」選單。
- 選擇「從設定檔 (.xml) 匯入」，然後使用檔案選擇器找到您的 XML 檔案。
確認匯入
- 應用程式會解析 XML 檔案，建立專案、區段和變數。完成後，您將在主畫面看到新專案卡片（顯示專案名稱和描述）。

注意：
#

確保 XML 格式正確，否則匯入可能失敗。
目前僅支援 XML 格式，未來版本將新增其他方式（如 QR 碼掃描）。

開始收集資料
#

使用應用程式記錄野外調查資料，充分利用自動功能和自訂欄位。

步驟：
#

選擇專案
- 在主畫面，點擊專案卡片（例如「釣魚日記」）進入專案。
新增記錄
- 點擊浮動按鈕開始為某個區段（例如「釣魚日」或「地點」）新增記錄。
填寫資料
- 根據模板中的變數填入資料：
  - 自動欄位：如「日期」、「調查時間」若有 AutoNow 標記，會自動填入當前時間。
  - 手動欄位：輸入文字（如「地點」）、選擇選項（如「總結」選 “大豐收”）、記錄 GPS 位置（如「位置」）。
  - Markdown 欄位：撰寫格式化心得或備註（如「內容」）。
- 若變數設為必填，需完成輸入才能儲存（ 目前版本 NotRequired 未實作，預設全為不必填 ）。
儲存或繼續
- 點擊「完成」按鈕儲存記錄，或選擇「儲存並新增下一筆」繼續收集。
編輯與檢視
- 點擊記錄檢視詳細資料，點擊「編輯」按鈕修改，或放大特定欄位（如「位置」、「心得」）以便詳細輸入。

匯出資料（僅適用於預覽版）
#

將專案中的資料匯出為 CSV 檔案，以便後續分析或分享。

步驟：
#

進入專案
- 在主畫面，點擊目標專案卡片。
選擇匯出
- 點擊專案卡片右下角的「表格」圖示（匯出按鈕）。
選取儲存位置
- 選擇行動裝置上的儲存資料夾，應用程式會為每個區段生成獨立的 CSV 檔案。
- 檔案命名格式為：=[專案名稱][區段名稱][日期時間].csv=（例如 =釣魚日記_戰積_20250610.csv=）。
檢視匯出結果
- 每個 CSV 檔案包含：
  - 欄位：記錄 ID、父記錄 ID（若有）、各變數的值。
  - 資料：根據記錄填入，例如「體長」為 “45.5”、「物種」為 “FishA”。

注意：
#

確保儲存位置有足夠空間。
Markdown 和地圖類型資料會清理換行符號，確保 CSV 格式正確。

*注意*：在 Beta 版中，將無需手動匯出，應用程式將內建遠端資料同步功能，自動備份並分享資料。

目標 #

快速入門 #

建立您的模板（僅適用於預覽版） #

步驟： #

匯入應用程式 #

步驟： #

注意： #

開始收集資料 #

步驟： #

匯出資料（僅適用於預覽版） #

步驟： #

注意： #

目標
#

快速入門
#

建立您的模板（僅適用於預覽版）
#

步驟：
#

匯入應用程式
#

步驟：
#

注意：
#

開始收集資料
#

步驟：
#

匯出資料（僅適用於預覽版）
#

步驟：
#

注意：
#