You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 41 Next »


Nghiệp vụ

IT

Người lập

Người duyệt

Người lập

Người duyệt

Tên, Chức danh





Ngày ký





Jira Link

https://jira.popplife.vn/browse/BPMKVH-3789

1. Card (Mô tả tính năng)

Là admin nghiệp vụ, tôi muốn quản lý được danh mục loại hợp đồng sử dụng

2. Confirmation/ Acceptance Criteria (Tiêu chí nghiệm thu)

  1. Tôi muốn xem được danh sách loại hợp đồng bao gồm các thông tin
    1. Mã loại hợp đồng (Duy nhất)
    2. Tên loại hợp đồng
    3. Trạng thái
  2. Tôi muốn tìm kiếm được loại hợp đồng theo mã - tên loại hợp đồng
  3. Tôi muốn tạo mới được thông tin loại hợp đồng:
    1. Mã loại hợp đồng
    2. Tên loại hợp đồng
    3. Trạng thái
  4. Tôi muốn sửa được thông tin loại hợp đồng
    1. Tên loại hợp đồng
    2. Trạng thái
  5. Tôi muốn xem chi tiết được thông tin loại hợp đồng
    1. Mã loại hợp đồng
    2. Tên loại hợp đồng
    3. Trạng thái
  6. Tôi muốn xóa được loại hợp đồng theo một bản ghi hoặc nhiều bản ghi
  7. Tôi muốn hệ thống cảnh báo và chặn trong trường hợp Thêm mới trùng mã loại hợp đồng 
  8. Tôi muốn hệ thống cảnh báo và chặn trong trường hợp Xóa loại hợp đồng đã được sử dụng 
  9. Tôi muốn nhập file excel/ Xuất file excel được Loại hợp đồng

3. Conversation (Mô tả chi tiết)

3.1 UIUX:

3.1.1. Màn hình danh mục Danh mục loại hợp đồng

3.1.1.1. Màn hình Danh sách trống (không có dữ liệu ban đầu):

3.1.1.2. Màn hình Danh sách (có kết quả):

3.1.1.3. Màn hình Danh sách (không có kết quả):

3.1.2. Màn hình pop-up "Thêm mới loại hợp đồng"

3.1.3. Màn hình pop-up "Chỉnh sửa loại hợp đồng"

3.1.4. Màn hình pop-up "Xem chi tiết loại hợp đồng"

3.1.5. Màn hình pop-up "Xác nhận xóa"

3.1.6. Màn hình pop-up "Cảnh báo trùng"

3.1.7. Màn hình pop-up "Xuất danh sách danh mục loại hợp đồng"

3.1.8. Màn hình pop-up "Nhập file Excel"

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

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

 

3.2 Luồng:

  • Activity Diagram:


  • Sequence Diagram:


  • Flowchart: 


3.3 API Spec: <gắn link tài liệu mô tả API vào đây>

API Spec Document

Method


URL


1. Headers

STT

Field

Source Data Type / Length 

Description

Sample Values






2. Body

STT

Path

Field

Data Type / Length

Description

Note

Sample Values















3. Response / Incoming Data Specification

STT

Field

Data Type / Length

Description

Note

Sample Values




















4. Mô tả các trường dữ liệu trên màn hình:

4.1. Màn hình danh mục "Loại hợp đồng"

4.1.1 Màn hình Danh sách Danh mục loại hợp đồng

Màn hình Danh mục "Loại hợp đồng cho phép người dùng lưu trữ dữ liệu về loại hợp đồng trên hệ thống để quản  thông tin về loại hợp đồng

STT

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

Kiểu dữ liệu

Điều kiện

Độ dài ký tự


Quy định

Mô tả


1 

STT 

Số (Number)

 Không bắt buộc



Thể hiện số thự tự tự sinh tăng dần của từng bản ghi trên màn hình danh sách danh mục loại hợp đồng

2 

Mã loại hợp đồng

Văn bản (Text)

 Không bắt buộc


Chỉ xem

Thể hiện mã của loại hợp đồng

3 

Tên loại hợp đồng

Văn bản (Text)+ Đường dẫn (Hyperlink)

 Không bắt buộc


- Chỉ xem

- Sau khi nhấn vào tên loại hợp đồng, hệ thống mở ra Pop-up "Xem chi tiết loại hợp đồng"

Thể hiện tên của loại hợp đồng

4 

Hoạt động

Công tắc (Toggle)

 Không bắt buộc


Hệ thống cho phép người dùng chọn 1 trong 2 giá trị:

  • Hoạt động
  • Không hoạt động

Thể hiện trạng thái hoạt động của loại hợp đồng với 2 giá trị tương ứng gồm:

  • Hoạt động: Thông tin đang hoạt động và có thể sử dụng. 
  • Không hoạt động: Thông tin đang không hoạt động và không thể sử dụng

5 

Ô tìm kiếm (Search box)Văn bản (Text)

 Không bắt buộc

150

- Ô cho phép người dùng nhập từ khóa theo tiêu chí: 

  • Mã loại hợp đồng
  • Tên loại hợp đồng

- Hệ thống tự động lọc dữ liệu ngay khi người dùng nhập.

- Hành vi hệ thống khi Thể hiện kết quả:

  • Trường hợp 1 - Có kết quả:
    • Điều kiện: Có ít nhất một loại hợp đồng trong hệ thống khớp với từ khóa người dùng nhập.
    • Hành vi: Hệ thống Thể hiện danh sách các loại hợp đồng khớp với từ khóa tìm kiếm.
  • Trường hợp 2 - Không có kết quả/Danh sách trống (không có dữ liệu ban đầu):
    • Điều kiện: Không có loại hợp đồng nào khớp với từ khóa tìm kiếm hoặc danh sách loại hợp đồng ban đầu trống.
    • Hành vi: Hệ thống Thể hiện thông báo "Ở đây chưa có gì cả. Hiện tại chưa có loại hợp đồng nào. Hãy thêm mới loại hợp đồng đầu tiên nhé!"
Thể hiện ô tìm kiếm cho phép người dùng tìm loại hợp đồng

6

Nút “Thêm mới” 

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

 Không bắt buộc


Sau khi nhấn nút, hệ thống hiển thị pop-up "Thêm mới loại hợp đồng"Cho phép người dùng thêm mới loại hợp đồng

7

Nút “Sửa” 

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

 Không bắt buộc


Sau khi nhấn nút, hệ thống hiển thị pop-up "Chỉnh sửa loại hợp đồng"Cho phép người dùng chỉnh sửa loại hợp đồng

8

Nút “Xóa” 

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

 Không bắt buộc


Sau khi nhấn nút, hệ thống mở ra pop-up "Xác nhận xóa"Cho phép người dùng xóa loại hợp đồng

9

Hộp tích chọnHộp tích chọn (Check box)Không bắt buộc

- Disable hộp tích chọn đối với:

- Cho phép người dùng tích chọn một/ nhiều/ tất cả các dòng để thực hiện thao tác xóa hàng loạt.

Cho phép người dùng tích chọn loại hợp đồng

10

Nút "Xóa" hàng loạt

Nút chức năng (Button)Không bắt buộc

Chỉ hiển thị nút sau khi người dùng đã bấm vào hộp tích chọn 

Sau khi nhấn nút, hệ thống mở ra pop-up "Xác nhận xóa (hàng loạt)"

Cho phép người dùng xóa nhiều loại hợp đồng
11Nút "Xuất file Excel"Nút chức năng (Button)Không bắt buộc

Sau khi nhấn nút, hệ thống hiển thị pop-up "Xuất danh sách danh mục loại hợp đồng"

Cho phép người dùng xuất file danh sách loại hợp đồng theo định dạng excel
12

Nút "Nhập file Excel"

Nút chức năng (Button)Không bắt buộc

Sau khi nhấn nút, hệ thống hiển thị pop-up "Nhập file Excel"

Cho phép người dùng nhập file danh sách loại hợp đồng theo định dạng excel

4.1.2 Màn hình pop-up "Thêm mới loại hợp đồng"

Pop-up "Thêm mới loại hợp đồng" hiển thị khi người dùng nhấn button "Thêm mới" trên màn hình danh sách

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 

Mã loại hợp đồng

Văn bản (Text)

Bắt buộc

50

Cho phép nhập dữ liệu

Cho phép người dùng nhập mã của loại hợp đồng

2 

Tên loại hợp đồng

Văn bản (Text)

Bắt buộc150Cho phép nhập dữ liệuCho phép người dùng nhập tên của loại hợp đồng

3

Trạng thái hoạt động

Công tắc (Toggle)

Không bắt buộc


Hệ thống cho phép người dùng chọn 1 trong 2 giá trị:

  • Hoạt động (mặc định)
  • Không hoạt động

Cho phép người dùng chọn trạng thái hoạt động của loại hợp đồng với 2 giá trị tương ứng gồm:

  • Hoạt động: Thông tin đang hoạt động và có thể sử dụng. 
  • Không hoạt động: Thông tin đang không hoạt động và không thể sử dụng

4

Nút “Áp dụng” 

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

Không bắt buộc


- Nút chỉ kích hoạt khi tất cả các trường dữ liệu bắt buộc đã được nhập

- Hệ thống kiểm tra điều kiện các trường bắt buộc

- Sau khi nhấn nút, hệ thống thực hiện kiểm tra trùng lặp dữ liệu ở trường "Mã loại hợp đồng" theo 2 trường hợp:

  • TH1: Mã loại hợp đồng không bị trùng lặp → 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 - Thêm mới loại hợp đồng thành công"
  • TH2: Mã loại hợp đồng bị trùng lặp → Hệ thống không lưu thông tin thêm mới và hiển thị pop-up "Cảnh báo trùng"

Cho phép người dùng thêm mới loại hợp đồng

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 thực hiện kiểm tra dữ liệu theo 2 trường hợp:

  • TH1: Chưa có trường nào được nhập → Hệ thống đóng pop-up và quay về giao diện trước đó
  • TH2: Có ít nhất 1 trường đã được nhập → Hệ thống hiển thị pop-up "Xác nhận hủy (thêm mới)"
Cho phép người dùng hủy thao tác thêm mới loại hợp đồng và đóng pop-up

4.1.3 Màn hình pop-up "Chỉnh sửa loại hợp đồng"

Pop-up "Chỉnh sửa loại hợp đồng" hiển thị khi người dùng nhấn button "Sửa" trên màn hình danh sách

STT

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

Kiểu dữ liệu

Điều kiện

Quy định

Mô tả


1 

Mã loại hợp đồng

Văn bản (Text)

Bắt buộc


Không cho phép chỉnh sửa dữ liệu

Hiển thị mã của loại hợp đồng

2 

Tên loại hợp đồng

Văn bản (Text)

Bắt buộc150Cho phép chỉnh sửa dữ liệu

Cho phép người dùng sửa tên của loại hợp đồng

3

Trạng thái hoạt động

Công tắc (Toggle)

Không bắt buộc


- Cho phép chỉnh sửa dữ liệu

- Hệ thống cho phép người dùng chọn 1 trong 2 giá trị:

  • Hoạt động
  • Không hoạt động

Cho phép người dùng sửa trạng thái hoạt động của loại hợp đồng với 2 giá trị tương ứng gồm:

  • Hoạt động: Thông tin đang hoạt động và có thể sử dụng. 
  • Không hoạt động: Thông tin đang không hoạt động và không thể sử dụng

4

Nút “Áp dụng” 

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

Không bắt buộc


- Nút chỉ kích hoạt khi có ít nhất 1 trường dữ liệu được chỉnh sửa

- Hệ thống kiểm tra điều kiện các trường bắt buộc

- Sau khi nhấn nút, hệ thống thực hiện lưu thông tin chỉnh sửa, đóng pop-up và hiển thị toast thành công màu xanh lá: " Thành công - Cập nhât loại hợp đồng thành công"

Cho phép người dùng chỉnh sửa loại hợp đồng

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 thực hiện kiểm tra dữ liệu theo 2 trường hợp:

  • TH1: Chưa có trường nào được chỉnh sửa → Hệ thống đóng pop-up và quay về giao diện trước đó
  • TH2: Có ít nhất 1 trường đã được chỉnh sửa → Hệ thống hiển thị pop-up "Xác nhận hủy (chỉnh sửa)"
Cho phép người dùng hủy thao tác chỉnh sửa loại hợp đồng và đóng pop-up

4.1.4 Màn hình pop-up "Xem chi tiết loại hợp đồng"

Pop-up "Xem chi tiết loại hợp đồng" hiển thị khi người dùng nhấn vào tên loại hợp đồng trên màn hình danh sách

STT

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

Kiểu dữ liệu

Điều kiện

Quy định

Mô tả


1 

Mã loại hợp đồng

Văn bản (Text)

Bắt buộc

50

 Chỉ xem

Thể hiện mã của loại hợp đồng

2 

Tên loại hợp đồng

Văn bản (Text)

Bắt buộc150Chỉ xem

Thể hiện tên của loại hợp đồng

3

Trạng thái hoạt động

Công tắc (Toggle)

Không bắt buộc


Chỉ xem

Thể hiện trạng thái hoạt động của loại hợp đồng với 2 giá trị tương ứng gồm:

  • Hoạt động: Thông tin đang hoạt động và có thể sử dụng. 
  • Không hoạt động: Thông tin đang không hoạt động và không thể sử dụng

4

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 đóng pop-up

4.1.5 Màn hình pop-up "Xác nhận xóa"

Pop-up "Xác nhận xóa" hiển thị khi người dùng nhấn button "Xóa" trên màn hình danh sách

Pop-up "Xác nhận xóa (hàng loạt)" hiển thị khi người dùng nhấn button "Xóa hàng loạt" trên màn hình danh sách

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ả)


Pop-up Xác nhận xóa 

1 

Bạn có chắc chắn muốn xóa loại hợp đồng này?

Nhãn (Label)




Nội dung cảnh báo xác nhận xóa

2 

Tôi chắc chắn

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

Không bắt buộc

Sau khi nhấn nút, hệ thống kiểm tra bản ghi về loại hợp đồng theo 2 trường hợp:

⭢ Hệ thống không cho phép xóa và hiển thị toast cảnh báo: "Cảnh báo - Loại hợp đồng đang được sử dụng nên không thể xóa"

⭢ Hệ thống xóa dữ liệu về tất cả loại hợp đồng được chọn, đóng pop-up và hiển thị toast thành công màu xanh lá: "Thành công - Xóa loại hợp đồng thành công"

Cho phép người dùng xóa loại hợp đồng đã chọn

3

Hủy

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 xóa loại hợp đồng đã chọn và đóng pop-up

Pop-up Xác nhận xóa (hàng loạt)

1 

Bạn có chắc chắn muốn xóa X loại hợp đồng này?

Nhãn (Label)



Trong đó X là số lượng bản ghi được lựa chọn để xóa

Nội dung cảnh báo xác nhận xóa tất cả loại hợp đồng đã chọn

2 

Tôi chắc chắn

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

Không bắt buộc

Sau khi nhấn nút, hệ thống sẽ trả kết quả theo 2 trường hợp:

Hệ thống không cho phép xóa, đóng pop-up và quay về Màn hình Danh sách Danh mục loại hợp đồng và hiển thị toast cảnh báo: "Cảnh báo - Có (X) loại hợp đồng đang được sử dụng nên không thể xóa". Tại Màn hình Danh sách Danh mục loại hợp đồng, hệ thống thực hiện:

  • Làm mới trang (không xóa bất cứ giá trị nào)
  • Chỉ giữ lại lựa chọn các bản ghi có thể xóa
  • Disable hộp tích chọn các bản ghi đã sử dụng

⭢ Hệ thống xóa dữ liệu về tất cả loại hợp đồng được chọn, đóng pop-up và hiển thị toast thành công màu xanh lá: "Thành công - Xóa X loại hợp đồng thành công"

Cho phép người dùng xóa tất cả loại hợp đồng đã chọn

3

Hủy

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 xóa tất cả loại hợp đồng đã chọn và đóng pop-up

4.1.6 Màn hình pop-up "Cảnh báo trùng"

Pop-up "Cảnh báo trùng" hiển thị khi người dùng nhấn button "Áp dụng" trên màn hình pop-up Thêm mới loại hợp đồng

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 

Mã đã được sử dụng. Vui lòng nhập mã khác!

Nhãn (Label)




Nội dung cảnh báo trùng

2

ThoátNú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ề pop-up "Thêm mới loại hợp đồng"

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

4.1.7 Màn hình pop-up "Xuất danh sách danh mục loại hợp đồng"

Pop-up "Xuất danh sách danh mục loại hợp đồng" hiển thị khi người dùng nhấn button "Xuất file Excel" trên màn hình danh sách

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 

Chọn kiểu xuất fileNút chọn (Radio)Không bắt buộc

Hệ thống cho phép người dùng chọn 1 trong 3 giá trị:

  • Tất cả loại hợp đồng (mặc định)
  • Trên trang này
  • Tất cả loại hợp đồng phù hợp với kết quả tìm kiếm hiện tại
Cho phép người dùng chọn kiểu xuất file sẽ tải xuống

2

Xuất fileNút chức năng (Button)Không bắt buộc

- Quy tắc đặt tên: LoaiHopDong_yyyymmdd

  • VD: LoaiHopDong_20251215

- Sau khi nhấn nút, hệ thống thực hiện tải xuống tài liệu, đóng pop-up 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 loại hợp đồng theo định dạng excel và kiểu xuất file đã chọn

3 

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 xuất danh sách loại hợp đồng và đóng pop-up

Thông tin file excel tải xuống: LoaiHopDong.xlsx

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

2

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

3 

STTThể hiện số thự tự tự sinh tăng dần 

4

Mã loại hợp đồng *

Thể hiện thông tin mã của loại hợp đồng

5

Tên loại hợp đồng *

Thể hiện thông tin tên của loại hợp đồng

6

Trạng thái hoạt động

Thể hiện trạng thái hoạt động của loại hợp đồng:

  • Hoạt động
  • Không hoạt động

4.1.8 Màn hình pop-up "Nhập file Excel"

Pop-up "Nhập file Excel" hiển thị khi người dùng nhấn button "Nhập file Excel" trên màn hình pop-up danh sách

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
    • Sheet "LoaiHopDong" bị thay đổi vị trí (không phải là sheet đầu tiên)

→ 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 - File excel 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

Thông tin file excel tài liệu mẫu: Template-LoaiHopDong.xlsx

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 

Mã loại hợp đồng *

Văn bản (Text)

Không bắt buộc

50

Cho phép người dùng nhập mã của loại hợp đồng

2

Tên loại hợp đồng *

Văn bản (Text)

Không bắt buộc150

Cho phép người dùng nhập tên của loại hợp đồng

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

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

Thông tin file excel danh sách lỗi tải xuống: LoaiHopDong_Error.xlsx

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"

Pop-up "Xác nhận hủy (thêm mới)" hiển thị khi người dùng nhấn nút “Hủy”/nút Đóng “X”  trên màn hình pop-up "Thêm mới loại hợp đồng"

Pop-up "Xác nhận hủy (chỉnh sửa)" hiển thị khi người dùng nhấn nút “Hủy”/nút Đóng “X”  trên màn hình pop-up "Chỉnh sửa loại hợp đồng"

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ả)


Pop-up Xác nhận hủy (thêm mới)

1 

Bạn có chắc chắn muốn hủy thêm mới?

Nhãn (Label)




Nội dung cảnh báo xác nhận hủy thao tác thêm mới

2 

Tôi chắc chắn

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

Không bắt buộc
Sau khi nhấn nút, hệ thống hủy thao tác thêm mới đơn vị tại pop-up "Thêm mới loại hợp đồng", đóng pop-up hiện tại và pop-up "Thêm mới loại hợp đồng", 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 hủy thao tác thêm mới loại hợp đồng và đóng pop-up

3

Hủy

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 "Thêm mới loại hợp đồng" trước đó

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

Pop-up Xác nhận hủy (chỉnh sửa)

1 

Bạn có chắc chắn muốn hủy chỉnh sửa?

Nhãn (Label)




Nội dung cảnh báo xác nhận hủy thao tác chỉnh sửa

2 

Tôi chắc chắn

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

Không bắt buộc
Sau khi nhấn nút, hệ thống hủy thao tác chỉnh sửa đơn vị tại pop-up "Chỉnh sửa loại hợp đồng", đóng pop-up hiện tại và pop-up "Chỉnh sửa loại hợp đồng", 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 hủy thao tác chỉnh sửa loại hợp đồng và đóng pop-up

3

Hủy

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 "Chỉnh sửa loại hợp đồng" trước đó

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

4.1.11. Cập nhật trường "Loại hợp đồng" tại 2442 - User Story - Nhân viên kế hoạch - tổng hợp soạn thảo hợp đồng

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

Loại hợp đồng

Lựa chọn (Droplist)

Bắt buộc


- Cho phép chỉnh sửa dữ liệu

- Hệ thống chỉ lấy các loại hợp đồng có trạng thái hoạt động = "Hoạt động"

- Cho phép người dùng chọn loại hợp đồng sử dụng cho hợp đồng.

- Danh sách dữ liệu được lấy từ trường "Mã loại hợp đồng"-"Tên loại hợp đồng" trong  Danh mục loại hợp đồng thuộc Phân hệ Quản lý danh mục





  • No labels