SysML v2
SysML v2 modellerinin alışverişi
.sysml dosyalarını, zip arşivlerini ve SysML v2 JSON'unu önizlemeyle bir SysML v2 projesine içe aktarın; modeli veya bir paketi .sysml metni ya da SysML v2 JSON olarak dışa aktarın.
Bu sayfada
- Genel bakış
- Kavramlar
- Nasıl kullanılır
- Ne zaman ve neden
- Dosyaları bu projeye içe aktarın
- Dosyaları yeni bir projeye içe aktarın
- Bir paketi yeni bir sürümden güncelleyin
- Metinde öğeleri yeniden adlandırın ve taşıyın, kimliklerini koruyun
- Barındırılan hizmette büyük içe aktarmalar
- Modeli veya bir paketi dışa aktarın
- ReqIF gereksinimlerini içe ve dışa aktarın
- Bir depodan çekin ve bir depoya gönderin
- Çalışılmış örnek: Hybrid Car demosu
- İpuçları ve iyi uygulamalar
- Yaygın hatalar
- Diğer özelliklerle nasıl bağlantılıdır
- İçe ve dışa aktarma sayfası
- Depo
- Dosyalar nasıl okunur
- İletiler
- Sınırlar
- İlgili sayfalar
Genel bakış
SysML v2 projeleri modelleri diğer SysML v2 araçlarıyla dosya olarak alıp verir. İçe ve dışa aktarma sayfası (Model → İçe ve dışa aktarma) ikisini de yapar:
- İçe aktar,
.sysmldosyalarını,.sysmldosyalarından oluşan bir.zip'i veya bir SysML v2 JSON dosyasını okur. Neyin değiştiğinin önizlemesini gösterir, ardından bunu bu projeye uygular (tek bir Geri al ile hepsi geri alınır) veya yeni bir SysML v2 projesi oluşturur. - Dışa aktar, tüm modeli veya tek bir paketi SysML v2 metni (
.sysml) veya SysML v2 JSON (.json) olarak yazar. - Gereksinim araçlarından gelen ReqIF dosyaları (
.reqif,.reqifz) SysML v2 gereksinimleri olarak içe aktarılır ve gereksinimler ReqIF olarak dışa aktarılır: bkz. ReqIF gereksinimlerini içe ve dışa aktarın.
Doğrudan dosyalardan da proje oluşturabilirsiniz: Projeleri yönet'te Proje dosyaları ▾ → SysML v2 dosyalarını içe aktar…'a tıklayın.
İpucu: Modeli Systems Modeling API sunan bir SysML v2 model deposuyla eşzamanlı tutmak için aynı sayfanın Depo bölümünü kullanın: bkz. Bir depodan çekin ve bir depoya gönderin.
Kavramlar
Dosya biçimleri
| Biçim | İçindekiler | İçe aktarma | Dışa aktarma |
|---|---|---|---|
SysML v2 metni (.sysml) | Metinsel gösterim; üst düzey paket başına bir dosya. | Evet | Evet |
Zip arşivi (.zip) | Birkaç .sysml dosyası. Klasörler paket olur. | Evet | Evet, birkaç dosya dışa aktarıldığında |
SysML v2 JSON (.json) | Systems Modeling API'nin kullandığı biçimde, her biri @id ve @type içeren düz bir öğe listesi. | Evet | Evet |
ReqIF (.reqif, .reqifz) | DOORS, Polarion, Jama, codebeamer ve diğer gereksinim araçlarından öznitelikleri, hiyerarşisi ve ilişkileriyle gereksinimler. | Evet, gereksinimlere dönüştürülerek | Evet, gereksinimler |
KerML dosyaları (.kerml) henüz içe aktarılmıyor.
Kimlikler ve eşleştirme
Bir SysML v2 projesindeki her öğenin bir kimliği vardır. İki biçim onu farklı şekilde korur:
- JSON kimlikleri korur. JSON'dan yeniden içe aktarılan bir öğe aynı kimliğe sahip öğeyle eşleşir.
- Standart kitaplık başvuruları anlaşılır. Systems Modeling API'den, SysML v2 Pilot Implementation'dan veya başka bir depodan gelen JSON, standart kitaplık öğelerini (
ISQ::mass,ScalarValues::Real,Parts::Partgibi birimler) standart kimlikleriyle adlandırır. İçe aktarma onları aynı kitaplık öğeleri olarak okur; böylece birimler ve türler çözümlenmiş kalır. - Metin, istediğinizde kimlikleri korur.
.sysmlmetni dışa aktarırken Öğe kimliklerini dahil et'i işaretleyin. Bu durumda her adlandırılmış tanım, kullanım ve paket kimliğini gövdesinin ilk satırı olarak taşır:@HolarchMetadata::ElementId { id = "…"; }. Bu metin yeniden içe aktarıldığında kimliği olan her öğe, yeniden adlandırılmış, başka bir sahibe veya başka bir üst düzey pakete taşınmış ya da yeniden sıralanmış olsa bile aynı kimliğe sahip öğeyle eşleşir. Diyagram konumları, yorumları, izleri ve bağlantıları korunur. - Kimliksiz metin ada göre eşleştirilir. Holarch üst düzey paketleri adlarına, içlerindeki öğeleri ise adlarına ve konumlarına göre eşleştirir. Öğelerin eşleştiği yerde kimlikler korunur. Yeniden adlandırılan bir öğe yerini koruduğunda yine eşleşir; aynı anda yeniden adlandırılan ve taşınan bir öğe yeni bir öğe olur.
Dışa aktarma bunu dışa aktarma denetimlerinin altında belirtir: “Öğe kimlikleri JSON'da korunur. .sysml metninde onları korumak için Öğe kimliklerini dahil et'i işaretleyin: böylece düzenlenen metin yeniden içe aktarıldığında, yeniden adlandırma veya taşımadan sonra bile öğeler diyagram konumlarını, yorumlarını ve izlerini korur. Kimlikler olmadan öğeler ada göre eşleştirilir.”
Metindeki öğe kimlikleri
@HolarchMetadata::ElementId { id = "…"; } sıradan SysML v2 üst verisidir: ElementId, Holarch'ın kendi kitaplık paketi HolarchMetadata'daki (Standart kitaplıkta Holarch altında), TBD ve TBR'nin yanındaki bir üst veri tanımıdır. Diğer SysML v2 araçları satırı bir üst veri açıklaması olarak okur; adını çözümlemek için o kitaplıktan HolarchMetadata.sysml'e ihtiyaç duyarlar.
- Kimlik, satırı gövdesinde tutan öğeye aittir. Adsız öğeler (bağlantılar, ardışıklıklar, yorumlar) kimlik taşımaz ve eskisi gibi içeriklerine göre eşleştirilir.
- Holarch satırı bir öğe olarak tutmaz. Düzenleyici modeli bu satırlar olmadan gösterir ve gövdesinde yalnızca bu satır olan bir öğe
part engine : Engine;olarak gösterilir. - Kimlikler benzersiz olmalıdır. Aynı kimlik iki kez göründüğünde (örneğin metinde bir blok kopyalandıktan sonra) ilk öğe onu korur ve kopya yeni bir öğe olur.
- UUID olmayan bir kimlik (örneğin
"R-17") sabit bir UUID'ye dönüştürülür; böylece, bir JSON içe aktarmasında olduğu gibi, aynı dize her zaman aynı öğeyi verir. - Projede bulunmayan bir kimlik yeni öğe için korunur. Holarch'ta bir öğeyi silip metni yeniden içe aktarmak onu eski kimliğiyle geri getirir.
- Düzenleyici'de yapıştırılan bir satır düzenlediğiniz paketin içinde çalışır: başka bir paketin öğesine ait bir kimlik orada yok sayılır ve öğe ada göre eşleştirilir. Öğeleri paketler arasında taşıyıp kimliklerini korumak için kimliklerle dışa aktarın ve düzenlenen dosyaları içe aktarın.
Hybrid Car demosunun Car parça tanımı kaynak dosyasında böyle bir satır taşır; bu nedenle kimliği demonun her kopyasında aynıdır.
Klasörler paket olur
Bir zip arşivinde her klasör, dosyalarını ve alt klasörlerini tutan bir paket olur. Arşivin içindeki bir powertrain/engine.sysml dosyası, package powertrain { … } içinde yazılmış gibi okunur. Arşivin en üstündeki dosyalar olduğu gibi okunur. Klasörler ve dosyalar ad sırasıyla okunur.
Önizleme neyi karşılaştırır
Önizlemede üst düzey paket başına (veya yeni bir proje için üst düzey öğe başına) bir satır vardır. Her satırın bir sonucu vardır:
| Sonuç | Anlamı | Varsayılan olarak içe aktarılır |
|---|---|---|
| Yeni | Projede bu adda (veya kimlikte) bir paket yok. Eklenir. | Evet |
| Değiştirildi | Projede paket var; içe aktarma içinde öğe ekler, değiştirir veya kaldırır. Ayrıntı kaç tane olduğunu söyler; örneğin “3 eklendi, 1 değiştirildi (öğelerin eşleştiği yerde kimlikler korundu)”. | Evet |
| Değişmedi | Paket bu projedekiyle aynı. | Hayır (yapılacak bir şey yok) |
| Çakışma | Paket birleştirilemiyor. Ayrıntı nedenini ve ne yapılacağını söyler. | Hayır |
Nasıl kullanılır
Ne zaman ve neden
Bir model Holarch ile başka bir SysML v2 aracı arasında veya Holarch projeleri arasında taşınırken İçe ve dışa aktarma'yı kullanın:
- Başka bir yerde yazılmış bir modelden bir Holarch projesi başlatın.
- Başka bir ekibin sürdürdüğü bir paketi (örneğin bir bileşen kitaplığı) getirin ve yeni bir sürüm gönderdiklerinde güncelleyin.
- Bir paketi bir tedarikçiye veya SysML v2 metni ya da JSON okuyan bir araca verin.
.sysmldosyalarını Holarch projesinin yanında kendi sürüm denetiminizde tutun.
Dosyaları bu projeye içe aktarın
- Model → İçe ve dışa aktarma'yı açın.
- İçe aktar altında Bu projeye'yi seçin.
- Dosyaları bırakma alanına bırakın veya ona tıklayıp seçin.
“Dosyalar okunuyor…” iletisini, ardından önizlemeyi görürsünüz: üst düzey paket ve dosya sayısı, varsa sorunlar ve İçe aktar, Paket, Öğeler ve Sonuç içeren bir tablo.
- Varsa sorunlar listesini okuyun. Liste, ayrıştırılamayan her dosyayı ve satırı ve atlanan her dosyayı adlandırır.
- İçe aktarmak istemediğiniz paketlerin işaretini kaldırın. Adı çakışan bir paketi değiştirmek için onu işaretleyin.
Öğe sınırı olan bir planda önizleme, projenin içe aktarmadan sonra sahip olacağı öğeleri sayar (ilişkiler sayılmaz). Bu sayı sınırı aşıyorsa önizleme bunu belirtir, örneğin “Bu içe aktarma projeyi 1,804 öğeye çıkarır; Free planı 1,000 öğeye izin verir.” ve yeterli sayıda paketin işaretini kaldırana kadar N paketi içe aktar kapalı kalır. Hiçbir şey uygulanmaz veya sunucuya gönderilmez. Yeni bir projeye yapılan içe aktarmalar da aynı şekilde planınızın proje başına sınırına göre denetlenir.
- N paketi içe aktar düğmesine tıklayın.
Bildirimde “N paket içe aktarıldı.” yazar. Sayfada “N paket içe aktarıldı (M öğe). Geri al, içe aktarmayı tek adımda geri döndürür.” yazar. Paketleri görmek için Metni aç düğmesine tıklayın.
Dosyaları yeni bir projeye içe aktarın
- Model → İçe ve dışa aktarma sayfasını açın ve Yeni bir SysML v2 projesine seçeneğini seçin.
- Dosyaları bırakın veya seçin.
Önizleme, tümü işaretli olarak en üst düzey öğeleri listeler.
- İstemediklerinizin işaretini kaldırın ve Proje adı alanını düzenleyin. Varsayılan ad, tek dosyanın veya ilk paketin adıdır.
- Proje oluştur düğmesine tıklayın.
Yeni proje Düzenleyici'de açılır.
Projeleri yönet sayfasında Proje dosyaları ▾ → SysML v2 dosyalarını içe aktar… aynı işi tek adımda yapar. Dosyaların bazı bölümleri okunamıyorsa önce sorar: “N sorun bulundu: dosyaların bazı bölümleri dışarıda bırakıldı. Proje geri kalanıyla oluşturulsun mu? Önce sorunları görmek için bir SysML v2 projesi açın ve İçe ve dışa aktarma sayfasını kullanın.” Devam etmek için Proje oluştur düğmesine tıklayın.
Bir paketi yeni bir sürümden güncelleyin
- Yeni sürümü
.sysmldosyaları veya JSON olarak dışa aktarın ya da bu biçimde alın. - Onu Bu projeye içe aktarın.
Paket, eklenen, değiştirilen ve kaldırılan öğe sayılarıyla birlikte Değişti olarak görünür.
- 1 paketi içe aktar düğmesine tıklayın.
Eşleşen öğeler kimliklerini korur; bu nedenle onlara giden bağlantılar (gereksinim bağlantıları, riskler, görünüm yerleşimleri, yorumlar) kalır. Artık dosyada olmayan öğeler Çöp kutusuna taşınır.
Metinde öğeleri yeniden adlandırın ve taşıyın, kimliklerini koruyun
- Paketleri Öğe kimliklerini dahil et işaretli olarak SysML v2 metni biçiminde dışa aktarın.
- Dosyaları düzenleyin: öğeleri yeniden adlandırın, başka sahiplere veya başka bir paket dosyasına taşıyın, yeniden sıralayın. Her
@HolarchMetadata::ElementIdsatırını kendi öğesinin gövdesi içinde tutun. - Düzenlenen dosyaları Bu projeye içe aktarın.
Paketler Değişti olarak görünür. Yeniden adlandırılan ve taşınan öğeler eklenmiş ve kaldırılmış olarak değil, değişmiş olarak sayılır.
- N paketi içe aktar düğmesine tıklayın.
Öğeler kimliklerini korur: diyagram konumları, yorumları, izleri ve bağlantıları kalır. Başka bir pakete taşınan öğeler bulundukları paketten çıkar.
Barındırılan hizmette büyük içe aktarmalar
Barındırılan hizmette 5,000 veya daha fazla öğelik bir içe aktarma tarayıcınız tarafından değil, sunucu tarafından uygulanır. İşaretli her paket Yeni olduğunda veya bir Çakışma paketini değiştirdiğinde, dosyaları sunucunun kendisi okur (aşağıdaki adımlar). İşaretli bir paket Değişti olduğunda, birleştirmeyi her zamanki gibi tarayıcınız hesaplar ve değişiklikleri bir kez karşıya yükler; ardından sunucu bunları aynı ilerleme kartı, İçe aktarmayı iptal et ve İçe aktarmayı geri al ile tek adımda yazar.
- Dosyaları seçin ve önizlemeyi her içe aktarmada olduğu gibi denetleyin.
- N paketi içe aktar (veya Proje oluştur) düğmesine tıklayın.
Dosyalar bir kez karşıya yüklenir. Sunucu bunları önizlemeyle aynı denetimler ve aynı öğe kimlikleriyle okur ve sonucu tek adımda yazar.
- Pencerenin altındaki ilerleme kartını izleyin: kart aşamayı (karşıya yükleme, okuma, denetleme, uygulama, proje dizinini güncelleme) ve kalan süreyi gösterir.
Sayfadan ayrılabilir veya sekmeyi kapatabilirsiniz. İçe aktarma sunucuda devam eder ve projeyi yeniden açtığınızda sonucu oradadır. İçe aktarma uygulandığında projenin açık olan her kopyası yeniden yüklenir; gönderilmemiş düzenlemeler yeniden yüklemeden sonra tekrar gönderilir.
- Diğer üyeler aynı kartta ve İçe ve dışa aktarma sayfasında “Ad, dosya içe aktarıyor…” iletisini görür.
- Bir seferde tek içe aktarma: aynı projeye yapılan ikinci bir büyük içe aktarma, ilki bitene kadar bekler.
- İçe aktarmayı iptal et (başlatan kişi veya bir sahip) içe aktarmayı uygulanmadan önce durdurur. Hiçbir şey değişmez.
- İçe aktarmayı geri al: tarayıcıdaki ⌘Z / Ctrl+Z, sunucuda yapılan bir içe aktarmayı geri almaz. Projeyi son içe aktarmadan önceki durumuna döndürmek için İçe ve dışa aktarma sayfasında İçe aktarmayı geri al düğmesine tıklayın. Geri almadan önceki durum Geçmiş içinde saklanır; böylece içe aktarmadan sonra yapılan düzenlemeler oradan kurtarılabilir.
- Proje etkinliği ve Geçmiş, içe aktarmayı başlatan kişiye ait tek bir kayıt olarak listeler.
Modeli veya bir paketi dışa aktarın
- Model → İçe ve dışa aktarma'yı açın.
- Dışa aktar altında neyin dışa aktarılacağını seçin: Tüm model veya nitelikli adıyla bir paket.
- Biçimi seçin: SysML v2 metni (.sysml; birden çok paket için .zip) veya SysML v2 JSON (.json).
- Düzenleyip yeniden içe aktaracağınız metin için Öğe kimliklerini dahil et seçeneğini işaretleyin.
- Dışa aktar düğmesine tıklayın.
Tek bir dosya iner; dışa aktarma birden çok dosya içeriyorsa bir zip iner. Bildirimde “<file> dışa aktarıldı.” veya “N dosya zip olarak dışa aktarıldı.” yazar.
Tek bir paketi hızlıca dışa aktarmak için Gezgin'i kullanın: bir paketin satır menüsünde .sysml olarak dışa aktar ve JSON olarak dışa aktar bulunur.
ReqIF gereksinimlerini içe ve dışa aktarın
ReqIF, gereksinim araçlarının değişim biçimidir. Bir ReqIF dosyası tek bir SysML v2 gereksinim paketi olarak içe aktarılır ve gereksinimler yeniden ReqIF olarak dışa aktarılır; böylece bir gereksinim aracı ile bir SysML v2 projesi aynı gereksinimleri iki yönde de alıp verebilir.
Bir ReqIF dosyasını içe aktarın:
- Model → İçe ve dışa aktarma sayfasını açın (veya Gereksinimler sayfasında İçe aktar… düğmesine tıklayın ya da ⌘K / Ctrl+K içinde ReqIF içe aktar… komutunu seçin).
.reqifveya.reqifzdosyasını kutuya bırakın ya da seçmek için kutuya tıklayın. Her içe aktarmada bir ReqIF dosyası.- ReqIF paneli gereksinim, bölüm ve ilişki sayısını, bunlardan kaçının dönüştürüldüğünü, yaklaşık olarak aktarıldığını veya dışarıda bırakıldığını ve SysML v2 metninin sorunsuz denetlenip denetlenmediğini gösterir.
- Kısa adların kaynağı altında Yabancı kimlik (kaynak araçta kişilerin gördüğü numara, örneğin
SRS-12) veya ReqIF tanımlayıcısı (aracın iç kimliği) seçeneğini seçin. Yabancı kimliği olmayan gereksinimler tanımlayıcıyı alır. - İlişki türleri altında her ilişki türünün neye dönüşeceğini seçin: Türet, Ayrıntılandır, Bağımlılık veya Dışarıda bırak. Önizleme yeniden hesaplanır ve seçim aynı dosyanın bir sonraki içe aktarması için saklanır.
- 1 paketi içe aktar düğmesine tıklayın. Tek bir Geri al içe aktarmanın tamamını geri alır. Bildirimde “<title> kaynağından N gereksinim içe aktarıldı.” yazar.
İçe aktarmanın oluşturdukları:
| ReqIF | SysML v2 |
|---|---|
| Gereksinim (spec object) | Kısa ad olarak Yabancı kimlik veya tanımlayıcı, ad ve doc olarak metinle bir requirement |
| Gereksinim türü | Her ReqIF özniteliği için bir öznitelikle requirement def |
| Numaralandırma veri türü | enum def |
| Durum özniteliği (Taslak, Önerildi, Onaylandı vb.) | Gereksinimin Holarch'taki durumu |
| Bölüm başlığı | Kısa ad olarak bölüm numarasıyla package |
| İç içe gereksinim | İç içe requirement |
| derived from ilişkisi | Türetme bağlantısı |
| refines ilişkisi | Refinement ek açıklamalı bağımlılık |
| satisfies, verified by ve diğer ilişkiler | Bağımlılık (rapor nedenini belirtir) |
| Belirtim | Dosyanın paketi içinde package |
Tablolar hücreler arasında | bulunan metin satırlarına, listeler tireyle başlayan satırlara dönüşür; biçimlendirme ve bağlantılardan yalnızca metin kalır; bu gereksinimler Yaklaşık olarak işaretlenir. Görüntüler ve gömülü nesneler içe aktarılmaz; bunlardan birini içeren gereksinim nedeniyle birlikte listelenir, böylece dosyayı ona ekleyebilirsiniz. Raporu indir her gereksinimi ve ilişkiyi sonucuyla birlikte CSV olarak kaydeder; SysML v2 metnini indir metni kaydeder.
Dosyanın daha yeni bir kopyasını içe aktarın: onu aynı projeye içe aktarın. Holarch önceki içe aktarmanın paketini bulur ve gereksinimleri tek tek karşılaştırır:
- Gereksinimler öğe kimliklerini korur; böylece diyagramlar, satisfy ve verify bağlantıları, incelemeler ve Geçmiş bağlı kalır. Yeniden adlandırılan ve taşınan gereksinimler yerinde güncellenir.
- Yeni dosyada bulunmayan gereksinimler korunur. Onları Çöp kutusuna taşımak için Bu dosyada olmayan N gereksinimi kaldır seçeneğini işaretleyin.
- Holarch'ta eklediğiniz parçalar, doğrulama senaryoları ve bağlantılar korunur.
- Yalnızca Holarch'ta değiştirilen bir gereksinim sizin değişikliğinizi korur. Hem burada hem dosyada değiştirilen bir gereksinim dosyanın metnini alır; önceki metin Geçmiş'te kalır. Önizleme bunları Burada ve dosyada değişti altında listeler.
ReqIF olarak dışa aktarın:
- Dışa aktar altında bir paket veya Tüm model ile ReqIF (.reqif) veya ReqIF arşivi (.reqifz) seçeneğini seçin.
- Dışa aktar düğmesine tıklayın. Bildirimde “N gereksinim <file> olarak dışa aktarıldı.” yazar.
Veritabanı veya Gereksinimler sayfasındaki Dışa aktar… → Gereksinimler (ReqIF), listelenen (veya seçilen) gereksinimleri aynı şekilde dışa aktarır.
Dosya her gereksinimin kısa adını (ReqIF.ForeignID olarak), adını, doc metnini (XHTML olarak), durumunu ve öznitelik değerlerini, belirtim olarak paket hiyerarşisini ve derive, refine ve dependency ilişkilerini içerir. ReqIF'ten içe aktarılan gereksinimler özgün tanımlayıcılarını, türlerini ve ilişki türlerini korur; böylece kaynak araç kopya eklemek yerine kendi gereksinimlerini günceller; dosyayı dışa aktarıp yeniden içe aktarmak her paketi Değişmedi olarak gösterir. Hesaplanan öznitelik değerleri metin olarak yazılır. Satisfy ve verify bağlantıları Holarch'ta kalır: ReqIF'te parçalar veya doğrulama senaryoları yoktur.
Bir depodan çekin ve bir depoya gönderin
Bir SysML v2 model deposunun son commit'ini okumak ve değişikliklerinizi geri göndermek için projeyi deponun bir dalına bağlayın.
- Model → İçe ve dışa aktarma sayfasını açın ve Depo bölümünü bulun.
- Depo adresi'ni (deponun Systems Modeling API'sinin https adresi) ve depo gerektiriyorsa Erişim belirteci'ni girin.
- Projeleri yükle düğmesine tıklayın, ardından Proje ve Dal seçin. Bu modelden yeni bir depo projesi başlatmak için bunun yerine Yeni depo projesi düğmesine tıklayın.
- Çek… düğmesine tıklayın. Holarch dalın son commit'ini okur ve her farkı listeler: Yeni, Değişti, Kaldırıldı veya Çakışma. Çekilecek bir şey olmadığında “Güncel: depoda değişiklik yok.” iletisini görürsünüz.
- İstemediğiniz farkların işaretini kaldırın, ardından Pull'u uygula düğmesine tıklayın. Tek bir Geri al çekmenin tamamını geri alır.
- Modeli değiştirdikten sonra Gönder düğmesine tıklayın. Son eşitlenen commit'ten bu yana yaptığınız değişiklikler dala tek bir yeni commit olarak gider. Örneğin “3 değişiklik 1a2b3c4d commit'i olarak gönderildi.” iletisini görürsünüz.
Çakışma, son eşitlemeden bu yana hem burada hem depoda değiştirilmiş bir öğedir. İşareti kaldırılmış bir çakışma bu projenin sürümünü korur.
Not: Dalda bu projenin çekmediği commit'ler varsa gönderme reddedilir: “Depo dalında bu projenin çekmediği commit'ler var. Önce çekin, sonra yeniden gönderin.”
Çalışılmış örnek: Hybrid Car demosu
Önce demoyu oluşturun: Projeleri yönet'te Proje dosyaları ▾ → Yeni demo proje → Hybrid Car (SysML v2)'ye tıklayın.
- Model → İçe ve dışa aktarma sayfasını açın. Dışa aktar altında Tüm model ve SysML v2 metni seçeneklerini seçin, ardından Dışa aktar düğmesine tıklayın.
Her en üst düzey paket için bir dosya içeren bir zip iner; örneğin
Vehicles.sysml,VehicleRequirements.sysml,VehicleBehavior.sysmlveVehicleViews.sysml. VehicleRequirements.sysmldosyasını bir metin düzenleyicide açın.attribute maxCurbMass : MassValue = 1650 [kg];değerini1600 [kg]olarak değiştirin ve kaydedin.- İçe ve dışa aktarma sayfasına dönün, Bu projeye seçeneğini seçin ve
VehicleRequirements.sysmldosyasını bırakın.Önizleme VehicleRequirements paketini değişen öğe sayısıyla birlikte Değişti olarak gösterir. Diğer paketler dosyada olmadığı için listelenmez.
- 1 paketi içe aktar düğmesine tıklayın.
Değer modelde değişir. Sedan Mass (VR-1.1) gereksinimi
maxCurbMassadını içerdiğinden bağlantıları inceleme için işaretlenir (bkz. SysML v2 projelerinde gereksinimler ve doğrulama). İçe aktarmayı geri almak için ⌘Z / Ctrl+Z tuşlarına basın. - Aynı dosyalardan ikinci bir proje başlatmak için Yeni bir SysML v2 projesine seçeneğini seçin, zip dosyasını bırakın ve Proje oluştur düğmesine tıklayın.
İpuçları ve iyi uygulamalar
- Kimlikler önemli olduğunda, örneğin diğer araç bağlantıları kimliğe göre tuttuğunda, bir modeli SysML v2 araçları arasında taşımak için JSON kullanın. Dosyaları kişiler okuyacak veya inceleyecekse metin kullanın; metin düzenlendikten sonra Holarch'a geri gelecekse Öğe kimliklerini dahil et seçeneğini işaretleyin.
- Yalnızca okuyacak kişilere verdiğiniz metinde kimlikleri dışarıda bırakın: kimlikler her öğe için bir satır ekler.
- Her dosyada bir en üst düzey paket tutun. Dışa aktarma dosyaları bu şekilde yazar ve sonraki bir içe aktarma da paket paket eşleştirir.
- Başka bir ekipten gelen paketi kendi en üst düzey paketine içe aktarın. Güncellemeler bu durumda yalnızca o paketi etkiler.
- İçe aktarmadan önce sorunlar listesini denetleyin. Ayrıştırılamayan üyeler dışarıda bırakılır.
Yaygın hatalar
- Bir paket Çakışma gösteriyor: “Başka kimliklere sahip X adlı bir paket var.” Projede bu JSON'dan içe aktarılmamış, bu adda bir paket var. Onu değiştirmek için satırı işaretleyin (eski paket Çöp kutusuna taşınır) veya yeni bir projeye içe aktarın.
- “İçe aktarmada X adlı iki en üst düzey paket var; yalnızca ilki içe aktarılır.” İki dosya aynı en üst düzey paketi bildiriyor. Onları tek bir dosyada birleştirin veya birini yeniden adlandırın.
- Yeniden adlandırılan bir öğe yeni olarak içe aktarıldı. Metinde öğe kimlikleri yoktu ve öğe aynı anda hem yeniden adlandırıldı hem taşındı (veya hem türü hem adı değişti). Öğe kimliklerini dahil et ile dışa aktarın, değişikliği yapın ve yeniden içe aktarın.
- İçe aktarmadan sonra öğeler eksik. Ayrıştırılamayan bir üye dışarıda bırakılır: “Bu üye ayrıştırılamıyor ve dışarıda bırakıldı.” Sorunlar listesinin adlandırdığı satırı düzeltin, ardından yeniden içe aktarın.
- Bir JSON içe aktarması reddedildi. Bir seferde tek bir SysML v2 JSON dosyasını,
.sysmldosyaları olmadan içe aktarın.
Diğer özelliklerle nasıl bağlantılıdır
- Düzenleyici: içe aktarılan paketler orada açılır; dışa aktarılan dosyalar orada gördüğünüz metindir.
- Geri alma ve Çöp kutusu: tek bir Geri al bu projeye yapılan bir içe aktarmanın tamamını geri alır; içe aktarmanın kaldırdığı veya değiştirdiği öğeler Çöp kutusuna gider.
- Değişiklik denetimi: bir içe aktarma yoluyla değişen değerler ve belgeler, diğer her düzenleme gibi gereksinim bağlantılarını inceleme için işaretler.
- Holarch proje dosyaları: Projeleri yönet sayfasındaki Bu projeyi dışa aktar…, riskler, belgeler ve diğer Holarch verileriyle birlikte tüm Holarch projesini kaydeder.
.sysmlve JSON yalnızca modeli içerir. - Dönüştürme: bir modeli LML ile SysML v2 arasında taşımak için dönüştürülmüş bir kopya oluşturun (bkz. LML ile SysML v2 arasında dönüştürme).
İçe ve dışa aktarma sayfası
İçe aktarma
| Denetim | Kullanım |
|---|---|
| Bu projeye | Dosyaları açık projeyle birleştirir. Projeyi yalnızca görüntüleyebilen kişiler için kullanılamaz; onlar için içe aktarmalar yeni bir proje oluşturur. |
| Yeni bir SysML v2 projesine | Dosyalardan yeni bir proje oluşturur. |
| Bırakma alanı | “Dosyaları buraya bırakın veya seçmek için tıklayın”. .sysml dosyalarını, .sysml dosyalarından oluşan bir .zip dosyasını veya tek bir SysML v2 JSON dosyasını kabul eder. |
| Önizleme tablosu | İçe aktar (onay kutusu), Paket (ad ve tür), Öğeler (sayı), Sonuç (Yeni, Değişti, Değişmedi veya Çakışma, bir ayrıntıyla). |
| Proje adı | (Yalnızca yeni proje) Yeni projenin adı, en fazla 200 karakter. |
| N paketi içe aktar / Proje oluştur | İçe aktarmayı uygular. |
| İptal | Önizlemeyi içe aktarmadan kapatır. |
.sysml metninde herhangi bir paketin dışındaki öğeler tek bir satırda, Paketlerin dışında altında birlikte listelenir.
Bir önizleme açıkken model değişirse (başka bir sekme, bir ortak çalışan veya Geri al), önizleme yeniden hesaplanır.
Dışa aktarma
| Denetim | Kullanım |
|---|---|
| Dışa aktar (kapsam) | Tüm model veya nitelikli adıyla herhangi bir paket. |
| olarak (biçim) | SysML v2 metni (.sysml; birden çok paket için .zip) veya SysML v2 JSON (.json). |
| Öğe kimliklerini dahil et | (Yalnızca metin; varsayılan olarak kapalı) Adlandırılmış her öğenin kimliğini metne @HolarchMetadata::ElementId { id = "…"; } olarak yazar; böylece yeniden içe aktarılan düzenlenmiş bir kopya, yeniden adlandırma ve taşımalarda kimlikleri korur. |
| Dışa aktarma | Dosyayı indirir. |
Metin dışa aktarması her en üst düzey paket için onun adını taşıyan bir dosya yazar (Vehicles.sysml). Paketlerin dışındaki öğeler Outside packages.sysml dosyasına gider. JSON dışa aktarması proje veya paket adını taşıyan tek bir dosya yazar.
Depo
Depo bölümü projeyi, Systems Modeling API sunan bir deponun bir dalına bağlar.
- Depo adresi: deponun API'sinin https adresi. Holarch yalnızca genel ana bilgisayarlardaki https adreslerine bağlanır; site yöneticileri ana bilgisayarları ve bağlantı noktalarını sınırlayabilir.
- Erişim belirteci: hesabınız ve bu proje için şifrelenmiş olarak saklanır ve yalnızca o adrese gönderilir. Bir daha gösterilmez; saklanan belirteci korumak için alanı boş bırakın.
- Projeleri yükle, Proje ve Dal: nereyle eşitleneceğini seçin. Yeni depo projesi, depoda bu model için bir proje oluşturur.
- Çek…, Pull'u uygula: son commit'i okuyun, farkları inceleyin ve bunları uygulayın; tek bir Geri al ile hepsi geri alınır. Holarch son eşitlediği commit ile karşılaştırır; böylece sizin değişikliklerinizi deponunkilerden ayırt edebilir.
- Gönder: son eşitlenen commit'ten bu yana yapılan değişiklikleri tek bir commit olarak gönderir. “Gönderilecek bir şey yok: model son eşitlenen commit ile aynı.” yeni bir şey olmadığı anlamına gelir.
- Ayarlar… bağlantıyı değiştirir. Bağlantıyı kes saklanan belirteci ve eşitleme durumunu kaldırır; model kalır.
- Depo işlemleri düzenleyici rolü gerektirir. Görüntüleyiciler çekemez veya gönderemez.
- Düzenlemeye tabi veri gizlilik işaretleri olan projelerde gönderme reddedilir.
Dosyalar nasıl okunur
- Herhangi bir şey okunmadan önce dosyalar denetlenir: boyutları, sayıları, iç içe yerleşimleri ve metin uzunlukları.
- Bir zip içindeki gizli dosyalar ve
__MACOSXklasörleri yok sayılır. Bağlantılar,.sysmldışındaki dosyalar ve aynı yolun ikinci bir kopyası atlanır; sorunlar listesi nedenini belirtir. - Metin UTF-8 olmalıdır. Bayt sırası işaretine izin verilir.
- İçe aktarılan her öğe yazılmadan önce denetlenir. Reddedilen bir öğe, sahip olduğu üyeleri de beraberinde götürür; sorunlar listesi bunları sayar.
- JSON'da, Holarch'ın yorumlamadığı türlerdeki öğeler içe aktarıldıkları gibi korunur: bkz. Holarch'ın yorumlamadığı öğeler.
Holarch'ın yorumlamadığı öğeler
SysML v2 JSON, Holarch'ın modellemediği öğe türlerini içerebilir; örneğin KerML davranışları, adımları veya etkileşimleri. Holarch bunları dışarıda bırakmak yerine korur:
- Her biri kimliği, adı, sahibi ve ilişkileri (türlemeler, özelleştirmeler ve diğerleri) ile sahip oldukları dahil özgün JSON'uyla modelde kalır. Üyeleri onu sahipleri olarak korur.
- Gezgin özgün türünü Yorumlanmadı etiketiyle gösterir; açıklama için etiketin üzerine gelin. Özellik paneli türünü, dosyadaki kimliğini ve ilişkilerinin neyi gösterdiğini gösterir.
- Holarch'ta yeniden adlandırılamaz veya düzenlenemez. Onu geldiği araçta değiştirin ve yeniden içe aktarın. Taşıyabilir veya silebilirsiniz.
- SysML metni yoktur. Düzenleyici onu ve sahip olduğu her şeyi metnin dışında bırakır ve metnin üstündeki bir not kaç öğenin gösterilmediğini belirtir. Metni düzenlemek onları asla kaldırmaz. Bir
.sysmldışa aktarması da onları dışarıda bırakır. - Bir JSON dışa aktarması onu değiştirmeden geri yazar. Yalnızca modelde değişen ayarlanır: sildiğiniz veya eklediğiniz bir üye, yeniden adlandırdığınız bir üye veya yeni bir sahip.
- İçe aktarma önizlemesi korunan her türü bir kez, not olarak listeler; örneğin 2 Behavior öğesi içe aktarıldığı gibi korunuyor. Notlar sorun değildir.
Korunmayanlar: bazı araçların tüm dışa aktarmayı içine sardığı adsız kök ad alanı (üyeleri en üst düzey öğe olur) ve bir değerin içindeki desteklenmeyen öğeler (bunlar sorun olarak listelenir). JSON'u 256 KB'tan büyük olan bir öğe yalnızca türünü ve kimliğini korur.
İletiler
| İleti | Anlamı ve düzeltme |
|---|---|
| .sysml dosyalarını, .sysml dosyalarından oluşan bir .zip dosyasını veya bir SysML v2 JSON dosyasını seçin. | Hiçbir dosya seçilmedi. |
| Hiç .sysml dosyası bulunamadı. .sysml dosyalarını, .sysml dosyalarından oluşan bir .zip dosyasını veya bir SysML v2 JSON dosyasını seçin. | Arşivde veya seçimde hiç .sysml dosyası yok. |
| Bir seferde tek bir SysML v2 JSON dosyasını, .sysml dosyaları olmadan içe aktarın. | Birden çok JSON dosyası veya metinle karışık JSON seçildi. |
| <file> bir ReqIF dosyası değil (…). Kaynak araçtan ReqIF 1.0 veya sonrası olarak dışa aktarın ve yeniden içe aktarın. | Dosya ReqIF XML değil veya Holarch'ın okumadığı bir DOCTYPE içeriyor. |
| <file> hiç gereksinim içermiyor (SPEC-OBJECT öğesi yok). Belirtimleri nesneleriyle birlikte dışa aktarın ve dosyayı yeniden içe aktarın. | ReqIF dosyasında türler var ama gereksinim yok. |
| <title> içinde N gereksinim var; bu, tek bir içe aktarmanın aldığından (yaklaşık M) fazla. Belirtimleri ayrı ReqIF dosyaları olarak dışa aktarın. | SysML v2 metni 8 MB sınırını aşar. Belirtimleri birer dosya olarak içe aktarın. |
| <file> UTF-8 metin değil. UTF-8 olarak kaydedin ve yeniden içe aktarın. | Dosyanın kodlamasını dönüştürün. |
| <file> geçerli bir ZIP arşivi değil. Arşivi yeniden oluşturun. | Arşiv hasarlı. |
| <file> şifrelenmiş dosyalar içeriyor. Arşivi parola olmadan oluşturun. | Parola korumalı arşivler okunmaz. |
| <path> 200:1 oranından fazla sıkıştırılmış; bu bir zip bombasına özgüdür. Arşivi yeniden oluşturun. | Arşiv güvenlik nedeniyle reddedildi. |
| Arşiv desteklenmeyen bir sıkıştırma yöntemi kullanıyor. Standart ZIP sıkıştırmasıyla oluşturun. | Standart (deflate) sıkıştırma kullanın. |
| KerML dosyaları henüz içe aktarılmıyor. | .kerml dosyaları atlanır. |
| Bir arşivden yalnızca .sysml dosyaları içe aktarılır. | Zip içindeki diğer dosyalar atlanır. |
| Bağlantılar içe aktarılmaz. | Zip içindeki sembolik bağlantılar atlanır. |
| Arşiv bu dosyayı iki kez içeriyor; ilk kopya içe aktarılır. | İki girişin yolu aynı. |
| <file> geçerli bir JSON değil. Modeli yeniden dışa aktarın. | JSON dosyası hasarlı. |
| <file> SysML v2 JSON değil (@id ve @type içeren bir öğe listesi). Bir SysML v2 JSON dışa aktarması seçin. | JSON başka bir biçimde. |
| <file> dosyasının N. satırı 64 KB'tan uzun. Satırı bölün, ardından dosyayı yeniden içe aktarın. | Çok uzun satırlar reddedilir. |
| Bu üye ayrıştırılamıyor ve dışarıda bırakıldı. | Sorunlar listesinde adı geçen satırı düzeltin. |
| Bu projede bu kimliğe sahip bir öğe <element> içinde bulunuyor. Önce onu en üst düzeye taşıyın veya yeni bir projeye içe aktarın. | (Çakışma) JSON'un en üst düzey paketi modelde daha derinde zaten var. |
| Bunun N öğe kimliği bu projede başka yerlerde kullanılıyor. Bunun yerine yeni bir projeye içe aktarın. | (Çakışma) JSON başka öğelerin kimliklerini yeniden kullanıyor. |
| Paket metni yazdırıldıktan sonra ayrıştırılamıyor. Onu yeni bir projeye içe aktarın. | (Çakışma) Paket birleştirilemedi. |
| N <kind> öğesi içe aktarıldığı gibi korunuyor (yorumlanmadı): … | (Not) Holarch'ın yorumlamadığı türdeki öğeler değiştirilmeden korunur. Bkz. Holarch'ın yorumlamadığı öğeler. |
| Bir değerin içindeki <kind> türünde bir öğe desteklenmez ve dışarıda bırakılır. | Bir değer (bir ifade) Holarch'ın okuyamadığı bir öğe içeriyor. Değerin geri kalanı metin olarak korunur. |
| <kind> türündeki bir öğe tamamen korunamayacak kadar büyük; yalnızca türü ve kimliği korunur. | JSON'u 256 KB'tan büyük. |
| İçe aktarma uygulanmadı: … Hiçbir şey değiştirilmedi. | İçe aktarma başarısız oldu; proje değişmedi. |
| Model boş. Bir paket ekleyin, ardından yeniden dışa aktarın. | Dışa aktarılacak bir şey yok. |
| Dışa aktarılacak paket artık yok. Başka bir paket seçin. | Paket, sayfa açıkken silindi. |
Sınırlar
| Sınır | Değer |
|---|---|
| İçe aktarma başına dosya | 2,000 |
İçe aktarma başına .sysml metni (açılmış) | 8 MB |
| Zip arşivi | 16 MB, 10,000 giriş |
| Zip içinde klasör iç içeliği | 32 klasör |
| İçe aktarma başına öğe (metin veya JSON) | 100,000 |
| JSON dosyası | 24 MB, 64 düzey iç içelik |
| Holarch'ın yorumlamadığı tek bir öğenin JSON'u | 256 KB, 12 düzey iç içelik |
| Satır uzunluğu | 64 KB |
ReqIF dosyası (.reqif veya bir .reqifz içindeki .reqif) | 64 MB; oluşturduğu SysML v2 metni 8 MB metin sınırına sığmalıdır (yaklaşık 8,000 ile 20,000 gereksinim) |
- Depo yanıtları tüm bir çekme için 64 MB ile sınırlıdır ve her depo işlemi 120 saniye sonra durur.
- Her hesap saatte en fazla 300 depo işlemi çalıştırabilir.
- KerML (
.kerml) dosyaları henüz içe aktarılmıyor. - Barındırılan uygulamada sunucu en fazla 1.5 MB
.sysmlmetni içeren içe aktarmaları okur. Daha büyük içe aktarmalar tarayıcınızda aynı sonuçla okunur. - Modelin yanındaki Holarch verileri (gereksinim durumu, riskler, bütçeler, simülatör ayarları, görünüm yerleşimleri)
.sysmlveya JSON dosyalarının parçası değildir. Bunları korumak için Projeleri yönet sayfasında Bu projeyi dışa aktar… kullanın.
İlgili sayfalar
- Metin düzenleyici ve Gezgin
- LML ile SysML v2 arasında dönüştürme
- SysML v2 projelerine başlarken
- SysML v1 modellerini içe aktarma: SysML 1.x araçlarından gelen ve SysML v2'ye dönüştürülen XMI.
- LML projeleri (LML'ye ReqIF dahil) ve Holarch proje dosyaları için İçe ve dışa aktarma.
SysML® ve OMG®, Object Management Group, Inc.'in Amerika Birleşik Devletleri'nde ve diğer ülkelerde tescilli ticari markalarıdır.