Nhập Yêu cầu

Bạn có thể tải dữ liệu yêu cầu hiện có của mình lên Requirements & Systems Portal một cách nhanh chóng và dễ dàng bằng Import Wizard có sẵn trong Requirements Module. Tận dụng khả năng trích xuất được hỗ trợ bởi AI, bạn có thể nhập các yêu cầu từ các tệp PDF, Word, Excel và CSV phi cấu trúc, giúp giảm thời gian và công sức cần thiết để chuyển dữ liệu yêu cầu theo cách thủ công, đồng thời giúp bạn thu thập yêu cầu chính xác và hiệu quả hơn.

Phiên bản mới hơn của Import Wizard (hiện đang ở giai đoạn Beta) được mô tả trên trang này. Nếu bạn không có quyền truy cập vào phiên bản này trong instance Requirements & Systems Portal của mình, thì một phiên bản trước đó của Importer sẽ được sử dụng (xem phần thu gọn Previous Iteration of the Importer để tìm hiểu thêm).

Truy cập Importer

Có thể truy cập 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 rồi chọn Create Requirement từ menu xuất hiện. Ngoài ra, khi đặc tả hiện đang được xem chưa có yêu cầu nào, có thể truy cập importer bằng cách nhấp vào nút Import trên trang.

Tải tệp lên

Cửa sổ Import Requirements sẽ mở ra. Ở bước này, 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.

Các tệp ở định dạng *.pdf và *.docx chỉ có thể được nhập bằng AI importer, tính năng này được bật theo mặc định. Nếu cần, quản trị viên Workspace có thể tắt tính 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 dưới bên trá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ác tệp ở định dạng *.xlsx và *.csv mới có thể được nhập bằng classic importer. Trong trường hợp này, một thông báo tương ứng sẽ được hiển thị ở đầu cửa sổ Import Requirements ().

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 tệp *.xlsx có thể được sử dụng để thu thập 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 tệp xuống.

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

  • Trong trường hợp tải lên 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 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 .

Đối với tệp *.xlsx hoặc *.csv đã tải lên, bạn có thể chọn tiếp tục sử dụng classic importer bằng cách bật tùy chọn Classic Import (Non-AI) ở góc dưới bên trái của cửa sổ.

Xem lại dữ liệu đã trích xuất

Sau khi tệp cần thiết được tải lên, hãy nhấp vào nút  để tiếp tục. 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 xem lại.

Giao diện người dùng của trang xem lại của AI importer

Giao diện người dùng của trang xem lại của classic importer

 

Theo mặc định, các yêu cầu được đề xuất sẽ được nhập vào đặc tả đã được xem khi truy cập Importer. Bạn có thể chọn đặc tả cần thiết bằng cách chọn từ danh sách thả xuống ở đầu cửa sổ hoặc tạo đặc tả mới bằng cách chọn mục + Add specification từ danh sách thả xuống và xác định tên của đặc tả mới bằng trường tên đặc tả xuất hiện ().

Khi tạo đặc tả mới, phải đáp ứng các quy tắc đặt tên. Tên đặc tả không được chứa các ký tự sau: \ / ? % * : | " < >. Ngoài ra, các khoảng trắng ở đầu và cuối sẽ bị bỏ qua.

Bật tùy chọn Update requirements để ghi đè mọi yêu cầu hiện có trong đặc tả đích 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ó Identifier đã tồn tại trong đặc tả được chọn làm đích, Requirements & Systems Portal sẽ thêm hậu tố số (_1, _2, _3, v.v.) vào identifier 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ó Identifier đã 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 & Systems Portal sẽ thêm biểu tượng cảnh báo vào các identifier để cảnh báo rằng có identifier 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 sẽ được hỗ trợ, tức là nếu một giá trị trong tệp bị để 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.

Bật tùy chọn Parametrize values để kiểm tra các yêu cầu được đề xuất nhằm tìm các tham số có thể định lượng và chuyển đổi chúng thành Vali.

Khi sử dụng classic importer, các tùy chọn sau cũng khả dụng:

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

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

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 các hàng tương ứng.

Ánh xạ dữ liệu

Bạn có thể xác định cách dữ liệu từ tệp đã tải lên sẽ tương ứng với các trường cụ thể trong Requirements & Systems Portal. Nếu tệp chứa các tiêu đề giống với các trường mặc định trong Requirements & Systems 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. Nhấp vào tiêu đề cột và chọn trường cần thiết từ danh sách thả xuống.

Ngoài ra, bạn có thể ánh xạ dữ liệu cột vào một cột tùy chỉnh mới bằng cách nhập tên cần thiết của cột đó vào trường Search/Add custom trong danh sách thả xuống rồi chọn <custom_column_name> (Create new) từ danh sách thả xuống.

Bạn cũng có thể chọn None từ danh sách thả xuống để không ánh xạ dữ liệu từ tệp sang bất kỳ cột nào (tức là dữ liệu này sẽ không được nhập).

Ít nhất phải chọn các cột Identifier và Text. Nếu không, 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 có thể được nhập vào yêu cầu bằng Importer:

  • Identifier

  • Text

  • Title

  • Rationale

  • Children

  • Parents

  • Section

  • Path to Section

  • Applicable Block

  • Compliance Comment

  • Type

  • State

  • Compliance

  • V&V Status

  • V&V Methods

  • Applicability

  • Owner

  • Tags

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

  • Children, V&V Methods, Applicable Blocks, Applicability 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 thức xác minh, applicable block, loại yêu cầu, trạng thái, compliance hoặc tag đang được nhập hiện chưa tồn tại trong Requirements & Systems 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 Applicability, có thể tham chiếu các loại khối kết hợp bằng /, ví dụ: block_A/block_B.

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

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

  • Type

  • State

  • Compliance

  • Tags

Ví dụ: nếu tag TBD đã tồn tại trong Requirements & Systems Portal và tag tbd đang được nhập, một tag 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 dữ liệu cần nhập đã được xem lại và các tùy chọn được cấu hình theo yêu cầu, hãy nhấp vào nút  để tiếp tục. Một cửa sổ xác nhận sẽ xuất hiện khi quá trình nhập hoàn tất.

Nếu importer phát hiện các vấn đề trong các yêu cầu được 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 lý do của các vấn đề được phát hiện. Các trường hợp có thể xảy ra là:

  • Cố gắng nhập một yêu cầu có quan hệ với các identifier không tồn tại trong dự án cũng như trong các yêu cầu khác trong tệp được nhập.

  • Cố gắng nhập một yêu cầu có quan hệ với một requirement identifier thuộc về nhiều hơn một yêu cầu, trong dự án hoặc trong các yêu cầu khác của tệp được nhập.

  • Cố gắng nhập một yêu cầu với câu lệnh compliance hiện chưa được định nghĩa trong Requirements & Systems Portal.

  • Cố gắng nhập một yêu cầu với một type hiện chưa được định nghĩa trong Requirements & Systems Portal.

  • Cố gắng nhập một yêu cầu với một state hiện chưa được định nghĩa trong Requirements & Systems Portal.

  • Cố gắng nhập một yêu cầu với một tag hiện chưa được định nghĩa trong Requirements & Systems Portal.

  • Cố gắng nhập một yêu cầu với một điều kiện applicability hiện chưa được định nghĩa trong Requirements & Systems Portal.

  • Cố gắng nhập một yêu cầu với một method hiện chưa được định nghĩa trong Requirements & Systems Portal.

  • Cố gắng nhập một yêu cầu với một applicable block hiện chưa được định nghĩa trong Requirements & Systems Portal.

  • Cố gắng nhập một owner hiện chưa được định nghĩa trong Requirements & Systems Portal.

  • Cố gắng nhập nhiều hơn một owner, state hoặc type hiện chưa được định nghĩa trong Requirements & Systems Portal.

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

Phiên bản trước của Importer

Khi bạn không có quyền truy cập vào phiên bản Importer mới hơn được mô tả ở trên, phiên bản trước của nó sẽ được sử dụng. Hãy tham khảo phần thu gọn bên dưới để tìm hiểu thêm.

Nếu tùy chọn này bị tắt và bạn đang nhập các yêu cầu có Identifier đã tồn tại trong đặc tả được chọn làm đích, Requirements & Systems Portal sẽ thêm hậu tố _import vào các identifier của những 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ó Identifier đã 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 & Systems Portal sẽ thêm biểu tượng cảnh báo vào các identifier để cảnh báo về identifier bị 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 sẽ đượ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, 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 một hàng tiêu đề tham chiếu chung do Requirements & Systems Portal cung cấp (tức là tiêu đề cột như A, B, C, v.v.).

    Requirements & Systems Portal xem hàng Header 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 sheet, bạn có thể chọn sheet mà mình muốn nhập dữ liệu từ đó.

  • Starting row – bạn có thể chọn hàng nào của tệp được nhập mà từ đó dữ liệu sẽ bắt đầu được thu thập để chèn vào Requirements & Systems 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 đó với các trường trong Requirements & Systems 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 & Systems Portal 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 đề giống hệt các trường mặc định trong Requirements & Systems 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ạ:

      • Identifier

      • Text

      • Title

      • Rationale

      • Parents

      • Children

      • Path to Section

      • Type

      • State

      • Tags

      • Compliance

      • Compliance comment

      • V&V Methods

      • Applicability

      • Applicable Blocks

      • Owner

      • Tags

      • Custom Columns

    • 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. Để thực hiện điều 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, applicable block, loại yêu cầu, trạng thái, compliance hoặc tag đang được nhập hiện chưa tồn tại trong Requirements & Systems Portal, mục đó sẽ được tự động 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 block ghép có thể được tham chiếu bằng /, ví dụ: block_A/block_B.

    • Đối với custom columns, 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 phân biệt chữ hoa chữ thường:

      • Type

      • State

      • Compliance

      • Tags

      Ví dụ: nếu tag TBD đã tồn tại trong Requirements & Systems Portal và tag tbd đang được nhập, một tag 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 (lần lặp trước)

    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 với các thay đổi đã được 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ệ → Identifier của Parent hoặc Children không tồn tại trong dự án

    • Không thể thiết lập quan hệ → Identifier của Parent hoặc Children bị trùng lặp trong dự án

    • Requirement Compliance Statement không tồn tại trong dự án

    • Requirement Type không tồn tại trong dự án

    • Requirement State không tồn tại trong dự án

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

    • Applicability Condition 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).

    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 ở đầu cửa sổ. Quy trình này sẽ quét văn bản của các yêu cầu đã nhập để tìm các tham số có thể định lượng nhằm chuyển đổi thành Valis 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