Holarch

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.

Nasıl kullanılır →

Bu sayfada
  1. Genel bakış
  2. Kavramlar
    1. Dönüştürülen, yaklaşık aktarılan ve dışarıda bırakılan
    2. SysMLv1Library paketi
    3. Opak gövdeler metinsel gösterimlere dönüşür
  3. Nasıl kullanılır
    1. Ne zaman ve neden
    2. Bir SysML v1 modelini projeye içe aktarma
    3. Aynı modelin daha yeni bir sürümünü içe aktarma
    4. Raporu ve metni saklama
    5. Modeli SysML v1 aracınızdan dışa aktarma
  4. Uygulamalı örnek: CubeSat EO-1 modeli
  5. İpuçları ve yaygın hatalar
  6. Neler dönüştürülür
  7. Sınırlar
  8. İletiler
  9. İlgili sayfalar

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 def olan 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

  1. Bir SysML v2 projesi açın ve Model → İçe ve dışa aktarma seçeneğine tıklayın.
  2. İçe aktar altında Bu projeye veya Yeni bir SysML v2 projesine seçeneğini seçin.
  3. .xmi, .uml, .xml veya .mdzip dosyası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.
  4. Ö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.
  5. 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.
  6. İçe aktarmadan önce sonucu okumak için SysML v2 metnini göster bölümünü açın.
  7. 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üş .sysml dosyası 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: .mdzip projesini doğrudan içe aktarın veya File → Export To → Eclipse UML2 (v5.x) XMI File komutunu kullanıp .xmi dosyasını içe aktarın.
  • Enterprise Architect: paketi seçin, Publish → Export XML komutunu seçin, XMI 2.1'i seçin ve .xml dosyası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 .uml dosyası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.

  1. 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)).
  2. 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 .xmi dosyası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.
  3. 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.
  4. 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, _2 gibi 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. .reqif dosyası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 v1SysML v2
Model, paketpackage
Blok, aktörpart def
Değer türü, veri türü, numaralandırmaattribute def, enum def (bilinen bir SI birimi olan değer türleri ISQ niceliğini özelleştirir)
Sinyalitem def
Interface blockport def
Parça, referans ve değer özellikleriÇokluklar ve varsayılan değerlerle part, ref part, attribute
Proxy port, flow propertyport, 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'leraction def, action, parametreler
Control ve object flow'lar, guard'larif guard'ları ve else ile succession'lar, parametreler arasında flow'lar
Initial, final, decision, merge, fork, joinstart, done, decide, merge, fork, join
State machine, state'ler, region'larstate def, state, paralel durumlar
Transition'lar, sinyal ve zaman tetikleyicileriaccept, accept after, guard'lar ve effect'lerle transition
InteractionLifeline'lar ve mesajlarla occurrence def
Use case, subject, includeuse case def, subject, include
Requirement (kimlik ve metin)requirement <'id'> Name { doc /* text */ }
Satisfy, verify, derive requirementsatisfy, bir doğrulama hedefi içinde verify, türetme bağlantısı
Refine, traceSysMLv1Library meta verisiyle dependency
Allocate, dependencyallocate, dependency
Constraint block, constraintconstraint def, assert constraint
Stereotipler ve etiketli değerlerStereotip başına, etiketleriyle uygulanan bir metadata def
Yorum, belgelemedoc, 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

İletiNe 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.

SysML® ve OMG®, Object Management Group, Inc.'in Amerika Birleşik Devletleri'nde ve diğer ülkelerde tescilli ticari markalarıdır.