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ộcKhô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
hể hiện nút chức năng (Button) cho phép người dùng người dù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ộcKhô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 để 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 đúng định dạng với tệp mẫu (template). 
    • Hành vi hệ thống:
      • Hành vi 1: Những ca làm việc được thêm mớ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: Lỗi không chọn tệp

  • Điều kiện: Người dùng nhấn “Áp dụng” khi chưa tải lên bất kỳ tệp nào.

  • Hành vi hệ thống:

    • Hiển thị thông báo (toast) lỗi
      •  Tiêu đề thông báo: Không thành công: tham chiếu mục:  

Lỗi 2: Lỗi tệp không đúng mẫu (không đúng template)

  •  Đ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

Lỗi 3: Lỗi dữ liệu trong file không hợp lệ (data validation error)

  • Đ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 4: 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.7. 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.

...