Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

STT

Trường thông tin/Nút chức năng

Kiểu dữ liệu

Điều kiện

Quy định

Mô tả

1Tài liệu mẫuVăn bản (Text)

Không

bắt buộc

Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa).Thể hiện tên trường là "Tài liệu mẫu" để  hướng dẫn người dùng về file mẫu cần thiết cho việc nhập dữ liệu.
1.1Tải xuốngNút chức năng (Button)

Không

bắt buộc

- Cho phép người dùng nhấn để thực hiện quá trình xuất tệp dữ liệu mẫu (template) ca làm việc.
- Khi nhấn nút, hành vi hệ thống như sau:

  • Hành vi 1: Cho phép người dùng chọn vị trí lưu trữ tệp và tải xuống tệp
    • Hệ thống mở pop-up của trình duyệt để người dùng chọn vị trí lưu tệp.

    • Sau khi chọn xong, hệ thống tiến hành xuất và tải file Excel chứa tệp dữ liệu excel đã chọn về máy tính cá nhân.

    • Thông tin tệp dữ liệu dùng để nhập dữ liệu excel : 
  • Hành vi 2: Hiển thị thông báo (toast) thành công:
    • Tiêu đề thông báo: Thành công
    • Nội dung thông báo: Tải xuống file dữ liệu mẫu thành công
Thể hiện nút chức năng cho phép người dùng chọn vị trí lưu trữ và tải tệp dữ liệu xuống máy tính cá nhân.
2Tài liệu đính kèmVăn bản (Text)

Không

bắt buộc

Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa).Thể hiện tên mục là "Tài liệu đính kèm" để hướng dẫn người dùng về vị trí đính kèm tệp dữ liệu excel sau khi điền thông tin.
2.1Nút "Nhấn hoặc tả để tải lên" Nút chức năng (Button)

Không

bắt buộc

- Cho phép người dùng nhấn để mở màn hình pop-up chọn tệp của trình duyệt để lựa chọn tệp dữ liệu cần tải lên từ máy tính cá nhân.
-  Sau khi chọn xong, hệ thống hiển thị tệp dữ liệu đã tải lên trong mục Tài liệu đính kèm.

Thể hiện nút chức năng cho phép người dùng đính kèm tệp dữ liệu excel sau khi điền thông tin. 

3Nút "Hủy"Nút chức năng (Button)

Không

bắt buộc

- Cho phép người dùng nhấn để hủy bỏ thao tác xóa.
-  Khi nhấn, màn hình pop-up đóng lại và bản ghi ca làm việc không bị xóa.

Thể hiện nút chức năng cho phép hủy bỏ thao tác mà không lưu dữ liệu.

4Nút "Áp dụng"Nút chức năng (Button)

Không

bắt buộc

- Cho phép người dùng nhấn khi đã tải lên tệp dữ liệu và  xác nhận tệp dữ liệu ca làm việc sau khi tải lên như sau:

  • Trường hợp 1: Tệp dữ liệu hợp lệ:
    • Điều kiện:
      • Tệp dữ liệu đầu vào thuân thủ theo tệp mẫu (template).
      • Thứ tự Sheet Bắt buộc: sheet “Mẫu nhập file excel” phải đứng trước, sheet “Hướng dẫn nhập liệu” đứng sau
    • Hành vi hệ thống:
      • Hành vi 1: Những ca làm việc được thêm mới đồng thời sẽ được hiển thị với giá trị trạng thái mặc định là "Hoạt động".
      • Hành vi 2: Hệ thống tải lên tệp dữ liệu và hiển thị thông báo thành công.
        • Tiêu đề thông báo: Thành công
        • Nội dung thông báo: Nhập dữ liệu thành công
  • Trường hợp 2: Tệp dữ liệu KHÔNG hợp lệ:

Lỗi 1: Tệp không đúng định dạng

  •  Điều kiện:  Tệp người dùng tải lên có 1 trong những đặc điểm sau: Cấu trúc cột khác template, Thiếu cột bắt buộc, Sai tên cột, File dư cột.
  • Hành vi hệ thống:  Hệ thống mở ra màn hình pop-up "Lỗi nhập file excel": Tham chiếu mục 3.4.7. Màn hình pop-up Lỗi nhập file excel
    • Hệ thống hiển thị thông báo lỗi:
    • Tiêu đề: Không thành công
    • Nội dung: Định dạng file không hợp lệ"

Lỗi 2: Lỗi dữ liệu trong không hợp lệ

  • Điều kiện: Người dùng sử dụng tệp dữ liệu đúng mẫu(template), nhưng nội dung bên trong chứa giá trị không hợp lệ, bao gồm một hoặc nhiều trường hợp sau:
    • Thiếu dữ liệu bắt buộc (ví dụ: Mã ca, thời gian bắt đầu/kết thúc).

    • Sai kiểu dữ liệu (nhập text thay vì giờ/số).

    • Mã ca đã tồn tại trong hệ thống.

    • Thời gian bắt đầu lớn hơn thời gian kết thúc.

    • Dữ liệu vượt quá giới hạn độ dài/giá trị.

    • Giá trị không thuộc danh mục cho phép.

  • Hành vi hệ thống: Hệ thống mở ra màn hình pop-up "Lỗi nhập file excel": Tham chiếu mục 3.4.7. Màn hình pop-up Lỗi nhập file excel

Lỗi 3: Lỗi trùng "mã ca + ngày áp dụng"

  • Điều kiện: Người dùng tải lên tệp dữ liệu đúng mẫu (template), nhưng trong nội dung file xuất hiện bản ghi không hợp lệ, bao gồm:
    • Bản ghi có Mã ca + Ngày áp dụng trùng với dữ liệu đã tồn tại trong hệ thống.

    • Bản ghi trùng lặp Mã ca + Ngày áp dụng ngay trong chính tệp được tải lên.

  • Hành vi hệ thống: Hệ thống mở ra màn hình pop-up "Lỗi nhập file excel": Tham chiếu mục 3.4.8. Màn hình pop-up Lỗi nhập file excel

Thể hiện nút chức năng cho phép người dùng xác nhận tệp dữ liệu excel sau khi hoàn thành tải lên.

5Nút "X"Nút chức năng (Button)Bắt buộc- Cho phép người dùng nhấn để hủy bỏ thao tác xóa.
- Khi nhấn, màn hình pop-up đóng lại và bản ghi ca làm việc không bị xóa.
Thể hiện nút chức năng cho phép hủy bỏ thao tác mà không lưu dữ liệu.

...

STT

Trường thông tin/Nút chức năng

Kiểu dữ liệu

Điều kiện

Quy định

Mô tả

1Thông báo tóm tắt lỗiVăn bản (Text)

Không

bắt buộc

Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa).

Thể hiện tổng quan về kết quả của quá trình nhập file Excel như sau:

  • Icon: Dấu "x" màu đỏ: biểu thị lỗi bên trái tiêu đề.
  • Tiêu đề: Không thành công
  • Mô tả chi tiết: File excel bạn nhập chưa chính xác
2Bảng "Danh mục lỗi gặp phải"Văn bản (Text)

Không

bắt buộc

Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa).Thể hiện tiêu đề bảng: Danh mục các lỗi gặp phải
2.1Dòng lỗiVăn bản (Text)

Không

bắt buộc

Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa).

- Tiêu đề cột: Dòng lỗi

- Nội dung cột: Số thứ tự dòng/hàng bị lỗi trong file Excel gốc.

2.2Ghi chú lỗiVăn bản (Text)

Không

bắt buộc

- Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa).

- Danh sách lỗi được hiển thị như sau:

  • Lỗi nhập thiếu trường bắt buộc: "Giá trị trường <Tên trường> chưa nhập"
  • Lỗi trùng mã ca và ngày áp dụng với mã ca và ngày áp dụng: "Mã ca và ngày áp dụng đã tồn tại" 
  • Lỗi trùng mã ca làm viêc và ngày áp dụng: "Mã ca làm việc và Ngày áp dụng bị trùng với mã tại dòng (X), (Y),...". Trường hợp có nhiều bản ghi trùng lắp, liệt kê các bản ghi và phân cách bằng dấu ",")Lỗi giá trị trường trạng thái hoạt động: "Trường trạng thái hoạt động chỉ cho phép nhập "Hoạt động" hoặc "Không hoạt động"

- Tiêu đề cột: Tên lỗi 

- Nội dung cột: Thể hiện nội dung lỗi gặp phải tại dòng tương ứng ở mục 2.1.

3Nút "Tải xuống"Nút chức năng (Button)

Không

bắt buộc

- Cho phép người dùng nhấn để thực hiện quá trình tải xuống tệp dữ liệu excel bảng "Danh mục các lỗi gặp phải".

- Thông tin tệp dữ liệu được xuất ra:






- Cho phép người dùng nhấn để hủy bỏ các thay đổi và đóng giao diện hiện tại mà không lưu thông tin.Thể hiện  nút chức năng cho phép hủy bỏ thao tác mà không lưu dữ liệu.
5Nút "Nhập lại"Nút chức năng (Button)

Không

bắt buộc

- Cho phép người dùng nhấn nút.

- Khi nhấn nút, hệ thống đóng pop-up "Lỗi nhập file excel" và điều hướng người dùng quay lại màn hình pop-up "Nhập file excel": tham chiếu mục: 3.4.6. Màn hình pop-up "Nhập file excel" 

Thể hiện  nút chức năng cho phép người dùng quay lại màn hình pop-up "Nhập file excel" để thực hiện lại quá trình đính kèm tệp dữ liệu.
6Nút "X"Nút chức năng (Button)

Không

bắt buộc

- Cho phép người dùng nhấn để hủy bỏ các thay đổi và đóng giao diện hiện tại mà không lưu thông tin.Thể hiện  nút chức năng cho phép hủy bỏ thao tác mà không lưu dữ liệu.

...