Dữ liệu Hồ sơ sức khoẻ cá nhân (PHR) được lưu trữ ở định dạng HL7 FHIR.
PHR hỗ trợ các phiên bản Tài nguyên có khả năng tương tác nhanh trong lĩnh vực y tế (FHIR) sau:
Loại tài nguyên y tế
FHIR bao gồm một tập hợp các thành phần mô-đun được gọi là tài nguyên. Nhóm tài nguyên FHIR được hỗ trợ và các danh mục tương ứng dựa trên các phần Tóm tắt bệnh nhân quốc tế.
Các tài nguyên này được liên kết với các danh mục dữ liệu trong Health Connect, được gọi là Loại tài nguyên y tế trong API. Tài nguyên quan sát được liên kết dựa trên nội dung như mã Tên và mã giá trị nhận dạng quan sát logic (LOINC) và danh mục FHIR.
Các quan sát không thuộc bất kỳ danh mục nào trong số này sẽ không được ghi vào Health Connect.
| Loại tài nguyên y tế trên Health Connect | (Các) tài nguyên FHIR |
|---|---|
| Dị ứng | AllergyIntolerance |
| Điều kiện | Điều kiện |
| Phòng thí nghiệm | Quan sát
|
| Thuốc | Medication, MedicationRequest, MedicationStatement |
| Thông tin cá nhân | Bệnh nhân |
| Thông tin về nhân viên y tế | Chuyên gia, PractitionerRole |
| Thai kỳ | Quan sát
|
| Thủ thuật y tế | Quy trình |
| Tiền sử xã hội | Quan sát
|
| Vắc-xin | Dữ liệu tiêm chủng |
| Hoạt động thăm khám | Gặp gỡ, Vị trí, Tổ chức |
| Dấu hiệu sinh tồn | Quan sát
|
Tài nguyên dành cho bệnh nhân
Hiện tại, Health Connect chỉ lưu trữ dữ liệu hồ sơ sức khoẻ cá nhân cho một cá nhân. Do đó, tất cả tài nguyên FHIR được viết phải thuộc về cùng một người.
Không có gì lạ khi nhiều tài nguyên Bệnh nhân FHIR tồn tại trong một hệ thống cho một cá nhân. Ưu tiên các ứng dụng điều chỉnh dữ liệu và ghi một tài nguyên Bệnh nhân duy nhất vào Health Connect. Tuy nhiên, điều này không được thực thi để phù hợp với các cấu trúc tổ chức khác nhau có thể tồn tại.
Xác thực dữ liệu
API PHR chấp nhận các tài nguyên FHIR hợp lệ từ các phiên bản được hỗ trợ và Health Connect thực hiện một số bước xác thực để xác nhận rằng bạn tuân thủ thông số kỹ thuật FHIR cho từng phiên bản được hỗ trợ.
Các quy trình kiểm tra xác thực được đánh dấu là Sắp ra mắt chưa được thực thi nhưng sẽ có trong bản phát hành sau này. Bạn nên phát triển dựa trên tất cả các quy trình kiểm tra xác thực được liệt kê để duy trì khả năng tương thích với các bản phát hành trong tương lai.
| Cấp độ | Kiểm tra xác thực | ||||||||
|---|---|---|---|---|---|---|---|---|---|
| JSON hợp lệ | Dữ liệu tuân thủ định dạng JSON. | ||||||||
| FHIR được hỗ trợ | Phiên bản FHIR do ứng dụng viết khai báo được hỗ trợ. Health Connect hỗ trợ các phiên bản FHIR sau:
|
||||||||
| FHIR được hỗ trợ | Loại tài nguyên FHIR được ghi lại trong thực thể tài nguyên được hỗ trợ. Health Connect hỗ trợ các loại tài nguyên FHIR sau:
|
||||||||
| Mã nhận dạng tài nguyên duy nhất | Tài nguyên có trường mã nhận dạng có giá trị đáp ứng các yêu cầu về biểu thức chính quy. | ||||||||
| Mã nhận dạng tài nguyên duy nhất | Tài nguyên không chia sẻ mã nhận dạng với một tài nguyên FHIR khác thuộc cùng loại tài nguyên từ cùng một MedicalDataSource. |
||||||||
| Quy tắc kinh doanh | Không bao gồm tài nguyên FHIR được chứa. Tài nguyên được chứa là các tài nguyên FHIR lồng trong tài nguyên "mẹ". Các tài nguyên này được dùng khi tài nguyên mẹ cần tham chiếu đến một tài nguyên khác, nhưng hệ thống không có đủ thông tin để tạo tài nguyên này dưới dạng một tài nguyên độc lập tồn tại độc lập. | ||||||||
| FHIR cơ sở hợp lệ | Các trường cấp cao nhất trong JSON FHIR tồn tại trong quy cách FHIR cho loại tài nguyên nhất định. | ||||||||
| FHIR cơ sở hợp lệ | Các trường cấp cao nhất không có giá trị rỗng JSON. | ||||||||
| FHIR cơ sở hợp lệ | Tất cả các trường bắt buộc cấp cao nhất đều có sẵn. | ||||||||
| FHIR cơ sở hợp lệ | Các trường cấp cao nhất được xác định là các phần tử lặp lại trong FHIR có loại dữ liệu array JSON. |
||||||||
| FHIR cơ sở hợp lệ | Các trường cấp cao nhất (bao gồm cả các phần tử trong array JSON) được xác định là Loại phức tạp trong FHIR có loại dữ liệu object JSON. |
||||||||
| FHIR cơ sở hợp lệ | Các trường cấp cao nhất (bao gồm cả các phần tử trong array JSON) được xác định là Loại gốc trong FHIR có đúng loại dữ liệu JSON.
|
||||||||
| FHIR cơ sở hợp lệ | Các trường cấp cao nhất được xác định là Loại gốc trong FHIR đáp ứng các yêu cầu về biểu thức chính quy. Sắp ra mắt | ||||||||
| FHIR cơ sở hợp lệ | Tiện ích cho các loại dữ liệu gốc
tồn tại trong quy cách FHIR và có loại dữ liệu object JSON. |
||||||||
| FHIR cơ sở hợp lệ | Không ghi lại nhiều trường cho Trường lựa chọn (fieldname[x]).Ví dụ: effectiveDateTime và effectivePeriod không thể xuất hiện trong cùng một thực thể tài nguyên. |
||||||||
| FHIR cơ sở hợp lệ | Loại dữ liệu phức tạp chứa các trường và loại dữ liệu khớp với thông số kỹ thuật FHIR. Sắp ra mắt | ||||||||
| FHIR cơ sở hợp lệ | Các phần tử xương sống (và các phần tử trong loại phức tạp) chứa các trường và loại dữ liệu khớp với thông số kỹ thuật FHIR. Sắp ra mắt | ||||||||
| FHIR cơ sở hợp lệ | Các trường phần tử tiện ích
value[x] là một loại hợp lệ và chứa nội dung theo loại dữ liệu đó.
Bạn có thể đưa các phần tử tiện ích vào bất kỳ tài nguyên nào để biểu thị thông tin bổ sung không thuộc thông số kỹ thuật cơ sở. Các phần tử này chứa trường url liên kết đến định nghĩa của tiện ích và trường value[x] chứa giá trị tiện ích.
value[x] phải thuộc danh sách các kiểu dữ liệu được chấp nhận.
Sắp ra mắt |
Dữ liệu FHIR đã chuyển đổi
Một số ứng dụng chuyển đổi dữ liệu FHIR để đáp ứng các yêu cầu riêng. Ví dụ:
- Hợp nhất dữ liệu từ nhiều nguồn (thường là API FHIR).
- Ánh xạ mã đến các thuật ngữ toàn cầu (ví dụ: SNOMED, LOINC, ICD) và chuẩn hoá các đơn vị.
- Hợp nhất và loại bỏ trùng lặp dữ liệu.
- Khắc phục vấn đề về định dạng hoặc các vấn đề khác về chất lượng dữ liệu.
- Lọc bản ghi dựa trên các quy tắc kinh doanh dành riêng cho ứng dụng.
Bạn có thể ghi dữ liệu FHIR chưa chuyển đổi và đã chuyển đổi vào Health Connect, miễn là dữ liệu đó tuân thủ quy cách FHIR R4. Bạn nên ghi dữ liệu đã chuyển đổi khi có thể. Tuy nhiên, hãy lưu ý những điều sau:
- Các ứng dụng có trường hợp sử dụng hẹp có thể lọc ra một lượng lớn bản ghi mà các ứng dụng khác trong hệ sinh thái có thể tạo ra giá trị cho người dùng. Trong những trường hợp như vậy, bạn nên viết FHIR chưa chuyển đổi để hoàn chỉnh hơn. Tuy nhiên, hãy nhớ thông báo cho người dùng rằng tập dữ liệu rộng hơn này đang được chia sẻ.
- Nếu hợp nhất dữ liệu bắt nguồn từ nhiều nguồn, bạn có thể ghi dữ liệu vào một
MedicalDataSourcetrong Health Connect. Bạn cũng phải chỉ định một mã nhận dạng mới cho từng tài nguyên để tránh xung đột và cập nhật các tệp tham chiếu tài nguyên để trỏ đến các mã nhận dạng mới. - Việc hợp nhất dữ liệu từ nhiều nguồn vào một
MedicalDataSourcecó thể làm lu mờ nguồn gốc dữ liệu. Vì người dùng dữ liệu thường cần hiểu nguồn gốc của dữ liệu, nên bạn nên điền nguồn gốc ban đầu của bản ghi (thường là URL cơ sở FHIR) vào trườngmeta.sourcecho mỗi tài nguyên.