가져오기 및 내보내기
가져오기 및 내보내기 형식
사양서, 스프레드시트, 요구사항 교환 파일, 모델을 Holarch 프로젝트로 가져오고, 모델을 문서, 표, 이미지, 교환 파일, 완전한 프로젝트 파일로 내보냅니다. 이 페이지에는 모든 형식과 그 방향, 담는 내용, 알려진 제한 사항이 나와 있습니다.
가져오기와 내보내기의 작동 방식
- 내보내기는 뷰어를 포함한 모든 프로젝트 구성원이 사용할 수 있습니다. 가져오기는 프로젝트를 변경하므로 소유자 또는 편집자 역할이 필요합니다.
- 가져오기 및 내보내기 페이지에서 가져오면 미리 보기가 표시되고, 가져온 항목에 새 ID가 부여되며, 실행 취소 한 단계로 처리됩니다. 새 항목을 추가하는 대신 기존 항목을 업데이트하려면 ID, 이름 또는 번호로 대응시킵니다.
- 가져온 콘텐츠는 정리됩니다: 서식 있는 텍스트에서는 스크립트와 안전하지 않은 링크가, SVG 그림에서는 스크립트와 외부 참조가 제거되며, DOCTYPE 또는 ENTITY 선언이 있는 XML은 거부됩니다.
- CSV 내보내기는 스프레드시트가 수식으로 실행할 텍스트를 무력화합니다. 파일 이름은 모든 운영 체제에 맞게 정리됩니다.
- 각 프로젝트는 LML 프로젝트 또는 SysML v2 프로젝트입니다. Word, 스프레드시트, 텍스트, ReqIF 가져오기는 LML 프로젝트용입니다. SysML v2 프로젝트는 SysML v2 텍스트와 JSON, 그리고 SysML v2로 변환되는 XMI 또는 .mdzip 형식의 SysML 1.x 모델을 가져옵니다. LML 프로젝트도 XMI를 가져옵니다. 프로젝트 파일과 공유 페이지의 Word, Excel, CSV 내보내기는 양쪽에서 모두 작동합니다.
바로 가기: 요구사항 및 사양서 · 모델 · 스프레드시트 및 표 · 문서 및 보고서 · 이미지 · 프로젝트 파일 · API 및 MCP
요구사항 및 사양서
| 형식 | 방향 | 다루는 내용 | 알려진 제한 사항 |
|---|---|---|---|
| Word(.docx) | 가져오기 | 사양서가 번호 매긴 문서가 됩니다. 제목은 수준에 따라 중첩된 Statement가 되고, „shall“, „must“, „will“, „should“가 있는 단락과 번호 매긴 목록 항목은 Requirement가 됩니다. 표는 행마다 항목 하나가 되거나 설명 안의 표로 남습니다. 굵게, 기울임꼴, 목록, 그림이 유지되고, 삽입된 변경 내용 추적이 읽히며, 원본 파일이 첨부됩니다. | PNG, JPEG, GIF, WebP, SVG 이외의 EMF, WMF 등의 형식으로 된 그림은 건너뜁니다. 삭제된 변경 내용 추적 텍스트는 가져오지 않습니다. |
| 일반 텍스트(.txt 또는 붙여 넣기) | 가져오기 | 번호 매긴 줄과 „shall“ 문장이 Statement와 Requirement로 된 번호 매긴 문서가 됩니다. 개요 번호는 감지되거나 선택됩니다: 십진, 로마 숫자, 문자, 혼합 수준, DoD 스타일 또는 사용자 지정 패턴. | 구조는 번호와 문구에서만 만들어집니다. |
| ReqIF(.reqif, .reqifz) | 가져오기 및 내보내기 | 가져오기: 각 SPEC-OBJECT가 항목이 되며, 사양 계층, 클래스가 되는 타입, 문자열, XHTML, Boolean, 날짜, 열거형, 정수, 실수 속성이 함께 들어옵니다. SPEC-RELATION은 관계가 됩니다. satisfy, verify, deriveReqt는 satisfies, verifies, traced from이 되고, trace와 refine은 traced to가 됩니다. 데이터베이스나 문서에서 내보내기: 클래스당 하나의 타입에 번호, 이름, 설명, 모든 속성을 담고, 관계는 SPEC-RELATION으로, 분해 구조는 계층으로 기록합니다. | 대응하는 것이 없는 관계 타입은 traced to가 됩니다. 스키마가 허용하지 않는 연결은 경고와 함께 건너뜁니다. |
모델
| 형식 | 방향 | 다루는 내용 | 알려진 제한 사항 |
|---|---|---|---|
| UML 및 SysML 1.x XMI(.xmi, .uml, .xml, .mdzip) | 가져오기 및 내보내기 | 가져오기: UML 2.5와 SysML 1.3~1.7 프로필을 사용하는 XMI 2.x 및 .mdzip 프로젝트 아카이브. ID와 텍스트가 있는 요구사항, 블록, 파트, 포트, 값 속성, 단위가 있는 값 타입, 일반화, 커넥터와 아이템 흐름, 제어 흐름이 있는 활동, 병렬 상태와 choice, junction, fork, join 전이가 있는 상태 머신, 시퀀스 다이어그램, 테스트 케이스, 패키지, 스테레오타입, 태그 값. Satisfy, verify, deriveReqt, refine, trace, copy, allocate는 Holarch 관계가 됩니다. 블록, 내부 블록, 상태 머신, Action 다이어그램은 가져온 모델에서 그려집니다. 내보내기: Cameo/MagicDraw, Enterprise Architect, Rhapsody용 SysML 1.6 XMI(XMI 2.5.1) 또는 Papyrus용 Papyrus(Eclipse UML, .uml)로, 요구사항, 블록, 파트, 포트, 단위가 있는 값 타입, 제약 블록, 아이템 흐름이 있는 커넥터, 활동, 유스케이스, 테스트 케이스, 상태 머신, 추적 관계를 담습니다. 가져온 항목은 XMI ID를 유지하고 내보내기가 이를 다시 기록하므로, 같은 모델의 이후 버전을 가져오면 사본을 추가하는 대신 항목을 업데이트합니다. Holarch 속성과 레이블을 켜면 파일을 손실 없이 Holarch로 다시 가져올 수 있습니다. | 다이어그램 레이아웃과 오퍼레이션은 가져오지 않으며, 검토 화면에 제외된 항목이 나열됩니다. 활동의 흐름은 구조가 잘 짜여 있을 때만 그려집니다. Artifact, 작업, 위험, 이슈, 결정, 시간 및 비용 항목은 내보내지 않습니다. |
| Java 소스(.java) | 가져오기 | 클래스 다이어그램에서 클래스, 인터페이스, 열거형은 Asset이 되고, 필드는 Characteristic이 되며, 메서드는 매개변수와 결과를 Input/Output으로 가진 Action이 됩니다. | 한 번에 파일 하나 또는 붙여 넣은 소스 하나. |
| SysML v2 텍스트(.sysml 또는 .sysml 파일의 .zip) | 가져오기 및 내보내기 | SysML v2 프로젝트나 새 프로젝트로 가져오며, 패키지별로 새로 추가됨, 변경됨, 변경 없음, 충돌을 미리 보여 줍니다. zip 안의 폴더는 패키지가 됩니다. 모델 전체나 패키지 하나를 내보내며, 여러 패키지는 zip으로 다운로드됩니다. | 텍스트에는 요소 ID가 없으므로 다시 가져올 때 이름으로 요소를 대응시킵니다. KerML(.kerml) 파일은 가져오지 않습니다. 가져오기당 최대 2,000개 파일, 텍스트 8 MB, zip 16 MB이며, 텍스트는 UTF-8이어야 합니다. |
| SysML v2 JSON (.json) | 가져오기 및 내보내기 | Systems Modeling API가 사용하는 @id와 @type이 있는 평면 요소 목록. 요소 ID가 유지되므로 다시 가져올 때 ID로 대응시킵니다. | 최대 24 MB, 요소 100,000개. Holarch가 해석하지 않는 요소 종류는 가져온 그대로 보관되고, 해석되지 않음으로 표시되며, 변경 없이 다시 기록됩니다. |
| SysML v2 모델 저장소 | 풀 및 푸시 | SysML v2 프로젝트를 Systems Modeling API를 제공하는 저장소의 브랜치 하나에 연결합니다. 최신 커밋을 풀하고 적용하기 전에 각 차이를 검토하며, 변경 사항을 하나의 커밋으로 푸시합니다. | 공개 호스트의 https 주소만 가능합니다. 브랜치에 풀하지 않은 커밋이 있으면 푸시가 거부됩니다. 풀당 64 MB, 작업당 120초, 계정당 시간당 작업 300회. 편집자 역할이 필요합니다. |
| Holarch의 Systems Modeling API | 다른 도구의 읽기 및 커밋 | 다른 SysML v2 도구는 개인 액세스 토큰으로 REST를 통해 SysML v2 프로젝트의 요소를 SysML v2 JSON으로 읽고, 변경 요청 브랜치에 변경을 커밋합니다. | main은 읽기 전용이며, 커밋은 승인자가 Holarch에서 적용하는 변경 요청으로 들어갑니다. 브랜치 헤드만 지원하며 태그, 병합, 저장된 쿼리는 없습니다. |
| SysML v1에서 SysML v2로(.xmi, .uml, .xml, .mdzip) | 가져오기 | Cameo 또는 MagicDraw, Enterprise Architect, Rhapsody, Papyrus의 SysML 1.x 모델이 SysML v2 텍스트로 변환되고, 검사되며, SysML v2 프로젝트나 새 프로젝트에 실행 취소 한 단계로 가져와집니다. 변환 보고서는 모든 요소를 변환됨, 근사 처리됨, 제외됨으로 이유와 함께 나열하며 CSV로 다운로드할 수 있습니다. | 다이어그램과 그 레이아웃은 변환되지 않습니다. 이름 없는 요소에 대한 관계는 제외됩니다. |
| LML에서 SysML v2로, 그리고 반대로 | 양방향 변환 사본 | 다른 언어로 된 새 프로젝트: Asset, 포트, Conduit, Input/Output, 요구사항, satisfy 연결, 테스트 케이스, 흐름이 있는 Action, 상태, 방정식. 위험, 결정, 작업, 문서, 화이트보드, 요구사항 상태, 테스트 결과도 함께 옮겨집니다. 보고서가 무엇이 변환되었고 무엇이 변환되지 않았는지 나열하며 CSV로 다운로드할 수 있습니다. | 다이어그램 레이아웃, 기록, 베이스라인, 변경 요청은 변환되지 않습니다. LML Measure와 Resource, 또는 SysML v2 계산과 분석 케이스처럼 한 언어에 들어갈 자리가 없는 요소는 보고서에 나열됩니다. |
요구사항 상태, 위험, 예산, 뷰 레이아웃처럼 SysML v2 모델 옆에 있는 Holarch 데이터는 .sysml이나 SysML v2 JSON 파일에 포함되지 않습니다. 프로젝트 내보내기는 이를 유지합니다.
스프레드시트 및 표
| 형식 | 방향 | 다루는 내용 | 알려진 제한 사항 |
|---|---|---|---|
| Excel(.xlsx, .xlsm) 및 CSV | 가져오기 | 머리글에서 제안되는 열 매핑으로 모든 클래스의 항목을 새로 만들거나 업데이트합니다. 속성, 레이블, 관계, 상위 열이나 번호로 만든 계층, 데이터에서 생성된 새 속성. 기존 항목을 업데이트하려면 ID, 이름 또는 번호로 대응시킵니다. | Excel 97-2003(.xls)과 세미콜론으로 구분된 CSV는 읽지 않습니다. 이름과 번호는 255자로 잘립니다. |
| 데이터베이스에서 Excel 및 CSV | 내보내기 | 임의의 항목 집합을 선택한 속성과 관계, 계층과 합산이 포함된 표, 정의, 관계 매트릭스, 변경 기록 또는 댓글로 내보냅니다. | Excel 셀은 최대 32,000자를 담으며, 더 긴 텍스트는 잘립니다. |
| 다른 페이지에서 Excel 및 CSV | 내보내기 | RVTM, VCRM, RVM, RTM, RSM, TVM. 요구사항 품질 결과. TBD/TBR 등록부. 인터페이스 등록부. N² 및 I² 매트릭스. 예산 및 TPM. 위험 등록부. 트레이드 스터디. 기능 분석 표. 베이스라인 비교. 차트 데이터. 시뮬레이터 타임라인, 이벤트 로그, 실행. | 각 페이지는 자체 열을 내보냅니다. |
| 추적성 매트릭스(.xlsx, .csv) | 가져오기 및 내보내기 | 임의의 관계를 매트릭스로 내보냅니다. 스프레드시트에서 통합 문서를 편집하고 다시 가져옵니다: 미리 보기에 추가할 연결, 제거할 연결, 건너뛴 셀이 나열됩니다. | 가져오기는 기존 항목 간의 연결만 추가하고 제거합니다. 스키마가 허용하지 않는 셀은 건너뛰고 나열됩니다. |
문서 및 보고서
| 형식 | 방향 | 다루는 내용 | 알려진 제한 사항 |
|---|---|---|---|
| Word(.docx) | 내보내기 | Word 제목 스타일, 표시, 표지, 페이지 번호가 있는 문서와 개요. 베이스라인 간 변경 내용 추적이 있는 변경 표시본. 엔터티 분해 구조. 다이어그램 보고서. ICD. 테스트 케이스. RVTM 및 추적성 매트릭스. 트레이드 스터디 요약. 기능 분석 보고서. DoDAF 아키텍처 패키지. | 페이지는 US Letter 크기입니다. |
| PowerPoint(.pptx) | 내보내기 | 페이지당 슬라이드 하나로, 텍스트 상자, 도형, 발표자 노트가 있는 프레젠테이션. 프레젠테이션은 HTML과 Word로도 내보낼 수 있습니다. | 없음. |
| Markdown(.md) | 내보내기 | Markdown 제목과 텍스트로 된 문서. | 없음. |
| HTML | 내보내기 | 다이어그램, 다이어그램 보고서, 차트, 프레젠테이션, 추적성 매트릭스의 웹 페이지. | 없음. |
| 인쇄 및 PDF | 내보내기 | PDF로 저장할 수 있는 브라우저의 인쇄 대화 상자를 통한 문서, 표, 다이어그램. 화이트보드는 PDF로 직접 내보냅니다. | 화이트보드 PDF 페이지는 이미지입니다. |
이미지
| 형식 | 방향 | 다루는 내용 | 알려진 제한 사항 |
|---|---|---|---|
| PNG 및 SVG | 내보내기 | 다이어그램, 차트, 슬라이드, 시뮬레이터 패널, 갤러리 카드. PNG는 선택한 배율로 배경 포함 또는 제외, SVG는 확대 가능한 벡터 이미지. | 없음. |
| 화이트보드: PNG, JPG, SVG, PDF | 내보내기 | 보드 하나, 선택 영역, 현재 뷰, 프레임 하나 또는 모든 보드. SVG는 벡터 도구에서 도형과 텍스트를 편집할 수 있게 유지합니다. | PDF 페이지는 이미지입니다. |
| 그림 및 첨부 파일 | 가져오기 | 서식 있는 텍스트의 그림, 엔터티 이미지, 파일 속성, 화이트보드, 슬라이드. 핫스폿이 있는 OV-1 같은 DoDAF 산출물용 PNG, JPEG, SVG 그래픽. | 가장 긴 변이 4,000 px를 넘는 그림은 축소됩니다. 파일은 Free 요금제 10 MB, Individual 25 MB, Team 100 MB로 제한되며, 프로젝트는 Free 요금제에서 100 MB로 제한됩니다. |
프로젝트 파일
| 형식 | 방향 | 다루는 내용 | 알려진 제한 사항 |
|---|---|---|---|
| Holarch 백업(.holarch) 및 프로젝트 파일(.json) | 가져오기 및 내보내기 | 백업이나 다른 Holarch 서버로의 이동을 위한 프로젝트 전체: 항목, 관계, 다이어그램, 베이스라인, 댓글, 기록, 홈 환경설정과 첨부 파일 및 그림. .holarch 백업은 모든 부분에 체크섬이 있으며 가져오기 전에 검사됩니다. 사용자가 소유하는 새 프로젝트로 가져옵니다. 백업 및 JSON 형식이 문서화되어 있습니다. | 항상 새 프로젝트로 가져옵니다. 열린 프로젝트에 병합하려면 아래의 병합 가져오기를 사용합니다. |
| 프로젝트에 병합(.holarch, .json) | 가져오기 | 첨부 파일이 포함된 Holarch 백업과 패키지, 그리고 Holarch 프로젝트, 데이터베이스, 문서 내보내기를 열린 프로젝트에 병합합니다. 클래스, 속성, 레이블, 관계는 이름으로 대응되며, 없는 스키마 항목은 먼저 추가할 수 있습니다. 선택하면 댓글, 기록, 다이어그램 레이아웃도 함께 옮겨집니다. | 파일에서 온 시뮬레이션 스크립트는 가져온 것으로 표시되며, 시뮬레이터가 실행 전에 확인을 요청합니다. |
| 프로젝트 패키지(.holarch) | 내보내기 | 선택한 항목과 그 관계, 다이어그램, 댓글, 스키마, 모든 첨부 파일로, 가져올 때 손상 여부를 검사합니다. | 선택한 항목을 담으며, 베이스라인과 기록은 포함되지 않습니다. |
| 스키마(.json) | 가져오기 및 내보내기 | 프로젝트의 클래스, 관계, 속성, 레이블. 가져오기는 프로젝트에 없는 것을 병합하거나 스키마를 대체합니다. | 없음. |
| 베이스라인 및 문서 데이터(.json) | 내보내기, 문서 데이터는 가져오기도 가능 | 날짜, 문서, 승인, 스냅샷이 있는 베이스라인. 다른 프로젝트에 병합할 수 있는 문서의 항목, 관계, 상태. | 없음. |
| DoDAF 산출물(JSON) 및 DM2 PES 하위 집합(XML) | 내보내기 | 아키텍처 설명, 데이터가 포함된 모든 산출물, 사전. XML은 사전을 DoDAF 메타 모델 용어로 기록합니다. | XML은 Holarch 자체 네임스페이스를 사용하며 DM2 PES 스키마에 대해 검증되지 않습니다. |
| MS Project 일정(.xml) | 내보내기 | 시뮬레이션 실행의 간트 행을 MS Project XML 일정으로. | 시뮬레이터 실행에서만 가능합니다. |
API 및 MCP
스크립트는 개인 액세스 토큰과 OpenAPI 설명을 사용하여 REST API로 프로젝트를 읽고 변경합니다. Claude 같은 AI 도구는 Model Context Protocol(MCP)로 연결되며, 그 변경은 적용되기 전에 검토하는 제안으로 도착합니다. API 및 MCP를 참조하십시오.