SysML v2
כיסוי שפת SysML v2
פרויקטי SysML v2 של Holarch מבוססים על מפרט OMG SysML v2 ותומכים בתת-קבוצה של השפה. הדף הזה מפרט כל תחום של הסימון הטקסטואלי, עד כמה Holarch תומך בו, ואת הפערים הידועים.
מה פירוש הרמות
- נתמך: העורך מנתח ובודק את המבנה, המודל שומר אותו, והתצוגות והדפים שמשתמשים בו קוראים וכותבים אותו.
- חלקי: נתמך, עם המגבלות שמצוינות בשורה.
- נשמר, לא מפורש: מנותח ונשמר בדיוק כפי שנכתב, בטקסט ובייצוא, אבל לא מקבל משמעות משלו.
- עדיין לא: לא זמין.
אותו מנוע שפה מריץ את העורך, את התצוגות ואת הבדיקות, כך שמבנה שהעורך מקבל זהה בכל תצוגה. ראו גם Holarch Language Engine.
מעבר אל: מבני שפה · קבצים והחלפה · בדיקות · פערים ידועים
מבני שפה
| תחום | רמה | מבנים | מגבלות |
|---|---|---|---|
| חבילות ומרחבי שמות | נתמך | package, חבילות מקוננות, library package, doc, comment … about, הערות // ו-//* */, alias … for …, public, private ו-protected, שמות קצרים <'1.2'>, שמות במירכאות. | חבילות ספרייה, כולל הספרייה התקנית, הן לקריאה בלבד. |
| ייבוא | נתמך | ייבוא של חברות ושל מרחבי שמות, ::*, ::** רקורסיבי, ייבוא עם נראות, ייבוא מסונן [@Kind]. | מסנני ייבוא בוחרים לפי מטא-מחלקה. |
| הגדרות ושימושים | נתמך | part, attribute, item, port, connection, interface, flow, action, state, requirement, constraint, calc, use case, analysis, verification, view, viewpoint, concern, enum, occurrence, allocation, metadata; ref, abstract, in, out, inout ו-end. | אין ידועים. |
| התמחות, טיפוס והגדרה מחדש | נתמך | התמחות :> ו-specializes, טיפוס : ו-defined by, תת-קבוצה :> ו-subsets, הגדרה מחדש :>> ו-redefines, צימוד ~, disjoint, שרשראות מאפיינים a.b.c. | אין ידועים. |
| ריבויים | נתמך | [n], [n..m], [*], [0..*], ordered, nonunique, ביטויים כגבולות. | אין ידועים. |
| ערכים ויחידות | נתמך | =, :=, default, כמויות כמו 5 [kg], ביטויי יחידות כמו [m/s^2], סוגי הכמויות של ISQ ויחידות SI והיחידות המקובלות בארה״ב של הספרייה התקנית, בדיקות ממדים. | אין ידועים. |
| אילוצים וחישובים | נתמך | הגדרות ושימושים של constraint ו-calc, return, assert constraint, קריאות, ביטויי KerML עם חשבון, השוואה, לוגיקה, if ? else ופעולות על רצפים, הערכה עם יחידות. | אין ידועים. |
| מבנה | נתמך | פתחות ופתחות מצומדות, connect, ממשקים עם קצוות, קצוות חיבור בעלי שם עם ריבויים (connect [1] driver ::> a to [1] driven ::> b), מחברי קשירה bind, זרימות פריטים flow of T from … to …, message. | אין ידועים. כיווני פתחות, זרימות ו-message נבדקים. תצוגות Interconnection מתייגות קצוות בעלי שם עם הריבוי שלהם, וחלונית המאפיינים עורכת אותם. |
| פעולות | חלקי | פרמטרים, perform, רצפים first … then … ו-then, fork, join, decide, merge, תנאי שמירה, accept, send, assign, if, while, for, loop, start, done, terminate. | הסימולטור מריץ זרימות פעולות, כולל הרצות Monte Carlo, עם משכי זמן, הסתברויות ענפים ומספרי חזרות של לולאות מהמודל. |
| מצבים | חלקי | פעולות entry, do ו-exit, מעברים עם טריגר, תנאי שמירה ואפקט (נערכים ב-State Transition View ובחלונית המאפיינים, ומוצגים מתחת למעבר בחלונית הדפדפן), מצבי parallel, מצבים מקוננים, exhibit. | הסימולטור מריץ מכונות מצבים עם מנוע SysML, עם גירויים, ומאיר את המצבים הפעילים בזמן הריצה. כל סוג של אפקט do נבדק, המטען של טריגר נבדק מול הפתחה שלו, וחלקים אחרים של המודל יכולים להפנות לטריגר ולאפקט של מעבר (plugIn.effect.sentMessage). |
| דרישות | נתמך | subject, actor, stakeholder, require constraint, assume constraint, frame concern, satisfy … by …, verify, שמות קצרים כמזהי דרישות, doc כטקסט הדרישה. | אין ידועים. |
| מקרי שימוש | נתמך | הגדרות ושימושים של מקרי שימוש, subject, actor, objective, include use case. | אין ידועים. |
| מקרי ניתוח ואימות | חלקי | מקרי ניתוח עם נושא, מטרה ותוצאת return; מקרי אימות עם verify ופסק דין. | מקרה ניתוח מוערך רק כשלכל קלט יש ערך. ניתוחי חלופות מהספרייה התקנית אינם מוערכים; במקום זאת, דף ניתוחי החלופות של Holarch מדרג חלופות עם ערכים מהמודל. |
| תצוגות | חלקי | view, view def, expose עם ::*, ::** ומסננים, filter, viewpoint, frame, render, הגדרות התצוגה התקניות. | תצוגות Sequence מציירות הודעות בין קווי חיים, והודעות בתוך if/else, לולאות, פיצולים והחלטות כמקטעי alt, opt, loop ו-par עם תנאי השמירה שלהם. |
| הקצאה ותלויות | נתמך | allocate a to b, הגדרות הקצאה, dependency from … to …. | אין ידועים. |
| מטא-נתונים | חלקי | @Name { … }, הקידומת #Name, metadata Name about …, metadata def שהמשתמש מגדיר, חבילות המטא-נתונים של Holarch לערכי TBD ו-TBR ולמושגי DoDAF ו-UAF, מילות מפתח שהמשתמש מגדיר (#safetyCritical part controller), מטא-נתונים סמנטיים (#fault def BatteryOverheat;), ומטא-נתונים עם משמעות משלהם: ערכים נדרשים, ערכים מהטיפוס המוצהר והאילוצים של ההגדרה נבדקים בכל שימוש. | האילוצים של הגדרת מטא-נתונים קוראים את הערכים שלה עצמה, לא את הרכיב המוער. מטא-נתונים שנכתבו עם about אינם מוסיפים טיפוס בסיס. |
| שונות | נתמך | הגדרות ושימושים של variation, חברי variant והפניות לווריאנטים (variant plugInHybrid;), בחירות לפי ערך (part :>> pack = BatteryPack::largePack;), תצורות שמסומנות @HolarchConfiguration. נבדק ומוערך: לווריאנט יש את המאפיינים של ה-variation שלו, בחירה חייבת להיות אחד הווריאנטים של הנקודה, ולנקודה ללא בחירה יש ערך לא ידוע, כך שטענה עליה אינה מתקיימת וגם אינה מופרת. | תצורות נכתבות בטקסט; Holarch עדיין אינו מחפש צירופים תקפים בדפים שלו. |
| יחידים ופרוסות זמן | נתמך | הגדרות ושימושים של individual (individual part def Car_VIN1234 :> Car), snapshot ו-timeslice (גם אחרי then), הערכים והרצפים שלהם. נבדק ומוערך: לתמונת מצב או לפרוסת זמן יש את המאפיינים של המופע שאליו הן שייכות, והערכים שלהן עצמן נקראים קודם. השדה מופע בחלונית המאפיינים, המסנן יחידים ו-תמונת מצב חדשה…/פרוסת זמן חדשה… בחלונית הדפדפן, ותצוגות General עם «individual», «snapshot» ו-«timeslice» ועם סידור כציר זמן. | רק מופעים יכולים להיות יחידים, תמונות מצב או פרוסות זמן. |
| ייצוגים טקסטואליים | חלקי | rep language "…" /* … */; גופים ב-SysML וב-KerML נבדקים ומודגשים כקוד, וגוף אילוץ ב-SysML מוערך. חלונית המאפיינים מוסיפה ועורכת ייצוגים, ותצוגות Action Flow מסמנות פעולה שיש לה ייצוג עם השפה שלו, כמו {Python}. | גופים בשפות אחרות, כמו Python, OCL או MATLAB, נשמרים כטקסט ולעולם אינם מורצים. גוף אינו יכול להכיל */. |
| KerML | חלקי | טקסט KerML של הספרייה התקנית: ספריות הליבה נקראות ב-KerML. גופי KerML של ייצוגים טקסטואליים נבדקים. | קובצי .kerml אינם מיובאים לפרויקטים, ומודלים שנכתבו ב-KerML אינם נבדקים. |
| הרחבות שפה | חלקי | מילות מפתח שהמשתמש מגדיר ממטא-נתונים סמנטיים: #fault def BatteryOverheat; מתמחה מטיפוס הבסיס של המטא-נתונים, ולכן יש לו את המאפיינים של הבסיס; מטא-נתונים שמגבילים את מה שהם מעירים (annotatedElement). | טיפוס הבסיס נקרא כשם (faults meta SysML::Usage). הרחבות אחרות של השפה אינן זמינות, ואי אפשר לערוך את הספרייה התקנית. |
קבצים והחלפה
| פורמט | רמה | מה הוא מכסה | מגבלות |
|---|---|---|---|
| טקסט SysML v2 (.sysml) | נתמך | ייבוא וייצוא, גם כ-.zip של קבצים, עם תצוגה מקדימה לפני שייבוא מוחל. | מזהי רכיבים נשמרים כשמסמנים הכללת מזהי רכיבים בייצוא; בלעדיהם, ייבוא חוזר מתאים רכיבים לפי שם. |
| SysML v2 JSON | חלקי | ייבוא וייצוא של פורמט הרכיבים של Systems Modeling API, עם שמירה על מזהי הרכיבים. | סוגי רכיבים ש-Holarch לא מפרש נשמרים כפי שיובאו ונכתבים בחזרה ללא שינוי בייצוא; אין להם טקסט ואי אפשר לערוך אותם. |
| מודלי SysML v1 (XMI, .mdzip) | חלקי | ייבוא לפרויקט SysML v2 מ-Cameo או MagicDraw (.mdzip או XMI), Enterprise Architect, Rhapsody ו-Papyrus (XMI, .uml, .xml). המודל מומר לטקסט SysML v2 ונבדק, ודוח המרה מפרט כל רכיב כמומר, מקורב או מושמט, עם הסיבה, גם כ-CSV. הייבוא הוא צעד ביטול אחד. | ייבוא בלבד. רכיבים ללא מקבילה ב-SysML v2, כמו צומתי סיום זרימה, מחיצות פעילות, הרחבות של מקרי שימוש ו-instance specifications, מושמטים; דיאגרמות והפריסה שלהן אינן מומרות. קובץ אחד של 64 MB ו-250,000 רכיבים לכל היותר; קובצי פרויקט של Enterprise Architect (.eap, .qea) אינם נקראים. |
| מאגרי מודלים | נתמך | משיכה ודחיפה לענף אחד של מאגר שמציע את Systems Modeling API. | ענף אחד לכל פרויקט. |
| Systems Modeling API ב-Holarch | חלקי | כלי SysML v2 אחרים קוראים את המודל הנוכחי של פרויקט ומבצעים commit לענפים של בקשות שינוי. | main הוא לקריאה בלבד: commits נכנסים לבקשות שינוי שגורם מאשר מחיל ב-Holarch. |
| קובצי KerML (.kerml) | עדיין לא | אינם מיובאים; הייבוא מדלג עליהם. | יש להשתמש בקובצי .sysml. |
מגבלות הגודל וכל שאר הפורמטים מפורטים בייבוא וייצוא.
בדיקות
העורך בודק את הטקסט תוך כדי הקלדה ומסמן כל בעיה במקומה. הבדיקות כוללות:
- תחביר: תווים, הערות, מחרוזות, סוגריים מסולסלים,
;, שמות ואסימונים צפויים. - שמות: שמות לא מזוהים, דו-משמעיים, כפולים ופרטיים.
- טיפוס והתמחות: מעגלים, הסוג הנכון של הגדרה, תת-קבוצה והגדרה מחדש של מאפיינים שעוברים בירושה.
- ריבויים ויחידות: גבולות תקפים, ממדים תואמים, יחידות חסרות או לא ידועות.
- ביטויים: טיפוסי אופרנדים, ארגומנטים של חישובים ותנאים בוליאניים.
- מבנה, פעולות ומצבים: קצוות חיבור, כיווני פתחות, זרימות ו-
message, יעדי רצפים, צומתי בקרה, הערכים שלולאתforעוברת עליהם, מעברים התחלתיים, אזורים מקביליים, טריגרים של מעברים (מטענים דרך פתחות, זמניat) ואפקטים שלdo(כולל לאןsendהולך). - מילות מפתח שהמשתמש מגדיר:
#Nameמפנה למטא-נתונים, מטא-נתונים מסמנים רק את הסוגים שהם מתירים, וטיפוס בסיס סמנטי הוא הגדרה או שימוש שמתאימים לרכיב שהוא מסמן. - ערכי מטא-נתונים: כל שימוש בהגדרת מטא-נתונים נותן את הערכים הנדרשים שלה, כל ערך מתאים לטיפוס של המאפיין שלו, והאילוצים של ההגדרה מתקיימים.
- שונות: variations מכילים רק ווריאנטים מהסוג שלהם, בחירה היא ווריאנט של הנקודה שלה, והנקודות הפתוחות של תצורה מצוינות.
- דרישות, מקרים ותצוגות: חברים במקום הנכון, יעדי
satisfy, verify, exposeו-frame. - ייצוגים טקסטואליים: גופי SysML ו-KerML עוברים ניתוח ומצהירים על הרכיב שהם מייצגים; שפה ש-Holarch אינו מכיר מצוינת.
- הערכה: אילוצים, דרישות ומטרות שאינם מתקיימים עבור הערכים הנוכחיים.
כל בדיקה עם הודעה לדוגמה: בדיקות.
פערים ידועים
- אין פותר למקרי ניתוח. מקרה ניתוח מוערך כשלכל קלט יש ערך. ב-Parametric View, פתרון מוצא נעלם יחיד לכל אילוץ.
- אין חיפוש ווריאנטים בדפים. variations, ווריאנטים ותצורות נבדקים ומוערכים; הדפים של Holarch עדיין אינם מפרטים כל צירוף תקף.
- אין קובצי KerML. KerML נקרא עבור הספרייה התקנית בלבד.
- הרחבות השפה מוגבלות למילות מפתח שהמשתמש מגדיר ולמטא-נתונים. מטא-נתונים סמנטיים מחילים את טיפוס הבסיס שלהם; מטא-נתונים אחרים משמעותם מה שההגדרה שלהם קובעת (ערכים נדרשים, טיפוסי ערכים ואילוצים), והספרייה התקנית היא לקריאה בלבד.
- ייצוגים טקסטואליים בשפות אחרות מלבד SysML ו-KerML נשמרים כטקסט; Holarch לעולם אינו מריץ אותם.
- Systems Modeling API: אין commits ל-main, תגים או מיזוגים. כלים אחרים מבצעים commit לענפים של בקשות שינוי; גורם מאשר מחיל אותם ב-Holarch.
Holarch מממש את תת-הקבוצה של המפרט שמפורטת בדף הזה. מה חדש מפרט כל שינוי בה.