Holarch

SysML v2

ייבוא מודלים של SysML v1

המרת מודל SysML 1.x מ-Cameo, MagicDraw, Enterprise Architect, Rhapsody או Papyrus לטקסט SysML v2, סקירת מה ששינה צורה, וייבואו לפרויקט SysML v2.

אופן השימוש ←

בדף זה
  1. סקירה כללית
  2. מושגים
    1. הומר, בקירוב והושמט
    2. החבילה SysMLv1Library
    3. גופים אטומים הופכים לייצוגים טקסטואליים
  3. איך להשתמש בה
    1. מתי ולמה
    2. ייבוא מודל SysML v1 לפרויקט
    3. ייבוא גרסה חדשה יותר של אותו מודל
    4. שמירת הדוח והטקסט
    5. ייצוא המודל מכלי ה-SysML v1 שלך
  4. דוגמה מעובדת: מודל CubeSat EO-1
  5. טיפים וטעויות נפוצות
  6. מה מומר
  7. מגבלות
  8. הודעות
  9. דפים קשורים

סקירה כללית

אפשר להביא מודל SysML 1.x לפרויקט SysML v2. Holarch קורא את קובץ ה-XMI של המודל, ממיר אותו לטקסט SysML v2, בודק את הטקסט ומציג דוח המרה לפני שדבר משתנה.

  • קלט: מודל SysML 1.x כ-XMI (.xmi, .uml, .xml) או פרויקט Cameo או MagicDraw (.mdzip).
  • פלט: טקסט SysML v2 בפרויקט שלך (ביטול פעולה אחד מחזיר הכול לאחור), או פרויקט SysML v2 חדש.
  • דוח: כל אלמנט v1 עם התוצאה שלו: הומר, בקירוב או הושמט, והסיבה.

ההמרה עוקבת אחר הטרנספורמציה מ-SysML v1 ל-SysML v2 שבמפרט OMG SysML 2.0, במקומות שבהם מודל שהוחלף כ-XMI נושא מספיק פרטים לשם כך.

מושגים

הומר, בקירוב והושמט

כל אלמנט של מודל v1 מקבל תוצאה אחת:

  • הומר: לרכיב יש מקבילה ישירה ב-SysML v2, כמו בלוק שהופך ל-part def.
  • בקירוב: האלמנט נשמר בצורה שונה. לדוגמה, full port שהטיפוס שלו הוא interface block הופך ל-port, ו-transition דרך choice pseudostate הופך ל-transition אחד לכל מסלול.
  • הושמט: אין לו מקבילה ב-SysML v2, או שהאלמנט מצביע על משהו שאינו בקובץ. דוגמאות הן flow final nodes, activity partitions, use case extensions ו-instance specifications.

הדוח מסביר במילים את הסיבה לכל אלמנט שהומר בקירוב או הושמט.

החבילה SysMLv1Library

לחלק מתכונות SysML v1 אין מילת מפתח ב-SysML v2, כמו isEncapsulated של block או קשר refine. הממיר שומר אותן כמטא-נתונים מהחבילה SysMLv1Library, למשל @SysMLv1Library::RefineData { isRefine = true; }. החבילה היא חלק מהספרייה של Holarch, כך שהשמות האלה נפתרים בכל פרויקט SysML v2.

גופים אטומים הופכים לייצוגים טקסטואליים

Opaque behaviors, opaque actions, guards ו-constraint specifications נושאים טקסט בשפה כמו OCL או אנגלית. הממיר שומר כל גוף כייצוג טקסטואלי: language "OCL" /* … */. גופים ב-SysML או ב-KerML נבדקים כמו שאר הטקסט. ראו ייצוגים טקסטואליים.

איך להשתמש בה

מתי ולמה

כדאי להשתמש בייבוא כשצוות מעביר מודל SysML 1.x קיים ל-SysML v2, או רוצה לעשות שימוש חוזר בחלקים ממנו. הטקסט המומר הוא נקודת התחלה: הדוח מציין מה יש לסקור ידנית.

ייבוא מודל SysML v1 לפרויקט

  1. יש לפתוח פרויקט SysML v2 וללחוץ על מודל → ייבוא וייצוא.
  2. תחת ייבוא, יש לבחור לפרויקט הזה או לפרויקט SysML v2 חדש.
  3. יש לגרור את הקובץ .xmi, .uml, .xml או .mdzip אל התיבה, או ללחוץ על התיבה כדי לבחור אותו. מוצג כרטיס התקדמות עם השלבים קורא את קובץ ה-XMI…, ממיר ל-SysML v2… ו-בודק את התוצאה….
  4. יש לקרוא את המרה מ-SysML v1 בראש התצוגה המקדימה. הוא מציין את מספר האלמנטים שהומרו, הומרו בקירוב והושמטו, והאם טקסט SysML v2 נבדק ללא בעיות.
  5. אפשר להשתמש ב-הצגה כדי להציג את האלמנטים שהומרו בקירוב ושהושמטו, רק אחד מהסוגים האלה, או את כל האלמנטים. כל שורה מציגה את האלמנט, את סוג ה-SysML v1 שלו, את התוצאה עם מילת המפתח של SysML v2 והשם המלא, ואת למה.
  6. יש לפתוח את הצגת הטקסט של SysML v2 כדי לקרוא את התוצאה לפני הייבוא.
  7. יש לבטל בטבלה שלמטה את הסימון של חבילות שאין בהן צורך, ואז ללחוץ על ייבוא N חבילות (או יצירת פרויקט). המודל מיובא, וביטול פעולה אחד מחזיר הכול לאחור. ביטול פעולה מסיר אותו שוב.

ייבוא גרסה חדשה יותר של אותו מודל

כשמודל SysML v1 משתנה, יש לייצא אותו שוב ולייבא את הקובץ החדש לאותו פרויקט (לפרויקט הזה). כל אלמנט מומר מקבל את המזהה שלו מהמזהה של האלמנט בקובץ ה-XMI (xmi:id), כך שהייבוא מעדכן את האלמנטים במקומם: אלמנט ששמו שונה או שהועבר לחבילה אחרת בכלי SysML v1 נשאר אותו אלמנט, עם פריסות הדיאגרמה, ההערות, הקישורים וההיסטוריה שלו. הדוח מציין כמה אלמנטים מקבלים את המזהים שלהם ממודל SysML v1. אלמנטים ללא שם (connectors, successions) מותאמים לפי המקום שלהם במודל.

פרויקט שיובא ממודל SysML v1 לפני ש-Holarch גזר מזהים מקובץ ה-XMI שומר על המזהים שלו: ייצוא חדש יותר מעדכן את האלמנטים שלו לפי שם, ואלמנטים חדשים במודל SysML v1 מקבלים ממנו את המזהים שלהם.

שמירת הדוח והטקסט

  • יש ללחוץ על הורדת הדוח לקבלת קובץ CSV עם כל אלמנט, התוצאה שלו, הנתיב שלו ב-SysML v2 והסיבה.
  • יש ללחוץ על הורדת טקסט SysML v2 לקבלת קובץ ה-.sysml המומר.

ייצוא המודל מכלי ה-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. אי אפשר לקרוא ישירות קובצי פרויקט של Enterprise Architect (.eap, .qea).
  • IBM Rhapsody: יש לייצא את המודל באמצעות ערכת הכלים של XMI (XMI 2.x) ולייבא את הקובץ.
  • Eclipse Papyrus: יש לייבא את קובץ ה-.uml של המודל.

דוגמה מעובדת: מודל CubeSat EO-1

הדגמת CubeSat EO-1 היא פרויקט LML. ייצוא SysML v1 שלה יוצר מודל בדיקה מציאותי.

  1. יש לפתוח את הדגמת CubeSat EO-1 ולייצא אותה כ-UML/SysML XMI בתבנית OMG XMI 2.5.1 (ראו ייצוא מודל UML/SysML (XMI)).
  2. יש לפתוח פרויקט SysML v2, ללחוץ על מודל → ייבוא וייצוא, לבחור לפרויקט SysML v2 חדש ולגרור את קובץ ה-.xmi. הדוח מציג: 1,042 אלמנטים, 1,007 הומרו, 32 בקירוב, 3 הושמטו. טקסט SysML v2 נבדק ללא בעיות.
  3. יש להגדיר את הצגה ל-הושמט. שלוש השורות הן use case extension, שאין ב-SysML v2, ושני קשרי trace לאלמנטים ללא שם, שטקסט SysML v2 אינו יכול להפנות אליהם.
  4. יש ללחוץ על יצירת פרויקט. פרויקט SysML v2 החדש נפתח בעורך עם המבנה, הפונקציות, הדרישות והעקיבות של הלוויין.

טיפים וטעויות נפוצות

  • יש לייבא קובץ XMI אחד בכל פעם, ללא קבצים אחרים. יש לייבא קובץ SysML v1 XMI אחד בכל פעם, ללא קבצים אחרים.
  • יש לתת שמות לאלמנטים שאליהם עוקבים. קשרים לאלמנטים ללא שם מושמטים, כי טקסט SysML v2 מפנה לאלמנטים לפי שם.
  • ייבוא חוזר, לא יצירה מחדש. יש לייבא ייצוא חדש יותר לאותו פרויקט ולא לפרויקט חדש: אלמנטים שומרים על המזהים שלהם רק בתוך הפרויקט שבו הם נמצאים.
  • יש לבדוק קודם את ההמרות בקירוב. אלה המקומות שבהם המשמעות עשויה להיות שונה ממודל v1, כמו ports שהטיפוס שלהם הוא blocks או קצוות connector בתוך parts.
  • אלמנטים עם אותו שם באותו מקום מקבלים שם חדש עם סיומת כמו _2. הדוח מפרט כל שינוי שם.
  • דרישות שנשמרות בכלי דרישות (DOORS, Polarion, Jama, codebeamer) מגיעות כ-ReqIF, לא כ-XMI. יש לייבא את קובץ ה-.reqif באותו דף: הוא הופך לדרישות SysML v2 עם דוח מאותו סוג (ייבוא וייצוא של דרישות ReqIF).

מה מומר

SysML v1SysML v2
Model, packagepackage
Block, ‏actorpart def
Value type, data type, enumerationattribute def, enum def (value types עם יחידת SI ידועה מתמחים מגודל ISQ)
Signalitem def
Interface blockport def
מאפייני part, ‏reference ו-valuepart, ‏ref part, ‏attribute, עם ריבויים וערכי ברירת מחדל
Proxy port, flow propertyport, in/out item או attribute
Full portpart עם @SysMLv1Library::PortData
Connector, ‏binding connector, ‏item flowconnect, bind, flow
Generalization:>
Activity, call behavior action, pinsaction def, action, פרמטרים
Control flows ו-object flows, guardssuccessions עם guards של if ועם else, זרימות בין פרמטרים
Initial, final, decision, merge, fork, joinstart, done, decide, merge, fork, join
State machine, states, regionsstate def, state, מצבים מקבילים
Transitions, signal triggers ו-time triggerstransition עם accept, accept after, guards ו-effects
Interactionoccurrence def עם lifelines והודעות
Use case, subject, includeuse case def, subject, include
Requirement (מזהה וטקסט)requirement <'id'> Name { doc /* text */ }
Satisfy, verify, derive requirementsatisfy, verify ב-verification objective, חיבור גזירה
Refine, tracedependency עם מטא-נתונים של SysMLv1Library
Allocate, dependencyallocate, dependency
Constraint block, constraintconstraint def, assert constraint
סטריאוטיפים וערכים מתויגיםmetadata def לכל סטריאוטיפ, שמוחל עם התגים שלו
Comment, documentationdoc, comment

מגבלות

  • קובץ אחד של 64 MB לכל היותר.
  • לכל היותר 250,000 אלמנטים, בקינון של 512 רמות לכל היותר. מודל עם קינון עמוק יותר, או עם מחזור בעלות, אינו מיובא.
  • במודל המומר, אלמנטים בקינון עמוק מ-128 רמות מושמטים עם הסיבה קינון.
  • הטקסט המומר הוא 8 MB לכל היותר.
  • דיאגרמות והפריסה שלהן אינן מומרות. יש ליצור תצוגות בפרויקט SysML v2.

הודעות

הודעהמה לעשות
יש לייבא קובץ SysML v1 XMI אחד בכל פעם, ללא קבצים אחרים.יש לייבא את קובץ ה-XMI לבדו.
<file> אינו מכיל אלמנטים של UML או SysML. יש לייצא את המודל כ-XMI 2.x ולייבא אותו שוב.יש לייצא את המודל שוב כ-XMI 2.x.
לא נמצא מודל UML ב-<file>. ב-Cameo או ב-MagicDraw, יש לייצא את המודל כ-Eclipse UML2 XMI ולייבא את קובץ ה-.xmi.יש לייצא את הפרויקט כ-XMI.
במודל SysML v1 יש יותר מ-250,000 אלמנטים. יש לייצא חלק קטן יותר של המודל.יש לייצא חבילה אחת בכל פעם.
טקסט SysML v2 המומר יהיה גדול מ-8 MB. יש לייצא חלק קטן יותר של המודל.יש לייצא חבילה אחת בכל פעם.

SysML® ו-OMG® הם סימנים מסחריים רשומים של Object Management Group, Inc. בארצות הברית ובמדינות אחרות.