SysML v2
SysML v1 모델 가져오기
Cameo, MagicDraw, Enterprise Architect, Rhapsody 또는 Papyrus의 SysML 1.x 모델을 SysML v2 텍스트로 변환하고, 형태가 바뀐 부분을 검토한 다음, SysML v2 프로젝트로 가져옵니다.
이 페이지의 내용
개요
SysML 1.x 모델을 SysML v2 프로젝트로 가져올 수 있습니다. Holarch는 모델의 XMI 파일을 읽고, SysML v2 텍스트로 변환하고, 텍스트를 검사한 후, 무엇이든 변경하기 전에 변환 보고서를 보여 줍니다.
- 입력: XMI(
.xmi,.uml,.xml) 형식의 SysML 1.x 모델 또는 Cameo나 MagicDraw 프로젝트(.mdzip). - 출력: 프로젝트 안의 SysML v2 텍스트(실행 취소 한 번으로 모두 되돌림) 또는 새 SysML v2 프로젝트.
- 보고서: 모든 v1 요소와 그 결과(변환됨, 근사 처리됨 또는 제외됨) 및 이유.
변환은 XMI로 교환된 모델에 충분한 세부 정보가 있는 경우 OMG SysML 2.0 명세의 SysML v1에서 SysML v2로의 변환을 따릅니다.
개념
변환됨, 근사 처리됨, 제외됨
v1 모델의 각 요소는 결과 하나를 받습니다.
- 변환됨: 요소에 직접 대응하는 SysML v2 요소가 있습니다. 예를 들어 블록은
part def가 됩니다. - 근사 처리됨: 요소가 바뀐 형태로 보존됩니다. 예를 들어 interface block으로 타입 지정된 full port는 port가 되고, choice pseudostate를 거치는 transition은 경로마다 transition 하나가 됩니다.
- 제외됨: SysML v2에 대응하는 것이 없거나, 요소가 파일에 없는 것을 가리킵니다. 예로 flow final node, activity partition, use case extension, instance specification이 있습니다.
보고서는 근사 처리되거나 제외된 모든 요소의 이유를 글로 제시합니다.
SysMLv1Library 패키지
블록의 isEncapsulated나 refine 관계처럼 일부 SysML v1 속성에는 SysML v2 키워드가 없습니다. 변환기는 이를 SysMLv1Library 패키지의 메타데이터로 보존합니다. 예: @SysMLv1Library::RefineData { isRefine = true; }. 이 패키지는 Holarch 라이브러리의 일부이므로 모든 SysML v2 프로젝트에서 이 이름이 확인됩니다.
불투명 본문은 텍스트 표현이 됩니다
Opaque behavior, opaque action, guard, constraint specification에는 OCL이나 영어 같은 언어로 된 텍스트가 들어 있습니다. 변환기는 각 본문을 텍스트 표현으로 보존합니다: language "OCL" /* … */. SysML 또는 KerML로 된 본문은 나머지 텍스트와 마찬가지로 검사됩니다. 텍스트 표현을 참조하십시오.
사용 방법
사용 시기와 이유
팀이 기존 SysML 1.x 모델을 SysML v2로 옮기거나 그 일부를 재사용하려 할 때 가져오기를 사용합니다. 변환된 텍스트는 출발점이며, 보고서가 직접 검토할 부분을 알려 줍니다.
SysML v1 모델을 프로젝트로 가져오기
- SysML v2 프로젝트를 열고 모델 → 가져오기 및 내보내기를 클릭합니다.
- 가져오기에서 이 프로젝트로 또는 새 SysML v2 프로젝트로를 선택합니다.
.xmi,.uml,.xml또는.mdzip파일을 상자에 끌어다 놓거나, 상자를 클릭해 선택합니다. XMI 파일 읽는 중…, SysML v2로 변환하는 중…, 결과 검사 중… 단계가 있는 진행 카드가 표시됩니다.- 미리 보기 상단의 SysML v1에서 변환을 읽습니다. 변환됨, 근사 처리됨, 제외됨인 요소의 수와 SysML v2 텍스트가 문제 없이 검사되는지가 표시됩니다.
- 표시를 사용해 근사 처리되거나 제외된 요소, 그중 하나만, 또는 모든 요소를 나열합니다. 각 행에는 요소, 그 SysML v1 종류, SysML v2 키워드와 정규화된 이름이 있는 결과, 그리고 이유가 표시됩니다.
- 가져오기 전에 결과를 읽으려면 SysML v2 텍스트 표시를 엽니다.
- 아래 표에서 원하지 않는 패키지의 체크를 해제한 후 N개 패키지 가져오기(또는 프로젝트 만들기)를 클릭합니다. 모델을 가져오며, 실행 취소 한 번으로 모두 되돌립니다. 실행 취소하면 다시 제거됩니다.
같은 모델의 새 버전 가져오기
SysML v1 모델이 바뀌면 다시 내보내고 새 파일을 같은 프로젝트로 가져옵니다(이 프로젝트로). 변환된 각 요소는 XMI 파일에 있는 요소의 id(xmi:id)에서 id를 가져오므로, 가져오기가 요소를 그 자리에서 업데이트합니다. SysML v1 도구에서 이름이 바뀌거나 다른 패키지로 이동한 요소도 다이어그램 레이아웃, 댓글, 연결, 기록과 함께 같은 요소로 남습니다. 보고서에 SysML v1 모델에서 id를 가져온 요소의 수가 표시됩니다. 이름이 없는 요소(커넥터, succession)는 모델 안의 위치로 일치시킵니다.
Holarch가 XMI 파일에서 id를 도출하기 전에 SysML v1 모델에서 가져온 프로젝트는 기존 id를 유지합니다. 새 내보내기는 이름으로 요소를 업데이트하며, SysML v1 모델에 새로 생긴 요소는 그 모델에서 id를 가져옵니다.
보고서와 텍스트 보관하기
- 모든 요소와 그 결과, SysML v2 경로, 이유가 담긴 CSV 파일을 받으려면 보고서 다운로드를 클릭합니다.
- 변환된
.sysml파일을 받으려면 SysML v2 텍스트 다운로드를 클릭합니다.
SysML v1 도구에서 모델 내보내기
- Cameo Systems Modeler와 MagicDraw:
.mdzip프로젝트를 직접 가져오거나, File → Export To → Eclipse UML2 (v5.x) XMI File을 사용한 후.xmi파일을 가져옵니다. - Enterprise Architect: 패키지를 선택하고 Publish → Export XML을 선택한 후 XMI 2.1을 선택하고
.xml파일을 가져옵니다. Enterprise Architect 프로젝트 파일(.eap,.qea)은 직접 읽을 수 없습니다. - IBM Rhapsody: XMI 툴킷(XMI 2.x)으로 모델을 내보낸 후 파일을 가져옵니다.
- Eclipse Papyrus: 모델의
.uml파일을 가져옵니다.
실습 예제: CubeSat EO-1 모델
CubeSat EO-1 데모는 LML 프로젝트입니다. 그 SysML v1 내보내기는 현실적인 테스트 모델이 됩니다.
- CubeSat EO-1 데모를 열고 OMG XMI 2.5.1 형식의 UML/SysML XMI로 내보냅니다(UML/SysML 모델 내보내기(XMI) 참조).
- SysML v2 프로젝트를 열고 모델 → 가져오기 및 내보내기를 클릭한 후 새 SysML v2 프로젝트로를 선택하고
.xmi파일을 끌어다 놓습니다. 보고서 내용: 요소 1,042개, 변환됨 1,007개, 근사 처리됨 32개, 제외됨 3개. SysML v2 텍스트는 문제 없이 검사됩니다. - 표시를 제외됨으로 설정합니다. 세 행은 SysML v2에 없는 use case extension 하나와, SysML v2 텍스트가 참조할 수 없는 이름 없는 요소로의 trace 관계 두 개입니다.
- 프로젝트 만들기를 클릭합니다. 새 SysML v2 프로젝트가 위성의 구조, 기능, 요구사항, 추적과 함께 편집기에서 열립니다.
팁과 흔한 실수
- XMI 파일은 한 번에 하나씩, 다른 파일 없이 가져옵니다. SysML v1 XMI 파일은 다른 파일 없이 한 번에 하나씩 가져오십시오.
- 추적 대상 요소에 이름을 붙입니다. SysML v2 텍스트는 이름으로 요소를 참조하므로 이름 없는 요소로의 관계는 제외됩니다.
- 다시 만들지 말고 다시 가져옵니다. 새 내보내기는 새 프로젝트가 아니라 같은 프로젝트로 가져옵니다. 요소는 해당 요소가 있는 프로젝트 안에서만 id를 유지합니다.
- 근사 처리를 먼저 확인합니다. 블록으로 타입 지정된 port나 파트 안의 커넥터 끝처럼, 의미가 v1 모델과 다를 수 있는 부분입니다.
- 한곳에 같은 이름을 가진 요소는
_2같은 접미사로 이름이 바뀝니다. 보고서에 각 이름 변경이 나열됩니다. - 요구사항 도구(DOORS, Polarion, Jama, codebeamer)에 보관된 요구사항은 XMI가 아니라 ReqIF로 옮겨집니다. 같은 페이지에서
.reqif파일을 가져옵니다. 같은 종류의 보고서와 함께 SysML v2 요구사항이 됩니다(ReqIF 요구사항 가져오기 및 내보내기).
변환되는 것
| SysML v1 | SysML v2 |
|---|---|
| 모델, 패키지 | package |
| 블록, 액터 | part def |
| 값 유형, 데이터 유형, 열거형 | attribute def, enum def(알려진 SI 단위가 있는 값 유형은 ISQ 양을 특수화함) |
| 시그널 | item def |
| 인터페이스 블록 | port def |
| 파트, 참조, 값 속성 | 다중성과 기본값이 있는 part, ref part, attribute |
| 프록시 포트, 흐름 속성 | port, in/out item 또는 attribute |
| 풀 포트 | @SysMLv1Library::PortData이(가) 있는 part |
| 커넥터, 바인딩 커넥터, 아이템 흐름 | connect, bind, flow |
| 일반화 | :> |
| 액티비티, 호출 동작 액션, 핀 | action def, action, 매개변수 |
| 제어 흐름과 객체 흐름, 가드 | if 가드와 else가 있는 succession, 매개변수 간 흐름 |
| 초기, 최종, 결정, 병합, 포크, 조인 | start, done, decide, merge, fork, join |
| 상태 머신, 상태, 영역 | state def, state, 병렬 상태 |
| 전이, 시그널 및 시간 트리거 | accept, accept after, 가드, 효과가 있는 transition |
| 인터랙션 | 생명선과 메시지가 있는 occurrence def |
| 유스케이스, 주체, include | use case def, subject, include |
| 요구사항(id와 텍스트) | requirement <'id'> Name { doc /* text */ } |
| Satisfy, verify, derive requirement | 검증 목표 안의 satisfy, verify, 파생 연결 |
| Refine, trace | SysMLv1Library 메타데이터가 있는 dependency |
| Allocate, dependency | allocate, dependency |
| 제약 블록, 제약 | constraint def, assert constraint |
| 스테레오타입과 태그 값 | 스테레오타입마다 metadata def 하나, 태그와 함께 적용됨 |
| 주석, 문서화 | doc, comment |
제한 사항
- 최대 64 MB의 파일 하나.
- 최대 250,000개 요소, 최대 512단계 중첩. 더 깊게 중첩되었거나 소유 순환이 있는 모델은 가져오지 않습니다.
- 변환된 모델에서 128단계보다 깊게 중첩된 요소는 중첩이라는 이유로 제외됩니다.
- 변환된 텍스트는 최대 8 MB입니다.
- 다이어그램과 그 레이아웃은 변환되지 않습니다. SysML v2 프로젝트에서 뷰를 만듭니다.
메시지
| 메시지 | 할 일 |
|---|---|
| SysML v1 XMI 파일은 다른 파일 없이 한 번에 하나씩 가져오십시오. | XMI 파일만 단독으로 가져옵니다. |
| <file>에 UML 또는 SysML 요소가 없습니다. 모델을 XMI 2.x로 내보낸 후 다시 가져오십시오. | 모델을 XMI 2.x로 다시 내보냅니다. |
| <file>에서 UML 모델을 찾지 못했습니다. Cameo 또는 MagicDraw에서 모델을 Eclipse UML2 XMI로 내보낸 후 .xmi 파일을 가져오십시오. | 프로젝트를 XMI로 내보냅니다. |
| SysML v1 모델의 요소가 250,000개를 넘습니다. 모델의 더 작은 부분을 내보내십시오. | 패키지를 한 번에 하나씩 내보냅니다. |
| 변환된 SysML v2 텍스트가 8 MB보다 커집니다. 모델의 더 작은 부분을 내보내십시오. | 패키지를 한 번에 하나씩 내보냅니다. |
관련 페이지
- SysML v2 모델 교환
- ReqIF 요구사항 가져오기 및 내보내기: DOORS, Polarion 및 기타 요구사항 도구의 요구사항.
- SysML v2 텍스트 표기법
- LML과 SysML v2 간 변환
SysML® 및 OMG®는 미국 및 기타 국가에서 Object Management Group, Inc.의 등록 상표입니다.