功能介紹

# Flying 功能介紹

依據Flying使用手冊之界面介紹，列舉每個功能詳細使用說明。

# 1. 功能功能表

工具欄功能表包括：服務、設定、幫助。

服務： 點選後會出現下拉功能表。
- 啟動服務： 啟動 Flying 服務。
- 停止服務： 停止 Flying 服務。
- 退出： 停止 Flying 運行並退出程式。
設定： 點選後會出現下拉功能表。
- 選擇語言： 進行Flying界面語言的選擇。可選擇的語言型別有簡體中文、繁體中文和英語。
- 語言配置： 可設定不同語言顯示的文字內容。
幫助： 點選後會出現下拉功能表。

點選[關於]，可檢視產品的版本資訊內容。點選[註冊]，進入註冊對話方塊。
啟動、停止服務

Flying功能表欄下方的圖示按鈕可通過單擊來切換服務的啟動與停止狀態。當圖示顯示如上圖時，單擊圖示可停止Flying服務。

當圖示顯示如上圖時，單擊圖示可恢復Flying服務。

# 2. 功能說明

# 2.1. 系統日誌

系統日誌界面用於顯示服務的運行情況以及客戶端訪問服務端的日誌資訊。

打開：打開日誌資料夾。
複製：複製日誌資訊。
清空：清空所有的日誌資訊。
滾動：啟用滾動日誌檢視模式。
檢視：檢視詳細日誌資訊。

# 2.2. 列印設定

列印設定界面包含基本設定、HTTP列印、MQTT列印、報表設計、郵箱設定功能。

# 2.2.1. 基本設定

報表
- 報表模板路徑（為空預設 report目錄）：報表模板檔案的存放目錄，當此項為空時將使用Flying預設的目錄。
- 導出檔案路徑（為空預設 export目錄）：報表輸出檔案的儲存目錄，如輸入pdf，jpg等格式，當此項為空時將使用Flying預設的目錄。
- 導出檔案格式（為空預設 pdf格式）：報表輸出檔案的格式型別。分別是：pdf、pg、xls、txt、htm、rtf、csv。
- 列印/輸出：報表的輸出型別選項，列印表示為啟用報表列印，輸出表示為輸出報表為pdf，不進行列印。
日誌
- 日誌儲存路徑（為空預設log目錄）：客戶端請求報表列印或輸出時的日誌檔案存放目錄。
- 啟動時清空日誌：當Flying啟動時，清空日誌。
- 退出時清空日誌：當Flying退出時，清空日誌。
- 運行中，每隔分鐘，清空一次：當Flying運行中時，每隔多少分鐘（設定值）清空一次日誌。
- 隨 Windows 啟動：設定 Flying 是否跟隨Windows 進行自動啟動。
令牌

爲了防止連線被冒用，Flying提供了Token令牌，如果啟用了此功能，每個客戶端在訪問Flying時需攜帶Token列表中一個的令牌，並以此作為身份認證。
- 啟用Token：是否啟用Token令牌功能。
- Token列表（一行一個，類似白名單）：可作為Token令牌使用的列表。每一個令牌都需要單獨換行。

# 2.2.2. HTTP列印

HTTP列印服務的相關設定。

選項
- 主機：HTTP / WebSocket 列印服務的地址。在輸出列印檔案時將以這個地址進行輸出。
- 埠：設定列印服務的監聽埠，HTTP / WebSocket 使用同一埠進行監聽。
- 遠端主機：用於Flying伺服器遠端維護的地址，可通過設定遠端地址來實現遠端Flying服務的維護。遠端主機地址為HTTP服務地址，比如 http://192.168.0.142:8801。
- SSL：啟用以允許安全連線：是否啟用SSL模式。如啟用SSL則需設定SSL選項。
- SSL：SSL監聽的埠號資訊。
- 壓縮：啟用以允許壓縮數據：壓縮數據資訊。
- 身份認證：啟用使用者身份認證：啟用使用者的身份認證資訊。
- URL：WebSocket 服務的地址資訊。
- 使用者名稱：WebSocket 使用者的身份認證使用者名稱。
- 密碼：WebSocket 使用者的身份認證密碼。
SSL選項
- 證書檔案：SSL 證書所在的地址。
- 金鑰檔案：SSL 私鑰檔案所在的地址。
- 根證書檔案：SSL 的根證書檔案所在的地址。
- 密碼：SSL證書的密碼(如有設定請對照填寫)。

# 2.2.3. MQTT列印

MQTT列印服務的相關設定。

啟用MQTT：勾選以啟用MQTT列印服務。
SSL：設定是否啟用 SSL 保護 MQTT 連線。
地址：MQTT伺服器連線的地址，預設為本機地址。
埠：MQTT伺服器連線的埠號。
使用者名稱：MQTT伺服器的登錄使用者名稱。
密碼：MQTT伺服器的登錄密碼。
本機識別碼：MQTT伺服器的本機識別碼(對應于MQTT的主題)，遠程登錄時會發送資訊至客戶端。
本機驗證碼：MQTT伺服器的驗證碼，遠程登錄時客戶端需提供該資訊。
發佈主題：設定列印輸出時發送訊息的訂閱主題名稱。

# 2.2.4. 報表設計

報表設計界面提供了報表設計的相關設定。

在報表列表中右鍵滑鼠，將會打開報表設定選項。包含新建報表、修改標題、刪除、數據構造、下載報表、上傳報表、重新整理選項。

以上選項的說明如下。

新建報表

在彈出的對話方塊中輸入新建的報表名稱，輸入完畢後點擊[OK]即可。
修改標題

選擇需要修改名稱的報表選項，右鍵選擇該選項進入修改對話方塊。輸入要修改的名稱，輸入完畢後點擊[OK]即可。
刪除

選擇需要刪除的報表選項，右鍵選擇該選項即可刪除該報表。
數據構造

該功能用於產生在設計報表格式時使用的測試數據集，以更好展現報表設計和預覽效果。目前SQL最多支援10個數據集的報表。
- [伺服器]：連線的TARS服務端地址。
- [埠]：連線的TARS服務端埠號。
- [帳套]：連線的TARS服務端的連線設定名稱。
- [SecureKey]：連線TARS服務端設定的安全碼。
- [加密]：是否啟用加密連線，該選項需與TARS服務端的設定一致。
- [連線]：啟用與TARS服務端的連線，連線成功后該按鈕變為灰色。
- [SQL]：填寫用於構造報表數據集的SQL語句。
- [執行SQL]：向資料庫提交填寫的SQL用以執行。
- [JSON]：該欄目中顯示被轉換的數據集結果。
- [應用]：設定應用數據構造的選項。
除此之外，雙擊需要進行報表設計的模組，可進入報表設計界面。關於報表設計界面的詳細說明請參考Flying學習手冊報表設計的內容。
下載報表

將遠端Flying伺服器模板報表格式檔案下載至本機模板目錄中。

上傳報表

將報表格式檔案(*.fr3)或模板數據檔案(*.data)上傳至遠端地址的Flying伺服器。

重新整理

當報表的目錄結構發生變化時，使用此選項以重新整理顯示最新的目錄狀態。

# 2.2.5. 郵箱設定

顯示郵箱設定的相關選項，配置郵箱后，列印輸出的檔案將會被髮送至指定的郵箱。

郵件配置
- [啟用EMail]：啟用郵件發送服務。
- [郵件伺服器]：郵件發送使用的郵件伺服器。
- [埠]：郵件服務的埠，通常為25。如使用STARTTLS協議來發送郵件，請將埠設定為587；如使用SSL/TLS協議來發送郵件，請將埠設定為465。
- [發送人]：郵件的發送者郵箱地址。
- [密碼]：郵件的發送者郵箱密碼。
- [收件人]：郵件的接收者郵箱地址。

# 2.2.6. 列印記錄

在目前頁面中，選擇對應的日期，點選[查詢]可查詢列印伺服器的列印/輸出記錄。左側的列表顯示全部的列印記錄，右側顯示列印輸出的文件的預覽界面或者對應的日誌資訊。

# 2.2.7. 小工具

本程式提供了兩種實用工具，可供除錯測試使用。

URL編碼/解碼

一般來說，URL只能使用英文字母、阿拉伯數字和某些標點符號，不能使用其他文字和符號。比如，世界上有英文字母的網址"http://www.abc.com"，但是沒有希臘字母的網址"http://www.aβγ.com"（讀作阿爾法-貝塔-伽瑪.com）。這是因為網路標準RFC 1738 (opens new window)做了硬性規定，只有字母和數字[0-9a-zA-Z]、一些特殊符號$-_.+!*'(),、以及某些保留字，才可以不經過編碼直接用於URL，這意味著，如果URL中有漢字或者其他不在範圍內的字元要置入URL，就必須經過編碼后才能使用。

上圖中上側的編輯框由於填寫或顯示原始的字元資訊，下側的編輯庫用於顯示或輸入經過URL編碼的字元資訊。圖中的按鈕說明如下。
[UrlEncode編碼↓↓]：將原始的字串進行URL編碼。
[UrlDecode解碼↑↑]：將經過編碼的字串進行解碼操作，恢復原始的字串資訊。
Base64圖片轉換

Base64是一種用64個字元來表示任意二進制數據的方法，它可以將圖片、視訊、音訊等二進制數據轉換成文字編輯器可檢視的字串，以便於使用網路進行傳輸。想了解Base64請點這裡 (opens new window)。

圖中的按鈕說明如下。
- [選擇一張圖片(png,jpg,bmp,ico)]：點選此按鈕打開選擇圖片對話方塊，選擇圖片后，在編輯框中顯示選擇的圖片經過Base64編碼后的字串資訊。
- [Base64轉換為圖片]：將經過編碼的Base64字串放置於編輯框中，點選此按鈕進行解碼並顯示圖片。
- [複製]：將獲取到的Base64字串複製至系統剪下板。
- [貼上]：將截切版中的字元貼上至編輯框中。