Holarch

מ-SysML v1 ל-SysML v2

העברת מודל SysML v1 שלכם ל-SysML v2 בלי לצייר אותו מחדש.

גוררים לפרויקט SysML v2 מודל SysML v1 שנשמר כ-XMI ‏(.xmi, .xml, .uml) או כארכיון פרויקט .mdzip. ‏Holarch ממיר אותו לטקסט SysML v2, בודק את הטקסט ומדווח על כל רכיב אם הומר, קורב או הושמט, עם הסיבה, לפני שמשהו מיובא.

הממיר כלול בכל תוכנית, כולל Free. חשבונות חדשים מתחילים ניסיון Individual של 30 ימים בכניסה הראשונה: 10,000 פריטים לפרויקט, ללא כרטיס אשראי, וחזרה ל-Free בסופו. כבר יש לכם חשבון? התחלת הניסיון.

הוכחה: המודל CubeSat EO-1

תוצאהרכיבים
הומרו1,007
קורבו32
הושמטו3
רכיבים שנקראו1,042
בעיות בטקסט SysML v20

הטקסט המומר עובר בדיקה ללא שגיאות וללא אזהרות, ואותו מודל מומר לאותו טקסט בכל פעם. מה קורב ומה הושמט

ייבוא מודל SysML v1

ייבוא קובץ XMI או פרויקט .mdzip של מודל SysML v1 לפרויקט SysML v2. לפני שנוצר משהו, דוח המרה מפרט כל רכיב כמומר, מקורב או מושמט, עם הסיבה, ונשמר כקובץ CSV. הדוגמה היא המודל CubeSat EO-1: ‏1,042 רכיבים, שיובאו ללא בעיות.

ייבוא מודל SysML v1 בדף הסרטונים

מה מקבלים מהממיר

מודל SysML v2 שאפשר לעבוד בו, ורשימה ברורה של מה שצריך לבדוק.

בלי לצייר מחדש

בלוקים הופכים ל-part def, פתחות, מחברים וזרימות פריטים עוברים, דרישות שומרות על המזהים והטקסט שלהן, וקשרי satisfy, ‏verify ו-allocate נשארים עקיבים.

דוח על כל רכיב

כל רכיב של מודל v1 מופיע עם הסוג שלו ב-v1, התוצאה שלו, השם ב-SysML v2 שהוא קיבל, ולכל מה שקורב או הושמט, הסיבה במילים. אפשר לסנן אותו על המסך או להוריד אותו כ-CSV.

נבדק לפני הייבוא

המנוע שבודק את עורך SysML v2 תוך כדי הקלדה בודק את הטקסט המומר. קודם רואים את התוצאה, את הטקסט ואת הדוח; הייבוא הוא צעד ביטול אחד.

ייבוא חוזר כשמודל v1 משתנה

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

מודל שאפשר לעבוד בו

העורך, התצוגות, הדרישות, האימות ושאר הדפים של פרויקט SysML v2 קוראים את המודל המומר כמו כל מודל אחר.

מודל v1 שלכם נשאר כפי שהוא

Holarch קורא ייצוא שלו ולעולם אינו כותב אליו חזרה, כך שמודל v1 נשאר המקור בזמן שהצוות סוקר את גרסת SysML v2.

איך זה עובד

  1. גרירת הקובץ. בפרויקט SysML v2 יש ללחוץ על מודל ← ייבוא וייצוא, לבחור לפרויקט הזה או לפרויקט SysML v2 חדש, ולגרור את קובץ ה-.mdzip, ‏.xmi, ‏.uml או .xml. כרטיס התקדמות מציג קריאה, המרה ובדיקה.
  2. סקירת הדוח. המרה מ-SysML v1 מציג את הספירות, מציין אם הטקסט עובר בדיקה ללא בעיות, ומפרט את הרכיבים שקורבו ושהושמטו עם הסיבה לכל אחד. הצגת הטקסט של SysML v2 פותח את התוצאה; כדי לשמור אותם אפשר להוריד את הדוח או את קובץ ה-.sysml.
  3. ייבוא. מבטלים את הסימון של חבילות שאינן רצויות ומייבאים. ביטול פעולה אחד מסיר שוב את כל הייבוא.

שלב אחר שלב, עם הגדרות הייצוא של כל כלי: ייבוא מודלים של SysML v1 בתיעוד, ומדריך ההגירה לתכנון המעבר של תוכנית שלמה.

בלוק מומר

part def 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';
}

פלט הממיר עבור בלוק מכומס עם שני חלקים, מאפיין ערך בוואטים, מחבר בין פתחות proxy עם זרימת פריט, וקשר satisfy. מדריך ההגירה מציג את המודל הקטן כולו, לפני ואחרי.

מה הוא קורא

  • SysML v1 כ-XMI 2.x: ‏UML 2.5 עם פרופיל SysML 1.x.
  • .xmi: קובץ XMI.
  • .xml: ‏XMI שנשמר עם הסיומת .xml.
  • .uml: קובץ מודל XMI.
  • .mdzip: ארכיון פרויקט דחוס שמכיל את המודל כ-XMI; ‏Holarch קורא את ה-XMI שבתוכו.
  • פורמטים אחרים של פרויקטים: כלי ששומר מודלים בפורמט פרויקט משלו מייצא קודם את המודל כ-XMI.

קובץ אחד לכל ייבוא, עד 64 MB, ‏250,000 רכיבים ו-512 רמות קינון.

מה יוצא

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

ההמרה מבוססת על הטרנספורמציה מ-SysML v1 ל-SysML v2 שבמפרט OMG SysML 2.0.

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

כל רכיב של מודל v1 מקבל אחת משלוש תוצאות, כך שיודעים בדיוק איפה להסתכל.

הומרו

לרכיב יש מקבילה ישירה ב-SysML v2. בלוק הופך ל-part def, בלוק ממשק ל-port def, ודרישה שומרת על המזהה והטקסט שלה.

קורבו

הרכיב נשמר בצורה משתנה. פתחה מלאה שהטיפוס שלה הוא בלוק ממשק הופכת לפתחה; מעבר דרך צומת בחירה הופך למעבר אחד לכל מסלול; יחידה שאינה יחידת SI ממופה הופכת למספר ממשי, והיחידה נכתבת בתיעוד שלו.

הושמטו

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

מאפיינים של SysML v1 ללא מילת מפתח ב-SysML v2, כמו בלוק מכומס, פתחה מלאה או קשר refine, נשמרים כמטא-נתונים מהחבילה SysMLv1Library, ש-Holarch טוען בכל פרויקט SysML v2. הסטריאוטיפים שלכם הופכים להגדרות מטא-נתונים עם הערכים המתויגים שלהם, והתנהגויות אטומות, תנאי שמירה ואילוצים שומרים על הגוף שלהם כייצוגים טקסטואליים, כמו language "OCL" /* … */.

מה מומר למה

המיפויים העיקריים. התיעוד מפרט את כולם.

SysML v1SysML v2
חבילהpackage, מקונן כמו ב-v1
Block, ‏actorpart def
Value type, ‏enumerationattribute def, ‏enum def; ‏value type עם יחידת SI ידועה מתמחה מכמות ה-ISQ
מאפייני part, ‏reference ו-valuepart, ‏ref part, ‏attribute, עם ריבויים וערכי ברירת מחדל
Interface block, ‏proxy port, ‏flow propertyport def, ‏port, ‏item או attribute מכווני כיוון
Connector, ‏binding connector, ‏item flowconnect, bind, flow
Activity, פעולות, זרימות בקרה וזרימות אובייקטיםaction def, פעולות, רצפים (successions) עם תנאי שמירה, זרימות בין פרמטרים
State machine, מצבים, מעבריםstate def, מצבים, מעברים עם accept, תנאי שמירה ואפקטים
Requirement, ‏satisfy, ‏verify, ‏deriverequirement עם המזהה והטקסט שלה, satisfy, ‏verify, חיבורי גזירה
Allocate, ‏refine, ‏traceallocate; ‏dependency עם מטא-נתונים של SysMLv1Library
Use case, ‏interaction, ‏constraint blockuse case def, ‏occurrence def עם הודעות, constraint def
סטריאוטיפים וערכים מתויגיםmetadata def לכל סטריאוטיפ, שמוחל עם התגים שלו

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

הדגמת CubeSat EO-1 שיוצאה כ-SysML 1.6 XMI ויובאה לפרויקט SysML v2 חדש: ‏1,042 רכיבים נקראו, 1,007 הומרו, 32 קורבו, 3 הושמטו. טקסט SysML v2 עובר בדיקה ללא שגיאות וללא אזהרות, והפרויקט החדש נפתח עם המבנה, הפונקציות, הדרישות והעקיבות של הלוויין. כל רכיב שקורב או הושמט, לפי סיבה:

רכיביםתוצאהסיבה
10 מחבריםקורבוקצה מחבר נמצא בתוך חלק; הנתיב אליו חושב מטיפוסי החלקים.
8 מעבריםקורבו4 טריגרים של שינוי וזמן, כמו when Undervoltage, נשמרים כתיעוד; 4 אירועים ללא אות, כמו Contact Start, קיבלו הגדרת item בשם הזה.
6 זרימות פריטיםקורבוהשם משמש פעמיים באותו מקום; שם הזרימה שונה עם סיומת.
5 טיפוסי ערךקורבוהיחידה (%, ‏GB, ‏Mbps, ‏mNms, ‏W/m^2) אינה יחידת SI ש-Holarch ממפה; טיפוס הערך הוא מספר ממשי, והיחידה נכתבת בתיעוד שלו.
2 זרימות בקרהקורבוענף ללא תנאי שמירה לצד ענפים עם תנאי שמירה; הוא קיבל את תנאי השמירה true.
מצב סופי אחדקורבומצב סופי הפך למצב רגיל.
הרחבה אחת של מקרה שימושהושמטוב-SysML v2 אין הרחבות של מקרי שימוש.
2 קשרי traceהושמטוהם מצביעים על רכיבים ללא שם, שטקסט SysML v2 אינו יכול להפנות אליהם.

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

שאלות

מה הולך לאיבוד בהמרה?

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

האם המודל המומר מוכן לשימוש?

הוא עובר בדיקה ללא בעיות וכל דף של פרויקט SysML v2 עובד איתו, אבל כדאי להתייחס אליו כנקודת התחלה. חלק מההבדלים בין השפות מצדיקים החלטת מידול, לא רק תרגום. מה פרויקטי SysML v2 תומכים בו, והפערים הידועים: כיסוי שפת SysML v2.

כמה גדול יכול להיות מודל שאני ממיר?

קובץ אחד של 64 MB לכל היותר, עם 250,000 רכיבים לכל היותר בקינון של 512 רמות לכל היותר, ו-8 MB לכל היותר של טקסט מומר. מודל גדול יותר מייצאים חבילה אחת בכל פעם. מגבלת הפריטים לפרויקט של התוכנית שלכם חלה על המודל המומר: 1,000 ב-Free, ‏10,000 ב-Individual ו-50,000 ב-Team. ראו מה נחשב כפריט. למודל של יותר מ-10,000 פריטים, אפשר לבקש הערכה של Team.

אפשר להמשיך לעבוד בכלי SysML v1 שלי?

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

לאן הקובץ שלי הולך?

Holarch קורא וממיר את קובץ ה-XMI או ה-.mdzip בדפדפן שלכם; הקובץ עצמו אינו מועלה. ב-app.holarch.app טקסט SysML v2 המומר נשלח ל-Holarch כדי להכין את התצוגה המקדימה, והוא נשמר בפרויקט רק כשמייבאים. השירות המתארח אינו מקבל CUI או חומר שכפוף לבקרת יצוא; לשם כך Holarch פועל בסביבה שלכם (Enterprise). עוד באבטחה.

ומה עם דרישות שמנוהלות בכלי לניהול דרישות?

הן עוברות כ-ReqIF ‏(.reqif, ‏.reqifz), פורמט ההחלפה התקני לדרישות. ‏Holarch מייבא ומייצא ReqIF בפרויקטי LML ו-SysML v2. בפרויקט SysML v2, קובץ ReqIF הופך לדרישות, להגדרות דרישה ולחבילות, עם דוח על מה שהומר, והדרישות מיוצאות חזרה עם המזהים המקוריים שלהן. בהלוך-חזור שלנו של הדגמת CubeSat EO-1 מ-Holarch ל-ReqIF וחזרה, כל 407 הפריטים ו-979 ערכי המאפיינים חזרו ללא שינוי. ReqIF בפרויקטי LML · ReqIF בפרויקטי SysML v2

כמה עולה הממיר?

שום דבר נוסף: הוא כלול בכל תוכנית, כולל Free. התוכניות נבדלות במספר הפריטים לפרויקט ובמה שהן כוללות מעבר למידול; ראו תמחור.

בונים הגירה בכלי שלכם?

הממיר הוא חלק מ-Holarch Language Engine, המנוע שמאחורי פרויקטי SysML v2 של Holarch, והוא מורשה לספקי כלים ולאינטגרטורים כתוסף ההגירה. זה אותו ממיר שפועל ב-Holarch.

  • המוצר שלכם קורא את קובץ ה-XMI, והמנוע ממיר: שולחים את מודל v1 כ-JSON בצורה הנייטרלית המתועדת, ומקבלים בחזרה את טקסט SysML v2, את הבדיקה של המנוע עליו ואת הדוח על כל רכיב עם קוד סיבה יציב והשם ב-SysML v2 שהוא קיבל, כ-JSON.
  • פועל במקום שבו המוצר שלכם פועל: בדפדפן כ-WebAssembly ב-Web Worker, או בשרת שלכם דרך Node.js או הרחבת Python עם שימוש בשרת.
  • ניתן לחזרה ותחום: אותו מודל מומר לאותו טקסט בכל פעם; מודלים של עד 250,000 רכיבים, ומודל גדול יותר מקבל תשובת שגיאה, לעולם לא תקיעה.
  • מופעל באמצעות אסימון הרישיון שלכם, בלי בנייה מחדש ובלי שינוי קוד. ההערכה החינמית של 60 ימים פועלת במחשב שלכם עם התיעוד והדוגמאות.

בקשה והתשובה שלה

// Request (the model shortened)
{ "op": "v1_convert",
  "model": { "format": "holarch-xmi-model", … } }

// Answer (shortened)
{ "text": "package 'Rover Model' { … }",
  "diagnostics": [],
  "report": {
    "summary": { "elements": 31, "converted": 27,
                 "approximated": 2, "dropped": 2 },
    "items": [ { "kind": "Association",
                 "status": "dropped",
                 "reason": "association" }, … ] } }

הבקשה v1_convert במדריך ה-API של המנוע. המנוע מציע גם סימולציה ושימוש בשרת כתוספים.

צפייה במודל שלכם ב-SysML v2.

ממירים אותו, קוראים את הדוח, ומייבאים רק כשמרוצים.

חשבונות חדשים מתחילים ניסיון Individual של 30 ימים בכניסה הראשונה: 10,000 פריטים לפרויקט, ללא כרטיס אשראי, וחזרה ל-Free בסופו. כבר יש לכם חשבון? אפשר להתחיל את הניסיון בהגדרות החשבון ← תוכנית וחיוב.