SysML v2
SysML v1 modellerini içe aktarma
Cameo, MagicDraw, Enterprise Architect, Rhapsody veya Papyrus'taki bir SysML 1.x modelini SysML v2 metnine dönüştürün, biçimi değişenleri inceleyin ve bir SysML v2 projesine içe aktarın.
Bu sayfada
Genel bakış
Bir SysML 1.x modelini bir SysML v2 projesine getirebilirsiniz. Holarch modelin XMI dosyasını okur, SysML v2 metnine dönüştürür, metni denetler ve herhangi bir şey değişmeden önce bir dönüştürme raporu gösterir.
- Girdi: XMI (
.xmi,.uml,.xml) olarak bir SysML 1.x modeli veya bir Cameo ya da MagicDraw projesi (.mdzip). - Çıktı: projenizde SysML v2 metni (tek bir Geri al ile hepsi geri alınır) veya yeni bir SysML v2 projesi.
- Rapor: her v1 öğesi sonucuyla birlikte: Dönüştürüldü, Yaklaşık veya Dışarıda bırakıldı ve nedeni.
Dönüştürme, XMI olarak alınıp verilen bir modelin yeterli ayrıntı taşıdığı yerlerde OMG SysML 2.0 belirtimindeki SysML v1'den SysML v2'ye dönüşümü izler.
Kavramlar
Dönüştürülen, yaklaşık aktarılan ve dışarıda bırakılan
v1 modelinin her öğesi tek bir sonuç alır:
- Dönüştürüldü: öğenin doğrudan bir SysML v2 karşılığı vardır; örneğin bir
part defolan bir blok. - Yaklaşık: öğe değiştirilmiş bir biçimde korunur. Örneğin bir interface block ile türlenen bir full port bir port olur ve bir choice pseudostate üzerinden geçen bir geçiş her yol için bir geçişe dönüşür.
- Dışarıda bırakıldı: SysML v2'de karşılığı yoktur veya öğe dosyada olmayan bir şeye işaret eder. Örnekler: flow final düğümleri, activity partition'lar, use case extension'lar ve instance specification'lar.
Rapor, yaklaşık aktarılan ve dışarıda bırakılan her öğenin nedenini sözcüklerle verir.
SysMLv1Library paketi
Bazı SysML v1 özelliklerinin SysML v2 anahtar sözcüğü yoktur; örneğin bir block'un isEncapsulated özelliği veya bir refine ilişkisi. Dönüştürücü bunları SysMLv1Library paketinden meta veri olarak korur; örneğin @SysMLv1Library::RefineData { isRefine = true; }. Paket Holarch kitaplığının parçasıdır; bu nedenle bu adlar her SysML v2 projesinde çözümlenir.
Opak gövdeler metinsel gösterimlere dönüşür
Opaque behavior'lar, opaque action'lar, guard'lar ve constraint specification'lar OCL veya İngilizce gibi bir dilde metin taşır. Dönüştürücü her gövdeyi bir metinsel gösterim olarak korur: language "OCL" /* … */. SysML veya KerML gövdeleri metnin geri kalanı gibi denetlenir. Bkz. Metinsel gösterimler.
Nasıl kullanılır
Ne zaman ve neden
İçe aktarmayı, bir ekip mevcut bir SysML 1.x modelini SysML v2'ye taşırken veya bir modelin bölümlerini yeniden kullanmak istediğinde kullanın. Dönüştürülen metin bir başlangıç noktasıdır: rapor neyi elle incelemeniz gerektiğini söyler.
Bir SysML v1 modelini projeye içe aktarma
- Bir SysML v2 projesi açın ve Model → İçe ve dışa aktarma seçeneğine tıklayın.
- İçe aktar altında Bu projeye veya Yeni bir SysML v2 projesine seçeneğini seçin.
.xmi,.uml,.xmlveya.mdzipdosyasını kutuya bırakın ya da seçmek için kutuya tıklayın. XMI dosyası okunuyor…, SysML v2'ye dönüştürülüyor… ve Sonuç denetleniyor… aşamalarını içeren bir ilerleme kartı görürsünüz.- Önizlemenin üstündeki SysML v1'den dönüştürme bölümünü okuyun. Bölüm dönüştürülen, yaklaşık aktarılan ve dışarıda bırakılan öğelerin sayısını ve SysML v2 metninin sorunsuz denetlenip denetlenmediğini belirtir.
- Yaklaşık aktarılan ve dışarıda bırakılan öğeleri, yalnızca bunlardan birini veya tüm öğeleri listelemek için Göster seçeneğini kullanın. Her satır öğeyi, SysML v1 türünü, SysML v2 anahtar sözcüğü ve nitelikli adla sonucu ve Neden sütununu verir.
- İçe aktarmadan önce sonucu okumak için SysML v2 metnini göster bölümünü açın.
- Aşağıdaki tabloda istemediğiniz paketlerin işaretini kaldırın, ardından N paketi içe aktar (veya Proje oluştur) düğmesine tıklayın. Model içe aktarılır ve tek bir Geri al ile hepsi geri alınır. Geri al onu yeniden kaldırır.
Aynı modelin daha yeni bir sürümünü içe aktarma
SysML v1 modeli değiştiğinde onu yeniden dışa aktarın ve yeni dosyayı aynı projeye içe aktarın (Bu projeye). Dönüştürülen her öğe kimliğini XMI dosyasındaki öğenin kimliğinden (xmi:id) alır; bu nedenle içe aktarma öğeleri yerinde günceller: SysML v1 aracında yeniden adlandırılan veya başka bir pakete taşınan bir öğe, diyagram yerleşimleri, yorumları, bağlantıları ve geçmişiyle aynı öğe olarak kalır. Rapor kaç öğenin kimliğini SysML v1 modelinden aldığını belirtir. Adı olmayan öğeler (connector'lar, succession'lar) modeldeki yerlerine göre eşleştirilir.
Holarch kimlikleri XMI dosyasından türetmeye başlamadan önce bir SysML v1 modelinden içe aktarılmış bir proje kendi kimliklerini korur: daha yeni bir dışa aktarma öğelerini ada göre günceller ve SysML v1 modelinde yeni olan öğeler kimliklerini ondan alır.
Raporu ve metni saklama
- Her öğeyi, sonucunu, SysML v2 yolunu ve nedenini içeren bir CSV dosyası için Raporu indir düğmesine tıklayın.
- Dönüştürülmüş
.sysmldosyası için SysML v2 metnini indir düğmesine tıklayın.
Modeli SysML v1 aracınızdan dışa aktarma
- Cameo Systems Modeler ve MagicDraw:
.mdzipprojesini doğrudan içe aktarın veya File → Export To → Eclipse UML2 (v5.x) XMI File komutunu kullanıp.xmidosyasını içe aktarın. - Enterprise Architect: paketi seçin, Publish → Export XML komutunu seçin, XMI 2.1'i seçin ve
.xmldosyasını içe aktarın. Enterprise Architect proje dosyaları (.eap,.qea) doğrudan okunamaz. - IBM Rhapsody: modeli XMI araç takımıyla (XMI 2.x) dışa aktarın ve dosyayı içe aktarın.
- Eclipse Papyrus: modelin
.umldosyasını içe aktarın.
Uygulamalı örnek: CubeSat EO-1 modeli
CubeSat EO-1 demosu bir LML projesidir. SysML v1 dışa aktarması gerçekçi bir test modeli oluşturur.
- CubeSat EO-1 demosunu açın ve OMG XMI 2.5.1 biçiminde UML/SysML XMI olarak dışa aktarın (bkz. Bir UML/SysML modelini dışa aktarma (XMI)).
- Bir SysML v2 projesi açın, Model → İçe ve dışa aktarma seçeneğine tıklayın, Yeni bir SysML v2 projesine seçeneğini seçin ve
.xmidosyasını bırakın. Raporda şunlar yazar: 1,042 öğe, 1,007 dönüştürüldü, 32 yaklaşık, 3 dışarıda bırakıldı. SysML v2 metni sorunsuz denetlenir. - Göster seçeneğini Dışarıda bırakıldı olarak ayarlayın. Üç satır, SysML v2'de bulunmayan bir use case extension ile SysML v2 metninin başvuramayacağı adsız öğelere giden iki trace ilişkisidir.
- Proje oluştur düğmesine tıklayın. Yeni SysML v2 projesi uydunun yapısı, işlevleri, gereksinimleri ve izleriyle Düzenleyici'de açılır.
İpuçları ve yaygın hatalar
- Bir seferde tek bir XMI dosyasını başka dosyalar olmadan içe aktarın. Bir seferde tek bir SysML v1 XMI dosyasını başka dosyalar olmadan içe aktarın.
- İz bağladığınız öğeleri adlandırın. SysML v2 metni öğelere adlarıyla başvurduğundan adsız öğelere giden ilişkiler dışarıda bırakılır.
- Yeniden oluşturmayın, yeniden içe aktarın. Daha yeni bir dışa aktarmayı yeni bir projeye değil aynı projeye içe aktarın: öğeler kimliklerini yalnızca onlara sahip olan proje içinde korur.
- Önce yaklaşık aktarmaları denetleyin. Bunlar, anlamın v1 modelinden farklı olabileceği yerlerdir; örneğin block'larla türlenen port'lar veya part'ların içindeki connector uçları.
- Aynı yerde aynı ada sahip öğeler,
_2gibi bir sonekle yeniden adlandırılır. Rapor her yeniden adlandırmayı listeler. - Bir gereksinim aracında tutulan gereksinimler (DOORS, Polarion, Jama, codebeamer) XMI olarak değil ReqIF olarak gelir.
.reqifdosyasını aynı sayfada içe aktarın: dosya aynı türde bir raporla SysML v2 gereksinimlerine dönüşür (ReqIF gereksinimlerini içe ve dışa aktarın).
Neler dönüştürülür
| SysML v1 | SysML v2 |
|---|---|
| Model, paket | package |
| Blok, aktör | part def |
| Değer türü, veri türü, numaralandırma | attribute def, enum def (bilinen bir SI birimi olan değer türleri ISQ niceliğini özelleştirir) |
| Sinyal | item def |
| Interface block | port def |
| Parça, referans ve değer özellikleri | Çokluklar ve varsayılan değerlerle part, ref part, attribute |
| Proxy port, flow property | port, in/out item veya attribute |
| Full port | @SysMLv1Library::PortData ile part |
| Bağlayıcı, bağlama bağlayıcısı, öğe akışı | connect, bind, flow |
| Genelleştirme | :> |
| Activity, call behavior action, pin'ler | action def, action, parametreler |
| Control ve object flow'lar, guard'lar | if guard'ları ve else ile succession'lar, parametreler arasında flow'lar |
| Initial, final, decision, merge, fork, join | start, done, decide, merge, fork, join |
| State machine, state'ler, region'lar | state def, state, paralel durumlar |
| Transition'lar, sinyal ve zaman tetikleyicileri | accept, accept after, guard'lar ve effect'lerle transition |
| Interaction | Lifeline'lar ve mesajlarla occurrence def |
| Use case, subject, include | use case def, subject, include |
| Requirement (kimlik ve metin) | requirement <'id'> Name { doc /* text */ } |
| Satisfy, verify, derive requirement | satisfy, bir doğrulama hedefi içinde verify, türetme bağlantısı |
| Refine, trace | SysMLv1Library meta verisiyle dependency |
| Allocate, dependency | allocate, dependency |
| Constraint block, constraint | constraint def, assert constraint |
| Stereotipler ve etiketli değerler | Stereotip başına, etiketleriyle uygulanan bir metadata def |
| Yorum, belgeleme | doc, comment |
Sınırlar
- En fazla 64 MB'lık tek bir dosya.
- En fazla 250,000 öğe, en fazla 512 düzey iç içe. Daha derin iç içe geçmiş veya sahiplik döngüsü olan bir model içe aktarılmaz.
- Dönüştürülen modelde 128 düzeyden daha derin iç içe geçmiş öğeler iç içelik nedeniyle dışarıda bırakılır.
- Dönüştürülen metin en fazla 8 MB'tır.
- Diyagramlar ve yerleşimleri dönüştürülmez. Görünümleri SysML v2 projesinde oluşturun.
İletiler
| İleti | Ne yapılmalı |
|---|---|
| Bir seferde tek bir SysML v1 XMI dosyasını başka dosyalar olmadan içe aktarın. | XMI dosyasını tek başına içe aktarın. |
| <file> hiç UML veya SysML öğesi içermiyor. Modeli XMI 2.x olarak dışa aktarın ve yeniden içe aktarın. | Modeli yeniden XMI 2.x olarak dışa aktarın. |
| <file> içinde UML modeli bulunamadı. Cameo veya MagicDraw'da modeli Eclipse UML2 XMI olarak dışa aktarın ve .xmi dosyasını içe aktarın. | Projeyi XMI olarak dışa aktarın. |
| SysML v1 modelinde 250,000'den fazla öğe var. Modelin daha küçük bir bölümünü dışa aktarın. | Bir seferde bir paket dışa aktarın. |
| Dönüştürülen SysML v2 metni 8 MB'tan büyük olur. Modelin daha küçük bir bölümünü dışa aktarın. | Bir seferde bir paket dışa aktarın. |
İlgili sayfalar
- SysML v2 modellerinin alışverişi
- ReqIF gereksinimlerini içe ve dışa aktarın: DOORS, Polarion ve diğer gereksinim araçlarından gelen gereksinimler.
- SysML v2 metinsel gösterimi
- LML ile SysML v2 arasında dönüştürme
SysML® ve OMG®, Object Management Group, Inc.'in Amerika Birleşik Devletleri'nde ve diğer ülkelerde tescilli ticari markalarıdır.