---
title: WinFormGui-for-F.U.C.K 使用手冊
tags: CyLab
description: Windows Form GUI for FHIR-Universal-Conversion-Kit 使用手冊，提供簡潔易懂的介面，讓你快速上手F.U.C.K
---
{%hackmd theme-dark %}

# 目錄
[TOC]

# 簡介-Intro

### 這是基於一項[開源的FHIR資料轉換工具](#開源的FHIR資料轉換工具-FUCK)而開發的視窗應用程式
方便使用者快速上手該工具，透過幾個按鈕自動安裝該工具的相依套件，並一鍵啟動該工具，省去手動輸入指令的麻煩

且提供簡易的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](https://github.com/Lorex/FHIR-Universal-Conversion-Kit)
+ 特別感謝該專案的作者 [Lorex](https://github.com/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](https://nodejs.org/en/download/) >= 16.8.0
+ [.Net Framework 4.8 Runtime](https://dotnet.microsoft.com/en-us/download/dotnet-framework/net48)
+ 執行時須允許以系統管理員權限運行
因為安裝在系統預設資料夾中，**需要系統管理員權限才能順利安裝相依套件以及自動啟動F.U.C.K服務**

# 介面概覽-User Interface Overview


# 功能清單-Function List

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

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

## 簡易RestClient

### 右側的視窗為Server回傳結果

### 左側的視窗為要POST出去的資料(Request Body)
:::warning
**只支援POST Raw json**
:::

### 可修改HTTP Method與server URL
:::info
目前只提供 **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完整貼到這裡
  ] // 記得先把這裡的中括號[]刪除再貼
}