İçe ve dışa aktarma
İçe ve dışa aktarma biçimleri
Spesifikasyonları, elektronik tabloları, gereksinim alışverişi dosyalarını ve modelleri bir Holarch projesine getirin ve modeli belgeler, tablolar, görüntüler, alışveriş dosyaları ve eksiksiz proje dosyaları olarak dışarı alın. Bu sayfa her biçimi, hangi yönde çalıştığını, neyi taşıdığını ve bilinen sınırlarını listeler.
İçe ve dışa aktarmalar nasıl çalışır
- Dışa aktarmalar, görüntüleyiciler dahil her proje üyesine açıktır. İçe aktarmalar projeyi değiştirdiği için Sahip veya Düzenleyici rolü gerektirir.
- İçe ve dışa aktarma sayfasından yapılan bir içe aktarma bir önizleme gösterir, içe aktarılan öğelere yeni kimlikler verir ve tek bir geri alma adımıdır. Yeni öğe eklemek yerine mevcut öğeleri güncellemek için onları kimliğe, ada veya numaraya göre eşleştirin.
- İçe aktarılan içerik temizlenir: zengin metin betiklerini ve güvenli olmayan bağlantılarını, SVG resimleri betiklerini ve dış başvurularını kaybeder; DOCTYPE veya ENTITY bildirimleri içeren XML reddedilir.
- CSV dışa aktarmaları, bir elektronik tablonun formül olarak çalıştıracağı metni etkisiz hâle getirir. Dosya adları her işletim sistemi için temizlenir.
- Her proje bir LML projesi veya bir SysML v2 projesidir. Word, elektronik tablo, metin ve ReqIF içe aktarmaları LML projeleri içindir. SysML v2 projeleri SysML v2 metni ve JSON'u ve SysML v2'ye dönüştürülen XMI veya .mdzip olarak SysML 1.x modellerini içe aktarır. LML projeleri de XMI içe aktarır. Proje dosyaları ve ortak sayfaların Word, Excel ve CSV dışa aktarmaları her ikisinde de çalışır.
Atla: Gereksinimler ve spesifikasyonlar · Modeller · Elektronik tablolar ve tablolar · Belgeler ve raporlar · Görüntüler · Proje dosyaları · API ve MCP
Gereksinimler ve spesifikasyonlar
| Biçim | Yön | Kapsamı | Bilinen sınırlar |
|---|---|---|---|
| Word (.docx) | İçe aktarma | Bir spesifikasyon numaralı bir belgeye dönüşür. Başlıklar düzeye göre iç içe geçmiş Statement'lara; "shall", "must", "will" veya "should" içeren paragraflar ve numaralı liste öğeleri Requirement'lara dönüşür. Tablolar satır başına bir öğe olur veya bir açıklamada tablo olarak kalır. Kalın, italik, listeler ve resimler korunur, eklenmiş izlenen değişiklikler okunur ve özgün dosya eklenir. | PNG, JPEG, GIF, WebP ve SVG dışındaki EMF, WMF ve diğer biçimlerdeki resimler atlanır. Silinmiş izlenen metin içe aktarılmaz. |
| Düz metin (.txt veya yapıştırılmış) | İçe aktarma | Numaralı satırlar ve "shall" cümleleri, Statement'lar ve Requirement'lardan oluşan numaralı bir belgeye dönüşür. Ana hat numaralandırması algılanır veya seçilir: ondalık, Roma rakamı, harf, karma düzeyler, DoD stili veya özel bir desen. | Yapı yalnızca numaralandırmadan ve ifadelerden gelir. |
| ReqIF (.reqif, .reqifz) | İçe ve dışa aktarma | İçe aktarma: her SPEC-OBJECT, spesifikasyon hiyerarşisi, sınıf olarak türü ve string, XHTML, Boolean, tarih, numaralandırma, tam sayı ve gerçek sayı öznitelikleriyle bir öğe olur. SPEC-RELATION'lar ilişki olur; satisfy, verify ve deriveReqt satisfies, verifies ve traced from; trace ve refine traced to olur. Veritabanından veya bir belgeden dışa aktarma: numara, ad, açıklama ve her öznitelikle sınıf başına bir tür, SPEC-RELATION olarak ilişkiler ve hiyerarşi olarak ayrıştırma. | Karşılığı olmayan ilişki türleri traced to olur; şemanın izin vermediği bağlantılar bir uyarıyla atlanır. |
Modeller
| Biçim | Yön | Kapsamı | Bilinen sınırlar |
|---|---|---|---|
| UML ve SysML 1.x XMI (.xmi, .uml, .xml, .mdzip) | İçe ve dışa aktarma | İçe aktarma: UML 2.5 ve SysML 1.3 ile 1.7 profiliyle XMI 2.x ve .mdzip proje arşivleri. Kimlikleri ve metinleriyle gereksinimler, bloklar, parçalar, portlar, değer özellikleri, birimli değer türleri, genellemeler, bağlayıcılar ve öğe akışları, kontrol akışlarıyla aktiviteler, paralel durumlar ve choice, junction, fork ve join geçişleriyle durum makineleri, sıra diyagramları, test senaryoları, paketler, stereotipler ve etiketli değerler. Satisfy, verify, deriveReqt, refine, trace, copy ve allocate, Holarch ilişkilerine dönüşür. Blok, iç blok, durum makinesi ve eylem diyagramları içe aktarılan modelden çizilir. Dışa aktarma: Cameo/MagicDraw, Enterprise Architect ve Rhapsody için SysML 1.6 XMI (XMI 2.5.1) veya Papyrus için Papyrus (Eclipse UML, .uml); gereksinimler, bloklar, parçalar, portlar, birimli değer türleri, kısıt blokları, öğe akışlı bağlayıcılar, aktiviteler, kullanım durumları, test senaryoları, durum makineleri ve izleme ilişkileriyle. İçe aktarılan öğeler XMI kimliklerini korur ve dışa aktarma bunları geri yazar; böylece aynı modelin sonraki bir sürümünü içe aktarmak kopya eklemek yerine öğeleri günceller. Holarch öznitelikleri ve etiketleri açıkken dosya Holarch'a kayıpsız geri aktarılır. | Diyagram yerleşimleri ve işlemler içe aktarılmaz; inceleme dışarıda bırakılanları listeler. Bir aktivitenin akışı yalnızca iyi yapılandırılmışsa çizilir. Artifact, Task, Risk, Issue, Decision, Time ve Cost öğeleri dışa aktarılmaz. |
| Java kaynağı (.java) | İçe aktarma | Bir sınıf diyagramında: sınıflar, arayüzler ve numaralandırmalar Asset, alanlar Characteristic, metotlar da parametreleri ve sonuçları Input/Output olan Action olur. | Her seferinde tek bir dosya veya yapıştırılmış kaynak. |
| SysML v2 metni (.sysml veya .sysml dosyalarından oluşan bir .zip) | İçe ve dışa aktarma | Paket başına bir önizlemeyle bir SysML v2 projesine veya yeni bir projeye içe aktarma: yeni, değişmiş, değişmemiş veya çakışma. Bir zip içindeki klasörler paket olur. Modelin tamamını veya tek bir paketi dışa aktarın; birkaç paket bir zip olarak iner. | Metin öğe kimliği taşımaz; bu yüzden yeniden içe aktarma öğeleri ada göre eşleştirir. KerML (.kerml) dosyaları içe aktarılmaz. İçe aktarma başına en fazla 2.000 dosya, 8 MB metin ve 16 MB zip; metin UTF-8 olmalıdır. |
| SysML v2 JSON (.json) | İçe ve dışa aktarma | Systems Modeling API'nin kullandığı, @id ve @type içeren düz öğe listesi. Öğe kimlikleri korunur; bu yüzden yeniden içe aktarma kimliğe göre eşleştirir. | En fazla 24 MB ve 100.000 öğe. Holarch'ın yorumlamadığı öğe türleri içe aktarıldığı gibi korunur, Yorumlanmadı olarak işaretlenir ve değiştirilmeden geri yazılır. |
| SysML v2 model deposu | Çekme ve gönderme | Bir SysML v2 projesini Systems Modeling API'yi sunan bir deponun tek bir dalına bağlayın. En son commit'i çekin ve her farkı uygulamadan önce inceleyin; değişikliklerinizi tek bir commit olarak gönderin. | Yalnızca genel ana makinelerdeki https adresleri. Dalda çekilmemiş commit'ler varken gönderme reddedilir. Çekme başına 64 MB, işlem başına 120 saniye ve hesap başına saatte 300 işlem. Düzenleyici rolü gerektirir. |
| Holarch'ta Systems Modeling API | Diğer araçların okuması ve commit yapması | Diğer SysML v2 araçları bir SysML v2 projesinin öğelerini kişisel erişim belirteciyle REST üzerinden SysML v2 JSON olarak okur ve değişiklikleri değişiklik talebi dallarına commit eder. | main salt okunurdur; commit'ler bir onaylayıcının Holarch'ta uyguladığı değişiklik taleplerine gider. Yalnızca dal uçları; etiket, birleştirme veya kayıtlı sorgu yok. |
| SysML v1'den SysML v2'ye (.xmi, .uml, .xml, .mdzip) | İçe aktarma | Cameo veya MagicDraw, Enterprise Architect, Rhapsody ya da Papyrus'tan bir SysML 1.x modeli SysML v2 metnine dönüştürülür, denetlenir ve tek bir geri alma adımı olarak bir SysML v2 projesine veya yeni bir projeye içe aktarılır. Bir dönüştürme raporu her öğeyi nedeniyle birlikte dönüştürüldü, yaklaşık aktarıldı veya dışarıda bırakıldı olarak listeler ve CSV olarak indirilebilir. | Diyagramlar ve yerleşimleri dönüştürülmez. Adsız öğelere giden ilişkiler dışarıda bırakılır. |
| LML'den SysML v2'ye ve geri | Her iki yönde dönüştürülmüş kopya | Diğer dilde yeni bir proje: Asset'ler, portlar, Conduit'ler, Input/Output'lar, gereksinimler, satisfy bağlantıları, test senaryoları, akışlarıyla Action'lar, durumlar ve denklemler. Riskler, kararlar, görevler, belgeler, beyaz tahtalar, gereksinim durumu ve test sonuçları da aktarılır. Bir rapor neyin dönüştürüldüğünü ve neyin dönüştürülmediğini listeler ve CSV olarak indirilebilir. | Diyagram yerleşimleri, geçmiş, temel çizgiler ve değişiklik talepleri dönüştürülmez. LML Measure ve Resource'ları veya SysML v2 hesaplamaları ve analiz senaryoları gibi bir dilde karşılığı olmayan öğeler raporda listelenir. |
Bir SysML v2 modelinin yanındaki gereksinim durumu, riskler, bütçeler ve görünüm yerleşimleri gibi Holarch verileri .sysml veya SysML v2 JSON dosyalarının parçası değildir. Bir proje dışa aktarması bunları korur.
Elektronik tablolar ve tablolar
| Biçim | Yön | Kapsamı | Bilinen sınırlar |
|---|---|---|---|
| Excel (.xlsx, .xlsm) ve CSV | İçe aktarma | Başlıklardan önerilen bir sütun eşlemesiyle herhangi bir sınıftan yeni veya güncellenmiş öğeler. Öznitelikler, etiketler, ilişkiler, bir üst öğe sütunundan veya numaralardan hiyerarşi ve verilerden oluşturulan yeni öznitelikler. Mevcut öğeleri güncellemek için onları kimliğe, ada veya numaraya göre eşleştirin. | Excel 97-2003 (.xls) ve noktalı virgülle ayrılmış CSV okunmaz. Adlar ve numaralar 255 karaktere kısaltılır. |
| Veritabanından Excel ve CSV | Dışa aktarma | Herhangi bir öğe kümesi; seçilen öznitelikler ve ilişkilerle bir tablo olarak, hiyerarşi ve toplamalarla, tanımlar olarak, bir ilişki matrisi olarak, değişiklik geçmişi olarak veya yorumlar olarak. | Excel hücreleri en fazla 32.000 karakter tutar; daha uzun metin kesilir. |
| Diğer sayfalardan Excel ve CSV | Dışa aktarma | RVTM, VCRM, RVM, RTM, RSM ve TVM; gereksinim kalitesi sonuçları; TBD/TBR kaydı; arayüz kaydı; N² ve I² matrisleri; bütçeler ve TPM'ler; risk kaydı; ödünleşim çalışmaları; fonksiyonel analiz tabloları; temel çizgi karşılaştırmaları; grafik verileri; simülatör zaman çizelgeleri, olay günlükleri ve çalıştırmalar. | Her sayfa kendi sütunlarını dışa aktarır. |
| İzlenebilirlik matrisi (.xlsx, .csv) | İçe ve dışa aktarma | Herhangi bir ilişkiyi matris olarak dışa aktarın. Çalışma kitabını bir elektronik tabloda düzenleyin ve geri içe aktarın: önizleme eklenecek bağlantıları, kaldırılacak bağlantıları ve atlanan hücreleri listeler. | İçe aktarma yalnızca mevcut öğeler arasındaki bağlantıları ekler ve kaldırır. Şemanın izin vermediği hücreler atlanır ve listelenir. |
Belgeler ve raporlar
| Biçim | Yön | Kapsamı | Bilinen sınırlar |
|---|---|---|---|
| Word (.docx) | Dışa aktarma | Word başlık stilleri, gizlilik işaretleri, kapak sayfaları ve sayfa numaraları içeren belgeler ve ana hatlar; temel çizgiler arasındaki izlenen değişikliklerle düzeltme işaretli sürümler; nesne ayrıştırmaları; diyagram raporları; ICD'ler; test senaryoları; RVTM ve izlenebilirlik matrisleri; ödünleşim çalışması özetleri; fonksiyonel analiz raporları; DoDAF mimari paketi. | Sayfalar US Letter boyutundadır. |
| PowerPoint (.pptx) | Dışa aktarma | Sayfa başına bir slayt olmak üzere metin kutuları, şekiller ve konuşmacı notları içeren sunular. Sunular HTML ve Word olarak da dışa aktarılır. | Belirtilen yok. |
| Markdown (.md) | Dışa aktarma | Markdown başlıkları ve metni olarak bir belge. | Belirtilen yok. |
| HTML | Dışa aktarma | Diyagramların, diyagram raporlarının, grafiklerin, sunuların ve izlenebilirlik matrislerinin web sayfaları. | Belirtilen yok. |
| Yazdırma ve PDF | Dışa aktarma | Belgeler, tablolar ve diyagramlar tarayıcının PDF kaydeden yazdırma iletişim kutusu üzerinden. Beyaz tahtalar doğrudan PDF dışa aktarır. | Beyaz tahta PDF sayfaları görüntüdür. |
Görüntüler
| Biçim | Yön | Kapsamı | Bilinen sınırlar |
|---|---|---|---|
| PNG ve SVG | Dışa aktarma | Diyagramlar, grafikler, slaytlar, simülatör panelleri ve galeri kartları. Seçilen ölçekte, arka planlı veya arka plansız PNG; ölçeklenebilir vektör görüntüsü olarak SVG. | Belirtilen yok. |
| Beyaz tahtalar: PNG, JPG, SVG, PDF | Dışa aktarma | Bir pano, bir seçim, geçerli görünüm, bir çerçeve veya tüm panolar. SVG, şekilleri ve metni vektör araçlarında düzenlenebilir tutar. | PDF sayfaları görüntüdür. |
| Resimler ve ekli dosyalar | İçe aktarma | Zengin metindeki resimler, nesne görüntüleri, dosya öznitelikleri, beyaz tahtalar ve slaytlar. DoDAF ürünleri için PNG, JPEG veya SVG grafikleri, örneğin etkin noktalı bir OV-1. | En uzun kenarı 4.000 px'i aşan resimler küçültülür. Dosyalar Free planında 10 MB, Individual planında 25 MB ve Team planında 100 MB ile, projeler ise Free planında 100 MB ile sınırlıdır. |
Proje dosyaları
| Biçim | Yön | Kapsamı | Bilinen sınırlar |
|---|---|---|---|
| Holarch yedeği (.holarch) ve proje dosyası (.json) | İçe ve dışa aktarma | Yedekleme veya başka bir Holarch sunucusuna taşıma için projenin tamamı: öğeler, ilişkiler, diyagramlar, temel çizgiler, yorumlar, geçmiş ve Ana sayfa tercihleri, ekler ve resimlerle birlikte. Bir .holarch yedeği her parça için bir sağlama toplamı taşır ve içe aktarılmadan önce denetlenir. Sahibi olduğunuz yeni bir proje olarak içe aktarılır. Yedek ve JSON biçimleri belgelenmiştir. | Her zaman yeni bir proje; açık bir projeyle birleştirmek için aşağıdaki birleştirerek içe aktarmayı kullanın. |
| Bir projeyle birleştirme (.holarch, .json) | İçe aktarma | Ekli dosyalarıyla Holarch yedekleri ve paketleri ile Holarch proje, Veritabanı ve belge dışa aktarımları, açık projeyle birleştirilir. Sınıflar, öznitelikler, etiketler ve ilişkiler ada göre eşleştirilir; eksik şema öğeleri önce eklenebilir. Seçildiğinde yorumlar, geçmiş ve diyagram yerleşimleri de aktarılır. | Bir dosyadan gelen simülasyon betikleri içe aktarılmış olarak işaretlenir ve simülatör bunları çalıştırmadan önce sorar. |
| Proje paketi (.holarch) | Dışa aktarma | Seçilen öğeler ilişkileri, diyagramları, yorumları ve şemalarıyla birlikte ve tüm ekli dosyalar; içe aktarmada hasara karşı denetlenir. | Seçilen öğeleri tutar; temel çizgiler ve geçmiş dahil değildir. |
| Şema (.json) | İçe ve dışa aktarma | Bir projenin sınıfları, ilişkileri, öznitelikleri ve etiketleri. İçe aktarma projede eksik olanları birleştirir veya şemayı değiştirir. | Belirtilen yok. |
| Temel çizgiler ve belge verileri (.json) | Dışa aktarma; belge verileri içe de aktarılır | Tarihi, belgesi, onayları ve anlık görüntüsüyle bir temel çizgi. Bir belgenin başka bir projeyle birleştirilebilen öğeleri, ilişkileri ve durumu. | Belirtilen yok. |
| DoDAF ürünleri (JSON) ve DM2 PES alt kümesi (XML) | Dışa aktarma | Mimari açıklama, verileriyle birlikte her ürün ve sözlük. XML, sözlüğü DoDAF Meta Model terimleriyle yazar. | XML, Holarch'ın kendi ad alanını kullanır ve DM2 PES şemasına göre doğrulanmaz. |
| MS Project takvimi (.xml) | Dışa aktarma | Bir simülasyon çalıştırmasının Gantt satırları, MS Project XML takvimi olarak. | Yalnızca simülatör çalıştırmalarından. |
API ve MCP
Betikler, kişisel erişim belirteci ve bir OpenAPI açıklamasıyla REST API üzerinden projeleri okur ve değiştirir. Claude gibi YZ araçları Model Context Protocol (MCP) üzerinden bağlanır; yaptıkları değişiklikler, uygulanmadan önce incelediğiniz öneriler olarak gelir. Bkz. API ve MCP.