Holarch

SysML v2

עורך הטקסט והדפדפן

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

אופן השימוש ←

בדף זה
  1. סקירה כללית
  2. מושגים
    1. מסמכי טקסט
    2. החלת טקסט על המודל
    3. שגיאות וטיוטות
  3. איך להשתמש בה
    1. פתיחת הטקסט של חבילה
    2. עריכה והחלה של טקסט
    3. הוספת מבנה
    4. השלמת שמות ומילות מפתח
    5. מעבר להגדרה ושינוי שם
    6. חיפוש והחלפה
    7. תיקון שגיאות
    8. עיון בעץ המודל
    9. מחיקה ושחזור של אלמנטים
  4. דוגמה מעשית: הוספת חיישן גלגל ל-Hybrid Car
  5. טיפים וטעויות נפוצות
  6. העורך
    1. פריסה
    2. המבנים של הוספה ▾
    3. קיצורי מקלדת
  7. הטקסט והתצוגות נשארים מסונכרנים
  8. עבודה עם אחרים
  9. הדפדפן
    1. כותרת הדף ומסננים
    2. שורות
    3. חלונית המאפיינים
    4. תפריט השורה
    5. מקלדת
    6. אלמנטים שאינם מפורשים
    7. אלמנטים שאיבדו מיקום
  10. אלמנטים שנמחקו
  11. נגישות
  12. הודעות
  13. מגבלות
    1. הבודק מושהה
  14. דפים קשורים

סקירה כללית

העורך (מודל → עורך) עורך מודל SysML v2 כטקסט. הדפדפן (מודל → דפדפן) מציג את אותו מודל כעץ של חבילות והחברים שלהן.

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

מושגים

מסמכי טקסט

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

פרויקט אינו מכיל קבצים: המסמכים מודפסים מתוך המודל. כדי לקבל קובצי .sysml, יש לייצא את המודל (ראו החלפת מודלים של SysML v2).

החלת טקסט על המודל

בהתחלה ההקלדה משנה רק את הטקסט. הטקסט מוחל על המודל בנקודת commit:

  • כשמפסיקים להקליד לרגע (כ-0.6 שניות);
  • כשיוצאים מהעורך;
  • כשלוחצים על ⌘S / Ctrl+S או על ⌘↩ / Ctrl+Enter.

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

שגיאות וטיוטות

טקסט עם שגיאה אינו הולך לאיבוד. החברים שמנותחים בהצלחה מוחלים; חבר עם שגיאה אינו מוחל ושומר במודל על המצב התקין האחרון שלו. שורת המצב מציגה לא הוחל: יש לתקן את שורה N.

טקסט שעדיין לא הוחל נשאר טיוטה בדפדפן הזה עד שהוא מנותח בהצלחה. כשפותחים שוב את החבילה, באנר מציג בטקסט הזה יש שינויים מ-<date> שלא הוחלו על המודל. יש לתקן את הטקסט כדי להחיל אותו, או ללחוץ על מחיקת הטיוטה כדי לחזור לטקסט של המודל.

טיוטות נשמרות רק בדפדפן שבו הוקלדו. אנשים אחרים רואים את המצב התקין האחרון של המודל.

איך להשתמש בה

פתיחת הטקסט של חבילה

  1. יש לפתוח את מודל → עורך. החבילה הראשונה נפתחת. אם אין במודל חבילות, יש ללחוץ על + חבילה חדשה.
  2. יש ללחוץ על חבילה ברשימה חבילות כדי לפתוח את הטקסט שלה.
  3. כדי לקפוץ לאלמנט, יש להשתמש ב-הצגה בטקסט בדפדפן, בחלונית המאפיינים או בתצוגה. העורך פותח את החבילה שלו ובוחר את ההצהרה שלו.

עריכה והחלה של טקסט

  1. ההקלדה היא כמו בכל עורך קוד. Enter שומר על ההזחה ומזיח אחרי {; הקלדת } מיישרת אותו עם שורת הפתיחה שלו.
  2. יש להפסיק להקליד. שורת המצב מתחת לטקסט מציגה עדיין לא הוחל, אחר כך מחיל…, ואחר כך הוחל. הדפדפן, התצוגות והדפים מציגים עכשיו את השינוי.
  3. ⌘Z / Ctrl+Z מבטל הקלדה. כשאין בעורך יותר הקלדה לבטל, ⌘Z / Ctrl+Z מבטל את השינוי האחרון בפרויקט, כמו בכל מקום אחר ב-Holarch.

שינוי שרק מעצב מחדש את הטקסט מציג אין שינויים במודל.

הוספת מבנה

הוספה ▾ כותב בשבילך מבנה SysML, כמו חלק עם הטיפוס והריבוי שלו.

  1. יש למקם את הסמן בשורה ריקה בגוף שבו המבנה צריך להיות.
  2. יש ללחוץ על הוספה ▾ בכותרת הדף, או על ⌃⇧Space / Ctrl+Shift+Space. הרשימה מציגה רק את המבנים שמתאימים במיקום הסמן, בארבע קבוצות: מבנה, התנהגות, דרישות ואחר. הכותרת שלה מציינת היכן נמצאים, למשל ברמת החבילה או בתוך הגדרת חלק.
  3. הקלדה מסננת את הרשימה. התצוגה המקדימה מציגה את הטקסט ואת משמעותו.
  4. Enter (או לחיצה) מוסיף אותו בשורה משלו.
  5. יש להקליד מעל השדה הנבחר (שם, טיפוס או ריבוי), ואז ללחוץ על Tab למעבר לשדה הבא. ⇧Tab / Shift+Tab חוזר אחורה. שדות טיפוס מציגים את ההגדרות של המודל: Enter (או בחירה עם ↑ ↓) לוקח אחת; Tab שומר את מה שהוקלד.
  6. Tab אחרי השדה האחרון, או Esc, יוצא מקטע הקוד. המבנה מוחל על המודל.

ההשלמה מציעה את אותם קטעי קוד: הקלדת par מציעה את מילת המפתח part ואת קטע הקוד חלק.

השלמת שמות ומילות מפתח

  1. יש להקליד שתי אותיות של שם או מילת מפתח, או :: או . אחרי שם. או ללחוץ על ⌃Space / Ctrl+Space. רשימה מציעה את מילות המפתח, השמות וקטעי הקוד שמתאימים במיקום הסמן.
  2. התנועה היא עם ↑ ו-↓ (PageUp ו-PageDown קופצים 8 שורות).
  3. Enter או Tab מקבלים, ו-Esc סוגר את הרשימה. רשימה שנפתחה בזמן ההקלדה נסגרת גם אחרי 4 שניות ללא מקש, כשהשם הושלם, כשאין התאמה, או כשמזיזים את הסמן או יוצאים מהעורך.

מעבר להגדרה ושינוי שם

  1. הצבעה על שם מציגה כרטיס עם הסוג, השם המלא והתיעוד שלו, וכל בעיה שיש בו. ⌘I / Ctrl+I מציג את אותו כרטיס מהמקלדת. הכרטיס נסגר כשעורכים, לוחצים על Esc, גוללים, יוצאים מהעורך או מזיזים את המצביע, והוא לעולם אינו מכסה את רשימת ההשלמה.
  2. לחיצה עם ⌘ / Ctrl על שם, או F12, עוברת להצהרה שלו. הצהרה בחבילה אחרת פותחת את אותה חבילה.
  3. כדי לשנות שם, יש למקם את הסמן על שם מוצהר וללחוץ על F2. יש להזין את השם חדש ולאשר. כל הפניה אליו משתנה, בכל החבילות, וביטול פעולה אחד מחזיר הכול לאחור. ההודעה הקופצת מציגה השם שונה ל-“name”.

חיפוש והחלפה

  1. יש ללחוץ על ⌘F / Ctrl+F או על חיפוש בכותרת הדף.
  2. יש להקליד את הטקסט לחיפוש. הסרגל מציג n מתוך m התאמות.
  3. לפי הצורך, יש להפעיל את Aa (התאמת רישיות), W (מילה שלמה) או .* (ביטוי רגולרי).
  4. Enter או ⌘G / Ctrl+G להתאמה הבאה, ⇧Enter / Shift+Enter או ⇧⌘G / Ctrl+Shift+G להתאמה הקודמת.
  5. יש ללחוץ על החלפה…, להקליד את הטקסט החלופי, ואז החלפה (ההתאמה הזו) או החלפת הכול.
  6. Esc או לחיצה על ✕ סוגרים את הסרגל.

תיקון שגיאות

  1. יש להסתכל בשורת המצב: היא סופרת את הבעיות, למשל 2 שגיאות, אזהרה אחת, או מציגה אין בעיות.
  2. F8 עובר לבעיה הבאה (⇧F8 / Shift+F8: לקודמת). או לחיצה על סימון בשוליים. הבעיה נבחרת וההודעה שלה מוצגת: קודם הבעיה, אחר כך התיקון.
  3. יש לתקן את הטקסט. כשהחבר מנותח בהצלחה, הוא מוחל.

עיון בעץ המודל

  1. יש לפתוח את מודל → דפדפן.
  2. יש ללחוץ על ▸ ליד חבילה כדי לפתוח אותה, או על הרחבת הכול.
  3. יש להקליד ב-סינון לפי שם, או לבחור סוג כמו part def ב-כל הסוגים. העץ מציג את ההתאמות עם הבעלים שלהן. הספירה מציגה n מתוך N אלמנטים.
  4. יש לבחור אלמנט כדי לראות את הפרטים שלו בחלונית המאפיינים.
  5. לחיצה כפולה עליו, או Enter, מציגה אותו בעורך.

מחיקה ושחזור של אלמנטים

  1. בדפדפן, יש לפתוח את תפריט השורה (⋯, לחיצה ימנית או Shift+F10) ולבחור מחיקה…. יש לאשר. האלמנט והחברים שלו עוברים לסל המחזור של הפרויקט. למחיקת הטקסט בעורך יש אותה השפעה.
  2. כדי להחזיר אותו, יש לפתוח את הכלי סל המחזור בתחתית סרגל הניווט וללחוץ על שחזור בשורה שלו. הוא חוזר עם אותה זהות, כך שההפניות אליו מזוהות שוב.

דוגמה מעשית: הוספת חיישן גלגל ל-Hybrid Car

הדוגמה הזו משתמשת בהדגמת Hybrid Car (SysML v2).

  1. יש לפתוח את מודל → עורך וללחוץ על Vehicles ברשימה חבילות.
  2. יש למצוא את part def Wheel :> Component. יש למקם את הסמן בשורה ריקה חדשה בתוך הגוף שלו, אחרי port hub : ~TorquePort;.
  3. יש ללחוץ על ⌃⇧Space / Ctrl+Shift+Space. הכותרת מציגה בתוך הגדרת חלק. יש להקליד att וללחוץ על Enter כדי להוסיף תכונה.
  4. יש להקליד speedSensorMass מעל שדה השם, ללחוץ על Tab, להקליד MassValue מעל שדה הטיפוס וללחוץ שוב על Tab כדי לצאת מקטע הקוד. השורה היא attribute speedSensorMass : MassValue; והיא מוחלת.
  5. יש להקליד = 0.2 [kg] לפני ה-; ולהפסיק להקליד. שורת המצב מציגה הוחל.
  6. יש לפתוח את מודל → דפדפן ולהקליד speedSensor ב-סינון לפי שם. התכונה מופיעה תחת Vehicles › Wheel; חלונית המאפיינים שלה מציגה בעלים Wheel ו-טיפוס MassValue.
  7. בחזרה בעורך, יש ללחוץ על F2 על speedSensorMass, להזין sensorMass ולאשר. הדפדפן מציג את השם החדש.
  8. יש למחוק את השורה ולהפסיק להקליד. התכונה עוברת לסל המחזור; שם אפשר לשחזר אותה עם שחזור.

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

  • השמירה אוטומטית. ⌘S / Ctrl+S רק מחיל את הטקסט עכשיו; אין שום דבר אחר לשמור.
  • שגיאה אחת אינה חוסמת את השאר. חברים לפני חבר שבור ואחריו עדיין מוחלים.
  • הקלדה במקביל לשותף. אם המודל השתנה בזמן ההקלדה, Holarch ממזג את הטקסט שלך עם המודל החדש. כששניכם שיניתם את אותו חבר, יש לבחור שמירת הגרסה שלי או לקיחת הגרסה שלהם.
  • שינוי שם בהקלדה מחדש. שינוי שם במקום גם שומר על האלמנט (Holarch מתאים אותו לפי מיקום וסוג), אבל הפניות במקומות אחרים עדיין משתמשות בשם הישן וכבר אינן מזוהות. כדי לשנות שם בכל מקום, יש להשתמש ב-F2.
  • מחיקת אלמנט שנמצא בשימוש. כשטקסט שנמחק מסיר אלמנט שאלמנטים או תצוגות אחרים משתמשים בו, Holarch שואל קודם. ביטול שומר אותו; הטקסט נשאר אז לא מוחל עד שלוחצים על ⌘S / Ctrl+S כדי להחליט שוב.
  • במגבלת הפריטים. כשהטקסט מוסיף אלמנטים שיעבירו את הפרויקט את מגבלת הפריטים של התוכנית, שום דבר מהשינוי אינו מוחל. הטקסט נשאר טיוטה ושורת המצב מציגה לא הוחל: הפרויקט יחרוג מהמגבלה של 1,000 פריטים. יש להסיר את ההצהרות החדשות או למחוק פריטים שאינם בשימוש. בפרויקט SysML v2, פריטים הם אלמנטי המודל שאינם קשרים: חבילות, הגדרות ושימושים (חלקים, תכונות, הפניות, יציאות, פעולות, מצבים, דרישות, …) נספרים; קשרים לא (ייבואים וחשיפות, חיבורים, ממשקים, זרימות, קשירות, רצפים, מעברים, הקצאות, satisfy ו-verify, תלויות, תת-סיווגים, קביעות טיפוס, תת-קבוצות, הגדרות מחדש). בהדגמת Hybrid Car יש 549 פריטים ובהדגמת Earth Observation Satellite יש 1,549, ולכן בתוכנית Free, פרויקט הדגמה חדש משבית את הרשומה Earth Observation Satellite עם "דורש את תוכנית Individual (1,549 פריטים)". ראו תוכניות ומגבלות.

העורך

פריסה

  • חבילות (מימין): רשומה אחת לכל חבילה ברמה העליונה, ועוד מחוץ לחבילות לפי הצורך. מספר אחרי החבילה הפתוחה סופר את השגיאות שלה. בפרויקט משותף, ראשי תיבות מראים מי עוד פתח חבילה.
  • כותרת הדף: + חבילה חדשה, הוספה ▾ וחיפוש.
  • אזור הטקסט: הדגשת תחביר, מספרי שורות ושוליים עם סימוני בעיות. לחיצה על מספר שורה בוחרת את השורה; לחיצה על סימון בוחרת את הבעיה ומציגה את ההודעה שלה.
  • שורת המצב (מתחת לטקסט): מיקום הסמן (Ln 12, Col 5), מספר הבעיות ומצב ההחלה.

צופים רואים את הטקסט לקריאה בלבד.

המבנים של הוספה ▾

קבוצהמבנים
מבנהחבילה, הגדרת חלק, חלק, תכונה, הגדרת תכונה, הגדרת יציאה, יציאה, ממשק, חיבור, הגדרת הקצאה, הקצאה, פריט, מנייה, שונות, גרסה, תצורה, בחירת גרסה
התנהגותהגדרת פעולה, פעולה, רצף, הגדרת מצב, מצב, מעבר, זרימה, פעולת Then, Perform, פיצול, החלטה, איחוד, מיזוג, קבלה, שליחה, השמה, If, לולאת While, לולאת For, פעולות מצב, מצב התחלתי, מעבר Accept, הגדרת מצב מקבילי, Exhibit State, הודעה
דרישותהגדרת דרישה, דרישה, ערך TBD, ערך TBR, הגדרת אימות, Satisfy, Verify, אילוץ, חישוב, נושא, שחקן, בעל עניין, הנחה, מקרה שימוש, מקרה ניתוח, חשש, נקודת מבט, תצוגה
אחרייבוא, כינוי, הערה, תיעוד

כל מבנה מוצע רק היכן שהוא תקף. ערך TBD וערך TBR דורשים private import HolarchMetadata::*; בחבילה (ראו סימון ערך כ-TBD או כ-TBR). גרסה מוצע רק בתוך וריאציה, שאינה מכילה דבר מלבד הגרסאות שלה. תצורה כותב שימוש המסומן ב-@HolarchConfiguration ודורש private import HolarchVariability::*;; בתוכו, בחירת גרסה בוחר את הגרסה של נקודת שונות אחת (ראו וריאציות, גרסאות ותצורות).

קיצורי מקלדת

ב-Windows וב-Linux, יש להשתמש ב-Ctrl במקום ⌘. / Ctrl+.

מקשיםפעולה
⌘S / Ctrl+S או ⌘↩ / Ctrl+Enterהחלת הטקסט עכשיו
⌘Z / Ctrl+Z / ⇧⌘Z / Ctrl+Shift+Zביטול / ביצוע חוזר (ב-Windows וב-Linux גם Ctrl+Y מבצע שוב)
⌃Space / Ctrl+Spaceהשלמה במיקום הסמן
⌃⇧Space / Ctrl+Shift+Spaceפתיחת הוספה ▾
Tab / ⇧Tab / Shift+Tabהזחה / ביטול הזחה; בקטע קוד, השדה הבא / הקודם
Esc, ואז Tabיציאה מהעורך (אחרת Tab מזיח)
⌘/ / Ctrl+/הוספה או הסרה של // בשורות שנבחרו
⌘F / Ctrl+Fחיפוש; ⌥⌘F / Ctrl+Alt+F פותח אותו עם החלפה
⌘G / Ctrl+G או F3 / ⇧⌘G / Ctrl+Shift+Gההתאמה הבאה / הקודמת
F8 / ⇧F8 / Shift+F8הבעיה הבאה / הקודמת
F12 או לחיצה עם ⌘ / Ctrlמעבר להצהרה
F2שינוי השם שבמיקום הסמן בכל מקום
⌘I / Ctrl+Iהצגת כרטיס המידע במיקום הסמן

הטקסט והתצוגות נשארים מסונכרנים

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

  • מטקסט למודל. הטקסט מוחל בכל נקודת commit, וביטול פעולה אחד מחזיר הכול לאחור. תצוגות, טבלאות ודפים מתעדכנים מיד.
  • ממודל לטקסט. שינוי בתצוגה, בדפדפן, בטבלה, בחלונית המאפיינים, בבקשת שינוי או בביטול פעולה נכתב לטקסט מיד. אם יש טקסט שלא הוחל באותה חבילה, Holarch ממזג אותו עם השינוי; ראו עבודה עם אחרים.
  • כל שינוי נבדק קודם. עריכה בתצוגה נכתבת כטקסט SysML ונבדקת לפני שהיא מוחלת. אם אי אפשר לכתוב אותה כטקסט תקין, היא נדחית: The change cannot be written as SysML text: … (אי אפשר לכתוב את השינוי כטקסט SysML). למשל, תנאי שמירה שאינו ביטוי תקין נדחה בתצוגת זרימת פעולות.
  • העיצוב שלך נשמר. אלמנטים שלא שונו שומרים על הטקסט המדויק שלהם, כולל הערות, שורות ריקות ואופן הכתיבה של מילות מפתח (כמו subsets לעומת :>). חלק ששונה באלמנט, או אלמנט חדש, נכתב בפריסה הסטנדרטית, מוזח כמו שכניו.
  • הפריסות נשמרות. מיקומים בתצוגות נשמרים לפי זהות האלמנט. עריכה או שינוי שם של אלמנט בטקסט שומרים על מקומו בכל תצוגה.

נתוני Holarch (מצב, תוצאות, תוויות, פריסות, הגדרות סימולטור) לעולם אינם נכתבים לטקסט. ראו נתוני מודל ונתוני Holarch.

עבודה עם אחרים

בפרויקט משותף, כמה אנשים יכולים לערוך את המודל בו-זמנית.

  • הרשימה חבילות מציגה את ראשי התיבות של אחרים שפתחו את הטקסט של חבילה. הצבעה עליהם מציגה את השמות.
  • כשהמודל משתנה בזמן ההקלדה, Holarch ממזג את הטקסט שלך שלא הוחל עם השינוי, חבר אחר חבר. מיזוג נקי מאפשר להמשיך להקליד.
  • כשמישהו אחר שינה את אותו חבר ששינית, באנר מציג <Package> השתנה בזמן ההקלדה. יש ללחוץ על שמירת הגרסה שלי כדי להחיל את הטקסט שלך על פני השינוי שלהם, או על לקיחת הגרסה שלהם כדי להחליף את הטקסט שלך בטקסט של המודל.
  • אם מישהו מוחק או מעביר את החבילה הפתוחה, באנר מציג החבילה הזו נמחקה או הועברה. הטקסט שלה נשאר כאן עד היציאה מהדף.

הדפדפן

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

כותרת הדף ומסננים

  • הרחבת הכול וכיווץ הכול פותחים או סוגרים כל אלמנט. הדפדפן זוכר מה פתוח בדפדפן האינטרנט הזה.
  • סינון לפי שם מתאים שמות ושמות קצרים.
  • כל הסוגים מגביל את העץ לסוג אחד, כמו part def, requirement או port. מוצגים רק סוגים שקיימים במודל. יחידים (מוצג כשיש במודל יחידים) מציג כל אלמנט שהוצהר individual, מכל סוג.
  • עם מסנן, העץ מציג את ההתאמות עם הבעלים שלהן, כולן פתוחות. הספירה מציגה n מתוך N אלמנטים.

שורות

כל שורה מציגה את הסוג של האלמנט, את השם שלו ואת השם הקצר שלו בסוגריים זוויתיים (<VR-1.1>). אלמנטים ללא שם מוצגים כ-(unnamed kind), למשל (unnamed succession), עם החריגים הבאים:

  • הצהרה שנעשתה עם מילת מפתח של המשתמש בלבד מציגה את מילת המפתח כסוג שלה, למשל #fault def עבור #fault def BatteryOverheat;.
  • הטריגר וההשפעה של מעבר הם חברים של המעבר. הם מוצגים כ-trigger וכ-effect, ונקראים לפי הטקסט שלהם, למשל trigger StartRequest.
  • פעולת סיום ללא שם מוצגת כ-terminate, או כ-terminate drive כשהיא מציינת מה היא מסיימת.
  • יחידים, צילומי מצב ופרוסות זמן מציגים את מילות המפתח שלהם עם הסוג, למשל individual part def, snapshot או timeslice part, אחרי סמל: טבעת ליחיד, נקודה על ציר זמן לצילום מצב, פס על ציר זמן לפרוסת זמן.

חלונית המאפיינים

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

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

עריכות נכתבות למודל, וביטול פעולה אחד מבטל כל אחת מהן. ראו תכונות Holarch.

תפריט השורה

פותחים אותו עם ⋯ בשורה, לחיצה ימנית, Shift+F10, מקש תפריט ההקשר או F2.

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

מקלדת

מקשיםפעולה
↑ / ↓השורה הקודמת / הבאה
Home / Endהשורה הראשונה / האחרונה
→פתיחת האלמנט, או מעבר לחבר הראשון שלו
←סגירת האלמנט, או מעבר לבעלים שלו
Enterהצגה בטקסט
F2, Shift+F10פתיחת תפריט השורה

אלמנטים שאינם מפורשים

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

אלמנטים שאיבדו מיקום

אלמנט שהבעלים שלו חסר, למשל אחרי ששותף מחק את החבילה שלו באותו רגע, מוצג תחת Misplaced (owner missing): move them into a package (איבדו מיקום, הבעלים חסר: יש להעביר אותם לחבילה). גם דף הבית מציג כרטיס אלמנטים שאיבדו מיקום. יש לפתוח את האלמנט בעורך ולהעביר את הטקסט שלו לחבילה.

אלמנטים שנמחקו

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

  • יש לפתוח את הכלי סל המחזור בתחתית סרגל הניווט. כל שורה מציגה את הסוג והשם של האלמנט, מתי נמחק, את הסיבה (נמחק עם 3 חברים) וכמה זמן הוא נשמר.
  • שחזור מחזיר אותו עם אותה זהות, כך שההפניות אליו מזוהות שוב. שחזור הכול משחזר כל רשומה.
  • ⋯ → תצוגה מקדימה מציג את הסוג, השם הקצר, התיעוד, החברים שלו ואת האלמנטים שעדיין מפנים אליו (מופנה על ידי).
  • ⋯ → מחיקה לצמיתות… מסיר רשומה אחת מיד. ריקון סל המחזור מסיר את כולן. את שתי הפעולות אפשר לבטל עם ⌘Z / Ctrl+Z.
  • רשומות מוסרות אוטומטית אחרי 30 יום.

כשטקסט שנמחק מסיר אלמנט שעדיין בשימוש, העורך שואל קודם: <n> הפניות ו-<m> תצוגות משתמשות ב-<name>. למחוק אותו?

נגישות

העורך והדפדפן פועלים עם המקלדת בלבד ועם קורא מסך.

  • העורך הוא תיבת טקסט בעלת תווית. Tab מזיח; כדי לצאת מהעורך, יש ללחוץ על Esc ואז על Tab.
  • F8 ו-Shift+F8 עוברים לבעיה הבאה ולקודמת ומקריאים אותה עם השורה שלה. בעיות מוכרזות גם כשנייה אחרי שהן משתנות.
  • F12 עובר להגדרה, F2 משנה שם, ⌘F / Ctrl+F מחפש, Ctrl+Space משלים ו-Ctrl+Shift+Space פותח את הוספה. ההשלמה והוספה הן רשימות שמכריזות על הרשומה הנבחרת. בקטע קוד, כל שדה מוכרז ("שדה 1 מתוך 3: שם").
  • הדפדפן הוא עץ. כל שורה מוקראת לפי השם והסוג שלה, כמו "Car, הגדרת חלק". מקשי החצים נעים בו; → פותח חבילה ו-← סוגר אותה. Shift+F10 פותח את תפריט השורה.

הודעות

הודעהמשמעות ותיקון
עדיין לא הוחלההקלדה בעיצומה; הטקסט מוחל כשמפסיקים.
הוחל / אין שינויים במודלהטקסט נמצא במודל / הטקסט כבר תאם את המודל.
לא הוחל: יש לתקן את שורה N.בחבר יש שגיאה. יש לתקן את שורה N; שאר הטקסט מוחל.
לא הוחל: המודל השתנה בזמן ההקלדה. יש לבחור «שמירת הגרסה שלי» או «לקיחת הגרסה שלהם».הטקסט שלך ושינוי אחר נוגעים באותו חבר.
לא הוחל: מחיקת <name> בוטלה. יש ללחוץ ⌘S / Ctrl+S כדי להחליט שוב.דחית מחיקה. יש לשחזר את הטקסט, או ללחוץ על ⌘S / Ctrl+S ולאשר.
בודק SysML נעצר. הטקסט שלך נשמר; הבודק הופעל מחדש.הבודק הופעל מחדש. אפשר להמשיך להקליד; הטקסט שלך בטוח.
הבדיקות מושהות: בודק SysML נעצר פעמיים. הטקסט שלך נשמר. יש לבחור «ניסיון חוזר» בהודעה, או לטעון מחדש את הדף.הבודק נעצר פעמיים ברציפות, בדרך כלל כי המודל גדול מדי עבורו, והוא מושהה. יש לבחור ניסיון חוזר בהודעה, או לטעון מחדש את הדף. ראו הבודק מושהה.
יש למקם את הסמן על שם כדי לשנות אותו.F2 נלחץ על מילת מפתח או על רווח ריק.
יש לתקן את השגיאות בטקסט הזה לפני שינוי השם.שינוי שם דורש טקסט שמנותח בהצלחה.
אי אפשר לשנות שם של אלמנטים מהספרייה. יש לשנות שם של אחד מהאלמנטים שלך.השם שייך לספרייה הסטנדרטית.
ההצהרה נמצאת בספרייה או בקובץ אחר ואי אפשר לפתוח אותה כאן.מעבר להגדרה מצא אלמנט של הספרייה הסטנדרטית. יש לחפש אותו בדף הספרייה הסטנדרטית.
לא נמצאה הצהרה של “name”.השם אינו מזוהה. יש לבדוק את האיות או את הייבואים שלו.
<Snippet> אינו מתאים כאן. יש להזיז את הסמן לשורה ריקה בגוף שמתיר אותו.המבנה אינו תקף במיקום הסמן.
אין קטעי קוד שמתאימים בתוך הערה או מחרוזת. יש להזיז את הסמן אל מחוץ להם.הוספה ▾ נפתח בתוך הערה או מחרוזת.
התבנית הזו אינה ביטוי רגולרי תקין. יש לתקן אותה, או לכבות את .*תבנית החיפוש אינה תקינה כש-.* מופעל.
אין עדיין חבילות במודל הזה. יש ליצור חבילה כדי להתחיל לכתוב SysML.יש ללחוץ על + חבילה חדשה.
אין אלמנט תואם. יש לשנות את המסנן.המסנן של הדפדפן אינו מתאים לשום דבר.
לא שוחזר: האלמנט כבר נמצא במודל.אלמנט עם אותה זהות כבר קיים.
צפייה בלבד: יש לבקש מבעלים הרשאת עריכה.יש לך הרשאת צפייה; הטקסט לקריאה בלבד.

ההודעות של הבודק על טקסט SysML עצמו מפורטות ב-הסימון הטקסטואלי של SysML v2.

מגבלות

  • מסמך טקסט אחד לכל חבילה ברמה העליונה; אין קבצים בתוך פרויקט.
  • מסמך גדול מ-8 MB, שורה ארוכה מ-64 KB או קינון עמוק מ-256 רמות אינם נבדקים.
  • שם שמגיע דרך יותר מ-512 ייבואים או התמחויות מקוננים (חבילה P2 שמייבאת את P1, שמייבאת את P0, וכן הלאה) נבדק רק בחלקו; רשימת הבעיות מציינת היכן. יש לקצר את השרשרת.
  • טיוטות קיימות רק בדפדפן שבו הוקלדו.
  • החיפוש מציג לכל היותר 10,000 התאמות (10,000+).
  • אלמנטים שנמחקו נשארים בסל המחזור 30 יום.
  • בודק SysML רץ בדפדפן. ב-Safari הוא מחזיק מודלים של עד כ-750,000 שורות טקסט SysML.

הבודק מושהה

מופיעה ההודעה המודל הזה גדול מדי עבור בודק SysML בדפדפן הזה. העריכה והדיאגרמות עדיין פועלות; הבדיקות מושהות. (או בודק SysML נעצר פעמיים על המודל הזה…) עם ניסיון חוזר.

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

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