目錄

• 目錄
• 簡介-Intro
  • • 這是基於一項開源的FHIR資料轉換工具而開發的視窗應用程式
    • 開源的FHIR資料轉換工具-F.U.C.K
• 專案網址-Project URL
  • • Git Repository
    • 發行安裝檔-Releases
• 系統需求-System Requirements
• 介面概覽-User Interface Overview
• 功能清單-Function List
• 使用教學-Tutorial
  • 啟動/重啟F.U.C.K服務
    • Step1-點開服務選單
    • Step2.1-點選啟動F.U.C.K
    • Step2.2-點選重啟F.U.C.K
  • 關閉F.U.C.K服務
    • 關閉應用程式時會自動關閉，無須手動操作
  • 測試F.U.C.K服務
    • Step1-於服務選單中點選測試F.U.C.K
    • Step2-確認測試F.U.C.K介面正確顯示
    • Step3-點選開始測試按鈕使用內建測試資料測試
    • Step4-查看回傳結果是否包含"success":true
    • 遇到錯誤時可嘗試的解決方法
  • 簡易RestClient
    • 右側的視窗為Server回傳結果
    • 左側的視窗為要POST出去的資料(Request Body)
    • 可修改HTTP Method與server URL
  • 編輯F.U.C.K Profile
    • 您可以直接於下拉選單中選擇F.U.C.K內建的profile來編輯
    • 或是透過對話框選取您自己的檔案
    • 檔案順利載入後即可自由編輯
    • 編輯完後記得要存檔!
  • 閱讀Excel文件
    • 從清單中選擇內建的Excel範例檔案
    • 或是手動選擇存放在其他位置的Excel檔
    • 成功讀取Excel後記得選取要檢視的工作表
    • 成功載入工作表的資料檢視畫面
    • 1.3.1新功能!可直接匯出或複製CSV格式的文字
  • CSV轉JSON
    • Step1-於選單中點選CSV轉JSON
    • Step2-確認介面如下
    • Step3-貼上您的csv文件內容並點選開始轉換
    • Step4-下方為轉換後的JSON，您可以選取並複製

簡介-Intro

這是基於一項開源的FHIR資料轉換工具而開發的視窗應用程式

方便使用者快速上手該工具，透過幾個按鈕自動安裝該工具的相依套件，並一鍵啟動該工具，省去手動輸入指令的麻煩

且提供簡易的REST Client，讓使用者可以省下安裝其他Rest Client的儲存空間與時間，同時內建F.U.C.K Profile編輯器，方便使用者修改FHIR資料轉換的自訂映射欄位，以及要上傳的目標Server URL

開源的FHIR資料轉換工具-F.U.C.K

• FHIR-Universal-Conversion-Kit 簡稱 F.U.C.K
• 特別感謝該專案的作者 Lorex

專案網址-Project URL

Git Repository

• https://github.com/luckypig3400/WinFormGui-for-F.U.C.K

發行安裝檔-Releases

• https://github.com/luckypig3400/WinFormGui-for-F.U.C.K/releases

系統需求-System Requirements

• Windows 10 or Above (Windows 7 might also supported)
• Node.js >= 16.8.0
• .Net Framework 4.8 Runtime
• 執行時須允許以系統管理員權限運行
  
  
  因為安裝在系統預設資料夾中，需要系統管理員權限才能順利安裝相依套件以及自動啟動F.U.C.K服務

介面概覽-User Interface Overview

功能清單-Function List

• 可以透過按鈕啟動/重新啟動F.U.C.K服務
• 自動安裝F.U.C.K的相依套件
• 關閉應用程式時自動停止F.U.C.K服務
• 提供測試介面供使用者驗證F.U.C.K服務是否正常運行
• 簡易的RestClient，可以POST json資料到F.U.C.K，亦可從FHIR Server GET資料
• F.U.C.K的自定義profile的編輯器
• 切換深色主題的功能
• Excel檔案閱讀器
• CSV檔案轉換為可傳遞至F.U.C.K的JSON檔案

使用教學-Tutorial

啟動/重啟F.U.C.K服務

Step1-點開服務選單

Step2.1-點選啟動F.U.C.K

請您按照此訊息建議的時間稍作等候

Step2.2-點選重啟F.U.C.K

若是您有修改Profile檔案，請記得存檔後點選此按鈕重啟F.U.C.K服務才會生效

關閉F.U.C.K服務

關閉應用程式時會自動關閉，無須手動操作

測試F.U.C.K服務

Step1-於服務選單中點選測試F.U.C.K

Step2-確認測試F.U.C.K介面正確顯示

Step3-點選開始測試按鈕使用內建測試資料測試

Step4-查看回傳結果是否包含"success":true

若您於右側server回傳結果終看到關鍵字"success":true代表F.U.C.K服務正常運作中，您可以開始您的FHIR資料轉換工作

遇到錯誤時可嘗試的解決方法

• 再多等1~2分鐘等待套件安裝，若您的電腦硬碟為傳統硬碟(H.D.D)，可能經歷較久的套件安裝與啟動時間
• 檢查電腦中有沒有程式佔用 1337 通訊埠(port)
• 停止電腦中所有正在運行的Node.js服務
  
  
  
  
  然後再於服務選單中啟動F.U.C.K
  

簡易RestClient

右側的視窗為Server回傳結果

左側的視窗為要POST出去的資料(Request Body)

只支援POST Raw json

可修改HTTP Method與server URL

目前只提供 GET 與 POST

編輯F.U.C.K Profile

您可以直接於下拉選單中選擇F.U.C.K內建的profile來編輯

或是透過對話框選取您自己的檔案

檔案順利載入後即可自由編輯

編輯完後記得要存檔!

閱讀Excel文件

從清單中選擇內建的Excel範例檔案

或是手動選擇存放在其他位置的Excel檔

成功讀取Excel後記得選取要檢視的工作表

成功載入工作表的資料檢視畫面

1.3.1新功能!可直接匯出或複製CSV格式的文字

CSV轉JSON

Step1-於選單中點選CSV轉JSON

Step2-確認介面如下

Step3-貼上您的csv文件內容並點選開始轉換

Step4-下方為轉換後的JSON，您可以選取並複製

這裡輸出的JSON可以直接放入要POST給F.U.C.K的Payload JSON

{
  "profile": "medicationMS",
  "data": [
      // 把從上方輸出複製的JSON完整貼到這裡
  ] // 記得先把這裡的中括號[]刪除再貼
}