# MITW2022程式說明指南
##### 程式撰寫：楊子億 | 參賽及整理：黃宇婷 | 特別鳴謝：洪彬彬、莊舒雅
## Part 1：環境及配置
2022 MI-TW 台灣醫學資訊互通聯測松 官網：https://mitw.dicom.org.tw/
GitHub下載地址：https://github.com/UnicornYumi/MITW2022
Setting文件中為FHIR伺服器地址。

var URL = 'https://203.64.84.150:58443/fhir';

## Part 2：病人基本資料互通
### 基本介紹
病人基本資料互通為第一賽道，主要有以下3個應用情境（Scenario）組成。主要行為如下圖所示：
病人在第一次看診的時候通常需要填寫**初診基本資料表**，表單大致如下圖所示：
結合以上應用情境及表單，我們對表單中的欄位屬性分別對應至相應的情境中。

**Scenario 1 - 病人身分確認用**
* 執行各項護理技術、檢查、治療、手術等醫療處置前對病人做身分確認
* 例如：在診療前，醫護人員請病人提供基本資訊如姓名、生日用以核對病人身分是否正確

**Scenario 2 - 聯繫病人用**
* 聯絡方式如手機、email…用以聯絡病人
* 通訊地址如住家地址、工作地址
* 兩種用途的病人資料將共用相同的識別碼如身分證、護照、居留證、病歷號

**Scenario 3 - 院外系統**

* Patient ID 串接其他兩種 Resource 資料並適當呈現
* 病人保有自己的PHR Patient ID，可透過PHR的授權機制授權醫護人員調用個人的健康資訊
* 範例：病人就醫時提供個人的PHR Patient ID，並授權醫護人員可對此ID對應的PHR個案資料調用和操作
### 網頁畫面說明
#### 新增病人資料頁面（Create_Patient.html）
（序號標識見上圖）
#### 1號區塊
* SC1,SC2,SC3 ID分別對應三種不同的情境，將產生3個ID編號。三種情境被寫在Organization屬性中。如下範例：

"managingOrganization": {
    "reference": "Organization/MITW.ForIdentifier"
  }

* 在網頁中填寫的時候可以**保持空白，不進行填寫**，系統會自動對其進行編號，一般會是連續的3個數字編號。
* 譬如：在該範例中，身份證字號為U92847364的這位病人由系統自動產生10308（ForIdentifier）、10309（ForContact）、10310（ForPHR）這三個ID。（可以從FHIR SERVER中輸入查詢語句查找到對應編號）
#### 2號區塊
* 作用：病人基本資訊填寫區塊
* 其中，Organization將于1號區塊的編號綁定，所以在此處無法進行修改。
#### 3號區塊
* 作用：聯絡人基本資訊填寫區塊
#### 伺服器接收成功
當點擊表單中的【CREATE】進行資料的上傳，當上傳完成時會顯示如下圖所示：data retrieved的回傳訊息。
並在【Output Panel】中會回傳所上傳資料的JSON檔案。

*若資料上傳失敗可參考[問題集(Part N)](https://hackmd.io/kaDtna-2T7CE9LlJZ6oKBA?both#Part-N%EF%BC%9A%E5%95%8F%E9%A1%8C%E9%9B%86)。*

此時，我們在瀏覽器中輸入下列查詢語句（10308為病人身分基本資料的ID）就可以查詢到新增的這位病人資料：

#### 更新病人資料頁面（Update_Patient.html）
作用：對病人基本資料進行修改並更新至FHIR伺服器。
範例：在此，我們修改病人的出生日期。如下圖所示，當我們更新之後，FHIR伺服器端的JSON檔案也隨之相應的完成了更新。
完成病人資本資訊的更新~
在點擊【UPDATE】之後可能會出現這兩個提示框，意思是我們沒有對Scenario2和Scenario3進行更新。
若我們想要對聯絡人資訊進行更新，我們只需填入對應的SC2 ID即可，步驟與上文一致。此時，網頁表單中將會顯示病人及聯絡人全部資訊，如下圖：

## Part 2：生理量測數據
### 基本介紹
請先參考MITW網站
### 網頁畫面說明
這部分的程式碼有以下兩種：
* Observation.html
* Observation_SearchTime.html

兩個網頁大同小異，主要差別在於【Observation_SearchTime.html】的查詢部分增加了時間段查詢的功能。（可再修改做結合）
#### 生理量測資料上傳及查詢
【Observation.html】頁面範例：
【Observation_SearchTime.html】頁面範例（上傳四筆血壓資料）：
左圖為搜尋病人ID出現的4筆結果，右圖為符合時間段限制的3筆結果，如下圖所示：
## Part 3：處方用藥及文件打包
### 基本介紹
請先參考MITW網站
#### 新增藥物（Create_Medication.html）
在新增藥物頁面可以建立藥物的資料庫，該頁面有助於當開立MedicationRequest的時候可以直接對應相應的藥品。
同時，新增的生理量測資料也會同步到MedicationRequest的伺服器上，如下圖：

## Part N：問題集
### 上傳失敗
在點擊【CREATE】進行上傳時，我們可以按F12打開開發者頁面。若上傳失敗，有可能出現下面提示：
### 解決辦法
* 原因：我們需要先打開FHIR伺服器。在GOOGLE網址框中輸入該鏈結：https://203.64.84.150:58443/fhir
* 該鏈結為FHIR伺服器鏈結，若變更伺服器，可在程式碼的【Setting.js】中進行修改。

步驟如下圖所示：
當在你的瀏覽器中打開了該頁面，便可回到程式執行的頁面中重新刷新並執行。