Holarch

गाइड · SysML v2

SysML v1 मॉडल को SysML v2 में ले जाना: चरण-दर-चरण माइग्रेशन

SysML v1 मॉडल को स्वचालित रूप से SysML v2 में रूपांतरित किया जा सकता है, लेकिन माइग्रेशन फ़ाइल रूपांतरण से अधिक है: किसी को तय करना होता है कि रूपांतरित मॉडल कैसा दिखे और जांचना होता है कि वह अब भी वही कहता है जो v1 मॉडल कहता था। यह गाइड आठ चरणों में एक माइग्रेशन से गुज़रती है, v1 मॉडल का जायज़ा लेने से लेकर स्विच करने तक, एक छोटे मॉडल को रूपांतरित करके और पंक्ति-दर-पंक्ति पढ़कर।

इस पृष्ठ पर
  1. शुरू करने से पहले: अनुवाद, अपग्रेड नहीं
  2. 1. v1 मॉडल का जायज़ा लें
  3. 2. SysML v1 टूल से मॉडल निर्यात करें
  4. 3. एक पायलट पैकेज रूपांतरित करें
  5. 4. रूपांतरण रिपोर्ट पढ़ें
  6. एक हल किया गया उदाहरण: एक छोटा रोवर मॉडल
  7. 5. जो अनुमानित किया गया या छोड़ा गया, उसे सुधारें
  8. 6. ज़रूरी व्यू फिर से बनाएं
  9. 7. v2 मॉडल की जांच और समीक्षा करें
  10. 8. बाकी रूपांतरित करें और स्विच करें
  11. माइग्रेशन चेकलिस्ट
  12. आगे कहाँ जाएं

शुरू करने से पहले: अनुवाद, अपग्रेड नहीं

SysML v2 एक नई भाषा है, SysML v1 फ़ाइल फ़ॉर्मेट का नया संस्करण नहीं। ब्लॉक part definition बन जाते हैं, पोर्ट को port definition से टाइप किया जाता है, आवश्यकताओं में शर्तें होती हैं, और आरेख ऐसे व्यू बन जाते हैं जिन्हें मॉडल परिभाषित करता है। SysML v1 बनाम v2 अंतरों को एक-एक करके समझाता है।

कन्वर्टर यांत्रिक हिस्सा करता है: जिस भी एलिमेंट का SysML v2 में समकक्ष है, वह SysML v2 में लिखा जाता है, और बाकी की रिपोर्ट दी जाती है। कन्वर्टर यह तय नहीं कर सकता कि आपकी टीम नई भाषा का उपयोग कैसे करना चाहती है। माइग्रेशन की योजना एक मॉडलिंग कार्य के रूप में बनाएं, जिसका एक स्वामी हो, एक समीक्षा हो और एक बिंदु हो जहाँ v2 मॉडल संदर्भ बन जाए।

यह गाइड Holarch के कन्वर्टर का उपयोग करती है, जो SysML 1.x मॉडल को SysML v2 प्रोजेक्ट में आयात करता है और हर एलिमेंट को रूपांतरित, अनुमानित या छोड़ा गया के रूप में रिपोर्ट करता है। नियोजन के चरण किसी भी कन्वर्टर पर लागू होते हैं।

1. v1 मॉडल का जायज़ा लें

कुछ भी निर्यात करने से पहले पता करें कि मॉडल में क्या है और उस पर कौन निर्भर है। एक छोटी सूची बाद का दोबारा काम बचाती है।

  • पैकेज और स्वामी। शीर्ष-स्तरीय पैकेज सूचीबद्ध करें, हर एक को कौन संभालता है, और अन्य मॉडल या दस्तावेज़ किनका संदर्भ देते हैं। पैकेज वह इकाई हैं जिसे आप रूपांतरित करेंगे और जिसकी समीक्षा करेंगे।
  • ज़रूरी आरेख। वे आरेख नोट करें जिन्हें लोग वास्तव में समीक्षाओं और दस्तावेज़ों में उपयोग करते हैं। आरेख लेआउट SysML v2 में नहीं आते, इसलिए ये ऐसे व्यू बनते हैं जिन्हें आप फिर से बनाते हैं।
  • प्रोफ़ाइल और स्टीरियोटाइप। अपने स्टीरियोटाइप और उनके टैग किए गए मान सूचीबद्ध करें। वे metadata definition बन जाते हैं, और नए मॉडल में उनके अर्थ पर फिर से सहमति बनानी होती है।
  • कोड के रूप में लिखा व्यवहार। OCL, किसी एक्शन भाषा या किसी टूल की स्क्रिप्टिंग में लिखे opaque behavior, गार्ड और बाधाएं अपनी मूल भाषा में टेक्स्ट के रूप में रखे जाते हैं; उनका अनुवाद नहीं होता।
  • बिना नाम वाले एलिमेंट। बिना नाम वाले एलिमेंट की ओर इशारा करने वाले संबंध SysML v2 टेक्स्ट में नहीं लिखे जा सकते, जो एलिमेंट को नाम से संदर्भित करता है। जिन एलिमेंट तक आप ट्रेस करते हैं, उनका नाम अभी v1 टूल में रखें।
  • आकार। Holarch एक बार में 64 MB और 250,000 एलिमेंट तक की एक फ़ाइल रूपांतरित करता है। बड़े मॉडल एक-एक पैकेज करके निर्यात किए जाते हैं।

2. SysML v1 टूल से मॉडल निर्यात करें

कन्वर्टर मॉडल को XMI से पढ़ता है, वह विनिमय फ़ॉर्मेट जिसे SysML v1 टूल लिखते हैं। हर टूल इसे थोड़ा अलग तरीके से निर्यात करता है:

टूलक्या आयात करें
Cameo Systems Modeler, MagicDraw.mdzip प्रोजेक्ट फ़ाइल, या File → Export To → Eclipse UML2 (v5.x) XMI File और .xmi फ़ाइल
Enterprise Architectपैकेज चुनें, Publish → Export XML, XMI 2.1 चुनें, और .xml फ़ाइल आयात करें। प्रोजेक्ट फ़ाइलें (.eap, .qea) सीधे नहीं पढ़ी जातीं।
IBM RhapsodyXMI टूलकिट से XMI 2.x निर्यात
Eclipse Papyrusमॉडल की .uml फ़ाइल

निर्यात की गई फ़ाइल को माइग्रेशन रिकॉर्ड के साथ रखें: यह वही v1 इनपुट है जिसका संदर्भ आपकी समीक्षा देती है।

3. एक पायलट पैकेज रूपांतरित करें

एक ऐसे पैकेज से शुरू करें जो प्रतिनिधि हो लेकिन सबसे बड़ा न हो: संरचना, इंटरफ़ेस, कुछ व्यवहार और अपनी आवश्यकताओं वाला एक सबसिस्टम। पायलट दिखाता है कि आपके मॉडल का रूपांतरण कैसा दिखता है, इससे पहले कि आप पूरी टीम को उसमें लगाएं।

  1. एक SysML v2 प्रोजेक्ट बनाएं, या वह खोलें जिसमें रूपांतरित मॉडल जाना चाहिए, और मॉडल → आयात और निर्यात पर क्लिक करें।
  2. आयात करें के अंतर्गत, पायलट के लिए नए SysML v2 प्रोजेक्ट में चुनें, ताकि और कुछ न छुआ जाए।
  3. निर्यात की गई फ़ाइल को बॉक्स पर छोड़ें। एक प्रगति कार्ड चरण दिखाता है: XMI फ़ाइल पढ़ना, SysML v2 में रूपांतरित करना, परिणाम की जांच करना।

अभी कुछ भी आयात नहीं हुआ है। अगली स्क्रीन रूपांतरण रिपोर्ट के साथ पूर्वावलोकन है।

4. रूपांतरण रिपोर्ट पढ़ें

पूर्वावलोकन के ऊपर SysML v1 से रूपांतरण रूपांतरित, अनुमानित और छोड़े गए एलिमेंट की संख्या देता है, और यह कि SysML v2 टेक्स्ट बिना समस्याओं के जांच में पास होता है या नहीं। v1 मॉडल के हर एलिमेंट का एक परिणाम होता है:

  • रूपांतरित: एलिमेंट का सीधा SysML v2 समकक्ष है, जैसे एक ब्लॉक जो part def बन जाता है।
  • अनुमानित: एलिमेंट बदले हुए रूप में रखा जाता है, उदाहरण के लिए choice से होकर जाने वाला ट्रांज़िशन जो हर पथ के लिए एक ट्रांज़िशन बन जाता है। ये वे जगहें हैं जहाँ अर्थ v1 मॉडल से अलग हो सकता है।
  • छोड़ा गया: SysML v2 में कोई समकक्ष नहीं है, या एलिमेंट किसी ऐसी चीज़ की ओर इशारा करता है जो फ़ाइल में नहीं है।

अनुमानित और छोड़े गए एलिमेंट सूचीबद्ध करने के लिए दिखाएं का उपयोग करें। हर पंक्ति एलिमेंट, उसका SysML v1 प्रकार, वह अपने SysML v2 नाम के साथ क्या बना, और क्यों, बताती है। परिणाम पढ़ने के लिए SysML v2 टेक्स्ट दिखाएं खोलें, और रिपोर्ट को CSV फ़ाइल के रूप में रखने के लिए रिपोर्ट डाउनलोड करें पर क्लिक करें। CSV चरण 5 की कार्य-सूची है: इसे कारण के अनुसार क्रमबद्ध करें और हर समूह को एक स्वामी दें।

एक हल किया गया उदाहरण: एक छोटा रोवर मॉडल

एक ग्रहीय रोवर के पावर पथ का छोटा SysML v1 मॉडल, तीन पैकेज में:

पैकेजSysML v1 एलिमेंट
प्रकारW इकाई वाला एक value type Power; एक block Charge; दो बाहर जाने वाली flow property, charge (एक Charge) और voltage (एक Real), वाला एक interface block Power Interface
संरचनाpart property battery और computer, 120 W की value property power budget, उनके पोर्ट के बीच connector power bus और उस पर Charge का item flow power flow वाला एक encapsulated block Rover। proxy port out वाला एक block Battery; conjugated proxy port in और full port raw वाला एक block Computer। दोनों पर टैग किए गए मानों के साथ एक उपयोगकर्ता स्टीरियोटाइप «Hardware» है। एक association जिसका एक सिरा association के स्वामित्व में है।
आवश्यकताएंआवश्यकताएं R-1 Mission और R-2 Power Margin; R-2, R-1 से derived; R-2, battery part द्वारा satisfied; Computer से Battery तक एक trace

रूपांतरित होने पर यह ऐसा दिखता है। लिस्टिंग कन्वर्टर का आउटपुट है, बिना बदलाव के:

package 'Rover Model' {
  package Types {
    attribute def Power :> ISQ::PowerValue;
    part def Charge;
    port def 'Power Interface' {
      out item charge : Charge;
      out attribute voltage : ScalarValues::Real;
    }
  }
  package Structure {
    part def Rover {
      doc /* Six-wheeled science rover. */
      @SysMLv1Library::BlockData { isEncapsulated = true; }
      part battery : Battery;
      part computer : Computer;
      attribute 'power budget' : Types::Power = 120 [SI::W];
      connection 'power bus' connect battery.'out' to computer.'in';
      satisfy Requirements::'Power Margin' by battery;
      flow 'power flow' of Types::Charge from battery.'out' to computer.'in';
    }
    part def Battery {
      @'SysML v1 Profiles'::rov::Hardware { qualified = "true"; vendor = "Acme Cells"; }
      port 'out' : Types::'Power Interface';
      attribute capacity : Types::Power;
    }
    part def Computer {
      @'SysML v1 Profiles'::rov::Hardware { vendor = "Orbital Logic"; }
      port 'in' : ~Types::'Power Interface';
      part raw : Types::Charge {
        @SysMLv1Library::PortData { isFullPort = true; }
      }
    }
  }
  package Requirements {
    requirement <'R-1'> Mission {
      doc /* The rover shall explore the landing site. */
    }
    requirement <'R-2'> 'Power Margin' {
      doc /* Keep a 50 % power margin. */
    }
    connection : DerivationConnections::Derivation connect 'Power Margin' to Mission;
    dependency from Structure::Computer to Structure::Battery {
      @SysMLv1Library::TraceData { isTrace = true; }
    }
  }
}

package 'SysML v1 Profiles' {
  package rov {
    metadata def Hardware {
      attribute qualified : ScalarValues::String;
      attribute vendor : ScalarValues::String;
    }
  }
}

v1 मॉडल के हर हिस्से का क्या हुआ:

  • इकाई वाला value type। वाट में Power मानक लाइब्रेरी के ISQ::PowerValue को विशेषीकृत करता है, और डिफ़ॉल्ट मान उसकी इकाई के साथ लिखा जाता है: 120 [SI::W]। जिस value type की इकाई मैप की गई SI इकाई नहीं है, वह वास्तविक संख्या बना रहता है, इकाई उसके दस्तावेज़ीकरण में होती है, और उसे अनुमानित के रूप में रिपोर्ट किया जाता है।
  • Block और property। Block part def बन जाते हैं और part property part बन जाती हैं। block की isEncapsulated का कोई SysML v2 कीवर्ड नहीं है, इसलिए उसे SysMLv1Library::BlockData मेटाडेटा के रूप में रखा जाता है।
  • Interface block और पोर्ट। interface block एक port def बन जाता है जिसकी flow property दिशा वाले फ़ीचर हैं: block-टाइप वाली के लिए out item, मान के लिए out attribute। conjugated proxy port को ~Types::'Power Interface' से टाइप किया जाता है। full port SysMLv1Library::PortData मेटाडेटा वाला एक part बन जाता है, क्योंकि SysML v2 पोर्ट को port definition से टाइप किया जाता है।
  • Connector और item flow। connector दोनों पोर्ट के बीच एक connection बन जाता है, और उस पर item flow उन्हीं पोर्ट के बीच Charge का एक flow।
  • आवश्यकताएं। हर आवश्यकता अपनी id को short name, <'R-1'>, के रूप में और अपने टेक्स्ट को doc के रूप में रखती है। satisfy संबंध उस block में होता है जिसके पास satisfy करने वाला part है; derive संबंध एक derivation connection बन जाता है; trace SysMLv1Library::TraceData वाली एक dependency बन जाता है।
  • उपयोगकर्ता स्टीरियोटाइप। «Hardware» पैकेज 'SysML v1 Profiles' में एक metadata def बन जाता है, जो हर block पर उसके टैग किए गए मानों के साथ लागू होता है। इसके दोनों अनुप्रयोग अनुमानित के रूप में रिपोर्ट किए जाते हैं: टैग मान टेक्स्ट एट्रिब्यूट बन गए, प्रोफ़ाइल में उनका प्रकार चाहे जो रहा हो।
  • Association। बिना क्लास वाले association का यहाँ कोई SysML v2 समकक्ष नहीं है, और association के स्वामित्व वाला उसका सिरा भी रूपांतरित नहीं होता। दोनों को छोड़ा गया के रूप में रिपोर्ट किया जाता है; block पर की property संरचना को वहन करती हैं।

इस मॉडल की रिपोर्ट: 31 एलिमेंट, 27 रूपांतरित, 2 अनुमानित, 2 छोड़े गए, और टेक्स्ट बिना त्रुटि और बिना चेतावनी के जांच में पास होता है। जो नाम सादे पहचानकर्ता नहीं हैं, जैसे 'power budget' या 'out' (एक SysML v2 कीवर्ड), उन्हें उद्धरण चिह्नों में रखा जाता है ताकि उनकी v1 वर्तनी बनी रहे।

5. जो अनुमानित किया गया या छोड़ा गया, उसे सुधारें

रिपोर्ट की अनुमानित और छोड़ी गई पंक्तियों को कारण के अनुसार देखें। अधिकांश कारणों के लिए कुछ ही निर्णयों में से एक चाहिए:

रिपोर्ट क्या कहती हैक्या तय करें
एक पोर्ट किसी ऐसे block से टाइप है जो interface block नहीं है; वह बिना प्रकार का पोर्ट बन गयासीमा पार करने वाले फ़ीचर के साथ एक port definition परिभाषित करें, और पोर्ट को उससे टाइप करें।
choice, junction, fork या join से होकर जाने वाले ट्रांज़िशन; हर पथ एक ट्रांज़िशन बन गयाजांचें कि जोड़े गए गार्ड अब भी वही कहते हैं जो v1 आरेख का अर्थ था; जहाँ पथ अब पढ़ने में आसान हैं वहाँ सरल करें।
एक ट्रिगर दस्तावेज़ीकरण के रूप में रखा गया हैजहाँ अर्थ स्पष्ट हो, change और time ट्रिगर को SysML v2 ट्रिगर के रूप में फिर से लिखें, जैसे किसी अवधि के accept after।
कोई इकाई ऐसी SI इकाई नहीं है जिसे Holarch मैप करता है; value type एक वास्तविक संख्या हैतय करें कि कोई मानक मात्रा उपयुक्त है या नहीं, या वास्तविक संख्या और दस्तावेज़ित इकाई रखें।
call, opaque या accept action के अलावा कोई action प्रकार एक सादा action बन गयाsend और अन्य विशिष्ट action को उसी काम वाले SysML v2 action से फिर से लिखें।
Activity partition रूपांतरित नहीं होतेस्विमलेन के बजाय part में perform से बताएं कि कौन सा part क्या करता है।
यह बिना नाम वाले एलिमेंट की ओर इशारा करता हैv1 टूल में लक्ष्य का नाम रखें और फिर से रूपांतरित करें, या v2 मॉडल में संबंध जोड़ें।
इसका नाम एक ही जगह दो बार उपयोग हुआ है; प्रत्यय के साथ नाम बदला गयाहर एलिमेंट को ऐसा नाम दें जो बताए कि वह क्या है।
टैग किए गए मान मेटाडेटा के टेक्स्ट एट्रिब्यूट बन गएमेटाडेटा एट्रिब्यूट को उनके ज़रूरी प्रकार दें, और तय करें कि अब हर स्टीरियोटाइप का क्या अर्थ है।

दो तरह के टेक्स्ट को देखना ज़रूरी है, भले ही वे साफ़ रूपांतरित हुए हों। opaque body अपनी मूल भाषा में textual representation के रूप में रखी जाती हैं, जैसे language "OCL" /* … */; Holarch केवल SysML या KerML में लिखी body की जांच करता है, इसलिए जहाँ मॉडल को किसी गार्ड या बाधा का मूल्यांकन करना चाहिए, उसे SysML expression के रूप में फिर से लिखें। और शाब्दिक अनुवाद v1 के जुगाड़ रखते हैं, जैसे केवल एक मान सेट करने के लिए बनाए गए property-specific type: SysML v2 में ये usage पर सादी redefinition हैं। किस पर फिर से सोचना है आम उदाहरण सूचीबद्ध करता है।

6. ज़रूरी व्यू फिर से बनाएं

आरेख और उनका लेआउट रूपांतरित नहीं होते। चरण 1 की आरेख सूची लें और हर उस आरेख के लिए एक व्यू बनाएं जिसकी अब भी ज़रूरत है: संरचना और आवश्यकताओं के लिए general view, parts और connections के लिए interconnection view, activities के लिए action flow view, state machines के लिए state transition view। केवल वही फिर से बनाएं जिसका लोग उपयोग करते हैं; बाकी सब मॉडल में हर हाल में रहता है। देखें व्यू संदर्भ।

7. v2 मॉडल की जांच और समीक्षा करें

  • टेक्स्ट जांच में साफ़ है। आयात कुछ भी बदलने से पहले रूपांतरित टेक्स्ट की जांच दिखाता है; आपके सुधार के बाद, संपादक टाइप करते समय कोई भी नई समस्या चिह्नित करता है।
  • गिनतियां मेल खाती हैं। v1 मॉडल और v2 मॉडल के बीच कुछ संख्याओं की तुलना करें: आवश्यकताएं, parts, पोर्ट, connections, verification संबंध। जो अंतर आप रिपोर्ट से नहीं समझा सकते, उसे देखना उचित है।
  • मॉडल का उपयोग करने वाले लोग इसकी समीक्षा करते हैं। पायलट पैकेज को उसके स्वामियों के साथ देखें, अनुमानित एलिमेंट और फिर से बनाए गए व्यू से शुरू करके।
  • निर्णय दर्ज करें। पोर्ट, ट्रिगर, इकाइयों और स्टीरियोटाइप के लिए तय किए गए मॉडलिंग पैटर्न लिख लें, ताकि बाकी माइग्रेशन उनका पालन करे।

8. बाकी रूपांतरित करें और स्विच करें

बचे हुए पैकेज एक-एक करके उसी SysML v2 प्रोजेक्ट में रूपांतरित करें। हर आयात वही पूर्वावलोकन दिखाता है: प्रोजेक्ट में पहले से मौजूद पैकेज बदला गया या अपरिवर्तित दिखता है, नया पैकेज नया, और आप चुनते हैं कि कौन से पैकेज आयात करने हैं। हर आयात एक पूर्ववत चरण है।

v2 मॉडल की समीक्षा होने तक v1 मॉडल को संदर्भ के रूप में रखें, फिर उसे फ़्रीज़ करें और SysML v2 प्रोजेक्ट को आधिकारिक मॉडल बनाएं। उसके बाद, परिवर्तन केवल v2 मॉडल में जाते हैं।

माइग्रेशन चेकलिस्ट

  • पैकेज, स्वामी और ज़रूरी आरेख सूचीबद्ध हैं।
  • जिन एलिमेंट की ओर संबंध इशारा करते हैं, उनके नाम हैं।
  • निर्यात की गई XMI फ़ाइल माइग्रेशन रिकॉर्ड के साथ रखी गई है।
  • एक पायलट पैकेज रूपांतरित हुआ, उसकी रिपोर्ट डाउनलोड हुई, और हर अनुमानित और छोड़ी गई पंक्ति पर निर्णय है।
  • पोर्ट, ट्रिगर, इकाइयों और स्टीरियोटाइप के मॉडलिंग पैटर्न लिखे गए हैं।
  • ज़रूरी व्यू फिर से बनाए गए हैं; टेक्स्ट जांच में साफ़ है।
  • मॉडल के उपयोगकर्ताओं ने पायलट की समीक्षा की है।
  • बचे हुए पैकेज उसी तरह रूपांतरित हुए हैं, और v1 मॉडल फ़्रीज़ है।

आगे कहाँ जाएं

Cameo Systems Modeler, MagicDraw, Enterprise Architect, Rhapsody और Eclipse Papyrus अपने-अपने स्वामियों के ट्रेडमार्क हैं। Holarch उनसे संबद्ध नहीं है और न ही उनके द्वारा समर्थित है।