SysML v1에서 SysML v2로
SysML v1 모델을 다시 그리지 않고 SysML v2로 옮기십시오.
XMI(.xmi, .xml, .uml) 또는 .mdzip 프로젝트 아카이브로 저장한 SysML v1 모델을 SysML v2 프로젝트에 놓습니다. Holarch가 SysML v2 텍스트로 변환하고, 텍스트를 검사하며, 무엇이든 가져오기 전에 모든 요소를 변환됨, 근사 처리됨, 제외됨으로 이유와 함께 보고합니다.
변환기는 Free를 포함한 모든 요금제에 포함됩니다. 새 계정은 첫 로그인 시 30일 Individual 체험판을 시작합니다. 프로젝트당 항목 10,000개, 카드 불필요, 끝나면 Free로 돌아갑니다. 계정이 있으십니까? 체험판을 시작하십시오.
증거: CubeSat EO-1 모델
| 결과 | 요소 |
|---|---|
| 변환됨 | 1,007 |
| 근사 처리됨 | 32 |
| 제외됨 | 3 |
| 읽은 요소 | 1,042 |
| SysML v2 텍스트의 문제 | 0 |
변환된 텍스트는 오류와 경고 없이 검사를 통과하며, 같은 모델은 매번 같은 텍스트로 변환됩니다. 근사 처리되고 제외된 것
SysML v1 모델 가져오기
SysML v1 모델의 XMI 파일이나 .mdzip 프로젝트를 SysML v2 프로젝트로 가져옵니다. 무엇이든 만들어지기 전에 변환 보고서가 모든 요소를 변환됨, 근사 처리됨, 제외됨으로 이유와 함께 나열하며, CSV 파일로 저장됩니다. 예제는 CubeSat EO-1 모델로, 요소 1,042개가 문제 없이 가져와졌습니다.
변환기로 얻는 것
작업할 수 있는 SysML v2 모델과, 검토할 항목의 명확한 목록.
다시 그리지 않음
블록은 part def가 되고, 포트, 커넥터, 아이템 흐름이 옮겨지며, 요구사항은 ID와 텍스트를 유지하고, satisfy, verify, allocate 관계는 계속 추적됩니다.
모든 요소에 대한 보고서
v1 모델의 각 요소가 v1 종류, 결과, 변환된 SysML v2 이름과 함께 나열되며, 근사 처리되거나 제외된 요소에는 이유가 문장으로 제시됩니다. 화면에서 필터링하거나 CSV로 다운로드할 수 있습니다.
가져오기 전에 검사
입력하는 동안 SysML v2 편집기를 검사하는 엔진이 변환된 텍스트를 검사합니다. 결과, 텍스트, 보고서를 먼저 확인하며, 가져오기는 실행 취소 한 단계입니다.
v1 모델이 바뀌면 다시 가져오기
요소는 v1 모델의 XMI ID에서 ID를 가져옵니다. 더 새로운 내보내기를 같은 프로젝트로 가져오면, 이름이 바뀌거나 이동된 요소도 다이어그램 레이아웃, 댓글, 링크, 기록과 함께 그 자리에서 업데이트됩니다.
작업할 수 있는 모델
편집기, 뷰, 요구사항, 검증 및 SysML v2 프로젝트의 다른 페이지가 변환된 모델을 다른 모델처럼 읽습니다.
v1 모델은 그대로 유지됩니다
Holarch는 v1 모델의 내보내기를 읽을 뿐 다시 쓰지 않으므로, 팀이 SysML v2 버전을 검토하는 동안 v1 모델이 기준으로 남습니다.
작동 방식
- 파일을 놓습니다. SysML v2 프로젝트에서 모델 → 가져오기 및 내보내기를 클릭하고, 이 프로젝트로 또는 새 SysML v2 프로젝트로를 선택한 다음
.mdzip,.xmi,.uml또는.xml파일을 놓습니다. 진행 카드에 읽기, 변환, 검사 단계가 표시됩니다. - 보고서를 검토합니다. SysML v1에서 변환은 개수와 텍스트가 문제 없이 검사되는지 여부를 알려 주고, 근사 처리되고 제외된 요소를 각각의 이유와 함께 나열합니다. SysML v2 텍스트 표시는 결과를 엽니다. 보관하려면 보고서나
.sysml파일을 다운로드하십시오. - 가져옵니다. 원하지 않는 패키지를 선택 해제하고 가져옵니다. 실행 취소 한 번으로 가져오기 전체를 다시 제거합니다.
도구별 내보내기 설정을 포함한 단계별 안내: Docs의 SysML v1 모델 가져오기, 그리고 프로그램 전체의 전환을 계획하기 위한 마이그레이션 가이드.
변환된 블록
part def Rover {
@SysMLv1Library::BlockData { isEncapsulated = true; }
part battery : Battery;
part computer : Computer;
attribute 'power budget' : Types::Power = 120 [SI::W];
connection 'power bus' connect battery.'out' to computer.'in';
satisfy Requirements::'Power Margin' by battery;
flow 'power flow' of Types::Charge from battery.'out' to computer.'in';
}파트 두 개, 와트 단위의 값 속성, 아이템 흐름이 있는 프록시 포트 간 커넥터, satisfy 관계를 가진 캡슐화된 블록에 대한 변환기 출력. 마이그레이션 가이드에 작은 모델 전체의 변환 전후가 나와 있습니다.
읽는 형식
- XMI 2.x 형식의 SysML v1: SysML 1.x 프로필을 사용하는 UML 2.5.
.xmi: XMI 파일..xml:.xml확장자로 저장된 XMI..uml: XMI 모델 파일..mdzip: 모델을 XMI로 담고 있는 압축된 프로젝트 아카이브. Holarch는 그 안의 XMI를 읽습니다.- 기타 프로젝트 형식: 모델을 자체 프로젝트 형식으로 보관하는 도구는 먼저 모델을 XMI로 내보냅니다.
가져오기당 파일 하나, 최대 64 MB, 요소 250,000개, 중첩 512단계.
결과물
- 열린 프로젝트나 새 SysML v2 프로젝트에 실행 취소 한 단계로 가져오는 SysML v2 텍스트.
- 가져오기 전에 표시되는 텍스트 검사.
- 모든 요소에 대한 변환 보고서로, 화면에서 필터링하고 CSV로 다운로드할 수 있습니다.
- 검토하거나 다른 SysML v2 도구에서 쓸 수 있도록 다운로드하는
.sysml파일.
변환은 OMG SysML 2.0 사양의 SysML v1→SysML v2 변환을 바탕으로 합니다.
변환됨, 근사 처리됨 또는 제외됨
v1 모델의 모든 요소는 세 가지 결과 중 하나를 받으므로, 어디를 봐야 할지 정확히 알 수 있습니다.
변환됨
요소에 직접 대응하는 SysML v2 요소가 있습니다. 블록은 part def가 되고, 인터페이스 블록은 port def가 되며, 요구사항은 ID와 텍스트를 유지합니다.
근사 처리됨
요소가 형태가 바뀐 채로 유지됩니다. 인터페이스 블록으로 타입이 지정된 full port는 포트가 되고, choice를 거치는 전이는 경로마다 하나의 전이가 되며, 대응되는 SI 단위가 아닌 단위는 문서에 단위가 적힌 실수가 됩니다.
제외됨
SysML v2에 대응 요소가 없거나, 요소가 파일에 없는 것을 가리킵니다. 예로는 flow final 노드, 활동 파티션, 유스케이스 extension, 이름 없는 요소에 대한 관계가 있습니다.
캡슐화된 블록, full port, refine 관계처럼 SysML v2 키워드가 없는 SysML v1 속성은 Holarch가 모든 SysML v2 프로젝트에 로드하는 SysMLv1Library 패키지의 메타데이터로 보관됩니다. 자체 스테레오타입은 태그 값이 있는 메타데이터 정의가 되며, opaque 동작, 가드, 제약 조건은 language "OCL" /* … */ 같은 텍스트 표현으로 본문을 유지합니다.
무엇이 무엇으로 변환되는가
주요 매핑입니다. Docs에 전체 목록이 있습니다.
| SysML v1 | SysML v2 |
|---|---|
| 패키지 | package, v1과 같이 중첩됨 |
| 블록, 액터 | part def |
| 값 타입, 열거형 | attribute def, enum def. 알려진 SI 단위가 있는 값 타입은 ISQ 수량을 특수화합니다 |
| 파트, 참조, 값 속성 | 다중성과 기본값이 있는 part, ref part, attribute |
| 인터페이스 블록, 프록시 포트, 흐름 속성 | port def, port, 방향이 있는 item 또는 attribute |
| 커넥터, 바인딩 커넥터, 아이템 흐름 | connect, bind, flow |
| 활동, 액션, 제어 및 객체 흐름 | action def, 액션, 가드가 있는 후속 관계, 매개변수 간 흐름 |
| 상태 머신, 상태, 전이 | state def, 상태, accept, 가드, 효과가 있는 전이 |
| 요구사항, satisfy, verify, derive | ID와 텍스트가 있는 requirement, satisfy, verify, 도출 연결 |
| Allocate, refine, trace | allocate. SysMLv1Library 메타데이터가 있는 dependency |
| 유스케이스, 인터랙션, 제약 블록 | use case def, 메시지가 있는 occurrence def, constraint def |
| 스테레오타입과 태그 값 | 스테레오타입마다 metadata def 하나, 태그와 함께 적용됨 |
실습 예제: CubeSat EO-1 모델
SysML 1.6 XMI로 내보내 새 SysML v2 프로젝트로 가져온 CubeSat EO-1 데모: 읽은 요소 1,042개, 변환됨 1,007개, 근사 처리됨 32개, 제외됨 3개. SysML v2 텍스트는 오류와 경고 없이 검사를 통과하며, 새 프로젝트는 위성의 구조, 기능, 요구사항, 추적과 함께 열립니다. 근사 처리되고 제외된 모든 요소를 이유별로 정리했습니다.
| 요소 | 결과 | 사유 |
|---|---|---|
| 커넥터 10개 | 근사 처리됨 | 커넥터 끝이 파트 안에 있으며, 그 경로는 파트 타입에서 산출되었습니다. |
| 전이 8개 | 근사 처리됨 | when Undervoltage 같은 변경 및 시간 트리거 4개는 문서로 보관되었고, Contact Start 같은 신호 없는 이벤트 4개는 같은 이름의 아이템 정의를 받았습니다. |
| 아이템 흐름 6개 | 근사 처리됨 | 같은 위치에서 이름이 두 번 사용되어 흐름 이름에 접미사를 붙였습니다. |
| 값 타입 5개 | 근사 처리됨 | 단위(%, GB, Mbps, mNms, W/m^2)가 Holarch가 대응시키는 SI 단위가 아니므로, 값 타입은 문서에 단위가 적힌 실수가 됩니다. |
| 제어 흐름 2개 | 근사 처리됨 | 가드가 있는 분기 옆에 가드 없는 분기가 있어 가드 true를 부여했습니다. |
| 최종 상태 1개 | 근사 처리됨 | 최종 상태가 일반 상태가 되었습니다. |
| 유스케이스 extension 1개 | 제외됨 | SysML v2에는 유스케이스 extension이 없습니다. |
| trace 관계 2개 | 제외됨 | SysML v2 텍스트가 참조할 수 없는 이름 없는 요소를 가리킵니다. |
EO-1 파일은 Holarch 자체의 SysML 1.6 내보내기이므로 Holarch가 기록하는 SysML v1 부분을 사용합니다. 다른 도구의 모델은 대개 언어를 더 많이 사용하므로 수치가 다를 것입니다. 중요한 기준은 자신의 모델에 대한 보고서이며, 무엇이든 가져오기 전에 확인할 수 있습니다. 여러 SysML v1 도구의 XMI 형식으로 작성된 Holarch 테스트 모델도 문제 없이 검사되는 텍스트로 변환되며, 같은 모델은 매번 같은 텍스트로 변환됩니다.
자주 묻는 질문
변환에서 무엇이 손실됩니까?
다이어그램과 그 레이아웃은 변환되지 않습니다. 중요한 다이어그램은 SysML v2 프로젝트에서 뷰로 만드십시오. 유스케이스 extension, flow final 노드, 활동 파티션처럼 SysML v2에 대응 요소가 없는 요소는 제외되며, 이름 없는 요소에 대한 관계도 제외됩니다. SysML v2 텍스트는 이름으로 요소를 참조하기 때문입니다(내보내기 전에 추적 대상 요소에 이름을 지정하십시오). 근사 처리된 요소는 형태가 바뀐 채로 유지됩니다. 의미가 v1 모델과 다를 수 있는 곳이므로 먼저 검토하십시오. 보고서는 그 모든 요소를 이유와 함께 명시합니다.
변환된 모델은 바로 사용할 수 있습니까?
문제 없이 검사되며 SysML v2 프로젝트의 모든 페이지에서 작동하지만, 출발점으로 다루십시오. 일부 두 언어의 차이는 번역뿐 아니라 모델링 결정이 필요합니다. SysML v2 프로젝트가 지원하는 것과 알려진 빈틈: SysML v2 언어 지원 범위.
얼마나 큰 모델을 변환할 수 있습니까?
최대 64 MB의 파일 하나, 최대 512단계로 중첩된 최대 250,000개 요소, 최대 8 MB의 변환된 텍스트입니다. 더 큰 모델은 패키지 단위로 내보내십시오. 변환된 모델에는 요금제의 프로젝트당 항목 수가 적용됩니다. Free는 1,000개, Individual은 10,000개, Team은 50,000개입니다. 항목으로 계산되는 것을 참조하십시오. 항목이 10,000개를 넘는 모델은 Team 평가를 요청하십시오.
SysML v1 도구에서 계속 작업할 수 있습니까?
예. Holarch는 내보내기를 읽을 뿐 v1 모델을 변경하지 않습니다. v1 모델이 바뀌면 다시 내보내고 새 파일을 같은 프로젝트로 가져오십시오. 요소는 XMI 파일에서 ID를 가져오므로, 이름을 바꾸거나 이동한 후에도 그 자리에서 업데이트됩니다. 한 위치에서 이름이 같은 요소는 _2 같은 접미사로 이름이 바뀌며, 보고서에 각 이름 변경이 나열됩니다.
파일은 어디로 갑니까?
Holarch는 XMI 또는 .mdzip 파일을 브라우저에서 읽고 변환하며, 파일 자체는 업로드되지 않습니다. app.holarch.app에서는 미리 보기를 준비하기 위해 변환된 SysML v2 텍스트가 Holarch로 전송되며, 가져오기를 할 때만 프로젝트에 저장됩니다. 호스팅 서비스는 CUI나 수출 통제 자료를 받지 않습니다. 이러한 자료에는 Holarch를 자체 환경에서 실행합니다(Enterprise). 자세한 내용은 보안을 참조하십시오.
요구사항 관리 도구에 보관된 요구사항은 어떻게 됩니까?
요구사항은 표준 요구사항 교환 형식인 ReqIF(.reqif, .reqifz)로 옮겨집니다. Holarch는 LML 및 SysML v2 프로젝트에서 ReqIF를 가져오고 내보냅니다. SysML v2 프로젝트에서 ReqIF 파일은 무엇이 변환되었는지에 대한 보고서와 함께 요구사항, 요구사항 정의, 패키지가 되며, 요구사항은 원래 식별자와 함께 다시 내보내집니다. CubeSat EO-1 데모를 Holarch에서 ReqIF로, 다시 Holarch로 왕복 변환했을 때 407개 항목과 979개 속성 값이 모두 그대로 돌아왔습니다. LML 프로젝트의 ReqIF · SysML v2 프로젝트의 ReqIF
변환기의 비용은 얼마입니까?
추가 비용은 없습니다. 변환기는 Free를 포함한 모든 요금제에 포함됩니다. 요금제는 프로젝트당 항목 수와 모델링 이외에 포함되는 기능이 다릅니다. 요금제를 참조하십시오.
자체 도구에 마이그레이션 기능을 구축하고 계십니까?
변환기는 Holarch의 SysML v2 프로젝트를 구동하는 엔진인 Holarch Language Engine의 일부이며, 도구 공급업체와 통합업체에 마이그레이션 애드온으로 라이선스됩니다. Holarch에서 실행되는 것과 같은 변환기입니다.
- 제품이 XMI 파일을 읽고, 엔진이 변환합니다. v1 모델을 문서화된 중립 형식의 JSON으로 보내면, SysML v2 텍스트, 엔진의 텍스트 검사 결과, 그리고 안정적인 사유 코드와 변환된 SysML v2 이름이 담긴 모든 요소에 대한 보고서를 JSON으로 받습니다.
- 제품이 실행되는 곳에서 실행됩니다: 브라우저에서는 Web Worker 안의 WebAssembly로, 서버에서는 서버 사용 애드온과 함께 Node.js 또는 Python 확장으로 실행됩니다.
- 반복 가능하고 한계가 정해져 있습니다: 같은 모델은 매번 같은 텍스트로 변환됩니다. 최대 250,000개 요소의 모델을 처리하며, 더 큰 모델에는 멈추지 않고 오류 응답을 반환합니다.
- 라이선스 토큰으로 활성화됩니다. 다시 빌드하거나 코드를 변경할 필요가 없습니다. 60일 무료 평가판은 문서 및 예제와 함께 자신의 컴퓨터에서 실행됩니다.
요청과 응답
// Request (the model shortened)
{ "op": "v1_convert",
"model": { "format": "holarch-xmi-model", … } }
// Answer (shortened)
{ "text": "package 'Rover Model' { … }",
"diagnostics": [],
"report": {
"summary": { "elements": 31, "converted": 27,
"approximated": 2, "dropped": 2 },
"items": [ { "kind": "Association",
"status": "dropped",
"reason": "association" }, … ] } }
엔진 API 참조의 v1_convert 요청. 엔진은 시뮬레이션과 서버 사용도 애드온으로 제공합니다.
자신의 모델을 SysML v2로 확인하십시오.
변환하고, 보고서를 읽고, 만족할 때만 가져오십시오.
새 계정은 첫 로그인 시 30일 Individual 체험판을 시작합니다. 프로젝트당 항목 10,000개, 카드 불필요, 끝나면 Free로 돌아갑니다. 계정이 있으십니까? 계정 설정 → 요금제 및 결제에서 체험판을 시작하십시오.