Versions Compared

Key

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

...

File đúng File đúng File sai
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ẫuLabel


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

2

Tải xuốngButton

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

  • VD: Template-DonViTienTe-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èmButton

- 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

Button



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

→ Hệ thống lưu thông tin thêm mới, đó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ã đơn vị đã tồn tại trong hệ thống.

    • Trùng lặp mã đơn vị 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

→ 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 - Lỗi nhập dữ liệu"

Cho phép người dùng thêm mới nhiều đơn vị tiền tệ trong tài liệu

5

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

Button



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

Label

Nội dung thông báo lỗi nhập file excel
2Danh mục các lỗi gặp phảiLabel

Tiêu đề danh sách các lỗi
3Dòng lỗiText
Đối với trường hợp file không theo template 

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

4Ghi chú lỗiText

Thể hiện thông tin lỗi của bản ghi
5Tải xuốngButton

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

  • VD: DonViTienTe_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ạiButton
Sau khi nhấn nút, hệ thống đóng pop-up và quay lại 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” Button

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 đơn vị tiền tệ

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

...

Thông tin danh sách lỗi khi nhập dữ liệu:

STT

Nội dung ghi chú lỗi

Validation

(Quy định)

Description

(Mô tả)

1Trường mã đơn vị đang bị bỏ trống
Label

Nội dung lỗi khi mã đơn vị bị bỏ trống
2

Trường tên đơn vị tiền tệ đang bị bỏ trống

LabelNội

Nội dung lỗi khi tên đơn vị bị bỏ trống
3Trường mã đơn vị đang vượt quá giới hạn độ dài (50 ký tự
Label
)
Nội dung lỗi khi mã đơn vị vượt quá ký tự
4Trường tên đơn vị tiền tệ đang vượt quá giới hạn độ dài (150 ký tự)
Label

Nội dung lỗi khi tên đơn vị vượt quá ký tự
5Mã đơn vị đã tồn tại trong hệ thống
Label

Nội dung lỗi khi mã đơn vị đã tồn tại trong hệ thống
6Trường trạng thái hoạt động chỉ cho phép nhập 0 hoặc 1 (với 0 = "Không hoạt động" và 1 = "Hoạt động")
Label

Nội dung lỗi khi trường trạng thái hoạt động bị bỏ trống/bị vượt quá ký tự
7Mã đơn vị bị trùng với mã đơn vị tại dòng (X)Trong đó, (X) là số thứ tự của dòng lỗi nằm trong chính tệp được tải lênNội dung lỗi khi mã đơn vị của bản ghi bị trùng với bản ghi khác trong tệp được tải lên


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

...