SysML v2
גרסאות מוצר ותצורות ב-SysML v2
מידול קו מוצרים בפרויקט SysML v2: נקודות שונות, גרסאות מוצר, כללים ותצורות בדפדפן ובחלונית המאפיינים, New Configuration…, תצוגות המוצגות כתצורה אחת וניתוחי חלופות של תצורות.
סקירה כללית
קו מוצרים הוא תכן אחד עם כמה נקודות שבהן המוצרים שלו שונים, כמו גודל הסוללה או האם מותקן מטען. ממדלים את הקו פעם אחת, ואז אפשר להסתכל על כל מוצר, לבדוק אותו ולהשוות אותו בלי להעתיק את המודל.
ב-SysML v2 זה מובנה בשפה. Holarch מציג את זה בכל האפליקציה:
- הדפדפן מסמן קווי מוצרים, נקודות שונות, גרסאות ותצורות, ומציג את התצורות של כל קו מוצרים.
- חלונית המאפיינים מציגה את הנקודות, הכללים והתצורות של קו מוצרים עם פסק דין לכל אחת, ומאפשרת לשנות את הבחירות של תצורה.
- תצורה חדשה… יוצר תצורה מתיבת דו-שיח שבודקת את הכללים תוך כדי הבחירה.
- הצגה בתור ▾ בסרגל העליון מציג את התצוגות, את מסד הנתונים, את חלונית המאפיינים ואת דף קו המוצרים כתצורה אחת.
- ניתוחי חלופות יכולים להשוות את התצורות של קו מוצרים או את הגרסאות של נקודה.
שונות בטקסט זמינה בכל התוכניות. בתוכנית Free, דף קו המוצרים, תצורה חדשה… ושינוי הבחירות של תצורה בחלונית המאפיינים הם לקריאה בלבד; העריכה שלהם היא חלק מתוכניות Individual ו-Team. ראו קווי מוצרים: תוכניות.
מושגים
נקודות שונות וגרסאות
נקודת שונות היא מקום בתכן שבו המוצרים שונים. הגרסאות שלה הן הבחירות המותרות.
- שימוש וריאציה הוא נקודה בתוך תכן אחד:
variation part charger : Component { variant part noCharger; variant part wallbox; }. - הגדרת וריאציה היא קבוצת בחירות לשימוש חוזר:
variation part def BatteryPack { variant part standardPack; variant part largePack; }. שימוש שהטיפוס שלו הוא היא, כמוpart pack : BatteryPack;, הוא גם נקודה.
קווי מוצרים
קו מוצרים הוא הגדרה או שימוש שמחזיקים נקודות שונות או יורשים אותן. בהדגמת Hybrid Car, CarLine הוא קו המוצרים: הוא מתמחה ב-Car ומוסיף את הנקודות pack ו-charger. הגדרה שמתמחה בקו מוצרים היא גם קו מוצרים.
כללים
כלל הוא assert constraint של קו המוצרים. הוא פוסל צירופים של גרסאות. בהדגמה, wallboxNeedsLargePack קובע שמטען ה-wallbox דורש את המארז הגדול:
assert constraint wallboxNeedsLargePack { charger == charger::wallbox implies pack == BatteryPack::largePack }
כל עוד לנקודה אין בחירה, כלל עליה אינו מתקיים וגם אינו מופר: פסק הדין שלו אינו ידוע.
תצורות
תצורה היא מוצר אחד של הקו. זהו שימוש שהטיפוס שלו הוא קו המוצרים, שקושר גרסה אחת לכל נקודה. Holarch מסמן אותה ב-@HolarchConfiguration (החבילה HolarchVariability), כך שהעורך מציין כל נקודה שעדיין לא נבחרה בה גרסה:
part plugInHybrid : CarLine {
@HolarchConfiguration;
part :>> pack = BatteryPack::largePack;
part :>> charger = charger::wallbox;
}
לכל תצורה יש פסק דין:
| הכרעה | משמעות |
|---|---|
| תקינה | נבחרה גרסה אחת לכל נקודה, וכל כלל מתקיים. |
| מפר את הכלל … | כלל מופר; פסק הדין מציין אותו. |
| לא שלם | לנקודה עדיין לא נבחרה גרסה; פסק הדין מציין אותה. |
| לא ידוע | לא ניתן היה לחשב כלל, למשל כי ערך שהוא קורא חסר. |
Holarch סופר גם את הצירופים של גרסאות ואת מספר הצירופים שהכללים מתירים. עבור קו מוצרים גדול מאוד הוא בודק רק את הצירופים הראשונים ומציין כמה מהם בדק.
איך להשתמש בה
מתי ולמה
שונות משמשת כשכמה מוצרים חולקים את רוב התכן: רמות גימור של רכב, גרסאות ייצוא, ערכות חיישנים, מוצר עם אפשרות ובלעדיה. ממדלים את התכן המשותף פעם אחת, מסמנים את הנקודות שבהן המוצרים שונים, ומוסיפים תצורה לכל מוצר. כל מוצר נשאר אז מעודכן בכל שינוי בתכן המשותף.
סימון נקודת שונות
- יש לפתוח את העורך ואת החבילה שמכילה את התכן.
- בתוך ההגדרה של קו המוצרים, יש לבחור הוספה ▾ → שונות ולמלא את השם ואת הטיפוס של הנקודה.
- בתוך הווריאציה, יש לבחור הוספה ▾ → גרסה פעם אחת לכל בחירה.
- כדי להשתמש מחדש בקבוצת בחירות, יש לבחור הוספה ▾ → שונות ברמת החבילה. הפעולה כותבת הגדרת וריאציה; יש לקבוע לפיה את הטיפוס של חלק.
הדפדפן מציג עכשיו את קו המוצרים עם סמל התיבות המוערמות, ואת הנקודה עם מעוין.
הוספת כלל
- בתוך ההגדרה של קו המוצרים, יש לכתוב assert constraint על הנקודות שלו, למשל
assert constraint r { charger == charger::wallbox implies pack == BatteryPack::largePack }. - יש לבחור את קו המוצרים בדפדפן.
הכלל מופיע תחת כללים בקטע קו מוצרים של חלונית המאפיינים, עם מספר הצירופים שהוא פוסל.
יצירת תצורה
- בדפדפן, יש לפתוח את תפריט השורה (⋯, לחיצה ימנית או Shift+F10) של קו המוצרים, או של הקבוצה תצורות שלו.
- יש לבחור תצורה חדשה….
- יש לבדוק את מגדיר תצורה של: קו המוצרים שהתצורה שייכת אליו.
- יש להזין שם, כמו
longRangeHybrid. - תחת בחירות גרסאות, יש לבחור גרסה אחת לכל נקודת שונות. פסק הדין מופיע מיד מתחת לבחירות, למשל תקינה: עומדת בכל הכללים או מפרה את הכלל wallboxNeedsLargePack.
- יש ללחוץ על יצירה.
התצורה נכתבת לטקסט אחרי התצורה האחרונה של קו המוצרים, מסומנת ב-@HolarchConfiguration, וביטול פעולה אחד מחזיר הכול לאחור. הדפדפן בוחר אותה בקבוצה תצורות של קו המוצרים.
אפשר לפתוח את תיבת הדו-שיח גם עם תצורה חדשה… בקטע קו מוצרים של חלונית המאפיינים, או מ-⌘K / Ctrl+K.
שינוי הבחירות של תצורה
- יש לבחור את התצורה בדפדפן (או בתצוגה).
- בקטע תצורה של חלונית המאפיינים, יש לבחור גרסה אחרת ברשימה של נקודה.
הקשירה בטקסט נכתבת מחדש (part :>> pack = BatteryPack::standardPack;) ופסק הדין מתעדכן; ביטול פעולה אחד מחזיר הכול לאחור. בחירת לא נבחר מסירה את הבחירה. בחירה שהייתה מוסיפה שגיאה למודל נדחית עם הסיבה.
להציג את המודל כתצורה אחת
- בסרגל העליון, יש ללחוץ על הצגה בתור ▾ (כתוב עליו כל התצורות ▾ עד שבוחרים אחת) ולבחור תצורה. באנר מתחת לסרגל העליון מציג, למשל, מוצגת התצורה plugInHybrid. ואת מספר האלמנטים שחלים. ב-General View, ב-Interconnection View ובתצוגת Grid, הגרסאות שהיא אינה בוחרת והתצורות האחרות מוסתרות, וכל נקודת שונות מציגה את הבחירה שלה, כמו pack : BatteryPack = largePack. מסד הנתונים, חלונית המאפיינים ודף קו המוצרים פועלים לפי אותה בחירה.
- כדי לחזור, יש לבחור הצגה בתור ▾ → כל התצורות, או ללחוץ על יציאה בבאנר.
בתוכניות Individual ו-Team אפשר לערוך בזמן שתצורה מוצגת; כל עריכה היא עריכת טקסט SysML v2, שנבדקת לפני שהיא מוחלת, וביטול פעולה אחד מבטל כל אחת מהן:
- בחירת גרסה כותבת את הקשירה בתצורה (
part :>> pack = BatteryPack::largePack;). - ערך תכונה ששונה הופך לערך של התצורה עצמה; ההגדרה שומרת על הערך שלה.
- חלקים ופעולות חדשים שייכים לתצורה.
- מחיקת אלמנט שעבר בירושה ושמותר להשמיט כותבת
part :>> roofBox[0];בתצורה. אי אפשר למחוק שם אלמנט חובה שעבר בירושה; יש לשנות אותו בעורך. - סיכון, משימה או פריט Holarch אחר שיוצרים חלים על התצורה.
בתוכנית Free, תצוגת התצורה היא לקריאה בלבד. מחלונית המאפיינים של תצורה, הצגה בתצוגה ▾ פותח תצוגה של קו המוצרים שלה, המוצג כאותה תצורה.
השוואת תצורות בניתוח חלופות
- יש לפתוח את סיכונים, בעיות והחלטות → ניתוחי חלופות וניתוח (או ללחוץ על + ניתוח חלופות חדש).
- תחת חלופות, יש ללחוץ על + מקו מוצרים….
- תחת מ-, יש לבחור תצורות של … (קו מוצרים) או גרסאות של … (נקודת שונות).
- יש לבטל את הסימון של כל פריט שאינו רצוי, וללחוץ על הוספה.
כל תצורה או גרסה הופכת לחלופה, מקושרת לאלמנט המודל. אפשר להוסיף קריטריונים וערכים כמו בכל ניתוח חלופות, או להשתמש ב-משיכת ערכים מהמודל.
דוגמה מעשית: הדגמת Hybrid Car
יש ליצור את ההדגמה עם קובצי פרויקט ▾ → פרויקט הדגמה חדש → Hybrid Car (SysML v2) בדף ניהול הפרויקטים.
- יש לפתוח את מודל → דפדפן ולהרחיב את Vehicles.
BatteryPackו-CarLineנושאים את סמלי קו המוצרים; ל-CarLineיש קבוצת תצורות עםlongRangeHybrid,plugInHybridו-selfChargingHybrid. - יש לבחור את
CarLine. הקטע קו מוצרים מציג את הנקודותpack(standardPack, largePack) ו-charger(noCharger, wallbox), את הכללwallboxNeedsLargePackואת שלוש התצורות, כולן תקינה. הוא מדווח על 4 צירופים: 3 מותרים לפי הכללים, ואחד נפסל (ה-wallbox עם המארז הסטנדרטי). - יש לבחור את
selfChargingHybridולשנות את charger ל-wallbox. פסק הדין הופך ל-מפרה את הכלל wallboxNeedsLargePack. ביטול עם ⌘Z / Ctrl+Z. - יש לפתוח את התצוגה
carLineVariants(דיאגרמות) ולבחור הצגה בתור ▾ → plugInHybrid. התיבהBatteryPackשומרת רק אתlargePack, והתיבהCarLineמציגה pack : BatteryPack = largePack ו-variation charger : Component = wallbox. - יש לפתוח את ניתוחי חלופות → Configuration Line-up (TR-2). החלופות שלו הן שלוש התצורות, עם ניקוד לפי מחיר, טווח חשמלי ונוחות טעינה.
עצות ושיטות עבודה טובות
- יש לשמור את התכן המשותף בקו המוצרים ורק את ההבדלים בגרסאות. גרסה מגדירה מחדש את מה שהיא משנה (
attribute :>> capacity = 12 [kW*h];). - כדאי לכתוב כללים ברגע שידוע שצירוף מסוים אינו מותר. פסקי הדין תופסים אז תצורה שגויה מיד.
- יש לתת לתצורות שמות לפי המוצר, לא לפי הבחירות (
plugInHybrid, לאlargePackWallbox). - כדאי להשתמש בתצוגה אחת לכל קו מוצרים ולהחליף אותה בין תצורות, במקום תצוגה אחת לכל תצורה.
טעויות נפוצות
- תצורה אינה מופיעה תחת קו המוצרים שלה. הטיפוס שלה חייב להיות קו המוצרים (
part x : CarLine). יש לבדוק את הטיפוס שלה בחלונית המאפיינים. - פסק דין נשאר «לא ידוע». כלל קורא ערך שאין לו ערך בתצורה הזו. יש לבחור גרסה לכל נקודה, או לתת לערך ברירת מחדל.
- בחירה נדחית. הגרסה אינה אחת מהגרסאות של אותה נקודה. יש לבחור מהרשימה בחלונית המאפיינים, או לתקן את השם בטקסט.
כיצד זה מתחבר לתכונות אחרות
- עורך: הוספה ▾ כותב שונות, גרסה, תצורה ובחירת גרסה. כל מה שכאן הוא טקסט SysML v2 רגיל, ולכן ייבואים, ייצואים וכלי SysML v2 אחרים קוראים אותו.
- ניתוחי חלופות: תצורות וגרסאות כחלופות.
- דיאגרמות בלוקים של אמינות: הגרסאות של נקודת שונות הן חלופות, ולכן הדיאגרמה סופרת רק את הגרסה שהתצורה ב-הצגה בתור ▾ בוחרת. כשכל התצורות מוצגות, הנקודה היא בלוק אחד עם ערכים משלו, והחלונית מציינת שיש לבחור תצורה.
- בדיקות המודל: אימות → בדיקות מודל מדווח על כל תצורה שמפרה כלל או משאירה נקודת שונות ללא גרסה (ProductLine.3, שגיאה). ההערה היא פסק הדין, כמו מפרה את הכלל wallboxNeedsLargePack, והכללים המופרים מוצגים כאלמנטים קשורים. תיקון → פתיחת הפריט פותח את התצורה. ה-API וה-MCP מדווחים על אותו ממצא (
run_model_checks,GET …/model-checks). - בקשות שינוי והיסטוריה: כל שינוי הוא שינוי מודל רגיל, וביטול פעולה אחד מבטל כל אחד מהם.
דפדפן
- סמלים: תיבות מוערמות לקו מוצרים, מעוין לנקודת שונות, מעוין מלא לגרסה, מחוונים לתצורה. לכל סמל יש תיאור כלי.
- הקבוצה תצורות: החבר הראשון בשורה של קו מוצרים. היא מציגה את התצורות של קו המוצרים בכל מקום שבו הן מוצהרות; כל שורה בה מייצגת את התצורה עצמה. בתפריט השורה שלה יש תצורה חדשה….
- תפריט השורה: תצורה חדשה… על קו מוצרים ועל כל אחת מהתצורות שלו.
- קוראי מסך: השם של שורה אומר מה היא, למשל CarLine, part def, product line או plugInHybrid, part, configuration of CarLine.
חלונית המאפיינים
קו מוצרים
- נקודות שונות: כל נקודה עם הגרסאות שהיא בוחרת מתוכן.
- כללים: ה-assert constraints של קו המוצרים, או אין כללים: כל צירוף של גרסאות מותר.
- תצורות: טבלה של התצורות ופסקי הדין שלהן.
- צירופים: כמה צירופים של גרסאות קיימים וכמה מהם הכללים מתירים, פוסלים או משאירים לא ידועים.
- תצורה חדשה…
תצורה
- מגדיר תצורה של: קו המוצרים.
- מצב: פסק הדין, שמוכרז לקוראי מסך כשהוא משתנה.
- רשימה אחת לכל נקודת שונות: הגרסה שנבחרה, או לא נבחר. ביטול פעולה אחד מבטל שינוי.
- כללים: כל כלל כ-מתקיים, מופר או לא ידוע.
- הצגה בתצוגה ▾: התצוגות General, Interconnection ו-Grid שמציגות את קו המוצרים, נפתחות כתצורה הזו.
נקודת שונות וגרסה
- נקודת שונות מציגה את הגרסאות שלה, ותחת נבחר על ידי, את מה שכל תצורה בוחרת.
- גרסה מציגה ממה היא גרסה של ואילו תצורות בוחרות בה.
הצגה בתור תצורה
- היכן: הסרגל העליון, כשיש במודל תצורה. בחירה אחת לכל כרטיסיית דפדפן: התצוגות General, Interconnection ו-Grid, מסד הנתונים, חלונית המאפיינים ודף קו המוצרים פועלים לפיה.
- בקרה: הצגה בתור ▾ (כתוב עליו כל התצורות ▾ עד שבוחרים אחת). התפריט מציג כל התצורות, את התצורות של כל קו מוצרים עם פסקי הדין שלהן, תחולה ▸ (הצגת המודל לפי מספר סידורי, תאריך בנייה או שניהם: מספר סידורי ותאריך… הוא יחידה עם המספר הסידורי הזה שנבנתה בתאריך הזה) וניהול קו מוצרים. בבאנר שמתחת לסרגל העליון יש שינוי ▾ ויציאה.
- מה משתנה: גרסאות שהתצורה אינה בוחרת והתצורות האחרות של אותו קו מוצרים מוסתרות, יחד עם מה שבבעלותן. נקודות שונות מציגות את הבחירה שלהן. הפריסות אינן מסודרות מחדש והן משותפות לכל התצורות.
- עריכה: תוכניות Individual ו-Team. העריכות פועלות לפי הכללים שב-הצגת המודל כתצורה אחת. בתוכנית Free, ולאנשים עם הרשאת צפייה, התצוגה היא לקריאה בלבד והבאנר מסביר מדוע.
- רשת: הטבלה משמיטה את האלמנטים המוסתרים ומציינת את הבחירות מעל הטבלה. המטריצה מציגה את כל קו המוצרים.
- לכל כרטיסייה: הבחירה נשמרת בכרטיסיית הדפדפן עד שמשנים אותה. התמונות של התצוגה ברשימת הדיאגרמות מציגות את כל קו המוצרים.
- קוראי מסך: המעבר מכריז על התצורה ועל מספר האלמנטים שחלים, למשל מוצגת התצורה plugInHybrid. … רכיבים חלים., ונוסף לקריאה בלבד. כשאי אפשר לערוך.
הודעות
| הודעה | מה לעשות |
|---|---|
| אין עדיין נקודות שונות במודל. יש להוסיף וריאציה בעורך (הוספה ▾ → שונות), ואז לנסות שוב. | יש לסמן קודם נקודת שונות. |
| אין עדיין במודל תצורות או גרסאות. … (+ מקו מוצרים…) | יש להוסיף קודם נקודת שונות או תצורה. |
| יש להזין שם לתצורה. | יש להקליד שם ב-שם. |
| … כבר בשימוש ב-…. יש לבחור שם אחר. | לאלמנט אחר באותה חבילה יש את השם הזה. |
| לשמות יש 1 עד 1,000 תווים וללא מעברי שורה. יש לשנות את השם. | יש לקצר את השם או להסיר את מעבר השורה. |
| בחירה או תצורה שנדחית | היא הייתה מוסיפה שגיאה למודל; ההודעה מציינת את השגיאה. יש לתקן את הטקסט, או לבחור גרסה אחרת. |
| בודק SysML אינו זמין, ולכן אי אפשר לקרוא את נקודות השונות. | יש לטעון מחדש את הדף, או ליצור את התצורה בעורך עם הוספה ▾ → תצורה. |
מגבלות
- עבור קו מוצרים גדול מאוד, ספירת הצירופים בודקת רק את הצירופים הראשונים; תצורות נבדקות תמיד במלואן.
- בתוכנית Free, תצוגה המוצגת כתצורה אחת היא לקריאה בלבד.
- עדיין לא: שחרור או הוצאה משימוש של תצורת SysML v2. כל תצורת SysML v2 היא במצב טיוטה, ולכן בקרת התצורה אינה נועלת אותה.
- השונות חלה על מודל SysML v2. פריטי Holarch שלצדו (סיכונים, בדיקות, משימות, סעיפי מסמכים) חלים על כל התצורות, מלבד אלה שנוצרו בזמן שתצורה הוצגה: הם חלים על אותה תצורה. אי אפשר עדיין לערוך את ה-Applies To שלהם בפרויקט SysML v2.
דפים קשורים
- הסימון הטקסטואלי של SysML v2: וריאציות, גרסאות ותצורות
- תצוגות SysML v2
- ניתוח ב-SysML v2: ניתוחי חלופות
SysML® ו-OMG® הם סימנים מסחריים רשומים של Object Management Group, Inc. בארצות הברית ובמדינות אחרות.