下載 Burni

• 進到 Burni 的 GitHub：

第一種方法：使用 Git

git clone https://github.com/Chinlinlee/Burni.git

第二種方法：下載 Zip

安裝所需軟體

所需軟體 requirement

• Node.js ≥ 14
• MongoDB > 4.0

安裝 Node.js 14.19.0

• 第一步：進到下載網址，網址：https://nodejs.org/zh-tw/download/releases/
• 第二步：使用上面的搜尋找 14.19 開頭的版本，找到 14.19.0 版本並按下載

• 第三步：點擊 node-v14.19.0-x64.msi 下載

• 第四步：開啟下載的 node-v14.19.0-x64

• 第五步：點擊 Next

• 第六步：勾選 I accept the terms in the License Agreement 並點擊 Next

• 第七步：選擇安裝目錄並點擊 Next

• 第八步：點擊 Next

• 第九步：點擊 Next

• 第十步：點擊 Install

測試是否安裝完成

安裝 MongoDB

• 第一步：進到 MongoDB主頁，網址：https://www.mongodb.com/try/download/community
• 第二步：選擇 Version → 4.4.13 ，Platform → Windows ， Package → msi 並點擊Download

• 第三步：打開下載的 mongodb-windows-x86_64-4.4.13-signed.msi

• 第四步：點Next

• 第五步：將 I accept the terms in the License Agreement 打勾

• 第六步：選擇 Complete

• 第七步：設定 Data Directory (資料存放位置) 以及 Log Directory (紀錄存放位置)，選擇完畢後按 Next

• 第八步：安裝 MongoDB Compass

• 第九步：點擊 Install

• 第十步：安裝完畢囉！

創建使用者帳號

• 第一步：打開 MongoDB Compass
• 第二步：在 New Connection 的 connection string 輸入以下內容，並點擊 Connect

mongodb://localhost:27017

• 第三步：點開下方的 >_MONGOSH

• 第四步：輸入以下指令切換到 admin 資料庫

use admin;

• 第五步：輸入以下指令創建 root 帳號

db.createUser({
    user : "root",
    pwd : "root" ,
    roles : [{role : "root" , db:"admin"}]
});

設定 Burni

安裝依賴

• 開啟 cmd (命令提示字元) 進到 Burni 專案目錄並執行以下指令

npm i --only=production

設定要使用的 FHIR Resource (config.js)

第一種：一般設定

• 更改 config/config.js ，如沒此檔案可以複製 config/confit.template.js 並重新改名成 config/config.js

module.exports = {
    "Patient": {
        "interaction": {
            "read": true, // 是否開啟 read 的功能
            "vread": true,
            "update": true,
            "delete": true,
            "history": true,
            "create": true,
            "search": true
        }
    }
};

• 如果需要新增 Resource ，您可以在 module.exports 內加入 Resource 的名稱，如要進一步設定 interaction，請按照上面 Patient 的範例設定即可

module.exports = {
    "Patient": {
        "interaction": {
            "read": true, // 是否開啟 read 的功能
            "vread": true,
            "update": true,
            "delete": true,
            "history": true,
            "create": true,
            "search": true
        }
    },
    "Organization": {}  // 新增 Organization ， 可以不輸入 interation 的資訊
};

第二種：支援所有 Resource 的設定

node config/generate-config-allResources.js

此項指令將會產生所有 Resource 設定的 config/config.js

設定 .env 檔案

• 第一步：複製根目錄的 .env.template ，貼上並更名為 .env

• 第二步：更改 .env 內的內容

MONGODB_NAME="Burni"
MONGODB_HOSTS=["localhost"]
MONGODB_PORTS=[27017]
MONGODB_USER="root"
MONGODB_PASSWORD="root"
MONGODB_IS_SHARDING_MODE=false
MONGODB_SLAVEMODE=false

SERVER_PORT=8080

FHIRSERVER_HOST="localhost"
FHIRSERVER_PORT=8080
FHIRSERVER_APIPATH="fhir"

ENABLE_TOKEN_AUTH=false
JWT_SECRET_KEY="secret-key"
ADMIN_LOGIN_PATH="adminLogin"
ADMIN_USERNAME="admin"
ADMIN_PASSWORD="password"

ENABLE_CHECK_ALL_RESOURCE_ID=false
ENABLE_CHECK_REFERENCE=false

ENABLE_CSHARP_VALIDATOR=false
VALIDATION_FILES_ROOT_PATH="/validationResources"
VALIDATION_API_URL="http://burni-fhir-validator-api:7414"

產生 Resource 程式碼

• 完成設定要使用的 FHIR Resource後，您必須運行以下指令產生程式碼：

npm run build

運行後您將會在 api/FHIR 資料夾; e.g. api/FHIR/Patient檔案以及models/mongodb/model資料夾; e.g. models/mongodb/model/Patient.js 檔案，看到產生的程式碼

部屬 Burni

• 開啟 cmd (命令提示字元) 進到 Raccoon 專案目錄並執行以下指令

node server.js

測試 Burni

• 在此章節使用 Postman 測試
• 使用資料：patient-example

創建 Patient

取得剛剛創建的 Patient (read)

更改 Patient