Versions Compared

Key

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


Nghiệp vụ

IT

Người lập

Người duyệt

Người lập

Người duyệt

Họ & Tên

Bùi Nguyệt Anh

Nguyễn Đức Trung



Tài khoản email/MS Team

anhbn4

trungnd3



Chức danh

Business Analyst (BA)

Product Owner (P.O)



Ngày soạn thảo/phê duyệt

 




Jira Ticket

[BPMKVH-1588] Quản lý GRID tổng thể ver 2 - Jira

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

Là người dùng tôi có thể tạo quản lý grid nhập liệu trên hệ thống BPM thông qua

  1. Thiết kế biểu mẫu grid dưới dạng kéo thả và đặt tên các trường thông tin
  2. Cấu hình cách thức nhập dữ liệu cho trường hợp đặc biệt
  3. Các case đặc thù
  4. Tiện ích trong quá trình nhập liệu

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

  1. Thiết kế biểu mẫu grid dưới dạng kéo thả và đặt tên các trường thông tin
    1. Cho phép điều chỉnh kích thước các cột bằng cách kéo thả
    2. Cho phép tự động giãn dòng khi nhập dữ liệu lớn
  2. Cấu hình cách thức nhập dữ liệu cho trường hợp đặc biệt
    1. Cho phép khai báo công thức tính theo cột (trung bình, min, max) giữa các cột trong grid
    2. Cho phép cấu hình nhập dòng dưới dạng cha - con (nhiều lớp)
    3. Cho phép tính toán dữ liệu cha - con (nhiều lớp) → hiển thị trên cùng dòng cấp cha
    4. Cho phép tính tổng theo cột, theo cấp hoặc cả 2
    5. Cho phép cấu hình đặc biệt:
      • Khóa theo từng bước quy trình
      • Hiển thị/ không hiển thị ở bước quy trình
    6. Import/ export excel (cấp cha con)
    7. Thông báo lỗi khi import excel
  3. Các case đặc thù
    1. Lấy thông tin người liên hệ theo mã nhà cung cấp
    2. Tính toán khoảng thời gian theo workingtime
    3. Tính toán giá trị nhỏ nhất theo từng lần nộp thầu và đàm phán
  4. Tiện ích trong quá trình nhập liệu
    1. Cho phép người dùng chỉnh kích thước cột, dòng trong quá trình nhập liệu
    2. Cho phép điều chỉnh kích thước các cột bằng cách kéo thả

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

3.1 UIUX:

           Màn hình công thức Giá trị lớn nhất

...

Panel
titleAPI Spec Document

Method

POST

URL

<DOMAIN>/application/artifactGrid/validate

Description

API update insert Grid

Note

API mới

1. Headers

STT

Field

Source Data Type / Length 

Description

Sample Values


authorizationStringToken

Bearer eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NjYzMDk1MTgsInVzZXIiOiJ7XCJpZFwiOjIwMjAsXCJ1c2VybmFtZVwiOlwiMDM3NDc4ODQwNVwiLFwibmFtZVwiOlwiQ2h1IFRo4buLIExpw6

puXCIsXCJyb2xlc1wiOltdLFwibWFwQmVhdXR5U2Fsb25cIjp7XCJicG0ucmVib3JuLnZuXCI6Nn0sXCJlbXBsb3llZUlkXCI6NTMxLFwiYnJhbmNoSWRcIjoyM30ifQ.UGz8TQudVxEd7rp_rsLXePraHELTRWHyc7iXNvVnn14

2. BODY

STT

Field

Required

Data Type / Length

Description

Note

1

dataHeader

true
String


2

data

falseString

3. Response / Incoming Data Specification

STT

Field

Data Type / Length

Description

Note

Sample Values


code
Integer 
code response
code == 0 thì sẽ trả về kết quả hợp lệ, nếu code != 0 thì request bị lỗi


messageStringnội dung phản hồi


result
Boolean
kết quả validate

...

  • Thao tác

    • Áp dụng tại màn hình cấu hình grid khi người dùng thực hiện config các trường trong bảng nhập liệu, và tại màn hình nhập dữ liệu thực tế.

    • Người dùng đưa con trỏ chuột vào ranh giới giữa hai cột liền kề.

    • Hệ thống hiển thị biểu tượng mũi tên ↔ (resize) nhằm thông báo cho người dùng biết có thể thực hiện thao tác thay đổi độ rộng cột.

  • Khi kéo thả:

    • Người dùng nhấn giữ chuột và kéo theo phương ngang:

      • Độ rộng cột được thay đổi theo vị trí di chuyển chuột (hiển thị đường preview trong quá trình kéo).

      • Các cột còn lại không tự động co giãn để đảm bảo cấu trúc bảng ổn định.

      • Sau khi thả chuột, độ rộng cột được cập nhật ngay trên giao diện.

    • Các cột còn lại vẫn giữ nguyên, không bị co giãn tự động.

  • Điều kiện:

    • Độ rộng cột tối thiểu: ....px

    • Độ rộng tối đa: ....px

  • Lưu cấu hình:

    • Tại màn hình cài đặt cấu hình bảng: độ rộng cột được lưu trong cấu hình grid.

    • Tại màn hình màn hình nhập dữ liệu bảng: 
      • Độ rộng cột sẽ được áp dụng theo cấu hình từ màn cài đặt cấu hình bảng. Người dùng vẫn được phép điều chỉnh lại độ rộng cột bằng thao tác kéo thả tương tự.

      • Độ rộng điều chỉnh ở màn hình nhập liệu có thể chỉ lưu cho phien làm việc hiện tại.

Tự động giãn dòng (Auto Row Height)

  • Thao tác

    • Áp dụng tại màn hình nhập dữ liệu bảng.

    • Khi người dùng nhập nội dung có độ dài vượt quá kích thước mặc định của ô (ví dụ: đoạn text nhiều dòng, nội dung có ký tự xuống dòng), hệ thống sẽ tự động xử lý để hiển thị đầy đủ mà không cần người dùng thay đổi độ rộng cột.

  • Hành vi hệ thống:

    • Khi phát hiện nội dung vượt quá chiều cao ô mặc định, hệ thống tự động điều chỉnh chiều cao của dòng (row) để vừa khít toàn bộ nội dung.
    • Nội dung trong ô được hiển thị theo chế độ word wrap (tự động xuống dòng).
    • Việc tăng chiều cao của dòng chỉ ảnh hưởng đến dòng hiện tại, các dòng khác giữ nguyên chiều cao mặc định.
    • Không hiển thị thanh cuộn dọc hoặc ngang trong phạm vi ô dữ liệu.

...