요구사항 가져오기

Import Wizard 에 있는 기능을 사용하면 Requirements Module에서 Requirements Portal로 기존 요구사항 데이터를 빠르고 쉽게 업로드할 수 있습니다.

AI Assisted Requirements Importer

요구사항 엔지니어링은 종종 PDF나 Excel 스프레드시트 같은 문서에서 이해관계자 요구사항을 작성하는 것부터 시작하는데, 이런 데이터는 구조화가 잘 되어 있지 않은 경우가 많습니다. 이러한 비정형 문서에서 요구사항 데이터를 수동으로 추출하는 작업은 많은 노동이 들고 오류가 발생하기 쉽습니다. Requirements Portal에서 요구사항을 캡처하는 과정을 더 빠르게 진행하기 위해, AI 기능을 활용하여 비정형 PDF, Excel, Word, CSV 파일에서 요구사항을 가져올 수 있습니다.

AI 지원 Importer 기능은 현재 베타(Beta)입니다.

Accessing the Importer

AI Assisted Importer는 Requirements Module()에서 페이지 좌측 상단의  버튼을 클릭한 뒤, 표시되는 메뉴에서 Create Requirement 를 선택하여 접근할 수 있습니다. 또는 현재 보고 있는 사양(specification)에 요구사항이 하나도 없는 경우, 페이지의 Import 버튼을 클릭하여 Importer에 접근할 수 있습니다.

Import Flow

Importer에 접근하면 Document Import 창이 표시됩니다. AI Assisted Importer를 계속 진행하려면 버튼을 클릭합니다.

이 창에서 원한다면 open the legacy importer here 링크를 클릭하여 레거시(legacy) Importer를 사용할 수도 있습니다. 레거시 Importer 사용 방법은 이 페이지의 described below 에 설명되어 있습니다.

다음 단계에서 지원되는 유형의 파일(*.pdf, *.docx, *.xlsx 또는 .*csv)을 업로드할 수 있습니다. 업로드하려면 창의 해당 영역으로 파일을 드래그 앤 드롭하거나, select from your computer 컨트롤을 클릭해 하드 드라이브에서 파일을 찾아 선택합니다.

업로드 가능한 최대 파일 크기는 100MB입니다.

업로드하는 파일은 비정형이어도 되지만, Excel template 링크를 사용해 요구사항을 구조화된 방식으로 캡처할 수 있는 *.xlsx 파일을 다운로드할 수 있습니다.

파일이 성공적으로 업로드되면 해당 항목이 창에 표시됩니다. 아이콘을 클릭하면 창에서 제거할 수 있습니다. 또는 다른 파일을 창으로 드래그 앤 드롭하여 기존 파일을 대체할 수도 있습니다.

 버튼을 클릭해 진행합니다. Importer가 업로드된 파일을 처리합니다. 처리가 완료되면 추출된 데이터가 ‘제안된 요구사항’ 테이블로 표시됩니다. 가져오려는 요구사항은 해당 행 왼쪽의 체크박스를 활성화하여 선택할 수 있습니다.

기본적으로 추출된 요구사항은 Importer에 접근했을 때 보고 있던 사양으로 가져와집니다. Importer 창 상단의 드롭다운에서 원하는 사양을 선택할 수도 있고, 드롭다운에서 As new (creates new specification) 항목을 선택한 다음 창에 표시되는 Specification name 필드에서 새 사양의 이름을 정의하여 새 사양을 생성할 수도 있습니다.

 버튼을 클릭해 진행합니다. 가져오기가 완료되면 확인 창이 표시됩니다.

Importer가 가져온 요구사항에서 문제를 감지하면 창()에 표시됩니다. 링크를 클릭하면 감지된 문제의 원인을 자세히 설명한 보고서를 다운로드할 수 있습니다. 

 버튼을 클릭해 Importer의 파일 업로드 단계로 돌아가거나,  를 클릭해 Importer를 종료합니다.

Legacy Importer

Importer에 접근할 때(learn more), 구조화된 요구사항 데이터를 업로드하기 위해 레거시 가져오기 도구를 계속 사용할 수 있습니다. 이 프로세스는 Specification, Upload, Review의 세 가지 주요 단계를 안내합니다. 사양 가져오기를 완료하면 요약이 표시되며, Valifying 수행 또는 다른 파일 가져오기 같은 추가 작업을 할 수도 있습니다. 이러한 단계와 작업은 아래 섹션에서 설명합니다.

Specification

Import Wizard의 이 단계에서는 가져오기 대상 사양을 정의할 수 있습니다.

  • Import Requirements 창의 왼쪽에 있는 Select a specification 영역을 사용하여 기존 사양을 선택하고, 필요하면 해당 섹션도 선택합니다.

  • Import Requirements 창의 오른쪽에 있는 Create a specification 영역을 사용하여 가져오기 마법사를 종료하지 않고 새 사양을 생성할 수 있으며(약어 및 할당할 블록도 함께 정의),

원하는 방법을 사용하려면 해당 영역을 클릭합니다.

 
  • Import Wizard가 Specification 또는 Section 컨텍스트에서 시작된 경우, 해당 항목이 가져오기 대상 위치로 미리 선택되어 표시됩니다.

  • 기존 사양이 없는 경우에는 사양을 하나 생성해야 합니다.

  • 새 사양의 이름을 정의할 때는 명명 규칙을 충족해야 합니다. 즉, 영숫자 문자와 특수 문자 _ (underscore)만 허용됩니다.

Upload

Import Wizard의 이 단계에서는 지원되는 유형의 파일을 업로드할 수 있습니다. 업로드하려면 Import Requirements 창 오른쪽 영역으로 파일을 드래그 앤 드롭하거나, Drop file 컨트롤을 클릭해 하드 드라이브에서 파일을 찾아 선택합니다. 파일이 성공적으로 업로드되면 창에 알림이 표시됩니다.

 
  • Excel(.xls, .xlsx) 및 CSV(Comma Separated Values, .csv) 파일만 지원됩니다. Excel 매크로 파일(.xlsm)은 지원되지 않습니다.

  • 지원되지 않는 파일을 업로드하면 오류 메시지로 안내됩니다.

  • 파일이 업로드되면 가져오기 프로세스를 계속 진행하거나, 새 파일을 업로드하여(이전 파일을 대체) 진행할 수 있습니다.

Review

이 단계의 Import Wizard에서는 업로드된 파일에서 데이터를 가져온 결과를 검토하고, 파일 옵션을 구성하며, 파일의 데이터를 요구사항 필드에 매핑할 수 있습니다.

Import Requirements 창의 Destination 영역은 데이터가 어디로 가져와질지(사양 또는 섹션 기준)를 시각적으로 표시합니다.

File options 영역에서는 다음 옵션을 제공합니다.

  • Update requirements – 활성화하면 대상 사양에 이미 존재하는 모든 요구사항이 데이터 치환으로 덮어써집니다(파일 데이터가 사양의 데이터를 대체).

    • 옵션이 비활성화되어 있고, 가져오려는 요구사항의 Identifier가 대상 사양에 이미 존재하는 경우 Requirements Portal은 가져온 요구사항의 Identifier에 _import  접미사를 추가하여 구분합니다.

    • 옵션이 비활성화되어 있고, 가져오려는 요구사항의 Identifier가 현재 프로젝트에는 이미 존재하지만 대상 사양에는 존재하지 않는 경우, Requirements Portal은 동일 프로젝트 내 중복 Identifier를 경고하는 아이콘을 Identifier에 추가합니다.

    • 옵션이 활성화되어 있으면 가져오는 파일의 빈 값(blank value)도 지원됩니다. 즉, 파일에서 값이 비어 있으면 해당 값은 요구사항에서 제거됩니다. 이는 Tags 같은 다중 선택 필드에도 동일하게 적용됩니다.

  • Use header row – 업로드한 파일의 헤더 행을 사용할지, 또는 Requirements Portal이 제공하는 일반 참조 헤더 행(즉, 열 헤더가 A, B, C 등)을 사용할지 결정할 수 있습니다.

    Requirements Portal은 헤더 행을 업로드된 파일의 첫 번째 행으로 간주합니다.

  • Sheet – 여러 시트가 있는 파일의 경우, 어떤 시트에서 가져올지 선택할 수 있습니다.

  • Starting row – 가져온 파일에서 Requirements Portal에 삽입할 데이터를 수집하기 시작할 행을 선택할 수 있습니다.

Import Requirements 창 하단의 테이블에서 업로드된 파일의 미리보기를 확인하고, 각 열을 Requirements Portal의 필드에 매핑할 수 있습니다. 이를 통해 각 열에 대해 Map To 드롭다운에서 적절한 필드를 선택하여 파일의 데이터가 Requirements Portal의 특정 필드에 어떻게 대응될지 정의할 수 있습니다. 파일에 있는 헤더가 Requirements Portal의 기본 필드와 동일하면 해당 필드는 자동으로 매핑됩니다. 다만 필요하다면 이 자동 매핑을 재정의하거나 조정할 수 있습니다.

  • 매핑에 선택할 수 있는 필드는 다음과 같습니다.

    • Identifier

    • Text

    • Title

    • Rationale

    • Parents

    • Children

    • Path to Section

    • Type

    • State

    • Tags

    • Compliance

    • Compliance comment

    • Verification Methods

    • Applicability

    • Applicable Blocks

    • Owner

    • Tags

    • Custom Columns

  • Verification Methods, Applicability, Tags는 각 요구사항에 대해 두 개 이상의 값으로 가져올 수 있습니다. 이를 위해 각 값은 쉼표로 구분해야 합니다.

  • Applicability의 경우, 복합 블록 타입은 /로 참조할 수 있습니다. 예: block_A/block_B.

최소한 Identifier 열은 반드시 선택해야 합니다. 그렇지 않으면 해당 조건이 충족될 때까지 경고 메시지가 표시됩니다().

Execution Report

가져오기 프로세스가 완료되고 성공적으로 끝나면, 성공 메시지와 함께 변경된 내용이 표시됩니다. 가져오기에 실패하면 실패 메시지가 표시됩니다. 성공적인 가져오기 예시는 아래와 같습니다.

소프트 오류(soft error)가 있는 경우에도 표시됩니다(). 가능한 소프트 오류는 다음과 같습니다.

  • 관계를 설정할 수 없습니다 → 프로젝트에 상위 또는 하위 식별자가 존재하지 않습니다

  • 관계를 설정할 수 없습니다 → 프로젝트에서 상위 또는 하위 식별자가 중복되었습니다

  • 프로젝트에 Requirement Compliance Statement가 존재하지 않습니다

  • 프로젝트에 Requirement Type이 존재하지 않습니다

  • 프로젝트에 Requirement State가 존재하지 않습니다

  • 프로젝트에 Tag가 존재하지 않습니다

  • Applicability Condition이 존재하지 않습니다

가져오기가 성공했는지 여부와 관계없이 Import new file(성공) 또는 Try again(실패)를 클릭하여 다시 가져오거나 새 가져오기를 수행할 수 있으며, 그러면 1단계(Specification)로 돌아갑니다.

가져오기에 성공하면 창 상단의 Check now 컨트롤을 클릭하여 Valify 프로세스를 시작할 수도 있습니다. 이 프로세스는 가져온 요구사항 텍스트에서 요구사항 내 Valis로 변환할 수 있는 정량화 가능한 파라미터 후보를 스캔합니다.

자세한 내용은 Valify Requirements 페이지를 참조하세요.

AI-LocalizedAI로 번역됨
만약 문제가 있으시다면, 텍스트/이미지를 선택하신 상태에서 Ctrl + Enter를 누르셔서 저희에게 피드백을 보내주세요.
기능 제공 여부

사용 가능한 기능은 보유하고 계시는 Altium 솔루션에 따라 달라집니다. 해당 솔루션은 Altium Develop, Altium Agile의 에디션(Agile Teams 또는 Agile Enterprise), 또는 활성기간 내의 Altium Designer 중 하나입니다.

안내된 기능이 고객님의 소프트웨어에서 보이지 않는 경우, 보다 자세한 내용을 위해 Altium 영업팀 에 문의해 주세요.

콘텐츠