Nhập yêu cầu

Bạn có thể nhanh chóng và dễ dàng tải dữ liệu yêu cầu hiện có của mình lên Requirements Portal bằng Import Wizard có sẵn trong Requirements Module.

Trình nhập yêu cầu có hỗ trợ AI

Kỹ thuật yêu cầu thường bắt đầu bằng việc soạn thảo các yêu cầu của các bên liên quan trong những tài liệu như PDF và bảng tính Excel, nơi dữ liệu không được cấu trúc rõ ràng. Việc trích xuất dữ liệu yêu cầu thủ công từ các tài liệu phi cấu trúc này có thể tốn nhiều công sức và dễ xảy ra lỗi; để đẩy nhanh quá trình ghi nhận yêu cầu trong Requirements Portal, bạn có thể tận dụng khả năng AI để nhập các yêu cầu từ các tệp PDF, Excel, Word và CSV phi cấu trúc.

Chức năng AI-assisted Importer hiện đang ở giai đoạn Beta.

Các trường sau đây có thể được nhập vào yêu cầu bằng AI-assisted Importer:

  • Định danh

  • Văn bản

  • Phương thức

  • Các khối áp dụng

  • Tiêu đề

  • Cơ sở lý do

  • Phần cha

  • Phần con

  • Loại

  • Trạng thái

  • Tuân thủ

  • Ghi chú tuân thủ

  • Người phụ trách

  • Thẻ

  • Đường dẫn đến Phần

Truy cập Importer

AI Assisted Importer được bật mặc định. Nếu cần, quản trị viên Workspace có thể tắt chức năng này bằng tùy chọn External Provider trên trang Settings – ValiAssistant (truy cập bằng cách nhấp vào biểu tượng  ở góc trên bên phải, chọn Settings từ menu xuất hiện, rồi chọn ValiAssistant từ danh sách ở khung bên trái) – .

Khi tùy chọn External Provider bị tắt, chỉ có thể truy cập và sử dụng trình nhập cũ. Để tìm hiểu thêm về trình nhập cũ, hãy tham khảo phần Legacy Importer bên dưới.

Có thể truy cập AI Assisted Importer từ Requirements Module () bằng cách nhấp vào nút  ở góc trên bên trái của trang và chọn Create Requirement từ menu xuất hiện. Ngoài ra, khi đặc tả đang xem hiện không có yêu cầu nào, có thể truy cập trình nhập bằng cách nhấp vào nút Import trên trang.

Luồng nhập

Sau khi truy cập trình nhập, cửa sổ Document Import sẽ được hiển thị. Để tiếp tục với AI Assisted Importer, nhấp vào nút .

Trong cửa sổ này, nếu muốn, bạn có thể chọn sử dụng trình nhập cũ bằng cách nhấp vào liên kết open the legacy importer here. Cách sử dụng trình nhập cũ được mô tả bên dưới trên trang này.

Ở bước tiếp theo, bạn có thể tải lên một tệp thuộc loại được hỗ trợ (*.pdf, *.docx, *.xlsx, hoặc .*csv). Để thực hiện, kéo và thả tệp vào vùng tương ứng của cửa sổ hoặc nhấp vào điều khiển select from your computer để duyệt và chọn tệp từ ổ cứng.

Kích thước tệp tải lên tối đa là 100 MB.

Mặc dù tệp được tải lên có thể là phi cấu trúc, bạn có thể dùng liên kết Excel template để tải xuống một tệp *.xlsx có thể được dùng để ghi nhận các yêu cầu theo cách có cấu trúc. Bạn cũng có thể dùng liên kết này để tải xuống tệp.

Sau khi tệp được tải lên thành công, mục nhập của tệp sẽ được hiển thị trong cửa sổ. Bạn có thể xóa tệp khỏi cửa sổ bằng cách nhấp vào biểu tượng . Hoặc kéo và thả một tệp khác vào cửa sổ để thay thế tệp hiện có.

Nhấp vào nút  để tiếp tục. Trình nhập sẽ xử lý tệp đã tải lên. Sau khi quá trình hoàn tất, dữ liệu đã trích xuất sẽ được trình bày dưới dạng bảng các yêu cầu được đề xuất. Bạn có thể chọn các yêu cầu muốn nhập bằng cách bật các ô chọn ở bên trái các hàng tương ứng.

Theo mặc định, các yêu cầu đã trích xuất sẽ được nhập vào đặc tả đang được xem tại thời điểm truy cập Importer. Bạn có thể chọn đặc tả cần dùng bằng cách chọn từ danh sách thả xuống ở đầu cửa sổ Importer hoặc tạo một đặc tả mới bằng cách chọn mục As new (creates new specification) từ danh sách thả xuống và xác định tên của đặc tả mới bằng trường Specification name xuất hiện trong cửa sổ.

Nhấp vào nút  để tiếp tục. Sau khi quá trình nhập hoàn tất, một cửa sổ xác nhận sẽ xuất hiện.

Nếu trình nhập phát hiện vấn đề trong các yêu cầu đã nhập, điều này sẽ được chỉ ra trong cửa sổ (). Nhấp vào liên kết để tải xuống báo cáo nêu chi tiết nguyên nhân của các vấn đề được phát hiện. 

Nhấp vào nút  để quay lại bước tải tệp lên của trình nhập hoặc nhấp vào  để thoát trình nhập.

Legacy Importer

Khi truy cập Importer (tìm hiểu thêm), bạn có thể chọn tiếp tục với công cụ nhập cũ để tải lên dữ liệu yêu cầu có cấu trúc. Ngoài ra, trình nhập cũ chỉ khả dụng khi tùy chọn External Provider bị quản trị viên tắt trong phần cài đặt Requirements Portal.

Quy trình này sẽ hướng dẫn bạn qua ba giai đoạn chính: Specification, Upload, và Review. Sau khi hoàn tất việc nhập một đặc tả, một bản tóm tắt sẽ được hiển thị cùng với khả năng thực hiện các hành động bổ sung như Valifying hoặc nhập các tệp khác. Các giai đoạn và hành động này được mô tả trong các phần bên dưới.

Đặc tả

Ở giai đoạn này của Import Wizard, bạn có thể xác định đặc tả đích để nhập:

  • Sử dụng vùng Select a specification ở phía bên trái của cửa sổ Import Requirements để chọn một đặc tả hiện có và tùy chọn phần của đặc tả đó.

  • Sử dụng vùng Create a specification ở phía bên phải của cửa sổ Import Requirements để tạo một đặc tả mới (đồng thời xác định chữ viết tắt và khối sẽ được gán) mà không cần thoát khỏi trình hướng dẫn nhập.

Nhấp vào vùng cần thiết để sử dụng phương thức mong muốn.

 
  • Nếu Import Wizard được khởi chạy trong ngữ cảnh của một Đặc tả hoặc một Phần, mục đó sẽ xuất hiện dưới dạng lựa chọn được đặt trước cho đích nhập.

  • Trong trường hợp không có đặc tả hiện có, bắt buộc phải tạo một đặc tả.

  • Trong phần xác định tên của Đặc tả mới, phải đáp ứng các quy tắc đặt tên – chỉ được phép dùng các ký tự chữ-số và ký tự đặc biệt _ (gạch dưới).

Tải lên

Ở giai đoạn này của Import Wizard, bạn có thể tải lên một tệp thuộc loại được hỗ trợ. Để thực hiện, kéo và thả tệp vào phía bên phải của cửa sổ Import Requirements hoặc nhấp vào điều khiển Drop file để duyệt và chọn tệp từ ổ cứng. Sau khi tệp được tải lên thành công, một thông báo sẽ được hiển thị trong cửa sổ.

 
  • Chỉ hỗ trợ các tệp Excel (.xls, .xlsx) và Comma Separated Values (.csv). Không hỗ trợ tệp Excel Macro (.xlsm).

  • Trong trường hợp tải lên một tệp không được hỗ trợ, một thông báo lỗi sẽ cho bạn biết điều này.

  • Khi một tệp đã được tải lên, bạn có thể tiếp tục quá trình nhập hoặc tải lên một tệp mới (thay thế tệp trước đó).

Xem lại

Ở giai đoạn này của Import Wizard, bạn có thể xem lại kết quả nhập dữ liệu từ tệp đã tải lên, cấu hình các tùy chọn của tệp và ánh xạ dữ liệu từ tệp vào các trường yêu cầu.

Vùng Destination của cửa sổ Import Requirements cung cấp chỉ báo trực quan về nơi dữ liệu sẽ được nhập vào (xét theo đặc tả hoặc phần).

Vùng File options cung cấp các tùy chọn sau:

  • Update requirements – khi được bật, mọi yêu cầu hiện có trong đặc tả đích sẽ bị ghi đè bằng cách thay thế dữ liệu (dữ liệu trong tệp sẽ thay thế dữ liệu trong đặc tả).

    • Nếu tùy chọn này bị tắt và bạn đang nhập các yêu cầu có Định danh đã tồn tại trong đặc tả được chọn làm đích, Requirements Portal sẽ thêm hậu tố _import vào các định danh của các yêu cầu được nhập để phân biệt chúng.

    • Nếu tùy chọn này bị tắt và bạn đang nhập các yêu cầu có Định danh đã tồn tại trong dự án hiện tại nhưng không tồn tại trong đặc tả được chọn làm đích, Requirements Portal sẽ thêm biểu tượng cảnh báo vào các định danh để cảnh báo về định danh trùng lặp trong cùng một dự án.

    • Nếu tùy chọn này được bật, các giá trị trống trong tệp đang nhập vẫn được hỗ trợ; tức là nếu một giá trị trong tệp để trống, giá trị đó sẽ bị xóa khỏi yêu cầu. Điều này cũng áp dụng cho các trường chọn nhiều giá trị, chẳng hạn như Tags.

  • Use header row – bạn có thể quyết định sử dụng hàng tiêu đề của tệp đã tải lên hoặc sử dụng hàng tiêu đề tham chiếu chung do Requirements Portal cung cấp (tức là tiêu đề cột như A, B, C, v.v.).

    Requirements Portal xem hàng Header là hàng đầu tiên của bất kỳ tệp nào được tải lên.

  • Sheet – trong trường hợp có tệp gồm nhiều sheet, bạn có thể chọn sheet muốn nhập.

  • Starting row – bạn có thể chọn dữ liệu sẽ bắt đầu được thu thập từ hàng nào của tệp đã nhập để chèn vào Requirements Portal.

Trong bảng ở cuối cửa sổ Import Requirements, bạn có thể xem trước tệp đã tải lên và ánh xạ các cột của tệp với các trường trong Requirements Portal. Điều này cho phép bạn xác định dữ liệu từ tệp sẽ tương ứng với các trường cụ thể trong Requirements Portal như thế nào bằng cách chọn trường phù hợp trong danh sách thả xuống Map To cho từng cột. Nếu tệp chứa các tiêu đề trùng với các trường mặc định trong Requirements Portal, các trường này sẽ được ánh xạ tự động. Tuy nhiên, bạn có thể ghi đè hoặc điều chỉnh ánh xạ tự động này nếu cần.

  • Các trường sau đây có thể được chọn để ánh xạ:

    • Mã định danh

    • Văn bản

    • Tiêu đề

    • Cơ sở lý do

    • Mục cha

    • Mục con

    • Đường dẫn đến Phần

    • Loại

    • Trạng thái

    • Thẻ

    • Tuân thủ

    • Ghi chú tuân thủ

    • Các phương pháp V&V

    • Khả năng áp dụng

    • Các khối áp dụng

    • Người phụ trách

    • Thẻ

    • Các cột tùy chỉnh

  • Các mục con, phương pháp V&V, khả năng áp dụng, các khối áp dụng và thẻ có thể được nhập với nhiều hơn một giá trị cho mỗi yêu cầu. Để thực hiện việc này, mỗi giá trị phải được phân tách bằng dấu phẩy.

  • Nếu một phương pháp xác minh, khối áp dụng, loại yêu cầu, trạng thái, tuân thủ hoặc thẻ đang được nhập hiện chưa tồn tại trong Requirements Portal, nó sẽ được tự động tạo trong quá trình nhập và thêm vào yêu cầu.

  • Đối với Khả năng áp dụng, các loại khối ghép có thể được tham chiếu bằng /, ví dụ: block_A/block_B.

  • Đối với các cột tùy chỉnh, có các loại sau: Select, Multiselect, Text, Date, Number.

  • Ít nhất phải chọn cột Mã định danh. Nếu không, một thông báo cảnh báo sẽ được hiển thị cho đến khi điều kiện đó được đáp ứng ().

  • Các trường sau đây phân biệt chữ hoa chữ thường:

    • Loại

    • Trạng thái

    • Tuân thủ

    • Thẻ

    Ví dụ: nếu thẻ TBD đã tồn tại trong Requirements Portal và thẻ tbd đang được nhập, thì một thẻ mới tbd sẽ được tạo và nhập cùng với yêu cầu.

Báo cáo thực thi

Sau khi quá trình nhập hoàn tất và nếu việc nhập thành công, một thông báo thành công cùng các thay đổi đã thực hiện sẽ được hiển thị. Nếu việc nhập thất bại, một thông báo thất bại sẽ được hiển thị. Ví dụ về một lần nhập thành công được hiển thị bên dưới.

Nếu có bất kỳ lỗi mềm nào, chúng cũng sẽ được hiển thị (). Các lỗi mềm có thể xảy ra là:

  • Không thể thiết lập quan hệ → Mã định danh của mục cha hoặc mục con không tồn tại trong dự án

  • Không thể thiết lập quan hệ → Mã định danh của mục cha hoặc mục con bị trùng lặp trong dự án

  • Tuyên bố tuân thủ của yêu cầu không tồn tại trong dự án

  • Loại yêu cầu không tồn tại trong dự án

  • Trạng thái yêu cầu không tồn tại trong dự án

  • Thẻ không tồn tại trong dự án

  • Điều kiện khả năng áp dụng không tồn tại

Bất kể trình nhập có thành công hay không, bạn có thể nhập lại hoặc thực hiện một lần nhập mới bằng cách nhấp vào Import new file (thành công) hoặc Try again (thất bại), để quay lại giai đoạn 1 (Specification).

Sau khi nhập thành công, bạn cũng có thể bắt đầu quy trình Valify bằng cách nhấp vào điều khiển Check now ở phía trên cửa sổ. Quy trình này sẽ quét văn bản yêu cầu đã nhập để tìm các tham số định lượng có thể được chuyển đổi thành Vali bên trong yêu cầu.

Để biết thêm thông tin, hãy tham khảo trang Valify Requirements.

AI-LocalizedBản địa hóa bằng AI
Nếu bạn phát hiện vấn đề, hãy chọn văn bản/hình ảnh và nhấnCtrl + Enterđể gửi phản hồi cho chúng tôi.
Tính khả dụng của tính năng

Các tính năng bạn có thể sử dụng phụ thuộc vào giải pháp Altium mà bạn đang có – Altium Develop, Altium Agile Teams, Altium Agile Enterprise, hoặc Altium Designer (đang trong thời hạn hiệu lực).

Nếu bạn không thấy một tính năng được nêu trong tài liệu có trong phần mềm thực tế của mình, liên hệ Bộ phận Kinh doanh của Altium để tìm hiểu thêm.

Nội dung