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 các tài liệu như PDF và bảng tính Excel, nơi dữ liệu không được cấu trúc tốt. Việc trích xuất dữ liệu yêu cầu theo cách 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 thu thập yêu cầu trong Requirements Portal, bạn có thể tận dụng các khả năng AI để nhập yêu cầu từ các tệp PDF, Excel, Word và CSV phi cấu trúc.

Chức năng Trình nhập có hỗ trợ AI 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 Trình nhập có hỗ trợ AI:

  • Mã định danh

  • Văn bản

  • Phương thức

  • Khối áp dụng

  • Tiêu đề

  • Cơ sở lý do

  • Cha

  • Con

  • Loại

  • Trạng thái

  • Mức độ tuân thủ

  • Nhận xét tuân thủ

  • Người phụ trách

  • Thẻ

  • Đường dẫn tới Mục

Truy cập Trình nhập

Trình nhập có hỗ trợ AI có thể được quản trị viên bật hoặc tắt 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 trong 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 Trình nhập cũ bên dưới.

Khi được bật, có thể truy cập Trình nhập có hỗ trợ AI 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ả hiện đang xem 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.

Quy trình nhập

Sau khi truy cập trình nhập, cửa sổ Document Import sẽ hiển thị. Để tiếp tục với Trình nhập có hỗ trợ AI, hãy nhấp vào nút .

Trong cửa sổ này, nếu muốn, bạn có thể chọn להשתמש 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 việc này, hãy 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ể dùng để ghi nhận yêu cầu theo cách có cấu trúc. Bạn cũng có thể sử 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 . Ngoài ra, hãy 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. Khi quá trình hoàn tất, dữ liệu được trích xuất sẽ được hiển thị 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 hộp kiểm ở bên trái những hàng tương ứng.

Theo mặc định, các yêu cầu được trích xuất sẽ được nhập vào đặc tả đang được xem khi Trình nhập được truy cập. 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ổ Trình nhập 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. 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 các 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.

Trình nhập cũ

Khi truy cập Trình nhập (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 hướng dẫn bạn qua ba giai đoạn chính: Specification, UploadReview. Khi hoàn tất việc nhập một đặc tả, phầ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 cả mục 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 tới) mà không cần thoát khỏi trình hướng dẫn nhập.

Nhấp vào vùng mong muốn để sử dụng phương thức bạn 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 Mục, thì mục đó sẽ xuất hiện dưới dạng lựa chọn được chọn sẵn 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 định nghĩa tên của Đặc tả mới, phải tuân thủ các quy tắc đặt tên – chỉ cho phép các ký tự chữ và số cùng 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 việc này, hãy 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. Khi tệp được tải lên thành công, một thông báo sẽ 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ợ các 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ẽ thông báo cho bạn về đ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 tới 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 mục).

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 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ó Mã đị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 mã đị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ó Mã định danh đã tồn tại trong dự án hiện tại nhưng không có trong đặc tả được chọn làm đích, Requirements Portal sẽ thêm một biểu tượng cảnh báo vào các mã định danh để cảnh báo về mã đị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 được nhập vẫn được hỗ trợ, tức là nếu một giá trị trong tệp để trống thì 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 dạng A, B, C, v.v.).

    Requirements Portal coi hàng tiêu đề là hàng đầu tiên của mọi tệp được tải lên.

  • Sheet – trong trường hợp tệp có nhiều trang tính, bạn có thể chọn trang tính muốn nhập dữ liệu từ đó.

  • Starting row – bạn có thể chọn dữ liệu nên 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 bản xem trước của tệp đã tải lên và ánh xạ các cột của tệp tới các trường trong Requirements Portal. Điều này cho phép bạn xác định cách dữ liệu từ tệp sẽ tương ứng với các trường cụ thể trong Requirements Portal bằng cách chọn trường thích 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ý giải

    • Phần cha

    • Phần con

    • Đường dẫn đến Mục

    • 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

    • Chủ sở hữu

    • Thẻ

    • Cột tùy chỉnh

  • Các mục Children, V&V Methods, Applicability, Applicable Blocks và Tags có thể được nhập với nhiều hơn một giá trị cho mỗi yêu cầu. Để làm điều đó, 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, mục đó sẽ tự động được tạo trong quá trình nhập và được thêm vào yêu cầu.

  • Đối với Applicability, các loại khối kết hợp có thể được tham chiếu bằng một /, ví dụ: block_A/block_B.

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

  • Ít nhất phải chọn cột Identifier. 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:

    • Type

    • State

    • Compliance

    • Tags

    Ví dụ: nếu thẻ TBD đã tồn tại trong Requirements Portal và thẻ tbd đang được nhập, 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 trình bày 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 phần cha hoặc phần con không tồn tại trong dự án

  • Không thể thiết lập quan hệ → Mã định danh của phần cha hoặc phần 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 á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), đưa bạn quay lại giai đoạn 1 (Specification).

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ố có thể định lượng nhằm 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-LocalizedAI-localized
If you find an issue, select the text/image and pressCtrl + Enterto send us your feedback.
Feature Availability

The features available to you depend on which Altium solution you have – Altium Develop, an edition of Altium Agile (Agile Teams or Agile Enterprise), or Altium Designer (on active term).

If you don’t see a discussed feature in your software, contact Altium Sales to find out more.

Nội dung