Versions Compared

Key

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

...

STT

Field

(Trường dữ liệu)

Type

(Kiểu dữ liệu)

Required

(Bắt buộc)

Length

(Độ dài ký tự)


Validation

(Quy định)

Description

(Mô tả)


1 

Tài liệu mẫuNhãn (Label)Không bắt buộc


Tài liệu mẫu để tải xuống

2

Tải xuốngNút chức năng (Button)Không bắt buộc

- Quy tắc đặt tên: Template-LoaiHopDong-yyyymmdd

  • VD: Template-LoaiHopDong-20251205
Cho phép người dùng tải xuống file tài liệu mẫu theo định dạng excel

3 

Tài liệu đính kèmNút chức năng (Button)Không bắt buộc

- Chỉ cho phép tải lên 1 file/lần

- Chỉ cho phép tải file với định dạng tệp Excel

  • VD: .xlsx , .xls , ...

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

- Cho phép người dùng đính kèm tài liệu lên hệ thống

- Cho phép người dùng xem lại tài liệu đính kèm

- Cho phép người dùng tải về tài liệu đính kèm

- Cho phép người dùng xóa tài liệu đính kèm

4

Áp dụng

Nút chức năng (Button)

Không bắt buộc


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

- Sau khi nhấn nút, hệ thống thực hiện kiểm tra điều kiện của các trường và sẽ trả kết quả theo 3 trường hợp:

  • TH1: File đúng định dạng với template và dữ liệu hợp lệ
    • 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 “LoaiHopDong” phải đứng trước, sheet “Hướng dẫn nhập liệu” đứng sau

→ Hệ thống lưu thông tin thêm mới với giá trị trường Trạng thái của loại hợp đồng mặc định: "Hoạt động", đóng pop-up và hiển thị toast thành công màu xanh lá: "Thành công - Nhập dữ liệu thành công"

  • TH2: File đúng định dạng với template và dữ liệu không hợp lệ bao gồm:
    • Thiếu dữ liệu bắt buộc.

    • Dữ liệu vượt quá giới hạn độ dài/giá trị.
    • Mã loại hợp đồng đã tồn tại trong hệ thống.

    • Trùng lặp mã loại hợp đồng ngay trong chính tệp được tải lên

→ Hệ thống không lưu thông tin thêm mới, hiển thị pop-up "Lỗi nhập file excel"

  • TH3: File sai định dạng với template bao gồm:
    • Dòng tên trường dữ liệu của bảng bị chỉnh sửa (không ở dòng 4)
    • Tên trường dữ liệu bị chỉnh sửa

→ Hệ thống không lưu thông tin thêm mới, hiển thị toast lỗi màu đỏ: "Không thành công - Định dạng file không hợp lệ"

Cho phép người dùng thêm mới nhiều loại hợp đồng trong tài liệu

5

Nút “Hủy”/Nút Đóng “X” 

Nút chức năng (Button)

Không bắt buộc


Sau khi nhấn nút, hệ thống đóng pop-up và quay về giao diện trước đó

Cho phép người dùng hủy thao tác nhập file excel và đóng pop-up

...

STT

Field

(Trường dữ liệu)

Type

(Kiểu dữ liệu)

Required

(Bắt buộc)

Validation

(Quy định)


Description

(Mô tả)

1

Không thành công

File excel bạn nhập chưa chính xác

Nhãn (Label)

Nội dung thông báo lỗi nhập file excel
2Danh mục các lỗi gặp phảiNhãn (Label)

Tiêu đề danh sách các lỗi
3Dòng lỗiVăn bản (Text)Không bắt buộcĐối với trường hợp dữ liệu trong file lỗi

Trả về số thứ tự của dòng lỗi

4Ghi chú lỗiVăn bản (Text)Không bắt buộc

Hiển thị danh sách lỗi khi gán dữ liệu Excel:

  • Lỗi nhập thiếu trường bắt buộc: "<Tên trường> - Thiếu thông tin <tên trường>"
  • Lỗi nhập thừa ký tự tại trường: "<Tên trường> - Vượt quá <độ dài ký tự của trường> ký tự"
  • Lỗi trùng mã duy nhất: "<Tên trường> - <Tên trường> đã tồn tại"
  • Lỗi khi mã của bản ghi bị trùng với bản ghi khác trong tệp được tải lên: "<Tên trường> - Mã bị trùng với mã tại dòng (X)" (trong đó, X là dòng đầu tiên xuất hiện mã trùng trong bảng thêm mới)
    • Ví dụ:

Bảng thêm mới

DòngMã loại hợp đồng*Tên loại hợp đồng*
1HDNTHợp đồng nguyên tắc
2

HDTC

Hợp đồng tài chính 1
3HDTCHợp đồng tài chính 2
4HDTCHợp đồng tài chính 3

Bảng thông báo lỗi

Dòng lỗiGhi chú lỗi
3Mã đơn vị tiền tệ - Mã bị trùng với mã tại dòng 2
4Mã đơn vị tiền tệ - Mã bị trùng với mã tại dòng 2
Hiển thị ghi chú lỗi của dòng lỗi
5Tải xuốngNút chức năng (Button)Không bắt buộc

- Quy tắc đặt tên: LoaiHopDong_Error-yyyymmdd

  • VD: LoaiHopDong_Error-20251205

- Sau khi nhấn nút, hệ thống thực hiện tải xuống tài liệu và hiển thị toast thành công màu xanh lá sau khi tải xong: "Thành công - Xuất dữ liệu thành công"

Cho phép người dùng tải xuống file danh sách các lỗi theo định dạng excel
6Nhập lạiNút chức năng (Button)Không bắt buộcSau khi nhấn nút, hệ thống đóng pop-up và quay về màn hình pop-up "Nhập file Excel"Cho phép người dùng nhập lại file excel
7Nút “Hủy”/Nút Đóng “X” Nút chức năng (Button)Không bắt buộc

Sau khi nhấn nút, hệ thống đóng pop-up và quay về giao diện Màn hình Danh sách Danh mục loại hợp đồng

Cho phép người dùng đóng pop-up

...

STT

Field

(Trường dữ liệu)

Description

(Mô tả)


1 

Thời gian xuấtThể hiện thời gian xuất dữ liệu theo định dạng: dd/mm/yyyy hh:mm:ss

2

Người xuấtThể hiện thông tin tên của người thực hiện xuất dữ liệu

3 

Dòng lỗiTrả về số thứ tự của dòng lỗi

4

Ghi chú lỗi

Hiển thị danh sách lỗi khi gán dữ liệu Excel:

  • Lỗi nhập thiếu trường bắt buộc: "<Tên trường> - Thiếu thông tin <tên trường>"
  • Lỗi nhập thừa ký tự tại trường: "<Tên trường> - Vượt quá <độ dài ký tự của trường> ký tự"
  • Lỗi trùng mã duy nhất: "<Tên trường> - <Tên trường> đã tồn tại"
  • Lỗi khi mã của bản ghi bị trùng với bản ghi khác trong tệp được tải lên: "<Tên trường> - Mã bị trùng với mã tại dòng (X)" (trong đó, X là dòng đầu tiên xuất hiện mã trùng trong bảng thêm mới)
    • Ví dụ:

Bảng thêm mới

DòngMã loại hợp đồng*Tên loại hợp đồng*
1HDNTHợp đồng nguyên tắc
2

HDTC

Hợp đồng tài chính 1
3HDTCHợp đồng tài chính 2
4HDTCHợp đồng tài chính 3

Bảng thông báo lỗi

Dòng lỗiGhi chú lỗi
3Mã đơn vị tiền tệ - Mã bị trùng với mã tại dòng 2
4Mã đơn vị tiền tệ - Mã bị trùng với mã tại dòng 2

4.1.10 Màn hình pop-up "Xác nhận hủy"

...