實作指引版本：0.1.0 FHIR版本：4.0.1 發佈日：2023-04-15 發佈者：大同世界科技股份有限公司 Server的FHIR RESTful功能要求 病床通報-伺服端 必須(SHALL) 可透過FHIR RESTful API查詢的Resources 根據FHIR規範實作RESTful HTTP回傳狀態碼 (Status 400)：無效參數(invalid parameter) (Status 401/4xx)：未經授權的請求(unauthorized request) (Status 403)：未充分授權的資料存取範圍(insufficient premission scope) (Status 404)：未知的resource(unknown resource) Server提供的API操作皆支援JSON格式 可識別每個新增到Server的實例(instance)之 meta.profile是否為TW Core Profiles Defining URL，並確認實例是否依循profile製作。【註：實例是指依據profile實作，將真實資料以JSON、XML或Turtle格式存放的檔案】 支援每個profile的查詢參數 病床通報-伺服端 建議應該(SHOULD) Server提供的API操作皆支援XML格式 安全性 Server必須(SHALL)透過回傳 HTTP 401「未授權」， HTTP 403「禁止」，或 HTTP 404 「未找到」，來拒絕任何未經授權的請求 系統廣泛的相互作用 可能可以(MAY)支援交易( transaction) 可能可以(MAY)支援批次( batch) 可能可以(MAY)支援查詢系統( search-system) Resources或Profiles的RESTful功能 共有七類Resources支援查詢，查詢參數如表列： Resources型別 Profile 支援的Profiles 支援的查詢參數 支援_includes(未來視情況新增) 支援_revincludes(未來視情況新增) 支援Operations(未來視情況新增) Bundle - 病床統計測量資料(Bundle-Bed Capacity), 病床個案資料(Bundle-Bed Case) _id, _lastUpdated, message, timestamp - - - Location 病床資料(Location-Bed Case) - - - - - Measure 病床統計測量(Bed Capacity) - - - - - MeasureReport 病床統計測量報告(Bed Capacity) - date - - - MessageHeader 病床通報訊息(HospBed MessageHeader) - author, sender - - - Patient 病人資料(Bed Case) - - - - - Organization 臺灣核心-醫事機構(TW Core Organization Hospital Department) - identifier, type - - - Bundle 預期的符合性(Conformance Expectation)： 必須(SHALL) 支援的Profiles： 病床統計測量資料(Bed Capacity), 病床個案資料(Bed Case) 支援的參照政策(Reference policy)： resolves，Server會嘗試將邏輯參照(logical reference)解析為文字參照，意即轉換Reference.identifier為Reference.reference(但如果解析失敗，Server仍然會接收這個resource，請參閱 logical)。 Profile 必須(SHALL)支援 create、 read、 update、 vread、 search-type、 patch 查詢參數摘要 符合性(Conformance) 參數 類型 範例 必須(SHALL) _id token GET [base]/Bundle?_id=[id], GET [base]/Bundle/[id] 必須(SHALL) _lastUpdated date GET [base]/Bundle?_lastUpdated={gt|lt|ge|le}[date] 必須(SHALL) message reference GET [base]/Bundle?message.author={Type/}[id], GET [base]/Bundle?message.sender={Type/}[id] 必須(SHALL) timestamp date GET [base]/Bundle?timestamp={gt|lt|ge|le}[date] Location 預期的符合性(Conformance Expectation)： 必須(SHALL) Profiles： 病床資料(Bed Case) 支援的參照政策(Reference policy)： resolves，Server會嘗試將邏輯參照(logical reference)解析為文字參照，意即轉換Reference.identifier為Reference.reference(但如果解析失敗，Server仍然會接收這個resource，請參閱 logical)。 Profile 必須(SHALL)支援 create、 read、 update、 vread、 search-type、 patch Measure 預期的符合性(Conformance Expectation)： 必須(SHALL) Profiles： 病床統計測量(Bed Capacity) 支援的參照政策(Reference policy)： resolves，Server會嘗試將邏輯參照(logical reference)解析為文字參照，意即轉換Reference.identifier為Reference.reference(但如果解析失敗，Server仍然會接收這個resource，請參閱 logical)。 Profile 必須(SHALL)支援 create、 read、 update、 vread、 search-type、 patch MeasureReport 預期的符合性(Conformance Expectation)： 必須(SHALL) Profiles： 病床統計測量報告(Bed Capacity) 支援的參照政策(Reference policy)： resolves，Server會嘗試將邏輯參照(logical reference)解析為文字參照，意即轉換Reference.identifier為Reference.reference(但如果解析失敗，Server仍然會接收這個resource，請參閱 logical)。 Profile 必須(SHALL)支援 create、 read、 update、 vread、 search-type、 patch 查詢參數摘要 符合性(Conformance) 參數 類型 範例 必須(SHALL) date date GET [base]/MeasureReport?date={gt|lt|ge|le}[date] MessageHeader 預期的符合性(Conformance Expectation)： 必須(SHALL) Profiles： 病床通報訊息(HospBed MessageHeader) 支援的參照政策(Reference policy)： resolves，Server會嘗試將邏輯參照(logical reference)解析為文字參照，意即轉換Reference.identifier為Reference.reference(但如果解析失敗，Server仍然會接收這個resource，請參閱 logical)。 Profile 必須(SHALL)支援 create、 read、 update、 vread、 search-type、 patch 查詢參數摘要 符合性(Conformance) 參數 類型 範例 必須(SHALL) author reference GET [base]/MessageHeader?author={Type/}[id] 必須(SHALL) sender reference GET [base]/MessageHeader?sender={Type/}[id] Patient 預期的符合性(Conformance Expectation)： 必須(SHALL) Profiles： 病人資料(Bed Case) 支援的參照政策(Reference policy)： resolves，Server會嘗試將邏輯參照(logical reference)解析為文字參照，意即轉換Reference.identifier為Reference.reference(但如果解析失敗，Server仍然會接收這個resource，請參閱 logical)。 Profile 必須(SHALL)支援 create、 read、 update、 vread、 search-type、 patch Organization 預期的符合性(Conformance Expectation)： 必須(SHALL) Profiles： 臺灣核心-醫事機構(TW Core Organization Hospital Department) 支援的參照政策(Reference policy)： resolves，Server會嘗試將邏輯參照(logical reference)解析為文字參照，意即轉換Reference.identifier為Reference.reference(但如果解析失敗，Server仍然會接收這個resource，請參閱 logical)。 Profile 必須(SHALL)支援 create、 read、 update、 vread、 search-type、 patch 查詢參數摘要 符合性(Conformance) 參數 類型 範例 必須(SHALL) identifier token GET [base]/Organization?identifier={system|}[code] 必須(SHALL) type token GET [base]/Organization?type={system|}[code]
病床通報-伺服端必須(SHALL)：(1)支援本實作指引中所有profiles (2)根據FHIR規範實作RESTful (3)回傳狀態碼-①(Status 400)：無效參數(invalid parameter)、②(Status 401/4xx)：未經授權的請求(unauthorized request)、③(Status 403)：未充分授權的資料存取範圍(insufficient premission scope)、④(Status 404)：未知的resource(unknown resource) (4)支援JSON格式 (5)可識別每個新增到Server的實例(instance)之meta.profile是否為病床通報Profiles Defining URL，並確認實例是否依循profile製作。 (6)支援每個profile的查詢參數。病床通報-伺服端建議應該(SHOULD)：(1)支援XML格式。