Holarch

SysML v2

SysML v2 모델 교환

.sysml 파일, zip 아카이브, SysML v2 JSON을 미리 보기와 함께 SysML v2 프로젝트로 가져오고, 모델이나 패키지를 .sysml 텍스트 또는 SysML v2 JSON으로 내보냅니다.

사용 방법 →

이 페이지의 내용
  1. 개요
  2. 개념
    1. 파일 형식
    2. ID와 대응
    3. 텍스트의 요소 ID
    4. 폴더는 패키지가 됩니다
    5. 미리 보기가 비교하는 내용
  3. 사용 방법
    1. 사용 시기와 이유
    2. 이 프로젝트로 파일 가져오기
    3. 새 프로젝트로 파일 가져오기
    4. 새 버전으로 패키지 업데이트하기
    5. 텍스트에서 요소의 이름을 바꾸고 이동하면서 ID 유지하기
    6. 호스팅 서비스에서의 대용량 가져오기
    7. 모델 또는 패키지 내보내기
    8. ReqIF 요구사항 가져오기 및 내보내기
    9. 저장소에서 가져오기 및 저장소로 보내기
    10. 작업 예제: Hybrid Car 데모
    11. 팁과 모범 사례
    12. 흔한 실수
    13. 다른 기능과의 연결
  4. 가져오기 및 내보내기 페이지
    1. 가져오기
    2. 내보내기
  5. 저장소
  6. 파일을 읽는 방식
    1. Holarch가 해석하지 않는 요소
  7. 메시지
  8. 제한 사항
  9. 관련 페이지

개요

SysML v2 프로젝트는 다른 SysML v2 도구와 파일로 모델을 교환합니다. 가져오기 및 내보내기 페이지(모델 → 가져오기 및 내보내기)가 둘 다 처리합니다.

  • 가져오기는 .sysml 파일, .sysml 파일의 .zip, 또는 SysML v2 JSON 파일을 읽습니다. 무엇이 바뀌는지 미리 보여 준 다음, 이 프로젝트에 적용하거나(실행 취소 한 번으로 모두 되돌림) 새 SysML v2 프로젝트를 만듭니다.
  • 내보내기는 모델 전체 또는 패키지 하나를 SysML v2 텍스트(.sysml)나 SysML v2 JSON(.json)으로 작성합니다.
  • 요구사항 도구의 ReqIF 파일(.reqif, .reqifz)은 SysML v2 요구사항으로 가져오고, 요구사항은 ReqIF로 내보냅니다. ReqIF 요구사항 가져오기 및 내보내기를 참조하십시오.

파일에서 바로 프로젝트를 만들 수도 있습니다. 프로젝트 관리에서 프로젝트 파일 ▾ → SysML v2 파일 가져오기…를 클릭합니다.

팁: Systems Modeling API를 제공하는 SysML v2 모델 저장소와 모델을 동기화된 상태로 유지하려면 같은 페이지의 저장소 섹션을 사용합니다. 저장소에서 가져오기 및 저장소로 보내기를 참조하십시오.

개념

파일 형식

형식담긴 내용가져오기내보내기
SysML v2 텍스트(.sysml)텍스트 표기법이며, 최상위 패키지마다 파일 하나입니다.예예
Zip 아카이브(.zip)여러 .sysml 파일. 폴더는 패키지가 됩니다.예예, 여러 파일을 내보낼 때
SysML v2 JSON(.json)Systems Modeling API가 사용하는 것처럼 각각 @id와 @type이 있는 요소의 평면 목록.예예
ReqIF(.reqif, .reqifz)DOORS, Polarion, Jama, codebeamer 및 기타 요구사항 도구의 요구사항(속성, 계층, 관계 포함).예, 요구사항으로 변환예, 요구사항

KerML 파일(.kerml)은 아직 가져오지 않습니다.

ID와 대응

SysML v2 프로젝트의 모든 요소에는 ID가 있습니다. 두 형식은 ID를 다르게 보존합니다.

  • JSON은 ID를 보존합니다. JSON에서 다시 가져온 요소는 ID가 같은 요소와 대응됩니다.
  • 표준 라이브러리 참조를 인식합니다. Systems Modeling API, SysML v2 Pilot Implementation 또는 다른 저장소의 JSON은 표준 라이브러리 요소(ISQ::mass 같은 단위, ScalarValues::Real, Parts::Part)를 표준 ID로 지정합니다. 가져오기는 이를 같은 라이브러리 요소로 읽으므로 단위와 타입이 계속 확인됩니다.
  • 텍스트는 요청할 때 ID를 보존합니다. .sysml 텍스트를 내보낼 때 요소 id 포함을 선택합니다. 그러면 이름이 있는 모든 정의, 사용, 패키지가 본문의 첫 줄에 ID를 @HolarchMetadata::ElementId { id = "…"; }로 담습니다. 그 텍스트를 다시 가져오면, ID가 있는 각 요소는 이름이 바뀌었거나, 다른 소유자나 다른 최상위 패키지로 이동했거나, 순서가 바뀌었더라도 ID가 같은 요소와 대응됩니다. 다이어그램 위치, 댓글, 추적, 연결이 유지됩니다.
  • ID가 없는 텍스트는 이름으로 대응됩니다. Holarch는 최상위 패키지를 이름으로, 그 안의 요소를 이름과 위치로 대응시킵니다. 요소가 대응되는 곳에서는 ID가 유지됩니다. 이름이 바뀐 요소도 제자리에 있으면 대응되지만, 이름을 바꾸면서 동시에 이동한 요소는 새 요소가 됩니다.

내보내기는 내보내기 컨트롤 아래에 다음과 같이 안내합니다: "요소 id는 JSON에 유지됩니다. .sysml 텍스트에서 id를 유지하려면 요소 id 포함을 선택하십시오. 그러면 편집한 텍스트를 다시 가져올 때 이름을 바꾸거나 이동한 경우에도 요소의 다이어그램 위치, 주석, 추적이 유지됩니다. id가 없으면 요소는 이름으로 대응됩니다."

텍스트의 요소 ID

@HolarchMetadata::ElementId { id = "…"; }는 일반 SysML v2 메타데이터입니다. ElementId는 TBD 및 TBR과 함께 Holarch 자체 라이브러리 패키지 HolarchMetadata(표준 라이브러리의 Holarch 아래)에 있는 메타데이터 정의입니다. 다른 SysML v2 도구는 이 줄을 메타데이터 주석으로 읽으며, 이름을 확인하려면 그 라이브러리의 HolarchMetadata.sysml이 필요합니다.

  • ID는 본문에 그 줄이 있는 요소에 속합니다. 이름 없는 요소(연결, 후속 관계, 주석)는 ID를 갖지 않으며, 이전처럼 내용으로 대응됩니다.
  • Holarch는 그 줄을 요소로 보관하지 않습니다. 편집기는 이 줄을 뺀 모델을 보여 주며, 본문에 그 줄만 있던 요소는 part engine : Engine;으로 표시됩니다.
  • ID는 고유해야 합니다. 같은 ID가 두 번 나오면(예: 텍스트에서 블록을 복사한 뒤) 첫 번째 요소가 ID를 유지하고 사본은 새 요소가 됩니다.
  • UUID가 아닌 ID(예: "R-17")는 고정된 UUID로 바뀌므로, JSON 가져오기에서처럼 같은 문자열은 항상 같은 요소가 됩니다.
  • 프로젝트에 없는 ID는 새 요소에 그대로 유지됩니다. Holarch에서 요소를 삭제하고 텍스트를 다시 가져오면 이전 ID로 요소가 되돌아옵니다.
  • 편집기에서 붙여 넣은 줄은 편집 중인 패키지 안에서만 작동합니다. 다른 패키지의 요소에 속한 ID는 그곳에서 무시되고 요소는 이름으로 대응됩니다. ID를 유지한 채 패키지 사이에서 요소를 옮기려면 ID를 포함해 내보낸 뒤 편집한 파일을 가져옵니다.

Hybrid Car 데모의 파트 정의 Car는 원본 파일에 이런 줄을 담고 있으므로 데모의 모든 사본에서 ID가 같습니다.

폴더는 패키지가 됩니다

zip 아카이브에서 각 폴더는 그 파일과 하위 폴더를 담는 패키지가 됩니다. 아카이브 안의 파일 powertrain/engine.sysml은 package powertrain { … } 안에 작성된 것처럼 읽힙니다. 아카이브 최상위의 파일은 그대로 읽힙니다. 폴더와 파일은 이름 순서로 읽힙니다.

미리 보기가 비교하는 내용

미리 보기에는 최상위 패키지(새 프로젝트의 경우 최상위 요소)마다 행이 하나 있습니다. 각 행에는 결과가 있습니다.

결과의미기본적으로 가져옴
신규프로젝트에 그 이름(또는 ID)의 패키지가 없습니다. 패키지가 추가됩니다.예
변경프로젝트에 그 패키지가 있으며, 가져오기가 그 안의 요소를 추가, 변경, 제거합니다. 세부 정보에 그 수가 표시됩니다. 예: "3 added, 1 changed (ids kept where elements match)".예
변경 없음패키지가 이 프로젝트의 것과 같습니다.아니요(할 일 없음)
충돌패키지를 병합할 수 없습니다. 세부 정보에 그 이유와 해야 할 일이 표시됩니다.아니요

사용 방법

사용 시기와 이유

모델이 Holarch와 다른 SysML v2 도구 사이, 또는 Holarch 프로젝트 사이를 오갈 때 가져오기 및 내보내기를 사용합니다.

  • 다른 곳에서 작성한 모델로 Holarch 프로젝트를 시작합니다.
  • 구성 요소 라이브러리처럼 다른 팀이 관리하는 패키지를 가져오고, 새 버전을 보내 오면 업데이트합니다.
  • 공급업체나 SysML v2 텍스트 또는 JSON을 읽는 도구에 패키지를 전달합니다.
  • Holarch 프로젝트 옆에서 자체 버전 관리로 .sysml 파일을 관리합니다.

이 프로젝트로 파일 가져오기

  1. 모델 → 가져오기 및 내보내기를 엽니다.
  2. 가져오기에서 이 프로젝트로를 선택합니다.
  3. 놓기 영역에 파일을 놓거나, 놓기 영역을 클릭해 파일을 선택합니다.

    "파일 읽는 중…"이 표시된 다음 미리 보기가 나타납니다: 최상위 패키지와 파일 수, 문제가 있으면 그 내용, 그리고 가져오기, 패키지, 요소, 결과가 있는 표.

  4. 문제 목록이 있으면 읽습니다. 구문 분석되지 않는 각 파일과 줄, 건너뛴 각 파일이 표시됩니다.
  5. 가져오지 않을 패키지의 체크를 해제합니다. 이름이 충돌하는 패키지를 교체하려면 체크합니다.

    항목 한도가 있는 요금제에서는 미리 보기가 가져오기 후 프로젝트가 갖게 될 항목 수를 셉니다(관계는 세지 않음). 한도를 넘으면 그렇게 알려 주며(예: "이 가져오기를 하면 프로젝트의 항목이 1,804개가 됩니다. Free 요금제는 1,000개까지 허용합니다."), 충분한 패키지의 체크를 해제할 때까지 N개 패키지 가져오기는 비활성 상태로 남습니다. 아무것도 적용되거나 서버로 전송되지 않습니다. 새 프로젝트로의 가져오기도 같은 방식으로 요금제의 프로젝트당 한도와 비교해 검사됩니다.

  6. N개 패키지 가져오기를 클릭합니다.

    알림에 "N개 패키지를 가져왔습니다."가 표시됩니다. 페이지에는 "N개 패키지(요소 M개)를 가져왔습니다. 실행 취소하면 가져오기가 한 단계로 되돌려집니다."가 표시됩니다. 가져온 내용을 보려면 텍스트 열기를 클릭합니다.

새 프로젝트로 파일 가져오기

  1. 모델 → 가져오기 및 내보내기를 열고 새 SysML v2 프로젝트로를 선택합니다.
  2. 파일을 끌어다 놓거나 선택합니다.

    미리 보기에 최상위 요소가 모두 체크된 상태로 나열됩니다.

  3. 원하지 않는 요소의 체크를 해제하고 프로젝트 이름을 편집합니다. 기본값은 단일 파일의 이름 또는 첫 번째 패키지의 이름입니다.
  4. 프로젝트 만들기를 클릭합니다.

    새 프로젝트가 편집기에서 열립니다.

프로젝트 관리에서 프로젝트 파일 ▾ → SysML v2 파일 가져오기…를 사용하면 한 단계로 같은 작업을 합니다. 파일의 일부를 읽을 수 없으면 먼저 묻습니다: "문제 N개가 발견되었습니다. 파일의 일부가 제외됩니다. 나머지로 프로젝트를 만드시겠습니까? 문제를 먼저 보려면 SysML v2 프로젝트를 열고 가져오기 및 내보내기를 사용하십시오." 계속하려면 프로젝트 만들기를 클릭합니다.

새 버전으로 패키지 업데이트하기

  1. 새 버전을 .sysml 파일 또는 JSON으로 내보내거나 받습니다.
  2. 이 프로젝트로 가져옵니다.

    패키지에 변경됨이 표시되고, 추가·변경·제거된 요소 수가 함께 표시됩니다.

  3. 1개 패키지 가져오기를 클릭합니다.

    일치하는 요소는 id를 유지하므로 그 요소에 대한 연결(요구사항 연결, 위험, 뷰 레이아웃, 댓글)이 그대로 남습니다. 파일에 더 이상 없는 요소는 휴지통으로 이동합니다.

텍스트에서 요소의 이름을 바꾸고 이동하면서 ID 유지하기

  1. 요소 id 포함을 체크한 상태로 패키지를 SysML v2 텍스트로 내보냅니다.
  2. 파일을 편집합니다. 요소의 이름을 바꾸고, 다른 소유자나 다른 패키지 파일로 옮기고, 순서를 바꿉니다. 각 @HolarchMetadata::ElementId 줄은 해당 요소의 본문 안에 둡니다.
  3. 편집한 파일을 이 프로젝트로 가져옵니다.

    패키지에 변경됨이 표시됩니다. 이름이 바뀌거나 이동한 요소는 추가 및 제거가 아니라 변경으로 셉니다.

  4. N개 패키지 가져오기를 클릭합니다.

    요소는 id를 유지합니다. 다이어그램 위치, 댓글, 추적, 연결이 그대로 남습니다. 다른 패키지로 이동한 요소는 원래 있던 패키지에서 빠집니다.

호스팅 서비스에서의 대용량 가져오기

호스팅 서비스에서 요소 5,000개 이상의 가져오기는 브라우저가 아니라 서버가 적용합니다. 체크된 모든 패키지가 새 항목이거나 충돌을 교체하는 경우, 서버가 파일을 직접 읽습니다(아래 단계). 체크된 패키지가 변경됨인 경우, 브라우저가 평소처럼 병합을 계산하고 변경 사항을 한 번 업로드합니다. 그러면 서버가 같은 진행 카드, 가져오기 취소, 가져오기 실행 취소와 함께 한 단계로 기록합니다.

  1. 다른 가져오기와 마찬가지로 파일을 선택하고 미리 보기를 확인합니다.
  2. N개 패키지 가져오기(또는 프로젝트 만들기)를 클릭합니다.

    파일이 한 번 업로드됩니다. 서버는 미리 보기와 같은 검사와 같은 요소 id로 파일을 읽고, 결과를 한 단계로 기록합니다.

  3. 창 하단의 진행 카드를 확인합니다. 단계(업로드, 읽기, 검사, 적용, 프로젝트 색인 업데이트)와 남은 시간이 표시됩니다.

    페이지를 떠나거나 탭을 닫아도 됩니다. 가져오기는 서버에서 계속되며, 프로젝트를 다시 열면 결과가 반영되어 있습니다. 가져오기가 적용되면 열려 있는 프로젝트의 모든 사본이 다시 로드되고, 전송되지 않은 편집은 다시 로드한 후 다시 전송됩니다.

  • 다른 멤버에게는 같은 카드와 가져오기 및 내보내기 페이지에 "Name이(가) file을(를) 가져오는 중…"이 표시됩니다.
  • 한 번에 하나의 가져오기: 같은 프로젝트로의 두 번째 대용량 가져오기는 첫 번째가 끝날 때까지 기다립니다.
  • 가져오기 취소(시작한 사람 또는 소유자)는 가져오기가 적용되기 전에 중지합니다. 아무것도 변경되지 않습니다.
  • 가져오기 실행 취소: 브라우저의 ⌘Z / Ctrl+Z로는 서버 가져오기를 되돌릴 수 없습니다. 프로젝트를 최근 가져오기 이전 상태로 되돌리려면 가져오기 및 내보내기 페이지에서 가져오기 실행 취소를 클릭합니다. 실행 취소 이전 상태는 기록에 보관되므로, 가져오기 후에 한 편집은 그곳에서 복구할 수 있습니다.
  • 프로젝트 활동과 기록에는 가져오기가 시작한 사람의 항목 하나로 나열됩니다.

모델 또는 패키지 내보내기

  1. 모델 → 가져오기 및 내보내기를 엽니다.
  2. 내보내기에서 내보낼 대상을 선택합니다. 모델 전체 또는 정규화된 이름으로 지정한 패키지입니다.
  3. 형식을 선택합니다. SysML v2 텍스트 (.sysml, 패키지가 여러 개면 .zip) 또는 SysML v2 JSON (.json)입니다.
  4. 편집한 후 다시 가져올 텍스트라면 요소 id 포함을 체크합니다.
  5. 내보내기를 클릭합니다.

    파일 하나가 다운로드되며, 내보내기에 파일이 여러 개이면 zip이 다운로드됩니다. 알림에 "<file>을(를) 내보냈습니다." 또는 "파일 N개를 zip으로 내보냈습니다."가 표시됩니다.

패키지 하나를 빠르게 내보내려면 브라우저를 사용합니다. 패키지의 행 메뉴에 .sysml로 내보내기와 JSON으로 내보내기가 있습니다.

ReqIF 요구사항 가져오기 및 내보내기

ReqIF는 요구사항 도구의 교환 형식입니다. ReqIF 파일은 SysML v2 요구사항의 패키지 하나로 가져와지고, 요구사항은 다시 ReqIF로 내보내지므로, 요구사항 도구와 SysML v2 프로젝트가 같은 요구사항을 양방향으로 주고받을 수 있습니다.

ReqIF 파일 가져오기:

  1. 모델 → 가져오기 및 내보내기를 엽니다(또는 요구사항 페이지에서 가져오기…를 클릭하거나, ⌘K / Ctrl+K에서 ReqIF 가져오기…를 선택합니다).
  2. .reqif 또는 .reqifz 파일을 상자에 끌어다 놓거나, 상자를 클릭해 선택합니다. 가져오기 한 번에 ReqIF 파일 하나입니다.
  3. ReqIF 패널에 요구사항, 장, 관계의 수와 그중 변환됨, 근사 처리됨, 제외됨의 수, 그리고 SysML v2 텍스트가 문제 없이 검사되는지가 표시됩니다.
  4. 짧은 이름 출처에서 외부 ID(원본 도구에서 사람들이 보는 번호, 예: SRS-12) 또는 ReqIF 식별자(도구의 내부 id)를 선택합니다. 외부 ID가 없는 요구사항은 식별자를 사용합니다.
  5. 관계 유형에서 각 관계 유형이 무엇이 될지 선택합니다. 파생, 정제, 의존 또는 제외입니다. 미리 보기가 다시 계산되며, 선택은 같은 파일의 다음 가져오기를 위해 유지됩니다.
  6. 1개 패키지 가져오기를 클릭합니다. 실행 취소 한 번으로 가져오기 전체를 되돌립니다. 알림에 "<title>에서 요구사항 N개를 가져왔습니다."가 표시됩니다.

가져오기가 만드는 것:

ReqIFSysML v2
요구사항(spec object)외부 ID 또는 식별자를 짧은 이름으로, 이름, 그리고 텍스트를 doc으로 갖는 requirement
요구사항 유형ReqIF 속성마다 attribute 하나를 갖는 requirement def
열거형 데이터 유형enum def
상태 속성(Draft, Proposed, Approved 등)Holarch에서의 요구사항 상태
장 제목장 번호를 짧은 이름으로 갖는 package
중첩된 요구사항중첩된 requirement
derived from 관계파생 연결
refines 관계Refinement 주석이 있는 의존
satisfies, verified by 및 기타 관계의존(보고서에 이유가 표시됨)
명세파일 패키지 안의 package

표는 셀 사이에 |이(가) 있는 텍스트 줄이 되고, 목록은 대시로 시작하는 줄이 되며, 서식과 링크는 텍스트만 남습니다. 이러한 요구사항은 근사 처리됨입니다. 이미지와 포함된 개체는 가져오지 않습니다. 이를 포함하던 요구사항은 이유와 함께 나열되므로 파일을 해당 요구사항에 첨부할 수 있습니다. 보고서 다운로드는 모든 요구사항과 관계를 결과와 함께 CSV로 저장하고, SysML v2 텍스트 다운로드는 텍스트를 저장합니다.

파일의 새 사본 가져오기: 같은 프로젝트로 가져옵니다. Holarch가 이전 가져오기의 패키지를 찾아 요구사항별로 비교합니다.

  • 요구사항은 요소 id를 유지하므로 다이어그램, satisfy 및 verify 연결, 검토, 기록이 연결된 상태로 남습니다. 이름이 바뀌거나 이동한 요구사항은 그 자리에서 업데이트됩니다.
  • 새 파일에 없는 요구사항은 유지됩니다. 휴지통으로 옮기려면 이 파일에 없는 요구사항 N개 제거를 체크합니다.
  • Holarch에서 추가한 파트, 검증 케이스, 연결은 유지됩니다.
  • Holarch에서만 변경된 요구사항은 그 변경을 유지합니다. 여기와 파일 양쪽에서 변경된 요구사항은 파일의 텍스트를 사용하며, 이전 텍스트는 기록에 남습니다. 미리 보기는 이러한 요구사항을 여기와 파일 양쪽에서 변경됨 아래에 나열합니다.

ReqIF로 내보내기:

  1. 내보내기에서 패키지 또는 모델 전체를 선택하고, ReqIF (.reqif) 또는 ReqIF 아카이브 (.reqifz)를 선택합니다.
  2. 내보내기를 클릭합니다. 알림에 "요구사항 N개를 <file>(으)로 내보냈습니다."가 표시됩니다.

데이터베이스 또는 요구사항 페이지의 내보내기… → 요구사항 (ReqIF)은 나열된(또는 선택한) 요구사항을 같은 방식으로 내보냅니다.

파일에는 각 요구사항의 짧은 이름(ReqIF.ForeignID로), 이름, doc(XHTML로), 상태, 속성 값, 명세로서의 패키지 계층, 그리고 derive, refine, dependency 관계가 들어 있습니다. ReqIF에서 가져온 요구사항은 원래 식별자, 유형, 관계 유형을 유지하므로 원본 도구는 사본을 추가하는 대신 요구사항을 업데이트합니다. 파일을 내보낸 후 다시 가져오면 모든 패키지가 변경되지 않음으로 표시됩니다. 계산된 속성 값은 텍스트로 기록됩니다. Satisfy 및 verify 연결은 Holarch에 남습니다. ReqIF에는 파트나 검증 케이스가 없습니다.

저장소에서 가져오기 및 저장소로 보내기

프로젝트를 SysML v2 모델 저장소의 브랜치 하나에 연결해 최신 커밋을 읽고 변경 사항을 되돌려 보냅니다.

  1. 모델 → 가져오기 및 내보내기를 열고 저장소 섹션을 찾습니다.
  2. 저장소 주소(Systems Modeling API의 https 주소)를 입력하고, 저장소에 필요하면 액세스 토큰도 입력합니다.
  3. 프로젝트 불러오기를 클릭한 후 프로젝트와 브랜치를 선택합니다. 이 모델로 새 저장소 프로젝트를 시작하려면 대신 새 저장소 프로젝트를 클릭합니다.
  4. 풀…을 클릭합니다. Holarch가 브랜치의 최신 커밋을 읽고 각 차이를 새 항목, 변경됨, 제거됨 또는 충돌로 나열합니다. 가져올 것이 없으면 "최신 상태: 저장소에 변경 사항이 없습니다."가 표시됩니다.
  5. 원하지 않는 차이의 체크를 해제한 후 가져온 변경 적용을 클릭합니다. 실행 취소 한 번으로 풀 전체를 되돌립니다.
  6. 모델을 변경한 후 푸시를 클릭합니다. 마지막으로 동기화한 커밋 이후의 변경 사항이 새 커밋 하나로 브랜치에 전송됩니다. 예를 들어 "변경 3개를 커밋 1a2b3c4d(으)로 푸시했습니다."가 표시됩니다.

충돌은 마지막 동기화 이후 여기와 저장소 양쪽에서 변경된 요소입니다. 체크를 해제한 충돌은 이 프로젝트의 버전을 유지합니다.

참고: 이 프로젝트가 풀하지 않은 커밋이 브랜치에 있으면 푸시가 거부됩니다: "저장소 브랜치에 이 프로젝트가 풀하지 않은 커밋이 있습니다. 먼저 풀한 후 다시 푸시하십시오."

작업 예제: Hybrid Car 데모

먼저 데모를 만듭니다: 프로젝트 관리에서 프로젝트 파일 ▾ → 새 데모 프로젝트 → Hybrid Car(SysML v2)를 클릭합니다.

  1. 모델 → 가져오기 및 내보내기를 엽니다. 내보내기에서 모델 전체와 SysML v2 텍스트를 선택한 후 내보내기를 클릭합니다.

    최상위 패키지마다 파일 하나씩 들어 있는 zip이 다운로드됩니다. 예: Vehicles.sysml, VehicleRequirements.sysml, VehicleBehavior.sysml, VehicleViews.sysml.

  2. 텍스트 편집기에서 VehicleRequirements.sysml을(를) 엽니다. attribute maxCurbMass : MassValue = 1650 [kg];을(를) 1600 [kg](으)로 바꾸고 저장합니다.
  3. 가져오기 및 내보내기로 돌아가 이 프로젝트로를 선택하고 VehicleRequirements.sysml을(를) 끌어다 놓습니다.

    미리 보기에 VehicleRequirements가 변경됨으로, 변경된 요소 수와 함께 표시됩니다. 다른 패키지는 파일에 없으므로 나열되지 않습니다.

  4. 1개 패키지 가져오기를 클릭합니다.

    모델의 값이 바뀝니다. 요구사항 Sedan Mass(VR-1.1)는 maxCurbMass을(를) 참조하므로 그 연결이 검토 대상으로 표시됩니다(SysML v2 프로젝트의 요구사항과 검증 참조). 가져오기를 실행 취소하려면 ⌘Z / Ctrl+Z를 누릅니다.

  5. 같은 파일로 두 번째 프로젝트를 시작하려면 새 SysML v2 프로젝트로를 선택하고 zip을 끌어다 놓은 후 프로젝트 만들기를 클릭합니다.

팁과 모범 사례

  • id가 중요할 때, 예를 들어 다른 도구가 id로 연결을 유지할 때는 JSON을 사용해 SysML v2 도구 간에 모델을 옮깁니다. 사람이 파일을 읽거나 검토할 때는 텍스트를 사용하며, 편집 후 텍스트가 Holarch로 돌아올 때는 요소 id 포함을 체크합니다.
  • 읽기만 하는 사람에게 건네는 텍스트에서는 id를 제외합니다. 요소마다 한 줄이 추가됩니다.
  • 파일마다 최상위 패키지를 하나씩 둡니다. 내보내기는 그렇게 파일을 기록하며, 이후 가져오기는 패키지별로 일치시킵니다.
  • 다른 팀의 패키지는 그 팀 전용 최상위 패키지로 가져옵니다. 그러면 업데이트가 해당 패키지에만 영향을 줍니다.
  • 가져오기 전에 문제 목록을 확인합니다. 구문 분석되지 않는 멤버는 제외됩니다.

흔한 실수

  • 패키지에 충돌이 표시됨: "다른 id를 가진 X라는 패키지가 있습니다." 프로젝트에 이 JSON에서 가져오지 않은 같은 이름의 패키지가 있습니다. 교체하려면 행을 체크하거나(이전 패키지는 휴지통으로 이동), 새 프로젝트로 가져옵니다.
  • "가져오기에 X라는 최상위 패키지가 두 개 있습니다. 첫 번째만 가져옵니다." 두 파일이 같은 최상위 패키지를 선언합니다. 하나의 파일로 병합하거나 하나의 이름을 바꿉니다.
  • 이름이 바뀐 요소가 새 요소로 가져와졌습니다. 텍스트에 요소 id가 없었고, 요소의 이름 변경과 이동이 동시에 이루어졌습니다(또는 종류와 이름이 모두 바뀌었습니다). 요소 id 포함으로 내보내고, 변경한 후 다시 가져옵니다.
  • 가져오기 후 요소가 누락되었습니다. 구문 분석되지 않는 멤버는 제외됩니다: "이 멤버는 구문 분석되지 않아 제외됩니다." 문제 목록에 표시된 줄을 고친 후 다시 가져옵니다.
  • JSON 가져오기가 거부됩니다. SysML v2 JSON 파일은 .sysml 파일 없이 한 번에 하나씩 가져옵니다.

다른 기능과의 연결

  • 편집기: 가져온 패키지가 그곳에서 열리며, 내보낸 파일은 그곳에서 보는 텍스트입니다.
  • 실행 취소와 휴지통: 이 프로젝트로의 가져오기 전체를 실행 취소 한 번으로 되돌리며, 가져오기가 제거하거나 교체하는 요소는 휴지통으로 이동합니다.
  • 변경 통제: 가져오기로 변경된 값과 문서화는 다른 편집과 마찬가지로 요구사항 연결을 검토 대상으로 표시합니다.
  • Holarch 프로젝트 파일: 프로젝트 관리의 이 프로젝트 내보내기…는 위험, 문서, 기타 Holarch 데이터와 함께 Holarch 프로젝트 전체를 저장합니다. .sysml과 JSON에는 모델만 들어 있습니다.
  • 변환: LML과 SysML v2 간에 모델을 옮기려면 변환된 사본을 만듭니다(LML과 SysML v2 간 변환 참조).

가져오기 및 내보내기 페이지

가져오기

컨트롤용도
이 프로젝트로열려 있는 프로젝트에 파일을 병합합니다. 프로젝트를 보기만 할 수 있는 사람은 사용할 수 없으며, 그들의 가져오기는 새 프로젝트를 만듭니다.
새 SysML v2 프로젝트로파일로 새 프로젝트를 만듭니다.
놓기 영역"여기에 파일을 끌어다 놓거나 클릭해 선택하십시오". .sysml 파일, .sysml 파일의 .zip, 또는 SysML v2 JSON 파일 하나를 받습니다.
미리 보기 표가져오기(체크 상자), 패키지(이름과 종류), 요소(개수), 결과(새 항목, 변경됨, 변경되지 않음 또는 충돌, 세부 정보 포함).
프로젝트 이름(새 프로젝트만 해당) 새 프로젝트의 이름으로, 최대 200자입니다.
N개 패키지 가져오기 / 프로젝트 만들기가져오기를 적용합니다.
취소가져오지 않고 미리 보기를 닫습니다.

.sysml 텍스트에서 어떤 패키지에도 속하지 않는 요소는 패키지 외부라는 한 행에 함께 나열됩니다.

미리 보기가 열려 있는 동안 모델이 바뀌면(다른 탭, 공동 작업자 또는 실행 취소) 미리 보기가 다시 계산됩니다.

내보내기

컨트롤용도
내보내기(범위)모델 전체 또는 정규화된 이름으로 지정한 임의의 패키지.
다음으로:(형식)SysML v2 텍스트 (.sysml, 패키지가 여러 개면 .zip) 또는 SysML v2 JSON (.json).
요소 id 포함(텍스트만 해당, 기본값은 꺼짐) 이름이 있는 각 요소의 id를 텍스트에 @HolarchMetadata::ElementId { id = "…"; }(으)로 기록하므로, 편집한 사본을 다시 가져와도 이름 변경과 이동을 거쳐 id가 유지됩니다.
내보내기파일을 다운로드합니다.

텍스트 내보내기는 최상위 패키지마다 그 이름을 딴 파일 하나를 기록합니다(Vehicles.sysml). 패키지 외부의 요소는 Outside packages.sysml에 들어갑니다. JSON 내보내기는 프로젝트 또는 패키지의 이름을 딴 파일 하나를 기록합니다.

저장소

저장소 섹션은 프로젝트를 Systems Modeling API를 제공하는 저장소의 브랜치 하나에 연결합니다.

  • 저장소 주소: 저장소 API의 https 주소입니다. Holarch는 공개 호스트의 https 주소에만 연결하며, 사이트 관리자가 호스트와 포트를 제한할 수 있습니다.
  • 액세스 토큰: 계정과 이 프로젝트에 대해 암호화되어 저장되며, 해당 주소로만 전송됩니다. 다시 표시되지 않습니다. 저장된 토큰을 유지하려면 필드를 비워 둡니다.
  • 프로젝트 불러오기, 프로젝트, 브랜치: 동기화할 위치를 선택합니다. 새 저장소 프로젝트는 이 모델을 위한 프로젝트를 저장소에 만듭니다.
  • 풀…, 가져온 변경 적용: 최신 커밋을 읽고, 차이를 검토하고, 적용하며, 실행 취소 한 번으로 모두 되돌립니다. Holarch는 마지막으로 동기화한 커밋과 비교하므로 사용자의 변경과 저장소의 변경을 구분할 수 있습니다.
  • 푸시: 마지막으로 동기화한 커밋 이후의 변경 사항을 커밋 하나로 전송합니다. "푸시할 것이 없습니다: 모델이 마지막으로 동기화한 커밋과 일치합니다."는 새로운 것이 없다는 뜻입니다.
  • 설정…은 연결을 변경합니다. 연결 해제는 저장된 토큰과 동기화 상태를 제거하며, 모델은 그대로 남습니다.
  • 저장소 작업에는 편집자 역할이 필요합니다. 뷰어는 풀하거나 푸시할 수 없습니다.
  • 규제 데이터 표시가 있는 프로젝트에서는 푸시가 거부됩니다.

파일을 읽는 방식

  • 읽기 전에 파일의 크기, 개수, 중첩, 텍스트 길이를 검사합니다.
  • zip에서 숨김 파일과 __MACOSX 폴더는 무시됩니다. 링크, .sysml 이외의 파일, 같은 경로의 두 번째 사본은 건너뛰며, 문제 목록에 이유가 표시됩니다.
  • 텍스트는 UTF-8이어야 합니다. 바이트 순서 표시는 허용됩니다.
  • 가져온 각 요소는 기록되기 전에 검사됩니다. 거부된 요소는 자신이 소유한 멤버도 함께 제외하며, 문제 목록에 그 수가 표시됩니다.
  • JSON에서 Holarch가 해석하지 않는 종류의 요소는 가져온 그대로 보존됩니다. Holarch가 해석하지 않는 요소를 참조하십시오.

Holarch가 해석하지 않는 요소

SysML v2 JSON에는 KerML behavior, step, interaction처럼 Holarch가 모델링하지 않는 요소 종류가 들어 있을 수 있습니다. Holarch는 이를 제외하지 않고 보존합니다.

  • 각 요소는 id, 이름, 소유자, 그리고 관계(타입 지정, 특수화 등)와 그 소유물을 포함한 원래 JSON과 함께 모델에 남습니다. 그 멤버들은 계속 이 요소를 소유자로 둡니다.
  • 브라우저는 원래 종류를 해석되지 않음 태그와 함께 표시합니다. 설명을 보려면 태그를 가리킵니다. 속성 패널에는 종류, 파일에서의 id, 관계가 가리키는 대상이 표시됩니다.
  • Holarch에서는 이름을 바꾸거나 편집할 수 없습니다. 원래 도구에서 변경한 후 다시 가져옵니다. 이동하거나 삭제할 수는 있습니다.
  • SysML 텍스트가 없습니다. 편집기는 이 요소와 그 소유물 전체를 텍스트에서 제외하며, 텍스트 위의 메모에 표시되지 않는 요소의 수가 나옵니다. 텍스트를 편집해도 이 요소는 제거되지 않습니다. .sysml 내보내기에서도 제외됩니다.
  • JSON 내보내기는 이 요소를 변경 없이 다시 기록합니다. 모델에서 바뀐 부분만 조정됩니다. 삭제하거나 추가한 멤버, 이름을 바꾼 멤버, 또는 새 소유자입니다.
  • 가져오기 미리 보기는 보존된 각 종류를 메모로 한 번씩 나열합니다. 예: Behavior 요소 2개가 가져온 그대로 보존됩니다. 메모는 문제가 아닙니다.

보존되지 않는 것: 일부 도구가 내보내기 전체를 감싸는 이름 없는 루트 네임스페이스(그 멤버는 최상위 요소가 됨), 그리고 값 안의 지원되지 않는 요소(문제로 나열됨). JSON이 256 KB보다 큰 요소는 종류와 id만 유지합니다.

메시지

메시지의미 및 해결 방법
.sysml 파일, .sysml 파일의 .zip 또는 SysML v2 JSON 파일을 선택하십시오.선택한 파일이 없습니다.
.sysml 파일을 찾지 못했습니다. .sysml 파일, .sysml 파일의 .zip 또는 SysML v2 JSON 파일을 선택하십시오.아카이브 또는 선택 항목에 .sysml 파일이 없습니다.
SysML v2 JSON 파일은 .sysml 파일 없이 한 번에 하나씩 가져오십시오.JSON 파일 여러 개, 또는 텍스트와 섞인 JSON이 선택되었습니다.
<file>은(는) ReqIF 파일이 아닙니다(…). 원본 도구에서 ReqIF 1.0 이상으로 내보낸 후 다시 가져오십시오.파일이 ReqIF XML이 아니거나, Holarch가 읽지 않는 DOCTYPE이 들어 있습니다.
<file>에 요구사항이 없습니다(SPEC-OBJECT 요소 없음). 명세를 개체와 함께 내보낸 후 파일을 다시 가져오십시오.ReqIF 파일에 유형은 있지만 요구사항이 없습니다.
<title>에 요구사항이 N개 있어 한 번에 가져올 수 있는 양(약 M개)을 넘습니다. 명세를 별도의 ReqIF 파일로 내보내십시오.SysML v2 텍스트가 8 MB 한도를 넘게 됩니다. 명세를 한 번에 파일 하나씩 가져오십시오.
<file>은(는) UTF-8 텍스트가 아닙니다. UTF-8로 저장한 후 다시 가져오십시오.파일의 인코딩을 변환합니다.
<file>은(는) 유효한 ZIP 아카이브가 아닙니다. 아카이브를 다시 만드십시오.아카이브가 손상되었습니다.
<file>에 암호화된 파일이 있습니다. 암호 없이 아카이브를 만드십시오.암호로 보호된 아카이브는 읽지 않습니다.
<path>의 압축률이 200:1을 넘으며, 이는 zip 폭탄의 전형적인 특징입니다. 아카이브를 다시 만드십시오.안전을 위해 아카이브가 거부되었습니다.
아카이브가 지원되지 않는 압축 방식을 사용합니다. 표준 ZIP 압축으로 만드십시오.표준(deflate) 압축을 사용합니다.
KerML 파일은 아직 가져오지 않습니다..kerml 파일은 건너뜁니다.
아카이브에서는 .sysml 파일만 가져옵니다.zip의 다른 파일은 건너뜁니다.
링크는 가져오지 않습니다.zip의 심볼릭 링크는 건너뜁니다.
아카이브에 이 파일이 두 번 들어 있습니다. 첫 번째 사본을 가져옵니다.두 항목의 경로가 같습니다.
<file>은(는) 유효한 JSON이 아닙니다. 모델을 다시 내보내십시오.JSON 파일이 손상되었습니다.
<file>은(는) SysML v2 JSON(@id와 @type을 가진 요소의 목록)이 아닙니다. SysML v2 JSON 내보내기를 선택하십시오.JSON이 다른 형식입니다.
<file>의 N번째 줄이 64 KB보다 깁니다. 줄을 나눈 후 파일을 다시 가져오십시오.매우 긴 줄은 거부됩니다.
이 멤버는 구문 분석되지 않아 제외됩니다.문제 목록에 표시된 줄을 고칩니다.
이 id를 가진 요소가 이 프로젝트의 <element> 안에 있습니다. 먼저 최상위로 옮기거나, 새 프로젝트로 가져오십시오.(충돌) JSON의 최상위 패키지가 모델의 더 깊은 곳에 이미 있습니다.
그 요소 id 중 N개가 이 프로젝트의 다른 곳에서 사용되고 있습니다. 대신 새 프로젝트로 가져오십시오.(충돌) JSON이 다른 요소의 id를 재사용합니다.
패키지 텍스트가 출력 후 구문 분석되지 않습니다. 새 프로젝트로 가져오십시오.(충돌) 패키지를 병합할 수 없었습니다.
<kind> 요소 N개가 가져온 그대로 보존됩니다(해석되지 않음): …(메모) Holarch가 해석하지 않는 종류의 요소는 변경 없이 보존됩니다. Holarch가 해석하지 않는 요소를 참조하십시오.
값 안의 <kind> 종류 요소는 지원되지 않으므로 제외됩니다.값(식)에 Holarch가 읽을 수 없는 요소가 들어 있습니다. 값의 나머지 부분은 텍스트로 보존됩니다.
<kind> 종류의 요소가 너무 커서 전체를 보존할 수 없습니다. 종류와 id만 보존됩니다.JSON이 256 KB보다 큽니다.
가져오기가 적용되지 않았습니다: … 아무것도 변경되지 않았습니다.가져오기에 실패했습니다. 프로젝트는 변경되지 않았습니다.
모델이 비어 있습니다. 패키지를 추가한 후 다시 내보내십시오.내보낼 것이 없습니다.
내보낼 패키지가 더 이상 없습니다. 다른 패키지를 선택하십시오.페이지가 열려 있는 동안 패키지가 삭제되었습니다.

제한 사항

한도값
가져오기당 파일 수2,000
가져오기당 .sysml 텍스트(압축 해제 후)8 MB
Zip 아카이브16 MB, 항목 10,000개
zip의 폴더 중첩폴더 32개
가져오기당 요소 수(텍스트 또는 JSON)100,000
JSON 파일24 MB, 중첩 64단계
Holarch가 해석하지 않는 요소 하나의 JSON256 KB, 중첩 12단계
줄 길이64 KB
ReqIF 파일(.reqif, 또는 .reqifz 안의 .reqif)64 MB. 이 파일로 만든 SysML v2 텍스트가 8 MB 텍스트 한도에 맞아야 합니다(요구사항 약 8,000~20,000개).
  • 저장소 응답은 풀 한 번 전체에 대해 64 MB로 제한되며, 각 저장소 작업은 120초 후에 중지됩니다.
  • 계정마다 시간당 최대 300개의 저장소 작업을 실행할 수 있습니다.
  • KerML(.kerml) 파일은 아직 가져오지 않습니다.
  • 호스팅 앱에서 서버는 최대 1.5 MB의 .sysml 텍스트 가져오기를 읽습니다. 더 큰 가져오기는 브라우저에서 읽으며, 결과는 같습니다.
  • 모델 옆의 Holarch 데이터(요구사항 상태, 위험, 예산, 시뮬레이터 설정, 뷰 레이아웃)는 .sysml 또는 JSON 파일에 포함되지 않습니다. 이를 보관하려면 프로젝트 관리에서 이 프로젝트 내보내기…를 사용합니다.

SysML® 및 OMG®는 미국 및 기타 국가에서 Object Management Group, Inc.의 등록 상표입니다.