Holarch

가이드 · SysML v2

SysML v1 모델을 SysML v2로 옮기기: 단계별 마이그레이션

SysML v1 모델은 SysML v2로 자동 변환할 수 있지만, 마이그레이션은 파일 변환 이상입니다. 누군가는 변환된 모델이 어떤 모습이어야 할지 결정하고, 그것이 여전히 v1 모델이 말하던 것을 말하는지 확인해야 합니다. 이 가이드는 v1 모델 현황 파악부터 전환까지 여덟 단계의 마이그레이션을 설명하며, 작은 모델을 변환해 한 줄씩 읽어 봅니다.

이 페이지의 내용
  1. 시작하기 전에: 업그레이드가 아니라 번역
  2. 1. v1 모델 현황 파악
  3. 2. SysML v1 도구에서 모델 내보내기
  4. 3. 시범 패키지 변환
  5. 4. 변환 보고서 읽기
  6. 실습 예제: 작은 로버 모델
  7. 5. 근사 처리되거나 제외된 것 재작업
  8. 6. 중요한 뷰 다시 만들기
  9. 7. v2 모델 검사와 검토
  10. 8. 나머지 변환과 전환
  11. 마이그레이션 체크리스트
  12. 다음에 읽을 내용

시작하기 전에: 업그레이드가 아니라 번역

SysML v2는 SysML v1 파일 형식의 새 버전이 아니라 새로운 언어입니다. 블록은 파트 정의가 되고, 포트는 포트 정의로 타입이 지정되며, 요구사항은 조건을 담고, 다이어그램은 모델이 정의하는 뷰가 됩니다. SysML v1과 v2 비교가 차이를 하나씩 설명합니다.

변환기는 기계적인 부분을 처리합니다. SysML v2에 대응 요소가 있는 모든 요소는 SysML v2로 작성되고, 나머지는 보고됩니다. 변환기가 할 수 없는 것은 팀이 새 언어를 어떻게 쓰고 싶은지 결정하는 일입니다. 마이그레이션은 담당자, 검토, 그리고 v2 모델이 기준이 되는 시점이 있는 모델링 작업으로 계획하십시오.

이 가이드는 Holarch의 변환기를 사용합니다. 이 변환기는 SysML 1.x 모델을 SysML v2 프로젝트로 가져오고 모든 요소를 변환됨, 근사 처리됨, 제외됨으로 보고합니다. 계획 단계는 어떤 변환기를 쓰든 적용됩니다.

1. v1 모델 현황 파악

무엇이든 내보내기 전에 모델에 무엇이 있고 누가 그것에 의존하는지 파악합니다. 짧은 목록이 나중의 재작업을 줄여 줍니다.

  • 패키지와 담당자. 최상위 패키지, 각각의 관리자, 그리고 다른 모델이나 문서가 참조하는 패키지를 나열합니다. 패키지는 변환하고 검토하는 단위입니다.
  • 중요한 다이어그램. 사람들이 실제로 검토와 문서에 쓰는 다이어그램을 적어 둡니다. 다이어그램 레이아웃은 SysML v2로 넘어가지 않으므로, 이것들은 다시 만들 뷰가 됩니다.
  • 프로필과 스테레오타입. 자체 스테레오타입과 그 태그 값을 나열합니다. 이것들은 메타데이터 정의가 되며, 새 모델에서의 의미를 다시 합의해야 합니다.
  • 코드로 작성된 동작. OCL, 액션 언어, 도구의 스크립트로 작성된 불투명 동작, 가드, 제약 조건은 원래 언어의 텍스트로 보관되며 번역되지 않습니다.
  • 이름 없는 요소. SysML v2 텍스트는 이름으로 요소를 참조하므로, 이름 없는 요소를 가리키는 관계는 SysML v2 텍스트로 쓸 수 없습니다. 추적 대상인 요소에 지금 v1 도구에서 이름을 붙이십시오.
  • 크기. Holarch는 한 번에 최대 64 MB, 요소 250,000개의 파일 하나를 변환합니다. 더 큰 모델은 패키지 하나씩 내보냅니다.

2. SysML v1 도구에서 모델 내보내기

변환기는 SysML v1 도구가 쓰는 교환 형식인 XMI에서 모델을 읽습니다. 도구마다 내보내는 방식이 조금씩 다릅니다.

도구가져올 것
Cameo Systems Modeler, MagicDraw.mdzip 프로젝트 파일, 또는 File → Export To → Eclipse UML2 (v5.x) XMI File로 만든 .xmi 파일
Enterprise Architect패키지를 선택하고 Publish → Export XML에서 XMI 2.1을 선택한 다음 .xml 파일을 가져옵니다. 프로젝트 파일(.eap, .qea)은 직접 읽지 않습니다.
IBM RhapsodyXMI 툴킷의 XMI 2.x 내보내기
Eclipse Papyrus모델의 .uml 파일

내보낸 파일은 마이그레이션 기록과 함께 보관하십시오. 검토가 참조하는 정확한 v1 입력입니다.

3. 시범 패키지 변환

대표성은 있지만 가장 크지는 않은 패키지 하나로 시작합니다. 구조, 인터페이스, 약간의 동작, 그리고 요구사항이 있는 하위 시스템입니다. 시범 변환은 팀 전체가 투입되기 전에 모델의 변환 결과가 어떤 모습인지 보여 줍니다.

  1. SysML v2 프로젝트를 만들거나 변환된 모델이 들어갈 프로젝트를 열고 모델 → 가져오기 및 내보내기를 클릭합니다.
  2. 가져오기 아래에서 시범 변환에는 새 SysML v2 프로젝트로를 선택하여 다른 것은 건드리지 않게 합니다.
  3. 내보낸 파일을 상자에 놓습니다. 진행률 카드가 단계를 보여 줍니다. XMI 파일 읽기, SysML v2로 변환, 결과 검사입니다.

아직 아무것도 가져오지 않았습니다. 다음 화면은 변환 보고서가 있는 미리 보기입니다.

4. 변환 보고서 읽기

미리 보기 상단의 SysML v1에서 변환은 변환됨, 근사 처리됨, 제외됨 요소의 수와 SysML v2 텍스트가 문제없이 검사를 통과하는지를 보여 줍니다. v1 모델의 모든 요소에는 결과가 하나씩 있습니다.

  • 변환됨: 요소에 직접 대응하는 SysML v2 요소가 있습니다. 예를 들어 블록은 part def가 됩니다.
  • 근사 처리됨: 요소가 형태가 바뀐 채로 유지됩니다. 예를 들어 choice를 거치는 전이는 경로마다 하나의 전이가 됩니다. 이런 곳은 의미가 v1 모델과 다를 수 있습니다.
  • 제외됨: SysML v2에 대응 요소가 없거나, 요소가 파일에 없는 것을 가리킵니다.

표시를 사용하여 근사 처리되거나 제외된 요소를 나열합니다. 각 행에는 요소, 그 SysML v1 종류, SysML v2 이름과 함께 무엇이 되었는지, 그리고 이유가 있습니다. SysML v2 텍스트 표시를 열어 결과를 읽고, 보고서 다운로드를 클릭하여 보고서를 CSV 파일로 보관합니다. CSV는 5단계의 작업 목록입니다. 이유별로 정렬하고 각 그룹에 담당자를 지정하십시오.

실습 예제: 작은 로버 모델

행성 탐사 로버의 전력 경로를 담은 작은 SysML v1 모델이며, 패키지 세 개로 되어 있습니다.

패키지SysML v1 요소
타입단위가 W인 값 타입 Power, 블록 Charge, 나가는 흐름 속성 두 개 charge(Charge)와 voltage(Real)가 있는 인터페이스 블록 Power Interface
구조파트 속성 battery와 computer, 120 W의 값 속성 power budget, 그 포트들 사이의 커넥터 power bus, 그 위의 Charge 아이템 흐름 power flow가 있는 캡슐화된 블록 Rover. 프록시 포트 out이 있는 블록 Battery, 켤레 프록시 포트 in과 full port raw가 있는 블록 Computer. 둘 다 태그 값이 있는 사용자 스테레오타입 «Hardware»를 가집니다. 끝을 연관 자체가 소유하는 연관 하나.
요구사항요구사항 R-1 Mission과 R-2 Power Margin. R-2는 R-1에서 파생되고, R-2는 battery 파트로 충족되며, Computer에서 Battery로의 trace가 있습니다

변환하면 다음과 같습니다. 목록은 변환기의 출력 그대로입니다.

package 'Rover Model' {
  package Types {
    attribute def Power :> ISQ::PowerValue;
    part def Charge;
    port def 'Power Interface' {
      out item charge : Charge;
      out attribute voltage : ScalarValues::Real;
    }
  }
  package Structure {
    part def Rover {
      doc /* Six-wheeled science 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';
    }
    part def Battery {
      @'SysML v1 Profiles'::rov::Hardware { qualified = "true"; vendor = "Acme Cells"; }
      port 'out' : Types::'Power Interface';
      attribute capacity : Types::Power;
    }
    part def Computer {
      @'SysML v1 Profiles'::rov::Hardware { vendor = "Orbital Logic"; }
      port 'in' : ~Types::'Power Interface';
      part raw : Types::Charge {
        @SysMLv1Library::PortData { isFullPort = true; }
      }
    }
  }
  package Requirements {
    requirement <'R-1'> Mission {
      doc /* The rover shall explore the landing site. */
    }
    requirement <'R-2'> 'Power Margin' {
      doc /* Keep a 50 % power margin. */
    }
    connection : DerivationConnections::Derivation connect 'Power Margin' to Mission;
    dependency from Structure::Computer to Structure::Battery {
      @SysMLv1Library::TraceData { isTrace = true; }
    }
  }
}

package 'SysML v1 Profiles' {
  package rov {
    metadata def Hardware {
      attribute qualified : ScalarValues::String;
      attribute vendor : ScalarValues::String;
    }
  }
}

v1 모델의 각 부분에 일어난 일:

  • 단위가 있는 값 타입. 와트 단위의 Power는 표준 라이브러리의 ISQ::PowerValue를 특수화하고, 기본값은 단위와 함께 120 [SI::W]로 작성됩니다. 단위가 대응되는 SI 단위가 아닌 값 타입은 단위를 문서에 적은 실수로 남고, 근사 처리됨으로 보고됩니다.
  • 블록과 속성. 블록은 part def가 되고 파트 속성은 part가 됩니다. 블록의 isEncapsulated에는 SysML v2 키워드가 없으므로 SysMLv1Library::BlockData 메타데이터로 보관됩니다.
  • 인터페이스 블록과 포트. 인터페이스 블록은 port def가 되고, 그 흐름 속성은 방향이 있는 피처가 됩니다. 블록 타입은 out item, 값은 out attribute입니다. 켤레 프록시 포트는 ~Types::'Power Interface'로 타입이 지정됩니다. SysML v2 포트는 포트 정의로 타입이 지정되므로, full port는 SysMLv1Library::PortData 메타데이터가 있는 파트가 됩니다.
  • 커넥터와 아이템 흐름. 커넥터는 두 포트 사이의 connection이 되고, 그 위의 아이템 흐름은 같은 포트 사이의 Charge flow가 됩니다.
  • 요구사항. 각 요구사항은 ID를 짧은 이름 <'R-1'>로, 텍스트를 doc로 유지합니다. satisfy 관계는 충족하는 파트를 소유한 블록 안에 있고, derive 관계는 파생 연결이 되며, trace는 SysMLv1Library::TraceData가 있는 의존 관계가 됩니다.
  • 사용자 스테레오타입. «Hardware»는 패키지 'SysML v1 Profiles' 안의 metadata def가 되어 태그 값과 함께 각 블록에 적용됩니다. 두 적용은 근사 처리됨으로 보고됩니다. 태그 값은 프로필에서의 타입과 관계없이 텍스트 속성이 되었습니다.
  • 연관. 클래스가 없는 연관은 여기서 SysML v2 대응 요소가 없고, 연관이 소유한 끝도 변환되지 않습니다. 둘 다 제외됨으로 보고되며, 블록의 속성이 구조를 담습니다.

이 모델의 보고서: 요소 31개, 변환됨 27개, 근사 처리됨 2개, 제외됨 2개이며, 텍스트는 오류와 경고 없이 검사를 통과합니다. 'power budget'이나 'out'(SysML v2 키워드)처럼 일반 식별자가 아닌 이름은 v1 철자를 유지하도록 따옴표로 묶입니다.

5. 근사 처리되거나 제외된 것 재작업

보고서의 근사 처리됨 및 제외됨 행을 이유별로 검토합니다. 대부분의 이유는 몇 가지 결정 중 하나를 요구합니다.

보고서 내용결정할 것
포트가 인터페이스 블록이 아닌 블록으로 타입이 지정되어 있어, 타입 없는 포트가 됨경계를 넘는 피처로 포트 정의를 만들고 포트의 타입으로 지정합니다.
choice, junction, fork 또는 join을 거치는 전이. 경로마다 하나의 전이가 됨합쳐진 가드가 여전히 v1 다이어그램의 의도를 말하는지 확인합니다. 경로가 이제 더 읽기 쉬워진 곳은 단순화합니다.
트리거가 문서로 보관됨의미가 분명한 곳에서는 변경 및 시간 트리거를 기간에 대한 accept after 같은 SysML v2 트리거로 다시 씁니다.
단위가 Holarch가 대응시키는 SI 단위가 아니어서 값 타입이 실수가 됨표준 수량이 맞는지 결정하거나, 실수와 문서에 적힌 단위를 유지합니다.
call, opaque, accept 액션 이외의 액션 종류가 일반 액션이 됨send 및 기타 특정 액션을 같은 일을 하는 SysML v2 액션으로 다시 씁니다.
활동 파티션이 변환되지 않음스윔레인 대신 파트 안의 perform으로 어느 파트가 무엇을 하는지 말합니다.
이름 없는 요소를 가리킴v1 도구에서 대상에 이름을 붙이고 다시 변환하거나, v2 모델에서 관계를 추가합니다.
같은 위치에서 이름이 두 번 사용되어 접미사를 붙여 이름을 바꿈각 요소에 그것이 무엇인지 말해 주는 이름을 붙입니다.
태그 값이 메타데이터의 텍스트 속성이 됨메타데이터 속성에 필요한 타입을 지정하고, 각 스테레오타입이 이제 무엇을 뜻하는지 합의합니다.

깔끔하게 변환되었더라도 두 종류의 텍스트는 살펴볼 필요가 있습니다. 불투명 본문은 language "OCL" /* … */처럼 원래 언어의 텍스트 표현으로 보관됩니다. Holarch는 SysML이나 KerML로 작성된 본문만 검사하므로, 모델이 평가해야 하는 가드나 제약 조건은 SysML 식으로 다시 쓰십시오. 그리고 직역은 값을 설정하려고만 만든 속성별 타입 같은 v1의 우회 방법을 그대로 유지합니다. SysML v2에서 이런 것은 사용에 대한 단순한 재정의입니다. 다시 생각해야 할 것에 흔한 경우가 나열되어 있습니다.

6. 중요한 뷰 다시 만들기

다이어그램과 그 레이아웃은 변환되지 않습니다. 1단계의 다이어그램 목록을 가져와 여전히 필요한 것마다 뷰를 만듭니다. 구조와 요구사항에는 일반 뷰, 파트와 연결에는 상호 연결 뷰, 활동에는 액션 흐름 뷰, 상태 머신에는 상태 전이 뷰입니다. 사람들이 쓰는 것만 다시 만드십시오. 나머지는 어차피 모델이 모두 담고 있습니다. 뷰 참조를 참조하십시오.

7. v2 모델 검사와 검토

  • 텍스트가 깔끔하게 검사를 통과합니다. 가져오기는 무엇이든 바뀌기 전에 변환된 텍스트의 검사 결과를 보여 줍니다. 재작업 후에는 편집기가 입력하는 동안 새로운 문제를 표시합니다.
  • 개수가 일치합니다. v1 모델과 v2 모델 사이에서 몇 가지 수를 비교합니다. 요구사항, 파트, 포트, 연결, 검증 관계입니다. 보고서로 설명할 수 없는 차이는 살펴볼 가치가 있습니다.
  • 모델을 사용하는 사람들이 검토합니다. 근사 처리된 요소와 다시 만든 뷰부터 시작하여 담당자와 함께 시범 패키지를 훑어봅니다.
  • 결정을 기록합니다. 포트, 트리거, 단위, 스테레오타입에 대해 정한 모델링 패턴을 적어 두어, 나머지 마이그레이션이 이를 따르게 합니다.

8. 나머지 변환과 전환

남은 패키지를 하나씩 같은 SysML v2 프로젝트로 변환합니다. 가져올 때마다 같은 미리 보기가 나옵니다. 프로젝트에 이미 있는 패키지는 변경됨 또는 변경 없음으로, 새 패키지는 새로 만듦으로 표시되며, 가져올 패키지를 선택합니다. 각 가져오기는 실행 취소 한 단계입니다.

v2 모델이 검토될 때까지 v1 모델을 기준으로 유지한 다음, v1 모델을 동결하고 SysML v2 프로젝트를 공식 모델로 삼습니다. 그때부터 변경은 v2 모델에만 들어갑니다.

마이그레이션 체크리스트

  • 패키지, 담당자, 중요한 다이어그램이 나열되어 있습니다.
  • 관계가 가리키는 요소에 이름이 있습니다.
  • 내보낸 XMI 파일이 마이그레이션 기록과 함께 보관되어 있습니다.
  • 시범 패키지가 변환되고 보고서를 다운로드했으며, 근사 처리되거나 제외된 모든 행에 결정이 있습니다.
  • 포트, 트리거, 단위, 스테레오타입에 대한 모델링 패턴이 기록되어 있습니다.
  • 필요한 뷰를 다시 만들었고, 텍스트가 깔끔하게 검사를 통과합니다.
  • 모델 사용자가 시범 변환을 검토했습니다.
  • 남은 패키지를 같은 방식으로 변환했고, v1 모델은 동결되었습니다.

다음에 읽을 내용

Cameo Systems Modeler, MagicDraw, Enterprise Architect, Rhapsody, Eclipse Papyrus는 각 소유자의 상표입니다. Holarch는 이들과 제휴 관계가 없으며 이들의 보증을 받지 않았습니다.