SysML v2
ייבוא מודלים של SysML v1
המרת מודל SysML 1.x מ-Cameo, MagicDraw, Enterprise Architect, Rhapsody או Papyrus לטקסט SysML v2, סקירת מה ששינה צורה, וייבואו לפרויקט SysML v2.
בדף זה
סקירה כללית
אפשר להביא מודל 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 לפרויקט
- יש לפתוח פרויקט SysML v2 וללחוץ על מודל → ייבוא וייצוא.
- תחת ייבוא, יש לבחור לפרויקט הזה או לפרויקט SysML v2 חדש.
- יש לגרור את הקובץ
.xmi,.uml,.xmlאו.mdzipאל התיבה, או ללחוץ על התיבה כדי לבחור אותו. מוצג כרטיס התקדמות עם השלבים קורא את קובץ ה-XMI…, ממיר ל-SysML v2… ו-בודק את התוצאה…. - יש לקרוא את המרה מ-SysML v1 בראש התצוגה המקדימה. הוא מציין את מספר האלמנטים שהומרו, הומרו בקירוב והושמטו, והאם טקסט SysML v2 נבדק ללא בעיות.
- אפשר להשתמש ב-הצגה כדי להציג את האלמנטים שהומרו בקירוב ושהושמטו, רק אחד מהסוגים האלה, או את כל האלמנטים. כל שורה מציגה את האלמנט, את סוג ה-SysML v1 שלו, את התוצאה עם מילת המפתח של SysML v2 והשם המלא, ואת למה.
- יש לפתוח את הצגת הטקסט של SysML v2 כדי לקרוא את התוצאה לפני הייבוא.
- יש לבטל בטבלה שלמטה את הסימון של חבילות שאין בהן צורך, ואז ללחוץ על ייבוא 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 שלה יוצר מודל בדיקה מציאותי.
- יש לפתוח את הדגמת CubeSat EO-1 ולייצא אותה כ-UML/SysML XMI בתבנית OMG XMI 2.5.1 (ראו ייצוא מודל UML/SysML (XMI)).
- יש לפתוח פרויקט SysML v2, ללחוץ על מודל → ייבוא וייצוא, לבחור לפרויקט SysML v2 חדש ולגרור את קובץ ה-
.xmi. הדוח מציג: 1,042 אלמנטים, 1,007 הומרו, 32 בקירוב, 3 הושמטו. טקסט SysML v2 נבדק ללא בעיות. - יש להגדיר את הצגה ל-הושמט. שלוש השורות הן use case extension, שאין ב-SysML v2, ושני קשרי trace לאלמנטים ללא שם, שטקסט SysML v2 אינו יכול להפנות אליהם.
- יש ללחוץ על יצירת פרויקט. פרויקט 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 v1 | SysML v2 |
|---|---|
| Model, package | package |
| Block, actor | part def |
| Value type, data type, enumeration | attribute def, enum def (value types עם יחידת SI ידועה מתמחים מגודל ISQ) |
| Signal | item def |
| Interface block | port def |
| מאפייני part, reference ו-value | part, ref part, attribute, עם ריבויים וערכי ברירת מחדל |
| Proxy port, flow property | port, in/out item או attribute |
| Full port | part עם @SysMLv1Library::PortData |
| Connector, binding connector, item flow | connect, bind, flow |
| Generalization | :> |
| Activity, call behavior action, pins | action def, action, פרמטרים |
| Control flows ו-object flows, guards | successions עם guards של if ועם else, זרימות בין פרמטרים |
| Initial, final, decision, merge, fork, join | start, done, decide, merge, fork, join |
| State machine, states, regions | state def, state, מצבים מקבילים |
| Transitions, signal triggers ו-time triggers | transition עם accept, accept after, guards ו-effects |
| Interaction | occurrence def עם lifelines והודעות |
| Use case, subject, include | use case def, subject, include |
| Requirement (מזהה וטקסט) | requirement <'id'> Name { doc /* text */ } |
| Satisfy, verify, derive requirement | satisfy, verify ב-verification objective, חיבור גזירה |
| Refine, trace | dependency עם מטא-נתונים של SysMLv1Library |
| Allocate, dependency | allocate, dependency |
| Constraint block, constraint | constraint def, assert constraint |
| סטריאוטיפים וערכים מתויגים | metadata def לכל סטריאוטיפ, שמוחל עם התגים שלו |
| Comment, documentation | doc, 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 v2
- ייבוא וייצוא של דרישות ReqIF: דרישות מ-DOORS, מ-Polarion ומכלי דרישות אחרים.
- הסימון הטקסטואלי של SysML v2
- המרה בין LML ל-SysML v2
SysML® ו-OMG® הם סימנים מסחריים רשומים של Object Management Group, Inc. בארצות הברית ובמדינות אחרות.