📥 Nhập kết quả từ thiết bị (Excel)
Trang này hướng dẫn cách nhập hàng loạt kết quả từ file Excel do thiết bị xét nghiệm xuất ra (ELISA, PCR...) vào phiếu phân tích, thay vì gõ tay từng dòng. Cơ chế hoạt động dựa trên ánh xạ cột (mapping): hệ thống đọc các vùng ô (cell range) trong file của thiết bị rồi đổ giá trị vào đúng trường đích (target field) của từng chỉ tiêu trong Xbook.
💡 Quy trình gồm hai phần: (1) thiết lập sẵn Cấu hình ánh xạ cho mỗi bộ Kit/thiết bị (làm một lần), và (2) chạy trình nhập kết quả trên phiếu phân tích mỗi khi có file mới.
Cách hoạt động của ánh xạ cột
Mỗi loại file thiết bị có bố cục cố định theo từng Kit / phương pháp. Để Xbook hiểu được file, bạn khai báo hai lớp:
| Đối tượng | Ý nghĩa |
|---|---|
| Phương pháp (Kit) | Đại diện một bộ Kit hoặc thiết bị đo. Có thể gắn với Phương pháp phân tích chung (ví dụ ELISA) để hệ thống tự lọc Kit phù hợp với chỉ tiêu. |
| Cấu hình (ánh xạ cột) | Một bộ ánh xạ thuộc một Phương pháp, gồm nhiều dòng mô tả: file đặt giá trị ở ô/vùng nào thì ghi vào trường nào. |
Trong mỗi Cấu hình, mở tab Chi tiết và khai báo từng dòng ánh xạ:
| Trường | Ý nghĩa |
|---|---|
| Thứ tự | Thứ tự sắp xếp các dòng ánh xạ (kéo thả). |
| Trường dữ liệu | Trường đích trong Xbook để nhận giá trị (ví dụ Kết quả, CT, Giá trị O.D, S/P Ratio, Titer, ID Mẫu / STT, Hình ảnh 1/2...). |
| Tên cột | Nhãn cột để dễ nhận biết (tùy chọn). |
| Vị trí ô | Vùng ô Excel chứa giá trị. |
Quy ước Vị trí ô (theo hướng dẫn ngay trên form cấu hình):
- Ô đơn (ví dụ
B2): dùng cho các trường đơn lẻ ở phần tiêu đề như Trung bình (Mean), Ngày, Tên Kit. - Vùng cột (ví dụ
B10:B100): dùng cho các trường danh sách như Giá trị OD, Kết quả, ID Mẫu.
💡 Nếu file thiết bị có cột mã mẫu, hãy ánh xạ một dòng vào trường ID Mẫu / STT (
Sample ID / No.). Khi có cột này, hệ thống sẽ ghép kết quả theo mã mẫu thay vì theo thứ tự — an toàn hơn nhiều.
📷 Cần chèn ảnh:
/img/modules/laboratory/device-import/01.png— Form Cấu hình ánh xạ cột: tab Chi tiết với các dòng Trường dữ liệu / Vị trí ô và khung hướng dẫn Vị trí ô.
Nhập kết quả vào phiếu phân tích
Từ Phiếu phân tích (Laboratory Analysis) cần nhập kết quả, mở chức năng Nhập kết quả (Import Result) — trình nhập gắn theo phiếu phân tích đang xem. Cửa sổ nhập có 2 bước: Cấu hình rồi Xem trước.
📷 Cần chèn ảnh:
/img/modules/laboratory/device-import/02.png— Phiếu phân tích và lối mở chức năng Nhập kết quả.
Bước 1 — Cấu hình và tải file
Khung thông báo nhắc: "Chọn Chỉ tiêu phân tích và tải lên tệp Excel của thiết bị."
- Chọn Nhóm mẫu (
Sample Group) — lọc theo nhóm mẫu của yêu cầu hiện tại (tùy chọn). - Chọn Chỉ tiêu đích (
Target Parameter) — chỉ tiêu sẽ nhận kết quả; danh sách được lọc theo lệnh phân tích và nhóm mẫu đã chọn. - Chọn Bộ Kit (
Kit / Instrument) — bộ Kit hoặc thiết bị đã dùng. Nếu chỉ có đúng một Kit phù hợp với chỉ tiêu, hệ thống tự điền sẵn. - Kiểm tra Cấu hình (
Mapping Configurations) — các cấu hình ánh xạ thuộc Kit; hệ thống tự chọn theo Kit, bạn có thể điều chỉnh. - Tại Tải tệp lên (
Upload File), chọn file Excel.xls/.xlsxdo thiết bị xuất ra. - Nhấn Xem trước (nút Preview) để hệ thống đọc file và dựng bảng ghép.
📷 Cần chèn ảnh:
/img/modules/laboratory/device-import/03.png— Bước Cấu hình: chọn Nhóm mẫu, Chỉ tiêu đích, Bộ Kit, Cấu hình và tải file Excel.
⚠️ Hệ thống chỉ nhập vào các dòng đang ở trạng thái "mới" của chỉ tiêu (các dòng chưa có kết quả). Nếu chỉ tiêu/nhóm đã chọn không còn dòng "mới" nào, hệ thống báo "Không tìm thấy dòng dữ liệu nào trong Xbook cho Chỉ tiêu/Nhóm đã chọn."
Bước 2 — Xem trước và xác nhận
Sau khi nhấn Xem trước, hệ thống hiển thị bảng ghép để bạn duyệt trước khi ghi: "Xem lại ánh xạ bên dưới. Kết quả chỉ được ghi vào mẫu đã khớp sau khi bạn xác nhận."
Bảng gồm các cột: Hàng (số dòng Excel), Mã mẫu Excel, Mẫu Xbook, Tên mẫu, Giá trị cần ghi và Trạng thái.
| Trạng thái | Ý nghĩa |
|---|---|
| Khớp theo mã | Dòng Excel ghép đúng một mẫu Xbook qua mã mẫu — sẽ được ghi. |
| Tuần tự (không mã) | Cấu hình không có cột mã mẫu; dòng được ghép với mẫu theo thứ tự (vị trí). |
| Không tìm thấy mã | Mã mẫu trong file không khớp mẫu nào — bị chặn (tô đỏ). |
| Mã trùng lặp / không rõ ràng | Mã mẫu khớp nhiều mẫu hoặc đã dùng — bị chặn (tô đỏ). |
- Đối chiếu cột Giá trị cần ghi với mẫu tương ứng.
- Nhấn Xác nhận nhập liệu (nút Confirm Import) để ghi kết quả vào các dòng đã khớp.
Khi hoàn tất, hệ thống báo "Nhập liệu thành công. Đã cập nhật N dòng."
📷 Cần chèn ảnh:
/img/modules/laboratory/device-import/04.png— Bước Xem trước: bảng ghép mã Excel ↔ mẫu Xbook ↔ giá trị cần ghi và cột Trạng thái.
⚠️ Nếu còn dòng Không tìm thấy mã hoặc Mã trùng lặp, nút Xác nhận nhập liệu sẽ bị ẩn và không thể nhập. Hãy nhấn Quay lại (nút Back) để sửa file hoặc cấu hình ánh xạ, rồi xem trước lại.
⚠️ Ghép tuần tự (không có cột mã mẫu): hệ thống ghép từng dòng Excel với mẫu chỉ theo vị trí. Nếu số dòng Excel khác số dòng đích, hệ thống chặn ngay (báo "Số hàng không khớp...") và gợi ý thêm cột ID Mẫu vào ánh xạ. Trước khi nhập kiểu tuần tự, bạn còn phải tích chọn ô xác nhận rằng thứ tự các dòng Excel trùng với thứ tự các dòng mẫu đích — vì nếu lệch thứ tự, kết quả sẽ ghi sai mẫu. Chỉ khi đã tích xác nhận này, nút Xác nhận nhập liệu mới hiện ra.
💡 Để xem trước lại với file hoặc cấu hình khác, dùng nút Quay lại trở về bước Cấu hình; nhấn Hủy bỏ (
Cancel) để đóng mà không ghi gì.
Liên quan
- Khai báo yêu cầu — khai báo yêu cầu, mẫu và chỉ tiêu phân tích nhận kết quả nhập về.
- Thiết bị & Hiệu chuẩn — quản lý thiết bị xét nghiệm và hiệu chuẩn.