Versions Compared

Key

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

...

3.4.5. Màn hình pop-up "Nhập file excel"


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 : 
      • Tên tệp dữ liệu: BPM1-Mẫu nhập file excel
      • Mẫu tệp dữ liệu (Template khi nhập file 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
ca làm việc
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:  

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: 

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.

3.4.6.Màn hình pop-up "Xuất file excel" :


Field

(Trường dữ liệu)

Type

(Kiểu dữ liệu)

Required

(Bắt buộc)

Validation

(Quy định)

Description

(Mô tả)

1Chọn kiểu xuất file

Văn bản (Text)

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à "Chọn kiểu xuất file" để  hướng dẫn người dùng về cách thức xuất tệp dữ liệu excel danh sách hợp đồng.

2Tùy chọn "Tất cả hợp đồng"Nút chọn (Radio Button)Không bắt buộcCho phép người dùng nhấn để chọn tùy chọn xuất toàn bộ dữ liệu hợp đồng trên hệ thống.Thể hiện tên tùy chọn là "Tất cả hợp đồng" cho phép người dùng chọn cách thức xuất tệp dữ liệu là xuất toàn bộ dữ liệu hợp đồng trên hệ thống.
3Tùy chọn "Trên trang này"Nút chọn (Radio Button)Không bắt buộcCho phép người dùng nhấn để chọn tùy chọn xuất tệp dữ liệu hợp đồng là bản ghi ca làm việc đang hiển thị trên trang hiện tại.Thể hiện tên tùy chọn là "Trên trang này" cho phép người dùng chọn cách thức xuất tệp dữ liệu là xuất chỉ dữ liệu hợp đồng đang hiển thị trên trang hiện tại.
4Tùy chọn "Tất cả kết quả tìm kiếm hiện tại"Nút chọn (Radio Button)Không bắt buộcCho phép người dùng nhấn để chọn tùy chọn xuất tệp dữ liệu ca làm việc là bản ghi ca làm việc đã được lọc (filter) hoặc tìm kiếm (search).Thể hiện tên tùy chọn là "Tất cả kết quả tìm kiếm hiện tại" cho phép người dùng chọn cách thức xuất tệp dữ liệu là xuất danh sách hợp đồng đã được lọc (filter) hoặc tìm kiếm (search).
5Nút "Hủy"Nút chức năng (Button)Không bắt buộcCho 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.

6Nút "Áp dụng"Nút chức năng (Button)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 hợp đồng.
- Khi nhấn nút, hành vi hệ thống như sau:
  • Hành vi 1: kiểm tra việc người dùng đã hoàn thành chọn kiểu xuất File.
  • Hành vi 2: 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.

  • Hành vi 3: 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: Xuất dữ liệu thành công

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

  • Tên tệp: BPM1-Dữ liệu danh sách hợp đồng
  • Mẫu tệp dữ liệu: 
Thể hiện nút chức năng cho phép xuất tệp dữ liệu excel hợp đồng.
7Nút "X"Nút chức năng (Button)Không bắt buộcCho 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.

3.4.7. Màn hình pop-up "Lỗi nhập file excel"


Field

(Trường dữ liệu)

Type

(Kiểu dữ liệu)

Required

(Bắt buộc)

Validation

(Quy định)

Description

(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ộ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 tiêu đề bảng: Danh mục các lỗi gặp phải
3Dòng lỗiVă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 cột số thứ tự dòng/hàng bị lỗi trong file Excel gốc.
- Tiêu đề cột: Dòng lỗi
4Tên lỗiVă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 cột nội dung/mô tả chi tiết lỗi gặp phải tại dòng tương ứng ở mục 2.1.
- Tiêu đề cột: Tên lỗi
5Nú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:


6


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