Dữ liệu Hồ sơ sức khoẻ được lưu trữ ở định dạng HL7 FHIR.
Bệnh án hỗ trợ các phiên bản Tài nguyên có thể tương tác nhanh về sức khoẻ (FHIR) sau đây:
Các loại tài nguyên y tế
FHIR bao gồm một tập hợp các thành phần theo mô-đun được gọi là tài nguyên. Tập hợp các tài nguyên FHIR được hỗ trợ và các danh mục tương ứng được dựa trên các phần Tóm tắt thông tin 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à Các 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ư Tên và mã nhận dạng quan sát logic (LOINC) và danh mục FHIR.
Những dữ liệu 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ế của Health Connect | (Các) tài nguyên FHIR | Khai báo quyền đối với Health Connect |
|---|---|---|
| Dị ứng | AllergyIntolerance |
android.permission.health.READ_MEDICAL_DATA_ALLERGIES_INTOLERANCES
|
| Điều kiện | Điều kiện |
android.permission.health.READ_MEDICAL_DATA_CONDITIONS
|
| Phòng thí nghiệm |
Quan sát
|
android.permission.health.READ_MEDICAL_DATA_LABORATORY_RESULTS
|
| Thuốc | Medication, MedicationRequest, MedicationStatement |
android.permission.health.READ_MEDICAL_DATA_MEDICATIONS
|
| Thông tin cá nhân | Bệnh nhân |
android.permission.health.READ_MEDICAL_DATA_PERSONAL_DETAILS
|
| Thông tin về nhân viên y tế | Nhân viên y tế, PractitionerRole |
android.permission.health.READ_MEDICAL_DATA_PRACTITIONER_DETAILS
|
| Thai kỳ |
Quan sát
|
android.permission.health.READ_MEDICAL_DATA_PREGNANCY
|
| Thủ thuật y tế | Quy trình |
android.permission.health.READ_MEDICAL_DATA_PROCEDURES
|
| Tiền sử xã hội |
Quan sát
|
android.permission.health.READ_MEDICAL_DATA_SOCIAL_HISTORY
|
| Vắc-xin | Dữ liệu tiêm chủng |
android.permission.health.READ_MEDICAL_DATA_VACCINES
|
| Hoạt động thăm khám | Cuộc gặp gỡ, Vị trí, Tổ chức |
android.permission.health.READ_MEDICAL_DATA_VISITS
|
| Dấu hiệu sinh tồn |
Quan sát
|
android.permission.health.READ_MEDICAL_DATA_VITAL_SIGNS
|
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ơ y tế của một cá nhân. Do đó, tất cả tài nguyên FHIR được ghi phải thuộc về cùng một người.
Không hiếm gặp trường hợp có nhiều tài nguyên Bệnh nhân FHIR trong một hệ thống cho một cá nhân. Các ứng dụng nên đối chiếu dữ liệu và ghi một Tài nguyên duy nhất cho bệnh nhân vào Health Connect. Tuy nhiên, quy tắc này không được thực thi để phù hợp với nhiều cấu trúc tổ chức có thể tồn tại.
Xác thực dữ liệu
Medical Records API 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ố quy trình xác thực để xác nhận rằng bạn tuân thủ quy cách FHIR cho từng phiên bản được hỗ trợ.
Các bước kiểm tra xác thực được đánh dấu là Sắp ra mắt hiện chưa được thực thi, nhưng sẽ được thực thi trong một 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ợ | Hệ thống có hỗ trợ phiên bản FHIR do ứng dụng ghi khai báo hay không. Health Connect hỗ trợ các phiên bản FHIR sau đây:
|
||||||||
| FHIR được hỗ trợ | Loại tài nguyên FHIR được ghi trong phiên bản 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ó một trường mã nhận dạng với 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 dùng chung mã nhận dạng với một tài nguyên FHIR khác 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à tài nguyên FHIR được lồng trong một tài nguyên "mẹ". Chúng đượ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. | ||||||||
| FHIR cơ bản hợp lệ | Các trường cấp cao nhất trong FHIR JSON có trong quy cách FHIR cho loại tài nguyên đã cho. | ||||||||
| FHIR cơ bản hợp lệ | Các trường cấp cao nhất không có giá trị rỗng JSON. | ||||||||
| FHIR cơ bản hợp lệ | Tất cả các trường bắt buộc ở cấp cao nhất đều có mặt. | ||||||||
| FHIR cơ bản 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ó kiểu dữ liệu JSON array. |
||||||||
| FHIR cơ bản hợp lệ | Các trường cấp cao nhất (bao gồm cả các phần tử trong JSON array) được xác định là Các loại phức tạp trong FHIR có kiểu dữ liệu JSON object. |
||||||||
| FHIR cơ bản 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à Các kiểu dữ liệu cơ bản trong FHIR có kiểu dữ liệu JSON chính xác.
|
||||||||
| FHIR cơ bản hợp lệ | Các trường cấp cao nhất được xác định là Các loại nguyên thuỷ 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ơ bản hợp lệ | Các tiện ích cho các loại Nguyên thuỷ có trong quy cách FHIR và có một loại dữ liệu JSON object. |
||||||||
| FHIR cơ bản hợp lệ | Không được ghi quá một trường cho Trường lựa chọn (fieldname[x]).Ví dụ: effectiveDateTime và effectivePeriod không thể cùng xuất hiện trong cùng một thực thể tài nguyên. |
||||||||
| FHIR cơ bản hợp lệ | Các 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 quy cách FHIR. Sắp ra mắt | ||||||||
| FHIR cơ bản hợp lệ | Các phần tử cơ bản (và các phần tử trong các loại phức tạp) chứa các trường và kiểu dữ liệu phù hợp với quy cách FHIR. Sắp ra mắt | ||||||||
| FHIR cơ bản hợp lệ | Phần tử tiện ích
Các trường value[x] là một loại hợp lệ và chứa nội dung theo kiểu 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 quy cách cơ bản. Các phần tử này chứa một trường url liên kết đến định nghĩa của tiện ích và một trường value[x] chứa giá trị tiện ích.
value[x] phải nằm trong danh sách các kiểu dữ liệu được chấp nhận.
Sắp ra mắt |
Dữ liệu FHIR đã được 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 của chúng. Ví dụ:
- Hợp nhất dữ liệu từ nhiều nguồn (thường là API FHIR).
- Ánh xạ mã với 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ỏ dữ liệu trùng lặp.
- 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.
Dữ liệu FHIR chưa được chuyển đổi và đã được chuyển đổi đều có thể được ghi vào Health Connect, miễn là chúng 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ểm sau:
- Những ứng dụng có trường hợp sử dụng hẹp có thể lọc ra một số 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 được chuyển đổi đầy đủ hơn. Tuy nhiên, hãy nhớ thông báo cho người dùng rằng bạn đang chia sẻ tập dữ liệu rộng hơn này.
- Nếu hợp nhất dữ liệu có nguồn gốc từ nhiều nguồn, bạn có thể ghi dữ liệu vào một
MedicalDataSourceduy nhất trong 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ài nguyên tham chiếu để trỏ đến 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ể che giấu nguồn gốc của dữ liệu. Vì người dùng dữ liệu thường cần hiểu rõ nguồn gốc của dữ liệu, nên bạn nên điền sẵn trườngmeta.sourcecho từng tài nguyên bằng nguồn gốc ban đầu của bản ghi (thường là URL cơ sở của FHIR).