Versions Compared

Key

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

...


Field

(Trường dữ liệu)

Type

(Kiểu dữ liệu)

Required

(Bắt buộc)

Validation

(Quy định)

Description

(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.
2Tả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.
3Tà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.
4Nú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. 

5Nú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 thông tin hợp đồng 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.

6Nú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: 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:  công 
      • Nội dung thông báo: Vui lòng chọn tệp trước khi áp dụng

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: 
    • 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: 
      • Nội dung thông báo: Tệp không đúng mẫu. Vui lòng tải tệp theo đúng template hệ thống

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ụ: số hợp đồng, tên hợp đồng, tên dự án).

    • Sai kiểu dữ liệu (nhập text thay vì ngày/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ị.

  • 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 2: Lỗi trùng "số hợp đồ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ã hợp đồng bị trùng

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

7Nú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.

...