요구사항
다른 프로젝트로의 연결
항목을 다른 프로젝트의 요구사항, 기능 또는 테스트로 추적합니다. 각 사용자는 연결된 항목의 프로젝트를 열 수 있을 때만 그 항목을 봅니다.
이 페이지의 내용
개요
다른 프로젝트로의 연결은 이 프로젝트의 항목에서 다른 프로젝트의 항목으로 가는 추적 관계입니다. 예를 들어 시스템 사양의 요구사항에서 traced from된 서브시스템 요구사항이나, 다른 팀이 관리하는 요구사항을 verifies하는 테스트 절차가 있습니다.
연결은 이 프로젝트의 일부입니다. 두 항목의 id와 관계만 저장합니다. 연결된 항목의 번호, 이름, 클래스, 상태는 볼 때마다 사용자 자신의 권한으로 해당 항목의 프로젝트에서 읽어 옵니다.
- 다른 프로젝트를 열 수 있으면 항목이 보이고 클릭해서 이동할 수 있습니다.
- 열 수 없으면 열 수 없는 프로젝트의 항목이 표시됩니다. 이름은 앱, 내보내기, API, AI 도구 어디로도 전달되지 않습니다.
다른 프로젝트로의 연결은 Team 요금제에 포함됩니다. 프로젝트 소유자의 요금제가 기준입니다. 다른 요금제에서는 기존 연결이 계속 표시되고 제거할 수 있지만 새 연결은 추가할 수 없습니다. Hybrid Car와 Hybrid Car Battery Pack 데모 프로젝트 사이의 연결은 모든 요금제에서 동작합니다.
개념
연결에 저장되는 내용
| 구성 요소 | 의미 |
|---|---|
| 출처 | 이 프로젝트의 항목 |
| 관계 | 이 프로젝트 스키마의 관계. 예: traced from, satisfies, verified by |
| 목표 | 프로젝트의 id와 그 프로젝트에 있는 항목의 id |
관계는 원본의 클래스에 대해 검사됩니다. 연결은 다른 프로젝트의 내용을 읽지 않으므로 연결을 만들 때 대상의 클래스는 검사하지 않습니다. 대상의 클래스가 관계에 맞지 않으면 추적 섹션에 "이 관계는 보통 …을(를) 가리키지 않습니다"와 함께 ⚠가 표시됩니다.
누가 무엇을 보는가
각 사용자는 연결된 각 항목을 해당 프로젝트에서 자신이 가진 역할로 봅니다.
| 다른 프로젝트에 대한 사용자의 권한 | 표시 내용 |
|---|---|
| 모든 역할(소유자, 편집자, 검토자, 뷰어) | 번호, 이름, 프로젝트, 항목을 여는 링크 |
| 없음, 또는 프로젝트가 더 이상 존재하지 않음 | 열 수 없는 프로젝트의 항목 |
존재하지 않는 프로젝트와 열 수 없는 프로젝트는 똑같이 보이므로, 연결은 프로젝트가 존재한다는 사실을 알려 주지 않습니다.
연결 상태
| 표시 | 의미 | 할 일 |
|---|---|---|
| 번호와 이름 | 항목이 존재하고 그 프로젝트를 열 수 있음 | 없음 |
| <project>에서 삭제됨 | 항목이 해당 프로젝트의 휴지통에 있음 | 그 프로젝트를 편집할 수 있는 사람에게 복원을 요청하거나 연결을 제거합니다 |
| 삭제됨 | 항목이 더 이상 존재하지 않음 | 연결을 제거합니다(끊어진 링크 제거) |
| 열 수 없는 프로젝트의 항목 | 프로젝트에 대한 권한이 없거나 프로젝트가 더 이상 존재하지 않음 | 필요하면 프로젝트 소유자에게 권한을 요청합니다 |
| 로드 중… | 항목을 읽는 중 | 잠시 기다립니다 |
이름은 페이지가 연결을 표시할 때, 1분 후 탭으로 돌아올 때 다시, 그리고 5분마다 읽습니다. 이름이 바뀐 항목은 이 프로젝트를 변경하지 않아도 새 이름으로 표시됩니다.
변경된 대상
연결이 만들어지거나 마지막으로 검토된 후 연결된 항목이 해당 프로젝트에서 편집되면 행에 변경됨이 표시됩니다. 가리키면 날짜가 표시됩니다. 연결이 여전히 유효한지 확인한 다음:
- 행의 ✓를 클릭하여 해당 연결을 검토됨으로 표시합니다.
- 항목의 표시된 연결을 모두 처리하려면 다른 프로젝트 옆의 ⋯를 클릭한 다음 모두 검토됨으로 표시(n)를 클릭합니다.
- 또는 니즈 및 요구사항 → 검토할 연결을 엽니다. 다른 프로젝트에서 변경됨 카드에 프로젝트의 표시된 연결이 모두 나열되며, 행마다 ✓가 있고 모두 검토됨으로 표시가 있습니다.
검토됨으로 표시하면 항목의 기록과 활동에 표시되며, 실행 취소 한 번으로 되돌립니다. 검토자와 뷰어는 표시를 볼 수 있지만 지울 수는 없습니다. 라이브러리 릴리스로의 연결은 표시되지 않습니다(릴리스는 변경되지 않음).
사용 방법
사용 시기와 이유
모델 하나로는 너무 크거나 여러 팀이 소유할 때 다른 프로젝트로의 연결을 사용합니다. 예를 들어 시스템 사양과 그 서브시스템 사양, 제품 라인의 공유 요구사항과 각 제품, 고객의 요구사항과 자사 설계입니다. 연결은 하위 수준 프로젝트에 두고 위쪽을 가리키게 합니다. 각 서브시스템은 시스템 요구사항에서 자신의 요구사항을 추적합니다.
한 프로젝트 안에서는 일반 관계를 사용합니다. 추적 섹션의 기존 항목 연결…은 같은 프로젝트의 항목을 관계 짓습니다. 다른 프로젝트로의 연결은 다른 곳에 있는 항목을 위한 것입니다.
연결 추가
- 항목(예: 서브시스템 요구사항)을 선택합니다.
- 속성 패널에서 추적 섹션을 엽니다. 다른 프로젝트 아래에서 +(다른 프로젝트에 링크 추가…)를 클릭합니다.
- 관계를 선택합니다(예: traced from).
- 프로젝트를 선택합니다. 그 항목이 번호순으로 나열됩니다.
- 라이브러리의 경우 버전을 선택합니다. 현재(작업 사본) 또는 Release 1.1 같은 릴리스입니다. 릴리스로의 연결은 현재 대신 해당 레이블을 표시하며, 그 이름은 페이지를 열지 않습니다.
- 검색에 입력하여 번호나 이름으로 항목을 찾습니다. 클래스를 선택하면 해당 클래스만 나열됩니다.
- 항목을 클릭한 다음 링크 추가를 클릭합니다. 알림에 "링크를 추가했습니다."가 표시되고 항목이 다른 프로젝트 아래에 나타납니다.
실행 취소 한 번으로 연결을 제거합니다. 같은 연결을 다시 추가하면 기존 연결이 유지됩니다.
연결된 항목 열기
연결된 항목의 이름을 클릭합니다. 해당 프로젝트가 그 항목에서 열립니다.
연결 제거
- 연결 하나를 제거하려면 연결 행의 ×를 클릭합니다.
- 연결이 삭제된 항목을 가리키면 다른 프로젝트 옆의 ⋯를 클릭한 다음 끊어진 링크 제거(n)를 클릭합니다.
연결을 제거하면 이 프로젝트만 변경됩니다. 다른 프로젝트는 연결로 인해 변경되지 않습니다.
실습 예제: 탑재체 서브시스템과 CubeSat EO-1 데모
- 요구사항 PL.1 Detector pixel pitch shall be at most 5.5 µm이 있는 EO-1 Payload라는 프로젝트를 만듭니다.
- PL.1을 선택하고 추적 → 다른 프로젝트 → +를 엽니다.
- traced from, 프로젝트 CubeSat EO-1을 선택하고 ground sample을 검색한 다음 1.2 Ground Sample Distance를 클릭합니다. 링크 추가를 클릭합니다.
- 행에 traced from 1.2 Ground Sample Distance CubeSat EO-1 · current가 표시됩니다. EO-1 Payload만 열 수 있는 동료는 같은 행에서 열 수 없는 프로젝트의 항목을 봅니다.
팁과 모범 사례
- 하위 수준에서 상위 수준으로 연결하여, 서브시스템이 추가될 때 시스템 프로젝트를 변경할 필요가 없게 합니다.
- 하위 수준 프로젝트에서 작업하는 사람들에게 상위 수준 프로젝트를 뷰어로 공유하면 이름을 볼 수 있습니다.
- 상위 수준 프로젝트를 재구성한 후 끊어진 링크 제거를 실행합니다.
흔한 실수
| 문제 | 원인 | 해결 |
|---|---|---|
| "이 항목은 이 프로젝트에 있습니다. 대신 기존 항목 연결…을 사용하십시오." | 대상이 같은 프로젝트에 있음 | 관계 그룹에서 기존 항목 연결…을 사용합니다 |
| 다른 프로젝트 아래에 +가 없음 | 프로젝트를 보기만 할 수 있거나 항목이 잠겨 있음 | 편집자 역할을 요청하거나 항목의 잠금을 해제합니다 |
| "다른 프로젝트 항목에 대한 링크는 Team 요금제에 포함됩니다." | 프로젝트 소유자가 Team 요금제를 사용하지 않음 | 계정 설정 → 요금제 및 결제에서 업그레이드합니다 |
| 선택기에 "이 프로젝트를 읽을 수 없습니다. 다른 프로젝트를 선택하십시오."가 표시됨 | 해당 프로젝트에 대한 권한을 잃었음 | 소유자에게 권한을 요청합니다 |
다른 기능과의 연결
- 추적성 매트릭스: 선택한 관계에 따른 행의 연결이 그리드 아래 다른 프로젝트에 나열됩니다. 내보내기…가 이를 포함합니다(추적성 참조).
- Spider 다이어그램: 연결된 항목은 해당 항목 주위에 점선 상자로 나타납니다. 옵션 → 다른 프로젝트로 끕니다.
- 프로그램 맵: 프로젝트 관리 → 프로그램 맵은 모든 프로젝트가 어떻게 연결되는지 보여 주고, 다른 프로젝트 ⋯ → 프로그램 맵에 표시는 이 항목을 다른 프로젝트를 거쳐 추적합니다(프로그램 맵 참조).
- 프로그램 커버리지: 연결 대상 프로젝트는 검증 → 프로그램 커버리지에 이러한 연결을 항목별, 프로젝트별로 나열합니다(프로그램 커버리지 참조).
- 기록 및 활동: 연결의 추가와 제거가 항목에 기록됩니다.
- 휴지통: 항목을 삭제하면 그 연결도 함께 휴지통으로 이동하며, 항목을 복원하면 연결도 복원됩니다.
- 변경 요청: 변경 추가 ▾ → 다른 프로젝트에 링크 추가…와 다른 프로젝트로의 링크 제거…는 연결을 준비해 두며, 요청이 적용될 때 추가되거나 제거됩니다.
- 라이브러리: 버전 선택으로 라이브러리 릴리스의 항목에 연결합니다(라이브러리 참조).
내보내기와 보고서
내보내기는 내보내는 사람의 권한으로 연결된 항목의 이름을 씁니다. 그 사람이 읽을 수 없는 것은 "다른 프로젝트의 항목"으로 기록됩니다.
| 내보내기 | 다른 프로젝트로의 연결에 일어나는 일 |
|---|---|
| 프로젝트 JSON(데이터베이스 내보내기) | 저장된 그대로 유지: id만. 파일을 가져오면 연결이 유지됩니다 |
| ReqIF(데이터베이스 및 문서) | 연결된 각 항목의 External links 속성: 관계, 프로젝트 id, 항목 id, 그리고 읽을 수 있는 경우 번호와 이름 |
| XMI | 제외됩니다. 내보내기 보고서에 "다른 프로젝트로의 연결"로 집계됩니다 |
| 추적성 매트릭스(Excel) | 별도의 Other projects 시트 |
| 추적성 매트릭스(CSV) | Other projects 열 |
| 요구사항 추적성 매트릭스(RTM) 보고서 | Other Projects 열 |
API 및 MCP
API와 MCP는 연결을 id로 반환합니다. 이름을 읽으려면 resolve 작업을 호출합니다. 이 작업은 토큰 자체의 권한과 프로젝트 목록을 사용합니다. 프로그램 맵과 항목 추적은 GET /api/v1/program-map, GET /api/v1/projects/<project>/items/<item>/trace, MCP 도구 program_map과 trace_chain으로 사용할 수 있습니다. API 및 MCP를 참조하십시오.
앱의 AI 기능은 연결을 id로만 받습니다.
메시지
| 메시지 | 의미 |
|---|---|
| 링크를 추가했습니다. | 연결이 저장됨 |
| 이 항목은 이 프로젝트에 있습니다. 대신 기존 항목 연결…을 사용하십시오. | 선택한 항목이 같은 프로젝트에 있음 |
| 항목을 선택한 후 링크를 추가하십시오. | 항목을 선택하지 않고 링크 추가를 클릭함 |
| 링크할 다른 프로젝트가 없습니다. 먼저 다른 프로젝트를 만들거나 여십시오. | 이 프로젝트만 있음 |
| 다른 프로젝트 항목에 대한 링크는 Team 요금제에 포함됩니다. | 프로젝트 소유자가 Team 요금제를 사용하지 않음 |
| 프로젝트에는 다른 프로젝트에 대한 연결을 최대 20,000개까지 둘 수 있습니다. 먼저 일부를 제거하십시오. | 프로젝트가 한도에 도달함 |
제한 사항
| 한도 | 값 |
|---|---|
| 프로젝트당 연결 | 20,000 |
| 요청당 읽는 항목 | 500 |
| 선택기에 나열되는 항목 | 검색당 100개(다른 항목을 보려면 검색을 좁힙니다) |
연결은 다른 프로젝트의 현재 버전, 또는 라이브러리 릴리스에 있는 항목의 사본을 가리킵니다(라이브러리 참조).