SysML v2
LML과 SysML v2 간 변환
LML 프로젝트의 SysML v2 사본이나 SysML v2 프로젝트의 LML 사본을 만들고, 변환되는 것과 변환되지 않는 것에 대한 보고서를 받습니다.
이 페이지의 내용
개요
프로젝트의 유형(LML 또는 SysML v2)은 만들 때 고정됩니다. LML 모델을 SysML v2로 작업하거나 SysML v2 모델을 LML 페이지로 작업하려면 변환된 사본을 만듭니다.
- LML 프로젝트의 SysML v2 사본 만들기…는 그 모델을 새 SysML v2 프로젝트에 SysML v2 텍스트로 기록합니다.
- SysML v2 프로젝트의 LML 사본 만들기…는 그 모델을 새 LML 프로젝트의 LML 엔터티와 관계로 바꿉니다.
원래 프로젝트는 절대 변경되지 않습니다. 사본을 만들기 전에 보고서가 변환되는 것을 개수와 함께, 변환되지 않는 것을 이유와 함께 나열합니다. 같은 보고서가 새 프로젝트에 저장됩니다.
개념
유형 변경이 아닌 사본
변환은 항상 새 프로젝트를 만듭니다. 원래 프로젝트에서 계속 작업하고 나중에 다시 변환할 수 있으며, 변환할 때마다 또 하나의 새 프로젝트가 생깁니다. 사본과 원래 프로젝트는 서로 연결되지 않습니다.
두 언어의 대응 관계
LML과 SysML v2는 많은 같은 대상을 서로 다른 방식으로 설명합니다. 변환은 양방향으로 다음 대응 관계를 사용합니다.
| LML | SysML v2 |
|---|---|
| Asset | 사용되는 모든 곳에 part usage가 있는 part definition |
| Asset의 분해(decomposed by) | 부모 정의 안의 part usage |
| Port | Port usage |
| Asset의 Characteristic | Attribute usage |
| Conduit | Connection usage, 또는 양 끝이 포트이면 interface usage |
| Input/Output | in 및 out item 매개변수와 흐름이 있는 item definition |
| Requirement(Number, Name, Description) | Requirement usage(짧은 이름, 이름, doc) |
| satisfied by | satisfy |
| Test Case | verify 목표가 있는 verification usage |
| Test Suite | 검증 케이스의 패키지 |
| 흐름이 있는 Action | succession이 있는 action usage |
| SYNC와 병렬 블록 | 포크와 조인 |
| OR | 결정과 병합 |
| LOOP | 루프 액션 |
| performed by | perform |
| 상태 특성과 전이 | 파트가 exhibit하는, 전이가 있는 state definition |
| Equation과 그 변수 | 매개변수가 있는 constraint definition |
Holarch 데이터도 함께 옮겨집니다
어느 언어에도 자리가 없는 데이터가 있습니다. 이는 Holarch 데이터이며 연결과 함께 복사됩니다.
- 위험, 결정, 작업, 비용, 일정, 이슈, 문서, 화이트보드가 복사되며 변환된 요소와 계속 연결됩니다.
- 요구사항 상태와 검증 방법은 각 요구사항에, 테스트 결과는 각 테스트 케이스에 남습니다. 클래스 워크플로의 사용자 지정 상태도 보존됩니다.
- 스키마 변경은 상태, 폐기된 상태, 전이, 승인자가 있는 클래스 워크플로를 포함해 양방향으로 이어집니다.
- 토론 댓글은 해당 요소를 따라갑니다.
- 결정의 분기 확률은 시뮬레이터를 위해 해당 분기에 남습니다.
- SysML v2 사본으로 만든 LML 사본은 첫 번째 변환이 보존한 LML 속성과 레이블을 되돌려 받습니다.
변환되지 않는 것
- 다이어그램 레이아웃. 뷰와 다이어그램은 사본에서 새로 그려집니다.
- 기록, 베이스라인, 변경 요청. 사본은 이것들 없이 시작합니다.
- LML Measure와 Resource, 또는 SysML v2의 열거형, 계산, 분석 케이스처럼 한쪽 언어에 자리가 없는 요소.
보고서에 이러한 항목이 모두 이유와 함께 표시됩니다. 보고서 참조를 참조하십시오.
사용 방법
사용 시기와 이유
프로젝트의 언어가 작업에 더 이상 맞지 않을 때 변환합니다.
- LML에서 SysML v2로: 팀이나 고객이 이제 SysML v2로 작업하거나, 모델을 SysML v2 도구와 교환해야 하는 경우입니다. 변환한 후
.sysml또는 JSON을 내보냅니다(SysML v2 모델 교환 참조). - SysML v2에서 LML로: SysML v2 프로젝트에 없는 LML 페이지나 다이어그램이 필요하거나, 검토를 위해 모델을 Holarch의 수명 주기 형태로 원하는 경우입니다.
모델이 안정된 후에 변환하고, 사본에 의존하기 전에 보고서를 읽습니다.
변환된 사본 만들기
- 프로젝트 관리에서 프로젝트 행의 ⋯을 클릭합니다.
- SysML v2 사본 만들기…(LML 프로젝트의 경우) 또는 LML 사본 만들기…(SysML v2 프로젝트의 경우)를 선택합니다.
Holarch가 변환을 검사합니다. 대규모 프로젝트에서는 창 하단의 진행 표시줄에 "변환 검사 중…"이 표시됩니다. 그런 다음 보고서와 함께 대화 상자가 열립니다.
- 보고서를 읽습니다.
- 변환됨은 항목의 각 종류, 그 개수, 그리고 무엇이 되는지를 나열합니다. 예: "Requirements 24 requirement usages".
- 변환되지 않음은 변환되지 않는 항목의 각 종류, 그 개수, 이유를 나열합니다.
- Holarch 밖에서 보고서가 필요하면 보고서 다운로드 (CSV)를 클릭해 항목당 한 행으로 저장합니다.
- 새 프로젝트 이름을 입력합니다. 기본값은 원래 이름 뒤에 "(SysML v2)" 또는 "(LML)"이 붙은 이름입니다.
- 사본 만들기를 클릭합니다.
알림에 ""<name>"을(를) 만들었습니다"가 표시됩니다. 사본이 홈 페이지에서 열립니다.
- 사본에서 Conversion report 문서를 엽니다. 변환되지 않은 모든 항목이 번호와 이름으로 나열됩니다.
사본 확인하기
- SysML v2 사본에서 모델 → 편집기를 엽니다.
모델은 프로젝트 이름을 딴 최상위 패키지 하나입니다. 그 안에 Architecture, System, Items, Requirements, Verification, Behavior, Constraints, Views 패키지가 있습니다(내용이 있는 패키지만).
- 여백에서 문제 표시를 찾습니다. 변환된 텍스트에 문제가 있으면 사본을 만들기 전에 대화 상자가 알려 주었습니다: "변환된 텍스트에 문제가 N개 있습니다. 사본의 편집기에 표시됩니다."
- 뷰에서 뷰(Architecture Overview, System Connections)를 열어 새로 그려진 구조를 확인합니다.
- LML 사본에서는 데이터베이스와 다이어그램을 열어 Asset, Requirement, 액션 흐름을 확인합니다.
실습 예제: Hybrid Car 데모의 LML 사본
먼저 데모를 만듭니다: 프로젝트 관리에서 프로젝트 파일 ▾ → 새 데모 프로젝트 → Hybrid Car(SysML v2)를 클릭합니다.
- 프로젝트 관리에서 Hybrid Car (SysML v2 demo)의 ⋯을 클릭하고 LML 사본 만들기…를 선택합니다. 사본의 이름은 "Hybrid Car (SysML v2 demo) (LML)"이 됩니다.
- 보고서를 읽습니다.
변환됨 아래: part usage는 Asset, port usage는 Port, attribute는 Characteristic, connection 및 interface usage는 Conduit, requirement usage와 definition은 Requirement, verification usage는 Test Case, action은 Action, 그리고 state와 transition은 해당하는 LML 요소가 됩니다.
변환되지 않음 아래에는 다음 등이 있습니다.
- 특수화: LML에는 특수화가 없습니다. 파트에 일반 정의의 기능이 복사되어 들어갑니다.
SportCar :> Car가 그 예입니다. - 재정의: 재정의하는 기능이 복사된 각 파트에서 상속된 기능을 대체합니다. 세단의 배터리는 48 kg으로 복사됩니다.
- 열거형(
DriveMode,FuelKind): 속성 값은 텍스트로 보존됩니다. - 계산(
PowerToWeight,ElectricRange)과 분석 케이스(PowerToWeightAnalysis). - 바인딩 커넥터(
bind output = transmission.output;): LML에는 기능 간 바인딩이 없습니다. - 속성 값: 각 Characteristic의 Value에 텍스트로 보존되며, 단위와 식은 평가되지 않습니다.
- 뷰: LML 사본에서 다이어그램이 새로 그려집니다.
- 특수화: LML에는 특수화가 없습니다. 파트에 일반 정의의 기능이 복사되어 들어갑니다.
- 사본 만들기를 클릭합니다.
LML 사본이 열립니다.
fleet.sedan과 그 파트는 Asset이며, 요구사항 Sedan Mass(VR-1.1)는 세단의 Asset이 충족하는 Requirement입니다. 데모의 위험, 결정, 작업도 복사되어 변환된 요소에 연결됩니다.
반대 방향을 시도하려면 CubeSat EO-1 데모(LML 프로젝트)를 만들고 그 프로젝트에서 SysML v2 사본 만들기…를 선택합니다.
팁과 모범 사례
- 변환하기 전에 LML 프로젝트를 정리합니다. 각 Conduit을 정확히 두 개의 Asset 또는 Port에 연결하고, 각 Characteristic을 Asset 또는 Equation에 붙이고, 빈 Test Suite를 제거합니다. 그렇지 않으면 변환되지 않음으로 보고됩니다.
- LML에서 OR 분기 레이블을 가드로 바꾸려면 모델 값에 대한 부울 식(예:
speed > 3)으로 작성합니다. 다른 레이블은 succession의 doc 주석이 됩니다. - SysML v2에서는 액터에 part definition 유형을, item 매개변수에 item definition 유형을 지정합니다. 유형이 없는 것은 변환되지 않습니다.
- 원본을 보관합니다. 두 프로젝트를 동시에 편집하지 말고, 큰 변경 후에는 원본에서 다시 변환합니다.
흔한 실수
- 원본이 바뀔 것으로 예상함. 바뀌지 않습니다. 사본은 별도의 프로젝트입니다.
- 다이어그램이 레이아웃을 유지할 것으로 예상함. 레이아웃은 변환되지 않습니다. 새 뷰나 다이어그램을 다시 배치합니다.
- LML 사본에 파트가 누락됨. LML에는 인스턴스만 있으므로, 어떤 파트도 사용하지 않는 part definition은 LML에 Asset이 없습니다. 파트에서 그 정의를 사용한 후 다시 변환합니다.
- 보고서에 "확인되지 않음" 항목이 있음. SysML v2 텍스트의 이름이 아무것도 가리키지 않습니다. 편집기에서 이름을 고친 후 다시 변환합니다.
보고서 참조
LML에서 SysML v2로
변환되는 항목에는 Asset(part usage가 있는 part definition), Characteristic(attribute), Port, Conduit(connection 또는 interface), Input/Output(item definition), Requirement, Action과 유스케이스, 액션 간 item flow, State, Transition, Equation(constraint definition), Performs, Test Suite, Test Case, Verifies, Satisfies, 그리고 Holarch 항목(연결과 함께 복사됨): Artifact, Statement, 작업, 위험, 일정 항목, 비용, 이슈, 결정, 위해 요인, 고장 모드가 포함됩니다. 클래스 워크플로(프로젝트의 스키마 변경)는 사용자 지정 상태, 전이, 승인자와 함께 이어지므로 요구사항과 테스트 케이스는 사용자 지정 Status 값을 유지합니다. 사본은 프로젝트의 공식 프로그램 및 안전 & 신뢰성 스위치를 유지합니다.
| 변환되지 않음 | 사유 |
|---|---|
| 분해 순환에 있는 Asset | 자신을 포함하는 Asset은 파트 트리에 자리가 없습니다. 그 part definition은 변환되지만 파트로 사용되지 않습니다. |
| 끝이 정확히 두 개가 아닌 Conduit | SysML connection은 두 끝을 잇습니다. Conduit을 두 Asset 또는 Port에 연결한 후 다시 변환합니다. |
| Conduit이 전달하는 항목 | 이 변환의 connection은 항목을 전달하지 않습니다. 항목은 item definition과 액션 간 흐름으로 변환됩니다. |
| 다른 Conduit으로 분해된 Conduit | 여기서는 SysML connection이 중첩되지 않으며, 각 Conduit은 별도의 connection이 됩니다. |
| 루프 횟수와 루프 스크립트 | 여기서 SysML 루프는 조건이 될 때까지 반복합니다. 횟수는 Holarch 데이터로 보존되며 LML 사본 만들기로 복원됩니다. |
| 결정 분기 레이블과 확률 | 결정의 모든 레이블이 모델 값에 대한 부울 식이면 레이블이 그 가드가 되고, 그렇지 않으면 succession의 doc 주석이 됩니다. 확률은 시뮬레이터를 위해 Holarch 데이터로 보존되며, 둘 다 LML 사본 만들기로 복원됩니다. |
| OR, SYNC, LOOP 항목 | 구문은 decide/merge, fork/join, loop 노드로 변환되며, 이를 이름 붙였던 항목은 보존되지 않습니다. |
| 상태의 진입, 수행, 종료 액션 | 액션은 액션으로 변환됩니다. 이 변환은 SysML 상태 본문을 채우지 않습니다. |
| 한 머신의 두 상태 사이에 있지 않은 전이 | SysML transition은 같은 state definition의 두 상태를 잇습니다. |
| 전이 가드와 트리거 | LML에서는 자유 텍스트로 작성됩니다. SysML 식이 아닌 Holarch 데이터로 보존되며 LML 사본 만들기로 복원됩니다. |
| Asset이 지정하지 않은 상태 | 상태에는 그 상태가 동작을 설명하는 Asset이 필요합니다. |
| Equation 식 | 식이 SysML 기능이 아닌 이름을 사용합니다. 각 식은 해당 constraint definition 안에 주석으로 보존됩니다. |
| 테스트 케이스가 없는 Test Suite | Suite는 그 검증 케이스의 패키지가 됩니다. 빈 Suite에는 담을 것이 없습니다. |
| 요구사항 이외의 것을 검증하는 테스트 케이스 | SysML verification case는 요구사항만 검증합니다. |
| 테스트 주기 | Suite에 기록된 테스트 실행은 모델의 일부가 아닙니다. 각 케이스의 최신 결과가 보존됩니다. |
| 다른 종류의 항목이 충족하는 요구사항 | 예를 들어 SysML에서는 요구사항이 다른 요구사항을 충족하지 않습니다. 텍스트에서 derivation을 사용합니다. |
| 기타 관계 | 이 변환에는 이에 해당하는 SysML 관계가 없습니다. 보고서에 각각이 표시됩니다. |
| Measure | 이 변환에서 효과도 척도에는 SysML 요소가 없습니다. |
| Resource | 자원량(consumes, produces)은 LML 시뮬레이터에 속하며 여기에는 SysML 요소가 없습니다. |
| Asset이나 Equation에 붙지 않은 Characteristic | attribute에는 소유자가 필요합니다. Asset으로 지정하거나 Equation 변수로 만듭니다. |
| 다른 클래스의 항목 | 이 클래스에는 SysML v2 프로젝트에서 SysML 요소나 Holarch 자리가 없습니다. |
| 기능과 구성 | 아직 지원되지 않음: 제품 라인의 기능과 구성은 SysML v2 가변점, 변형, 구성이 되지 않습니다. 보고서는 이를 Feature 항목과 Configuration 항목으로 나열합니다. 사본에서 변형을 다시 모델링합니다(SysML v2 변형과 구성 참조). |
| 베이스라인 | LML 프로젝트의 베이스라인은 새 모델에 적용되지 않습니다. 사본은 베이스라인 없이 시작합니다. |
| 기록 | 변경 기록은 사본에서 새로 시작합니다. |
| 변경 요청 | LML 변경 요청은 LML 항목에 대한 변경을 제안하며, 사본에는 그 항목이 없습니다. |
| 다이어그램 레이아웃 | 다이어그램은 SysML v2 뷰로 새로 그려지며, 위치는 이어지지 않습니다. |
| 문서 개요의 변환된 항목 | 문서는 복사됩니다. 개요에 있던 요구사항과 기타 모델 항목은 이제 SysML 요소이며 개요가 아닌 모델에 나타납니다. |
SysML v2에서 LML로
각 part usage는 Asset이 되며, 그 정의(및 정의가 특수화하는 정의)의 파트, 포트, 속성이 복사되어 들어갑니다. 재정의는 재정의 대상을 대체합니다. Connection과 interface는 그 Asset 간의 Conduit이 됩니다. 요구사항, 검증 케이스, satisfy, verify, perform, item 매개변수, 상태, 전이는 위 표와 같이 역으로 대응됩니다. Succession은 액션 흐름이 되며, 결정의 가드(또는 succession의 doc 주석)는 확률과 함께 OR 분기 레이블이 됩니다. 프로젝트의 스키마 변경은 사용자 지정 상태, 전이, 승인자가 있는 클래스 워크플로를 포함해 이어지므로 요구사항과 테스트 케이스는 사용자 지정 Status 값을 유지합니다.
| 변환되지 않음 | 사유 |
|---|---|
| 끝이 확인되지 않는 connection | 텍스트에서 끝의 이름을 고친 후 다시 변환합니다. |
| 어떤 파트도 사용하지 않는 정의 안의 connection | 각 connection은 그것을 가진 모든 파트의 파트 사이 Conduit이 됩니다. 이 정의를 사용하는 것이 없습니다. |
| 바인딩 커넥터 | LML에는 기능 간 바인딩(동등성)이 없습니다. |
| 확인되지 않는 verify 관계 | 검증 목표의 요구사항 이름을 고친 후 다시 변환합니다. |
| item definition이 없는 item 매개변수 | 변환하려면 매개변수에 item def 유형을 지정합니다. |
| 모델에 part definition이 없는 액터 | 변환하려면 액터에 part def 유형을 지정합니다. |
| 액션과 파트로 확인되지 않는 perform usage | part definition 또는 part usage에서 액션을 perform한 후 다시 변환합니다. |
| 확인되지 않는 satisfy 관계 | satisfy 문의 이름을 고친 후 다시 변환합니다. |
| 구조화된 흐름이 아닌 succession | LML 액션 흐름은 병렬, 결정, 루프 블록이 있는 시퀀스입니다. 다른 succession 그래프는 선형화됩니다. |
| 어떤 파트도 exhibit하지 않는 state definition | 상태는 그 상태가 동작을 설명하는 Asset 없이 변환됩니다. |
| 두 상태로 확인되지 않는 전이 | 상태 이름을 고친 후 다시 변환합니다. |
| 전이 트리거(accept) | LML 전이는 트리거를 자유 텍스트로만 보존하며, 수락된 시그널은 연결되지 않습니다. |
| Port, interface, connection definition | 파트가 사용하는 곳에서 Port와 Conduit으로 변환됩니다. LML에는 port, interface, connection 유형이 없습니다. |
| Attribute definition(값 유형) | LML Characteristic에는 유형이 없습니다. |
| 열거형과 열거 값 | LML에는 열거형이 없습니다. 속성 값은 텍스트로 보존됩니다. |
| 계산, 분석 케이스, 관심사 | LML에는 계산, 분석 케이스, 이해관계자 관심사가 없습니다. |
| 뷰와 뷰포인트 | LML 사본에서 다이어그램이 새로 그려집니다. |
| Assignment, if, send, accept 액션 | LML 액션에는 문(statement)이 없습니다. |
| 의존 | LML에는 일반 의존이 없습니다. |
| 할당 | 파트가 수행하는 액션에는 텍스트에서 perform을 사용합니다. |
| 메타데이터 | LML에는 메타데이터가 없습니다. |
| Occurrence | LML에는 occurrence가 없습니다. |
| 포함된 유스케이스 | 유스케이스 간 include 관계는 변환되지 않습니다. |
| 별칭 | LML 엔터티는 각각 이름이 하나입니다. |
| Reference usage(계산과 케이스의 매개변수) | LML에는 Equation 변수 외에 매개변수가 없습니다. |
| 특수화 | LML에는 특수화가 없습니다. 파트에 일반 정의의 기능이 복사되어 들어갑니다. |
| 재정의 | 재정의하는 기능이 복사된 각 파트에서 상속된 기능을 대체합니다. |
| 부분 집합 지정(subsetting) | LML에는 subsetting이 없습니다. |
| 임포트 | LML에는 네임스페이스가 없습니다. 모든 엔터티가 프로젝트 안에서 보입니다. |
| usage와 구별되는 definition | LML에는 인스턴스만 있습니다. part definition은 그것을 사용하는 파트의 Asset이 되고, 그 텍스트는 해당 Asset의 설명으로 들어갑니다. |
| 파트 이외의 다중성 | 파트 다중성만 LML에 자리가 있습니다(decomposed by의 Multiplicity). |
| 속성 값 | 값은 각 Characteristic의 Value에 텍스트로 보존되며, 단위와 식은 평가되지 않습니다. |
| 베이스라인 | SysML v2 프로젝트의 베이스라인은 LML 사본에 적용되지 않습니다. 사본은 베이스라인 없이 시작합니다. |
| 기록 | 변경 기록은 사본에서 새로 시작합니다. |
| 변경 요청 | SysML 변경 요청은 LML 엔터티에 적용되지 않는 텍스트 변경을 제안합니다. |
보고서 CSV
보고서 다운로드 (CSV)는 변환된 항목의 종류마다 한 행, 변환되지 않은 항목마다 한 행을 기록합니다. 열은 결과(변환됨 또는 변환되지 않음), 대상, 개수, 변환 결과 또는 이유, 번호, 이름입니다.
메시지
| 메시지 | 의미 및 해결 방법 |
|---|---|
| 변환 검사 중…(진행 표시줄) | 보고서를 준비하는 중입니다. |
| 이미 SysML v2 프로젝트입니다. 대신 LML 사본 만들기…를 선택하십시오. | 잘못된 방향을 선택했습니다. |
| 이미 LML 프로젝트입니다. 대신 SysML v2 사본 만들기…를 선택하십시오. | 잘못된 방향을 선택했습니다. |
| 변환된 텍스트에 문제가 N개 있습니다. 사본의 편집기에 표시됩니다. | 사본을 만들 수 있습니다. 사본의 편집기에서 문제를 고칩니다. |
| 변환된 텍스트가 구문 분석되지 않습니다(…). 프로젝트가 복사되지 않았습니다. 프로젝트 파일과 함께 이 문제를 보고하십시오. | 변환에 실패했습니다. 프로젝트 파일과 함께 지원팀에 문의하십시오. |
| SysML 검사기가 시작되지 않았습니다. 페이지를 다시 로드한 후 다시 시도하십시오. | 다시 로드한 후 다시 시도합니다. |
| 프로젝트를 읽을 수 없습니다. 페이지를 다시 로드한 후 다시 시도하십시오. | 다시 로드한 후 다시 시도합니다. |
| 사본이 만들어지지 않았습니다: … 페이지를 다시 로드한 후 다시 시도하십시오. | 다시 로드한 후 다시 시도합니다. |
| "<name>"을(를) 만들었습니다 | 사본이 만들어지고 열렸습니다. |
제한 사항
- 다이어그램 레이아웃, 기록, 베이스라인, 변경 요청은 변환되지 않습니다.
- 아직 지원되지 않음: LML 제품 라인(기능과 구성)을 SysML v2 변형으로 변환.
- 보고서 문서는 종류마다 최대 500개 항목을 나열합니다.
관련 페이지
SysML® 및 OMG®는 미국 및 기타 국가에서 Object Management Group, Inc.의 등록 상표입니다.