Versions Compared

Key

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

...

3.4.1.2. Chi tiết import excel

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

Kiểu dữ liệu

Điều kiện

Quy định

Mô tả

Tà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.
Tả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: Thể hiện 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.
Tài liệu đính kèm
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.
Nú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 Thể hiện 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. 

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

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

Nút chỉ kích hoạt khi người dùng đã thực hiện đính kèm tài liệu

  • 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à Thể hiện 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 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: 
    • Thể hiện thông báo (toast) lỗi
      •  Tiêu đề thông báo: Không thành công
      • Nội dung thông báo: Tệp không đúng mẫu. Vui lòng tải tệp theo đúng mẫu hệ thống

Lỗi 2: 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ụ: Tên Dịch vụ/Hạng mục, dự án).

    • Sai kiểu dữ liệu (nhập Văn bản (Text) thay vì ngày/tháng).

    • STT không hợp lệ

    • Trùng STT

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

Nú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.3.Màn hình pop-up "Xuất file excel" :


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

Kiểu dữ liệu

Điều kiện

Quy định

Mô tả

1Chọn kiểu xuất file

Văn bản (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"
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"
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 Thể hiện 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 Thể hiện 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"
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: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.
  • Hành vi 3: Thể hiện 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: DanhSachHangHoa_ddmmyyyy
  • 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.4. Màn hình pop-up "Lỗi nhập file excel"


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ộ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:

  • Tên tệp: BPM1-Dữ liệu danh sách lỗi khi nhập file excel
  • Mẫu tệp dữ liệu: BPM1-Mẫu danh sách lỗi khi nhập file excel.xlsx
  • Các lỗi:
  • Lỗi trùng giá trị cột được đánh dấu STT: "Giá trị cột <Tên cột> trùng"
  • Lỗi giá trị cột được đánh dấu STT không hợp lệ: "Giá trị cột <Tên cột> không hợp lệ"
  • Lỗi nhập thiếu trường bắt buộc: "Giá trị cột <Tên cột> chưa nhập"
  • Lỗi định dạng dữ liệu: "Giá trị cột <Tên cột> không hợp lệ"

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



...