מודל
מודל ומסד נתונים
ישויות, מחלקות, תכונות, קשרים ותוויות של LML, ותצוגת מסד הנתונים שמוצאת אותם, עורכת אותם, מקשרת ביניהם, מפיקה עליהם דוחות ומשחזרת אותם.
בדף זה
סקירה כללית
פרויקט LML שומר הכול במודל אחד, המבוסס על Lifecycle Modeling Language (LML 2.0), עם תמיכה במודלים של LML 1.x. דרישות, פונקציות, נכסים, ממשקים, בדיקות, סיכונים והחלטות הם כולם ישויות. דיאגרמות, מסמכים, מטריצות, מרשמים ותרשימים הם תצוגות של אותן ישויות. שינוי שנעשה בתצוגה אחת מופיע בכל התצוגות.
המסכים של Holarch קוראים לכל ישות פריט (למשל + פריט חדש, מחיקת הפריט… ותצוגת פריט); ישות הוא המונח של LML לאותו דבר, ו-⌘K / Ctrl+K מוצא פקודות לפי כל אחת מהמילים.
מסד הנתונים הוא התצוגה הישירה של המודל: טבלה של כל הישויות בפרויקט. משתמשים בו כדי למצוא, לערוך, לקשר, לדווח ולשחזר ישויות. יש בו שפת שאילתות, מסננים, שאילתות שמורות, עמודות הניתנות להגדרה, עריכה בתוך הטבלה, כלים לפעולות מרובות ודוחות. ישויות שנמחקו עוברות לסל המחזור של הפרויקט.
שתי תצוגות נוספות מציגות ישות אחת בכל פעם:
- תצוגת פריט מציגה הכול על ישות אחת.
- חלונית המאפיינים, בצד השמאלי של המעטפת, מציגה את הישות הנבחרת מכל דף.
הדף הזה עוסק במושגי המודל, במסד הנתונים, בתצוגת הפריט, בחלונית המאפיינים, בעורכי המאפיינים, בהיסטוריה, בתגובות ובנעילות. כדי לשנות את המחלקות, המאפיינים, היחסים והתוויות עצמם, ראו סכמה והרחבות.
מושגים
ישויות
ישות היא מופע אחד של מחלקה. לכל ישות יש:
- שם (עד 255 תווים) ומספר (עד 255 תווים, למשל
1.2.3). ישות זקוקה לפחות לאחד מהשניים. - מחלקה, שקובעת את המאפיינים שלה, את הקשרים שיכולים להיות לה ואת התוויות שהיא יכולה לשאת.
- תיאור, שדה טקסט עשיר (כותרות, רשימות, טבלאות, תמונות, קישורים).
- תוויות, תגים שמסווגים ישות בלי לשנות את המחלקה שלה.
- מאפיינים, השדות הייחודיים למחלקה (למשל Status של Requirement או משך של Action).
- תמונה אופציונלית, שמוצגת בחלונית המאפיינים ומשמשת בחלק מהדיאגרמות.
- מטא-נתונים:
- מזהה, למשל
e42, ייחודי בפרויקט. - תאריכי נוצר ושונה.
- דגל נעול.
- מזהה, למשל
כיתות
המחלקות יוצרות עץ. מחלקת צאצא יורשת את המאפיינים ואת יעדי הקשרים של ההורה שלה. שאילתה על מחלקה מוצאת גם את תת-המחלקות שלה. מחלקות LML העיקריות:
| סוג | שימוש עבור | קשרים אופייניים |
|---|---|---|
| פעולה | פונקציות, פעילויות ומשימות: מה שהמערכת עושה | decomposed by, performed by (Asset), generates ו-receives (Input/Output), satisfies (Requirement) |
| Asset | מערכות, תת-מערכות, אנשים וארגונים: מי או מה מבצעים פעולות | performs, connected by (Conduit), decomposed by |
| Resource (צאצא של Asset) | נכסים מתכלים או ניתנים להפקה, כמו מטען סוללה או אחסון נתונים | produced by, consumed by, seized by |
| Input/Output | נתונים, חומר או אנרגיה שעוברים בין פעולות | generated by, received by, transferred by |
| Conduit ו-Logical (צאצאים של Connection) | קישורים פיזיים בין נכסים (ממשקים); קשרים בין נכסים במודלי נתונים | connects to (Asset), transfers (Input/Output), decomposed by |
| הצהרה ו-דרישה | יעדים, הנחות והגדרות; הצהרות "The system shall…" | decomposed by, satisfied by, verified by, traced to |
| Artifact | מסמכים, מפרטים, חבילות בדיקות, מצגות | source of, decomposed by (מקטעים), originates (Requirement) |
| Heading | מקטע של מסמך מובנה (LML 2.0): מכיל פריטים מכל מחלקה | sourced by (Artifact), decomposed by (תת-מקטעים), contains (כל מחלקה) |
| Verification Requirement (צאצא של Statement) | מה יש להראות, ואיך, לפני שדרישה נחשבת כמתקיימת (LML 2.0) | verifies (Requirement, Asset), traced to (Test Case) |
| Test Case (צאצא של Action) | פעילויות אימות | verifies (Requirement), evaluates (Asset), decomposed by (שלבים) |
| Task ו-Transition (צאצאים של Action) | משימות פרויקט; מעברי מצב | decomposed by, occurs |
| Risk | דברים שעלולים להשתבש | caused by, mitigated by, resolves |
| Characteristic ו-Measure (צאצא של Characteristic) | פרמטרים, מדדי יעילות, TPMs; Value, Units, Formatted Equation, Computed Value | specifies |
| Cost, Time, Location (Orbital, Physical, Virtual), Decision, Issue, Equation | נתוני עלות, אבני דרך, מקומות, החלטות, סוגיות, משוואות | incurred by, occurred by, located at, alternative, … |
שני סוגי מחלקות אינם מופיעים בכל מקום:
- מחלקות שמסומנות מופשטת (למשל Location ו-Connection) מקבצות תת-מחלקות. אי אפשר ליצור אותן ישירות.
- מחלקות שמסומנות מוסתר (למשל Port, שדיאגרמות בלוקים יוצרות) אינן מוצעות בבוררי המחלקות.
נושא העזרה באפליקציה מחלקות LML (סכמה) מפרט את הקבוצה המלאה והעדכנית.
סכמת ברירת המחדל של Holarch מבוססת על מפרט LML 2.0 ושומרת כל מחלקה, קשר ומאפיין שמודלים של LML 1.x משתמשים בהם. התוספות של LML 2.0 כוללות את המחלקה Verification Requirement; את evaluates (Test Case → Asset); את Event Conditions ו-Event Constraints ב-Test Case; את Planned Start ועדיפות ב-Task; את Mitigation Status ומגמה ב-Risk; את Open ו-Closed ב-Status של Decision; את סוף ב-Time (אם נשאר ריק, הוא נגזר מ-Start ומ-Duration); את יחידות ב-Physical (היחידה של Altitude); את decomposed by ב-Logical; את transfers בכל Connection; את Formatted Equation האופציונלי (Equation: טקסט LaTeX) ואת Computed Value (Computable: נוסחה על מאפיינים אחרים, שמחושבת מחדש כשהם משתנים) ב-Characteristic וב-Measure; ולמסמכים מובנים, את המחלקה Heading עם contains / contained by ו-originates / originated by (Artifact → Requirement: המקור המוסמך שממנו דרישה הגיעה). פרויקט שנוצר לפני התוספות האלה שומר על הסכמה שלו; סכמה → הוספת הרכיבים המובנים החדשים… מוסיף אותן.
מאפיינים
מאפיינים הם שדות עם סוג שמוגדרים לכל מחלקה. הסוג קובע את העורך ואת האופן שבו ערכים מחופשים, ממוינים, נצברים ומיוצאים. לכל סוג, ראו סוגי מאפיינים ועורכים.
גם לקשרים יכולים להיות מאפיינים. לדוגמה, ל-decomposed by יש ריבוי, ל-performed by יש Amount ול-receives יש טריגר.
קשרים
קשר מחבר שתי ישויות עם יחס בעל שם. לכל יחס יש הפכי: "Capture Image Strip performed by Payload Camera" הוא אותו קישור כמו "Payload Camera performs Capture Image Strip". Holarch שומר את הקישור פעם אחת ומציג אותו משני הקצוות.
קשר נקרא כמשפט מהמקור אל היעד. ההפכי קורא את אותו קישור מהקצה השני. בחלונית המאפיינים, כל ישות מציגה את הקישורים שלה תחת השם שנקרא מאותה ישות.
הסכמה קובעת אילו מחלקות כל יחס יכול לחבר. Holarch מציע רק יחסים מותרים ודוחה אחרים, כך שהמודל נשאר תקף. הוספה של אותו קשר פעמיים אינה משפיעה.
הקשרים מתחלקים לכמה משפחות:
- עקיבות: traced to, satisfied by, verified by, derived by, refined by ו-copied by מתחילים ב-Statement או ב-Requirement. traced to הוא הכללי: היעד עונה להצהרה, בלי לומר איך. כשהסוגים הספציפיים מתאימים, כדאי להשתמש בהם. ראו קשרי עקיבות.
- מבנה: decomposed by, related to, specified by ו-instantiates בונים היררכיות ומתארים ישויות.
- התנהגות וארכיטקטורה: performed by, generates, receives, connected by ו-transferred by קושרים יחד פונקציות, נכסים, פריטים וממשקים.
- סיכון, החלטות, עלות וזמן: caused by, mitigated by, alternative, incurred by, occurs ואחרים.
מדריך הקשרים מפרט כל זוג עם המחלקות שהוא מחבר, המשמעות שלו ודוגמה. נושא העזרה באפליקציה קשרי LML (סכמה) מפרט את הקבוצה העדכנית של הפרויקט.
decomposed by / decomposes בונה כל היררכיה. מספור אוטומטי, תוכני עניינים של מסמכים, דיאגרמות היררכיה ועץ, צבירות והצאצאים של דיאגרמות פעולה כולם עוקבים אחריו.
תוויות
תוויות מתייגות ישויות בלי לשנות את המחלקה שלהן. דוגמאות: Requirement עם התווית Functional Requirement או Performance Requirement, Statement עם התווית הנחה, Artifact עם התווית חבילת בדיקות.
תוויות יכולות להיות מקוננות (תווית הורה עם תוויות צאצא) ואפשר להגביל אותן למחלקות מסוימות. נושא העזרה באפליקציה תוויות (סכמה) מפרט כל תווית.
נעילות, היסטוריה ותגובות
- ישות נעולה דוחה עריכות, מחיקה, שינויי מחלקה וקשרים חדשים או מוסרים עד שמישהו מבטל את הנעילה. תגובות עדיין מותרות.
- כל שינוי נרשם בהיסטוריה של הישות, עם התאריך, ובשירות המתארח גם עם האדם שביצע אותו. אפשר לשחזר כל גרסה קודמת.
- תגובות מצרפות הערות סקירה לישות. אפשר לערוך, לפתור, לפתוח מחדש ולמחוק אותן.
איך להשתמש בה
מתי ולמה
המודל הוא מקור האמת היחיד לכל מחזור החיים של הנדסת המערכות. משתמשים במסד הנתונים כדי לעבוד על המודל ישירות, בלי לעבור דרך דיאגרמה או מסמך:
- בזמן הגדרת הדרישות: הצגת דרישות, בדיקת ה-Status שלהן, ומציאת דרישות ללא הורה, מקור או אימות.
- בזמן ניתוח פונקציונלי וארכיטקטורה: מציאת פונקציות ללא מבצע, נכסים ללא ממשקים, וישויות עלה שעדיין צריך לפרק.
- לפני סקירה: מציאת תגובות פתוחות, דרישות שלא אומתו ויתומות (ישויות ללא קשרים). ייצוא טבלה או דוח הגדרות.
- לשינויים מרובים: שינוי תוויות, מספור מחדש, הגדרת מאפיין או יצירת קשרים לישויות רבות בבת אחת.
הוא עונה על שאלות כמו "אילו דרישות עדיין במצב In Review?", "אילו פונקציות לא הוקצו לנכס?" ו-"מה אמרה הדרישה הזו בחודש שעבר?".
מציאת ישויות עם שאילתה
מצמצמים את הטבלה עם שבבי מסנן בשורת השאילתה, ואז מחדדים אותה עם טקסט חיפוש.
- יש ללחוץ על מסד הנתונים בתחתית סרגל הניווט.
- יש ללחוץ על + מסנן בתחילת שורת השאילתה.
נפתחת רשימה עם הקבוצות מבנה, מחלקה, תווית, קשר, דיאגרמה ושילוב, עם ספירות. אפשר להקליד כדי לצמצם אותה, למשל
requ. - יש לבחור Requirement תחת מחלקה (ללחוץ עליה, או לעבור אליה עם ↓ ולהקיש Enter).
השבב מחלקה: Requirement מופיע והטבלה מציגה דרישות בלבד. הרשימה נשארת פתוחה, ומופיעה הקבוצה מאפייני הדרישה.
- יש לבחור Status תחת מאפייני הדרישה.
- יש לבחור = שווה ל, ואז In Review, וללחוץ על הוספת מסנן.
השבב Requirement: Status = In Review מופיע והטבלה מצטמצמת.
- יש להקליד מילת מפתח בתיבת החיפוש שאחרי השבבים, למשל
power.הטבלה מסתננת תוך כדי הקלדה. החיפוש מכסה שם, מספר ותיאור.
החיפוש עובד בכל שפה ומתעלם מרישיות ומרוחב תווים:
mullerמוצא את "Müller",strasseמוצא את "Straße" ו-absמוצא את "ABS" ברוחב מלא. סימני ניקוד (accents) נספרים רק כשמקלידים אותם:elementמוצא את "Élément" ואת "Element",élémentמוצא רק את "Élément". סימני קול יפניים (ガ, カ) והברות קוריאניות נשמרים. המיון לפי שם עוקב אחר שפת הדפדפן שלך, כך ש-"Ölpumpe" ממוין עם O, לא אחרי Z. - כדי לשנות את המיון, יש ללחוץ על כותרת עמודה. לחיצה נוספת הופכת את הסדר.
אפשר גם להקליד את כל השאילתה ולהקיש Enter, למשל class:Requirement Requirement:"Status=In Review" power. מונחי מסנן בהתחלה הופכים לשבבים, והשאר נשאר בתיבת החיפוש. ראו תחביר השאילתה. כדי להתחיל משאלה מוכנה, יש ללחוץ על תצוגה בחלונית תצוגות, למשל דרישות ללא בדיקה מאמתת.
יצירה ועריכה של ישויות
- יש ללחוץ על + פריט חדש בכותרת הדף.
תיבת הדו-שיח יצירת פריט נפתחת עם מחלקה, שם, מספר ותיאור, והסמן נמצא בשם. יצירה עם שם ריק מציג "יש להזין שם." מתחת לשדה; Enter בשם יוצר את הישות.
כשבשאילתה יש בדיוק שבב מחלקה אחד, כמו בדפים דרישות, נכסים, החלטות ופריטים וקלט/פלט, הלחצן נקרא על שם המחלקה (+ דרישה חדשה, + נכס חדש) ולתיבת הדו-שיח שלו, שכותרתה על שם המחלקה, אין שדה מחלקה. בפרויקט SysML v2 השמות הם מילים של SysML v2 (+ חלק חדש בארכיטקטורה → חלקים), מספר נקרא שם מקוצר, ולחלקים חדשים אין שדה שם מקוצר. בתיבת הדו-שיח של חלק או פעולה יש חלק מ: הגדרת החלק שמכילה אותו, שמוגדרת מראש למערכת הנדונה. ההודעה אחרי יצירה מציינת לאן הוא נכנס, למשל "נוצר Roof Rack ב-Vehicles::Vehicle". + פריט חדש בפריטים וקלט/פלט כבוי: מוסיפים פריטים בעורך או בתצוגה.
הדפים האלה של מחלקה אחת שומרים גם על עמודות משלהם, בנפרד מאלה של מסד הנתונים. הם מתחילים בלי העמודה מחלקה: דרישות מציג מספר, שם, Status, Verification Method, ציון איכות, תיאור ותוויות; החלטות מציג מספר, שם, Status, תיאור ותוויות; נכסים ופריטים וקלט/פלט מציגים מספר, שם, תיאור, תוויות ושונה. חלקים מציג שם, סוג, בעלים, ריבוי, תיאור ותוויות, ובנוסף מופעים במודל עם מופעים פרטניים (individuals). עמודות ▾ → עמודות ברירת מחדל מחזיר לקבוצה הזו.
- יש למלא את השדות וללחוץ על יצירה.
הישות החדשה נבחרת ונפתחת בחלונית המאפיינים.
- את מספר, שם, תיאור והתוויות עורכים בקבוצה הראשונה של חלונית המאפיינים (דרישה או הגדרה), ואת השדות של המחלקה בקבוצות שמתחתיה.
- כדי לערוך בטבלה במקום זאת, יש ללחוץ לחיצה כפולה על תא מספר, תיאור או מאפיין, או להקיש F2 על שם. Enter שומר ו-Esc מבטל. כדי לשנות תאים רבים בבת אחת, אפשר להדביק מגיליון אלקטרוני או למלא כלפי מטה (ראו עריכה כמו בגיליון אלקטרוני).
- כדי לראות הכול על הישות, יש ללחוץ לחיצה כפולה על השורה שלה מחוץ לתאים הניתנים לעריכה.
תצוגת פריט נפתחת.
דרישות חדשות מתחילות עם Status שמוגדר ל-טיוטה. מאפיינים עם ערך ברירת מחדל בסכמה מתחילים עם ברירת המחדל הזו.
קישור ישויות
יש ארבע דרכים להוסיף קשר. כדאי לבחור את זו שמתאימה למשימה.
קשר אחד, מחלונית המאפיינים או מתצוגת הפריט:
- יש לבחור את הישות ולעבור למקטע עקיבות.
- יש למצוא את היחס. אם הוא אינו מופיע, יש לבחור הצגת כל הקשרים כדי לראות כל יחס שהמחלקה תומכת בו.
- יש ללחוץ על + ביחס ולבחור קישור פריט קיים… או <class> חדש….
מהטבלה: יש להוסיף עמודת קשר (ראו עמודות), ואז ללחוץ על + בתא.
רבים בבת אחת:
- יש לסמן את השורות.
- יש ללחוץ על קשרים… בסרגל הפעולות המרובות.
- יש לסמן יחס אחד או יותר ויעד אחד או יותר.
- יש ללחוץ על החלה.
עריכה של ישויות רבות בבת אחת
- יש לסמן את השורות לשינוי. כדי לסמן טווח, יש ללחוץ Shift+לחיצה על תיבת סימון שנייה.
סרגל הפעולות המרובות מופיע ומציג N נבחרו.
- יש לבחור פעולה בסרגל הפעולות המרובות. ראו את הרשימה שלהלן.
- כדי לבטל את כל הפעולה, יש להקיש ⌘Z / Ctrl+Z (או Ctrl+Z). אפשר לבטל כל פעולה מרובה בביטול פעולה אחד.
הפעולות בסרגל הפעולות המרובות, בסדר זרימת העבודה:
- ✦ AI ▾ מציע את פעולות ה-AI לשורות המסומנות.
- קשרים… מוסיף או מסיר קשרים; פתיחה במטריצה מציג את השורות המסומנות במטריצת העקיבות.
- מאפיינים… מגדיר מאפיין אחד, או מוסיף קידומת לשם או למספר.
- תווית ▾ מוסיף או מסיר תווית בכל הישויות המסומנות.
- שינוי מחלקה… משנה את המחלקה.
- עוד ▾ מציע פתיחה, שכפול, נעילה / ביטול נעילה, חיפוש והחלפה…, צבירה…, מספור מחדש של הצאצאים…, העתקה עם צאצאים…, היסטוריה…, הוספה למסמך… וייצוא….
לכל פקד, ראו סרגל הפעולות המרובות.
שמירת תצוגה ושימוש חוזר בה
- יש להגדיר את המסננים, טקסט החיפוש, המיון, העמודות ועץ.
- בחלונית תצוגות, יש ללחוץ על שמירת תצוגה….
- יש להזין שם.
- כדי לשתף אותה, יש לסמן את שיתוף עם הפרויקט:
- מסומן: התצוגה נשמרת בפרויקט, לכל מי שפותח אותו (👥).
- לא מסומן: התצוגה נשארת בדפדפן הזה, בכל פרויקט שנפתח בו (👤).
- יש ללחוץ על שמירה.
כדי להחיל תצוגה, יש ללחוץ על השם שלה. היא משחזרת את השאילתה, השבבים, העמודות ועץ. התצוגה שתואמת לשאילתה הנוכחית מודגשת.
כדי לשנות תצוגה שמורה מאוחר יותר, יש להגדיר את הטבלה ולבחור ⋯ → שמירת התצוגה הנוכחית כאן בתצוגה. ⋯ → שיתוף עם הפרויקט משתף תצוגה אישית או הופך תצוגה משותפת לאישית שוב.
תרשים לוח שנה יכול להציג את האירועים של תצוגה משותפת. עריכת השאילתה במסד הנתונים שלו פותח את מסד הנתונים עם התצוגה הזו ועם לחצן עדכון "<name>" בשורת השאילתה: יש לשנות את השאילתה, ואז ללחוץ עליו כדי לשמור את השינוי בתצוגה המשותפת. כל לוח שנה וטבלת שקופית שמשתמשים בה עוקבים אחריה.
הפקת דוח
- יש לצמצם את הטבלה עם שאילתה, או לסמן שורות מסוימות.
- יש ללחוץ על ייצוא… בכותרת הדף (או על עוד ▾ → ייצוא… בסרגל הפעולות המרובות).
ייצוא נפתח.
- יש לבחור מה לייצא בייצוא בתור ולהגדיר את האפשרויות שלו.
- יש לבדוק את שם הקובץ.
- יש ללחוץ על ייצוא.
הקובץ יורד.
דוגמה מעובדת: CubeSat EO-1
יש ליצור את ההדגמה עם ניהול פרויקטים → קובצי פרויקט ▾ → פרויקט הדגמה חדש. היא מכילה:
- מפרט דרישות המערכת של EO-1 (SRS-001).
- פירוק החללית: 1 EO-1 Spacecraft עם 1.1 Payload Camera, 1.2 ADCS, 1.3 EPS וכן הלאה.
- זרימת פעולות הצילום, מ-OPS.1 Transmit Imaging Plan עד OPS.12 Process Image Products.
- מקרי בדיקה כמו TC-01 Ground Sample Distance Test.
מציאת הדרישות שממתינות לאישור:
- יש ללחוץ על מסד הנתונים.
- יש ללחוץ על + מסנן, לבחור Requirement תחת מחלקה, ואז Status תחת מאפייני הדרישה.
- יש לבחור = שווה ל ו-In Review, וללחוץ על הוספת מסנן.
הרשימה כוללת את 1.5 Daily Collection Volume, 1.6 Revisit Time ו-3.4 Bus Regulation. הדף אישורים משתמש באותה שאילתה (
Requirement:"Status=In Review").
מציאת דרישות שלא אומתו:
- בחלונית תצוגות, יש ללחוץ על דרישות ללא בדיקה מאמתת.
השבב מחלקה: Requirement מופיע, ו-
NOT relationship:"verified by"נשאר בתיבת החיפוש. הטבלה מציגה דרישות שאף Test Case עדיין אינו מאמת. הקלדתclass:Requirement AND NOT relationship:"verified by"והקשה על Enter נותנות את אותה תוצאה.
הצגה של מי שמספק כל דרישה:
- יש ללחוץ על עמודות ▾.
- תחת קשרים, יש לסמן את satisfied by, ואז להקיש Esc.
השורה של 3.4 Bus Regulation מציגה את 1.3.3 Power Distribution Unit. לחיצה על + בתא ריק מוסיפה ישות מספקת.
- כדי להציג גם את מי שמבצע את הישויות האלה, יש לפתוח את ▾ של העמודה satisfied by Entity, לבחור עמודה קשורה…, לבחור performed by וללחוץ על הוספה.
בחינת דרישה אחת:
- יש ללחוץ על השורה של 2.1 Pointing Accuracy.
חלונית המאפיינים מציגה אותה. במקטע דיון שלה יש הערת הסקירה על TC-04.
- יש להסתכל במקטע עקיבות.
verified by מציג את מקרה הבדיקה שלה, ו-satisfied by מציג את 1.2 ADCS.
שמירת העבודה ודיווח עליה:
- כש-דרישות ללא בדיקה מאמתת מוחלת, יש ללחוץ על שמירת תצוגה… בחלונית תצוגות.
- יש לקרוא לה
Unverified requirements, לסמן את שיתוף עם הפרויקט, וללחוץ על שמירה.לכל מי שבפרויקט יש עכשיו את התצוגה.
- יש ללחוץ על ייצוא… ולבחור טבלה (Excel).
- יש להשאיר את הקפאת שורת הכותרת מסומן וללחוץ על ייצוא.
הגיליון משתמש בעמודות שהוספת.
עצות ושיטות עבודה טובות
- להתחיל רחב, ואז לצמצם. כדאי להוסיף קודם שבב מחלקה. + מסנן מציג אז רק תוויות שתקפות עבורה, ואת המאפיינים שלה.
- להשתמש בעץ כדי לקרוא פירוק כעץ. ישויות שההורה שלהן ברשימה מופיעות תחתיו.
- להתחיל מתצוגה מובנית כמו קישורים לבדיקה או ממצאי בדיקת המודל לפני סקירה, ואז לצמצם אותה עם שבבים.
- לשמור את התצוגות שמשתמשים בהן כל שבוע ולשתף אותן עם הפרויקט, כך שהצוות עובד מאותן רשימות.
- למספר עם מספור מחדש של הצאצאים… בשורש של פירוק במקום להקליד מספרים ידנית. עבור Actions, סדר זרימת הפעולה עוקב אחר דיאגרמת הפעולה.
- לנעול את מה שאושר. כדאי לנעול דרישות או ממשקים שבקו בסיס, כך שעריכות בטעות יידחו.
- לפתור תגובות במקום למחוק אותן, כך שרשומת הסקירה תישמר.
טעויות נפוצות
- "אין ישויות שתואמות לחיפוש או למסננים. יש לנקות אותם כדי לראות את כל הישויות." שבב מחיפוש קודם עדיין פעיל. יש להסיר אותו עם ה-× שלו, או ללחוץ על ניקוי בשורת השאילתה.
- יחס חסר ברשימה. או שליחס עדיין אין קישורים, או שהסכמה אינה מתירה אותו למחלקה. יש לבחור הצגת כל הקשרים במקטע עקיבות. אם היחס אמור להיות מותר, יש להוסיף יעד בעורך הסכמה.
- עריכה נדחית עם "אי אפשר לשנות ישויות נעולות. יש לבטל את הנעילה שלהן קודם." הישות נעולה. בקשר, הישות שבכל אחד מהקצוות עשויה להיות נעולה. יש לבטל את הנעילה עם לחצן הנעילה.
- שינוי המחלקה מסיר נתונים. שינוי מחלקה מסיר קשרים, תוויות, ערכי מאפיינים ודיאגרמות שהמחלקה החדשה אינה יכולה לכלול. תיבת הדו-שיח מפרטת מה נמחק בשמירה: כדאי לקרוא אותה לפני הלחיצה על שינוי מחלקה. ביטול פעולה משחזר הכול.
- ישות שנמחקה נעלמה מהטבלה. יש לפתוח את סל המחזור של הפרויקט (כלי הסרגל) וללחוץ על שחזור. היא חוזרת עם אותו מזהה ועם הקשרים שלה לישויות שעדיין קיימות.
כיצד זה מתחבר לתכונות אחרות
- מזין את הכול: דיאגרמות, מסמכים, מטריצת העקיבות, RVTM, בדיקות המודל, הסימולטור וכל המרשמים קוראים את אותן ישויות. ראו עקיבות ודרישות.
- דפים מוגדרים מראש: דרישות, אישורים, נכסים, פריטים וקלט/פלט והחלטות בסרגל הניווט הם מסד הנתונים עם שאילתה מוגדרת מראש.
- מטריצה: פתיחה במטריצה בכותרת הדף פותח את השאילתה הנוכחית במטריצת העקיבות. פתיחה במטריצה בסרגל הפעולות המרובות פותח אותה עם השורות המסומנות.
- מסמכים: הוספה למסמך… מקשר את הישויות המסומנות ל-Artifact של מסמך. ראו מסמכים.
- ייבוא וייצוא: ייבוא CSV, Excel, Word ו-ReqIF יוצר ישויות שמופיעות כאן, והדוחות מייצאים אותן. ראו ייבוא וייצוא.
- סכמה: מחלקות, מאפיינים, יחסים ותוויות מגיעים מהסכמה של הפרויקט. ראו סכמה והרחבות.
תצוגת מסד הנתונים
מסד הנתונים מציג כל ישות בפרויקט, עם כלים לסינון, לעריכה, לקישור ולדיווח עליהן. פותחים אותו ממסד הנתונים בתחתית סרגל הניווט. בדף יש את החלונית תצוגות מימין, את שורת השאילתה ואת הטבלה באמצע, ואת חלונית המאפיינים משמאל.
הכתובת יכולה לשאת ?q=<query>, ?class=<id>, ?label=<id> ו-?focus=<entity id> (בוחר את השורה הזו וגולל אליה). מספר class או label מהמספור הקודם של פריטים מובנים נכתב מחדש למזהה הנוכחי.
כותרת הדף
| פקד | מה הוא עושה |
|---|---|
| ייצוא… | פותח את ייצוא עבור השורות המסומנות, או עבור השאילתה הנוכחית כשאף שורה אינה מסומנת. |
| פתיחה במטריצה | פותח את מטריצת העקיבות עם השאילתה הנוכחית על הציר שלה. |
| + פריט חדש | פותח את יצירת פריט. נקרא על שם המחלקה כשהשאילתה קובעת אחת, כמו + דרישה חדשה. |
| ✦ AI ▾ (בסרגל העליון) | פעולות ה-AI עבור הישות שמוצגת בחלונית המאפיינים, ו-יצירת דרישות…. |
שורת השאילתה
| פקד | מה הוא עושה |
|---|---|
| + מסנן | פותח את רשימת המסננים. ראו מסננים. |
| שבבים | שבב אחד לכל מסנן, בסדר של השאילתה: מחלקה: …, מסנני מאפיינים כמו Requirement: Status = In Review, תווית: …, מסנני מבנה כמו ללא הורה, דיאגרמה: …, קשר: … ומסננים או טקסט חיפוש. שבבים מאותו סוג מחוברים ב-או. לכל שבב יש × להסרתו. לחיצה על שבב מאפיין מאפשרת לשנות או להסיר אותו. |
| שבב מיון | מציג את המיון, למשל מיון: הכי הרבה קשרים ↓, כשאף כותרת עמודה גלויה אינה מציגה אותו. לחיצה עליו הופכת את הסדר; × חוזר למיון ברירת המחדל (לפי מספר). |
| תיבת חיפוש | טקסט חופשי או תחביר שאילתה. מסנן תוך כדי הקלדה (אחרי השהיה קצרה). Enter הופך מונחי מסנן מובילים לשבבים. Backspace בתיבה ריקה מסיר את השבב האחרון; Esc מנקה את טקסט החיפוש. |
| ניקוי | מסיר את טקסט החיפוש ואת כל המסננים. המיון נשאר. |
| ? | פותח את תחביר החיפוש, טבלה של דוגמאות שאילתה. |
| עץ | מציג צאצאים תחת ההורים שלהם (ראו עץ). לחוץ כשהוא פעיל. |
| פריטי ספרייה | מוצג כשהפרויקט מציג פריטים של ספרייה. מציג גם את הפריטים האלה לקריאה בלבד (ראו ספריות). לחוץ כשהוא פעיל. |
| עמודות ▾ | פותח את רשימת העמודות. ראו עמודות. |
חלונית התצוגות
| פריט | מה הוא עושה |
|---|---|
| כל הישויות | כל ישות, ממוינת לפי מספר. |
| שונו לאחרונה | ממוין לפי זמן השינוי, החדש ביותר קודם (order:modified-). |
| המקושרים ביותר | ממוין לפי מספר הקשרים, הרבים ביותר קודם (order:related-). |
| דרישות ללא בדיקה מאמתת | class:"Requirement" NOT relationship:"verified by". |
| קישורים לבדיקה | ישויות עם קישור לבדיקה: פריט במעלה הזרם השתנה מאז שהקישור נבדק (is:suspect). |
| TBD/TBR פתוחים | דרישות עם TBD או TBR פתוח (is:tbd). |
| ממצאי בדיקת המודל | ישויות עם ממצא של בדיקות המודל (is:finding). |
| תגובות שלא נפתרו | is:commented. |
| נעול | is:locked. |
| שמורות | התצוגות השמורות שלך: המשותפות (👥) קודם, ואחריהן שלך (👤). שמירת תצוגה… שומר את הנוכחית. לכל אחת יש ⋯ (ראו תצוגות שמורות). |
| ‹ (כותרת החלונית) | מסתיר את חלונית התצוגות. רצועה דקה › בקצה הימני מציגה אותה שוב. |
| ⋯ (כותרת החלונית) | איפוס עמודות, מיון ועץ (עמודות ורוחבים ברירת מחדל, ממוין לפי מספר, ללא עץ) ותחביר החיפוש. |
לחיצה על תצוגה מחילה את השאילתה שלה ממיון ברירת המחדל; תצוגה שמורה משחזרת גם את העמודות ואת העץ שלה. התצוגה שתואמת לשאילתה הנוכחית מודגשת (גם כשמקלידים את השאילתה שלה).
כדי לשנות את רוחב החלונית, יש לגרור את הקצה השמאלי שלה (מ-160 px עד 40 % מהחלון), או להתמקד בקצה ולהקיש על מקשי החצים שמאלה וימינה. לחיצה כפולה על הקצה מאפסת את הרוחב. הרוחב והאם החלונית מוסתרת נשמרים בדפדפן הזה, לכל פרויקט. בחלונות ברוחב 760 px ומטה, החלונית נפתחת במקום זאת מלחצן קצה.
תצוגות שמורות
- שמירת תצוגה… פותח את שמירת תצוגה עם שם ושיתוף עם הפרויקט. הוא שומר את השאילתה המלאה, השבבים, העמודות והעץ.
- תצוגה משותפת נשמרת בפרויקט (ניתן לביטול) ומשותפת עם כל מי שיכול לפתוח אותו. תצוגות אחרות נשמרות בדפדפן הזה וזמינות בכל פרויקט שנפתח בו.
- ⋯ בתצוגה: שינוי שם…, שמירת התצוגה הנוכחית כאן (מחליף את השאילתה, העמודות והעץ שלה בנוכחיים), שיתוף עם הפרויקט (מסומן כשהיא משותפת; בחירה בו מחליפה מצב), הזזה למעלה, הזזה למטה ומחיקה.
- גרירת תצוגה מסדרת אותה מחדש בין התצוגות עם אותו שיתוף.
טבלה
- עמודות: ברירות המחדל הן מספר, שם, מחלקה, תיאור, תוויות ושונה. משנים אותן מהכותרות ומעמודות ▾ (ראו עמודות).
- גלילה: הטבלה גוללת דרך כל השורות; אין עמודים. כשיש יותר מ-200 שורות, משורטטות רק השורות שליד מיקום הגלילה, כך שפרויקטים גדולים נשארים מהירים. מיקום הגלילה נשמר לביקור הבא עם אותו פרויקט ואותה שאילתה. הסרגל שמתחת לטבלה מציג את מספר הישויות (ובעץ, את השורות המוצגות).
- תאריכים ומספרים בתאי מאפיינים עוקבים אחר השפה והאזור של הדפדפן שלך (גרמנית: 29.10.2026, 14:05 ו-1234,5); תאריך בחצות מוצג כתאריך בלבד. מספרים מקבלים את סימן העשרוני המקומי אבל ללא מפרידי אלפים, כי מספרי חלקים וקודים הם לעתים קרובות מספרים. עריכת תא מציגה את הערך השמור.
- שורות עוקבות אחר צפיפות השורות בהעדפות (נוחה או דחוסה). תיאורים מציגים שתי שורות; כדי להציג את כולם, יש לסמן את הצגת תיאורים מלאים בעמודות ▾.
- תא השם: מקשר לתצוגת הפריט. הוא מציג גם סימנים:
- 🔒 לישות נעולה.
- סימן סקירה (⚠) לדרישה עם קישורים לבדיקה.
- 💬 כשלישות יש תגובות שלא נפתרו.
- לחיצה על שורה בוחרת אותה ומציגה אותה בחלונית המאפיינים. לחיצה כפולה על שורה פותחת את תצוגת הפריט. כששורה בפוקוס, ↑ ו-↓ עוברים לשורה הקודמת או הבאה, Home ו-End לראשונה או לאחרונה, ו-Enter מציג אותה בחלונית המאפיינים.
- לחיצה כפולה על תא מספר, תיאור בטקסט רגיל או מאפיין מאפשרת לערוך אותו במקום. מהמקלדת, יש לעבור לתא עם Tab ולהקיש Enter או F2. Enter שומר (Shift+Enter מוסיף מעבר שורה בתיאור); Esc מבטל; הפוקוס נשאר בתא. בחירות וכן/לא פותחים רשימה, תאריכים פותחים תיבת תאריך, ובחירות מרובות מקבלות ערכים מופרדים בנקודה-פסיק. תיאורי טקסט עשיר, קבצים, בדיקות איכות וערכים מחושבים נערכים בחלונית המאפיינים או בתצוגת הפריט.
- שם: הקשה על F2 על שם משנה את שם הישות במקום.
- תאי קשרים מציגים את הישויות הקשורות כקישורים ויש בהם + להוספת קשר (לעמודות קשורות שעוקבות אחר עמודה אחרת אין +).
- כותרת: לחיצה ממיינת לפי העמודה הזו; לחיצה נוספת הופכת. ▾ פותח את תפריט העמודה. גרירת הקצה השמאלי של כותרת משנה את הגודל (מינימום 40 px): רק העמודה הזו משתנה, והטבלה נעשית רחבה או צרה יותר. לחיצה כפולה על הקצה מאפסת את הרוחב.
- תיבות סימון: תיבת הסימון שבכותרת מסמנת כל שורה (את כולן, לא רק את הגלויות). Shift+לחיצה מסמנת או מבטלת סימון של טווח.
עריכה כמו בגיליון אלקטרוני
הטבלה עורכת תאים רבים בבת אחת, כמו גיליון אלקטרוני. אפשר לבטל כל הדבקה או מילוי בביטול פעולה אחד.
- מעבר בין תאים: כשתא בפוקוס, ← ו-→ נעים לאורך השורה, ↑ ו-↓ לאותה עמודה בשורה שמעל או מתחת.
- הדבקת בלוק: יש להעתיק תאים ב-Excel, ב-Numbers או ב-Google Sheets, ללחוץ על התא שבו הבלוק מתחיל ולהקיש ⌘V / Ctrl+V. שורות נכנסות כלפי מטה ועמודות לרוחב, לפי הסדר שבו הטבלה מציגה אותן, ולכן כדאי לסדר את העמודות כך שיתאימו קודם. תא ריק שהודבק מנקה את הערך.
- הדבקת ערך אחד בשורות רבות: יש לסמן את השורות, ואז להדביק ערך יחיד באחד מהתאים של השורות המסומנות. כל שורה מסומנת מקבלת אותו.
- מילוי כלפי מטה: יש לסמן את השורות, להתמקד בתא בעמודה ולהקיש ⌘D / Ctrl+D, או לבחור מילוי כלפי מטה בתפריט של כותרת העמודה. הערך של השורה המסומנת הראשונה נכנס לשאר השורות המסומנות. כשאין שורות מסומנות, ⌘D / Ctrl+D מעתיק את הערך מהשורה שמעל.
- העתקה: ⌘C / Ctrl+C על תא מעתיק את הטקסט שלו; כשהשורה שלו נמצאת בין השורות המסומנות, הוא מעתיק את הערכים של העמודה הזו בשורות המסומנות, אחד בכל שורה.
הערכים נקראים כפי שהמאפיין שומר אותם: בחירות חייבות להתאים לאחת מהבחירות של המאפיין (בכל רישיות), כן/לא מקבל yes, no, true, false, 1 ו-0, מספרים מקבלים התפלגויות, תאריכים מקבלים את צורות התאריך המקובלות, וסטטוס שתהליך עבודה מפקח עליו מקבל רק את המצבים הבאים המותרים שלו.
חלק מהתאים מדולגים:
- תאים לקריאה בלבד: פריטי ספרייה, פריטים נעולים, תיאורי טקסט עשיר, קבצים, בדיקות איכות, ערכים מחושבים ועמודות קשרים
- ערכים שאינם מתאימים למאפיין, כמו טקסט בעמודת מספר
ההודעה אחרי הדבקה או מילוי סופרת את התאים ששונו ושדולגו ומציינת את הסיבה הנפוצה ביותר. שורות שאחרי השורה האחרונה אינן נוספות; ההודעה סופרת אותן.
עץ
עץ בשורת השאילתה מציג את הפירוק כעץ. ישויות שההורה שלהן אינו בתוצאה הן שורות עליונות; לחיצה על ▸ מרחיבה את הצאצאים (צאצאים מוצגים גם אם השאילתה הייתה מחריגה אותם). ▸ / ▾ הוא לחצן: אפשר לעבור אליו עם Tab ולהקיש Enter או Space. העץ נשמר עם תצוגות שמורות.
תפריט לחיצה ימנית
לחיצה ימנית על שורה, בטבלה או בעץ, פותחת את התפריט שלה במיקום המצביע. מהמקלדת, יש להתמקד בשורה (קישור השם שלה, תיבת הסימון או תא) ולהקיש Shift+F10 או את מקש התפריט; התפריט נפתח בשורה ו-Esc מחזיר את הפוקוס אליה. במסך מגע, יש לגעת בשורה ולהחזיק.
התפריט מתחיל בעד שלוש פעולות מוצעות, שנבחרות לפי מצב הישות כשהתפריט נפתח. כל אחת מציגה את הסיבה שלה משמאל (גם בתיאור הכלי שלה). אחריהן ✦ עוד AI ▸ וקו מפריד.
| הצעה | מתי | הסיבה שמוצגת |
|---|---|---|
| בדיקת הקישור… | פריט במעלה הזרם השתנה מאז שהקישור לישות הזו נבדק. פותח את הבדיקה עבור הישות. | השתנה במעלה הזרם |
| פתרון TBD… (או פתרון TBR…) | לדרישה יש TBD או TBR פתוח. פותח את מרשם TBD/TBR כשהדרישה נבחרת. | TBD פתוח, או TBD שמועדו עבר |
| ✦ הוספת קריטריונים מדידים…, ✦ פיצול דרישה מורכבת…, ✦ הצעת שם…, ✦ פישוט…, ✦ ניסוח ברור מחדש… | הדרישה נכשלת בקריטריון איכות שהניסוח מחדש מתקן, למשל מונח ביצועים שאי אפשר למדוד, או ממצא AI שהיא אינה ניתנת לאימות (הוספת קריטריונים מדידים); שתי הצהרות או יותר או מחברים (פיצול); שם חסר (הצעת שם); ביטויי מקור מיותרים (פישוט); ממצאי ניסוח אחרים (ניסוח ברור מחדש). לכל היותר שתיים. | נכשל: קריטריון |
| ✦ יצירת מקרה בדיקה… | לדרישה אין קשר verified by. | לא אומת |
| ✦ יצירת דרישות צאצא… | אפשר לפרק את הדרישה או ההצהרה ואין לה צאצאים. | אין צאצאים |
| ✦ הצעת זרימה… | ל-Action יש שני Actions צאצאים או יותר ואין זרימה שמורה. | אין זרימה |
| ✦ בדיקת דרישה עם AI… ו-✦ לשאול את ה-AI על זה… | אף אחד מהמצבים שלמעלה אינו חל. | הקריטריונים שעדיין צריך לשפוט, או שדבר לא סומן |
ההצעות משתמשות רק במה שכבר נמצא בפרויקט (בדיקת האיכות מבוססת הכללים, ממצאי AI שקיבלת, קשרים וסימונים), ולכן התפריט נפתח מיד. הן מופיעות בסדר שלמעלה.
✦ עוד AI ▸ מפרט כל פעולת AI עבור הישות:
| ישות | פעולות ✦ AI |
|---|---|
| דרישה | בדיקת דרישה עם AI…, ניסוח מחדש ▸ (ניסוח ברור מחדש, הוספת קריטריונים מדידים, פישוט, פיצול דרישה מורכבת, טיוטת נימוק, הצעת שם), יצירת דרישות צאצא…, יצירת מקרה בדיקה… |
| הצהרה אחרת | ניסוח מחדש ▸ (ללא הוספת קריטריונים מדידים), יצירת דרישות צאצא… |
| Action עם שני Actions צאצאים או יותר | הצעת זרימה… (ניתוח פונקציונלי) |
| מסמך | יצירת דרישות…, סיכום המסמך…, תרגום המסמך… |
| כל ישות מלבד Risk | יצירת סיכונים… |
| כל ישות | לשאול את ה-AI על זה… פותח את לשאול את ה-AI עם הישות כהקשר ועם השאלה כבר בתחילתה |
כל פעולת AI מציגה את התוצאה שלה לסקירה לפני שמשהו משתנה, כמו מהפקד ✦ AI. כש-AI כבוי (אין ספק או מפתח, גישת צפייה בלבד, או שהארגון כיבה את ה-AI), חלק ה-AI של התפריט הוא שורה מעומעמת אחת, ✦ פעולות AI: ואחריה הסיבה. בדיקת הקישור… ופתרון TBD… עדיין מוצגים. ראו סיוע AI.
הפקודות שאחרי הקו המפריד:
| פקודה | מה הוא עושה |
|---|---|
| פתיחה | פותח את תצוגת הפריט. |
| שינוי שם… | משנה את השם. |
| שכפול | מעתיק את הישות, כמו שכפול בסרגל הפעולות המרובות. |
| הוספת צאצא… | יוצר ישות מאותה מחלקה עם השם שמזינים ומקשר אותה עם decomposed by. המספר שלה ממשיך את המספר של ההורה (למשל 2.3.4). |
| Status ▸, עדיפות ▸ | מגדיר את המאפיין. הערך הנוכחי מוצג משמאל ומסומן ברשימה. במחלקה ללא Status או עדיפות, התפריט מציג במקום זאת את שני מאפייני הרשימה הראשונים שלה (למשל כיוון ▸ ל-Port). |
| יצירת קשר אל ▸ | מציג קודם את הקשרים הנפוצים ביותר במחלקה (לדרישה: verified by, satisfied by, traced from, refined by, derived by), ואחר כך את כל הקשרים ▸ עם כל קשר שהמחלקה מתירה, לפי סדר אלפביתי. בחירה באחד פותחת בורר לישויות היעד. |
| הוספה למסמך ▸ | מציג את המסמכים; בחירה באחד מוסיפה את הישות, עם הצאצאים שלה, בסוף אותו מסמך. מסמכים שכבר מכילים אותה מעומעמים. |
| הצגה בדיאגרמה ▸ | מציג את סוגי הדיאגרמות שיכולות להציג את הישות; בחירה באחד פותחת אותו. |
| העתקת קישור | מעתיק קישור לתצוגת הפריט של הישות. |
| העתקת המספר | מעתיק את המספר של הישות (מוצג כשיש לה מספר). |
| מחיקה… | מוחק את הישות ואת הקשרים שלה אחרי אישור. |
כדי לסמן כמה שורות בלי תיבות הסימון: ⌘ / Ctrl-לחיצה (Ctrl-לחיצה ב-Windows וב-Linux) על שורה מסמנת אותה או מבטלת את סימונה, ⇧ / Shift-לחיצה מסמנת את הטווח מהשורה האחרונה שנלחצה, ו-⌘ / Ctrl+⇧ / Shift-לחיצה מוסיפה את הטווח הזה לשורות המסומנות. כששורה בפוקוס, ⌘A / Ctrl+A מסמן כל שורה ו-⇧ / Shift+↑ / ⇧ / Shift+↓ מרחיבים את השורות המסומנות מהשורה שבפוקוס. טווחים עוקבים אחר השורות כפי שהן מוצגות, עם המיון, המסנן והעץ הנוכחיים, גם מעבר לשורות הגלויות. סרגל הפעולות המרובות מציג את הספירה ("21 נבחרו"); Esc מבטל את הסימון של כל השורות.
לחיצה ימנית על שורה שאינה מסומנת הופכת אותה לבחירה (סימון השורות האחרות מבוטל). לחיצה ימנית על שורה מסומנת, כששורות אחרות מסומנות, פועלת על כל השורות המסומנות: התפריט מציג N נבחרו, ושכפול, הגדרת סטטוס ▸, הגדרת עדיפות ▸, הוספה למסמך ▸ ומחיקה חלים על כולן. קבוצת ✦ מציעה ✦ בדיקת דרישות עם AI (n דרישות)…, ✦ ניסוח מחדש (n) ▸, ✦ יצירת מקרי בדיקה (n)…, ✦ לשאול את ה-AI על אלה (n)… ו-✦ הצעת קשרי עקיבות (n)…, כל אחת עם תצוגה מקדימה אחת לכל הפריטים (AI על כמה פריטים נבחרים). הפקודות האחרות דורשות שורה אחת.
אפשר לבטל כל פקודה בביטול פעולה אחד. מהתפריט אי אפשר לשנות שם של ישויות נעולות, לקשר אותן, לתת להן צאצאים, סטטוס או עדיפות, להוסיף אותן למסמך או למחוק אותן. כל פקודה זמינה גם במקום אחר: בסרגל הפעולות המרובות, בחלונית המאפיינים או בתצוגת הפריט.
כדי להשתמש בתפריט של הדפדפן עצמו (למשל כדי לפתוח את קישור השם בכרטיסייה חדשה), יש ללחוץ ⌥ / Alt-לחיצה ימנית. תיבות טקסט ותאים בעריכה שומרים על התפריט של הדפדפן.
סרגל הפעולות המרובות
מופיע כששורה אחת לפחות מסומנת ומציג N נבחרו. הכלים עוקבים אחר סדר העבודה: AI קודם, אחר כך עקיבות, ואחר כך עריכה.
| פקד | מה הוא עושה |
|---|---|
| ✦ AI ▾ | פעולות ה-AI לשורות המסומנות, כמו בתפריט הלחיצה הימנית: לשורה אחת ההצעות שלה ו-✦ עוד AI ▸; לכמה שורות, ✦ בדיקת דרישות עם AI (n דרישות)…, ✦ ניסוח מחדש (n) ▸, ✦ יצירת מקרי בדיקה (n)…, ✦ לשאול את ה-AI על אלה (n)… ו-✦ הצעת קשרי עקיבות (n)…. כל תוצאה מוצגת בתצוגה מקדימה לפני שמשהו משתנה. |
| קשרים… | פותח את קשרים עבור N ישויות. פעולה היא הוספת קשרים או הסרת קשרים. קשרים מציג "(n/m מחלקות)" כשלא כל מחלקה מסומנת מתירה יחס. לפריטי יעד יש חיפוש. הסיכום מציג קשרים × יעדים × מקורות. זוגות שהסכמה אינה מתירה מדולגים ונספרים. |
| פתיחה במטריצה | פותח את מטריצת העקיבות עם השורות המסומנות. |
| מאפיינים… | פותח את הגדרת מאפיין עבור N ישויות. האפשרויות הן תיאור, הוספה לתחילת השם, הוספה לתחילת המספר, תמונה, או כל מאפיין שמשותף לכל המחלקות המסומנות מלבד מאפייני איכות. הערך מחליף את המאפיין בכל ישות. קידומת נוספת לפני השם או המספר הקיימים. |
| תווית ▾ | מציג תוויות שתקפות לכל מחלקה מסומנת. ✔ מסמן תוויות שכבר יש לכל הישויות המסומנות; בחירה בה מסירה את התווית מכולן, אחרת היא מוסיפה אותה לכולן. |
| שינוי מחלקה… | משנה את המחלקה. ראו שינוי מחלקה. |
| עוד ▾ | פתיחה (שורה אחת), שכפול (מעתיק כל ישות מסומנת, עם מחלקה, מספר, תיאור, מאפיינים, תוויות, תמונה וקשרים, כ-"עותק של …"), נעילה / ביטול נעילה (מבטל נעילה כשישות מסומנת כלשהי נעולה), חיפוש והחלפה…, צבירה… (שורה אחת עם צאצאים), מספור מחדש של הצאצאים… (שורה אחת), העתקה עם צאצאים… (שורה אחת), היסטוריה… (שורה אחת), הוספה למסמך…, ייצוא…. |
| מחיקת הפריט… / מחיקת N פריטים… | מוחק את הישויות המסומנות אחרי אישור (הן עוברות לסל המחזור של הפרויקט). ישויות נעולות מדולגות. |
| × | מבטל את הסימון של כל השורות (Esc עושה אותו דבר). |
כשהשורות המסומנות כוללות פריטי ספרייה, הסרגל מתחיל ב-"N פריטי ספרייה נבחרו" וב-אימוץ…, שמעתיק אותם לפרויקט כפריטים ניתנים לעריכה שזוכרים את המקור שלהם.
הוספה למסמך… מקשר את הישויות המסומנות למסמך עם source of. בוחרים את המסמך באחת משתי דרכים:
- מסמך קיים: יש לבחור Artifact תחת Artifact קיים.
- מסמך חדש: יש להשאיר את — מסמך חדש — ולהזין שם תחת או לתת שם ל-Artifact חדש. Holarch יוצר Artifact חדש עם התווית מסמך.
תחביר השאילתה
אותו תחביר עובד בחיפוש של מסד הנתונים, בשאילתות שמורות, בחלוניות תצוגה שמורה בדף הבית, בצירי שאילתה של מטריצות ובשדות שאילתה אחרים.
| שאילתה | תואם |
|---|---|
power | השם, המספר או התיאור מכילים "power" (ללא תלות ברישיות) |
"power subsystem" | הביטוי המדויק |
number:2.3, number:5.* | מספר, עם * כתו כללי |
name:Gen% | שם, עם % כתו כללי |
description:battery | התיאור מכיל את הטקסט |
id:e12 | הישות עם המזהה הזה |
class:Requirement | מחלקה, כולל תת-מחלקות. Camel case עובד ללא מירכאות: class:TestCase |
label:"Functional Requirement" | ישויות עם התווית הזו |
is:root, is:leaf, is:orphan, is:top, is:diagram, is:locked, is:commented | ללא הורה; ללא צאצאים; ללא קשרים; שורש עם צאצאים; יש דיאגרמה; נעול; יש תגובות שלא נפתרו |
is:suspect, is:tbd, is:finding | יש קישור לבדיקה; יש TBD או TBR פתוח; יש ממצא של בדיקות המודל |
is:library | פריט ספרייה שמוצג לקריאה בלבד מגרסת ספרייה; מסד הנתונים מציג פריטי ספרייה עם המונח הזה או כשפריטי ספרייה מופעל (ראו ספריות) |
status:Approved | המאפיין Status של כל מחלקה שיש לה כזה (ללא תלות ברישיות) |
quality:rework, quality:Verifiable=no, quality:R7 | תוצאות האיכות השמורות של דרישה: דורש עבודה נוספת (גם good, notrun, stale, manual, ai), דורג No בקריטריון (=yes: דורג Yes), ממצא של כלל (ראו סינון דף האיכות) |
relationship:"verified by" | יש לפחות קשר אחד מהסוג הזה |
in:"Station Spec" | פריטים של המסמך הזה (השם או המזהה שלו). לקובץ מאוגד: החלקים שלו והפריטים שלהם |
diagram:LML_ACTION | יש לו סוג הדיאגרמה הזה. קודים: LML_ACTION, LML_ASSET, LML_SPIDER, LML_HIERARCHY, LML_RISK, LML_TIMELINE, LML_SEQUENCE, TREE, SYSML_ACTIVITY, SYSML_BDD, SYSML_IBD, SYSML_CLASS, SYSML_PACKAGE, SYSML_PARAMETRIC, SYSML_STATE_MACHINE, SYSML_USE_CASE, SYSML_REQUIREMENT, IDEF0, N2, LAYER, RADAR, או מפתח דיאגרמה כמו ffbd |
Requirement:"Status=Draft" | בדיקת מאפיין עם =, >, <, >=, <=. אסימון המחלקה יכול להיות ב-camel case: TestCase:"Status=Passed" |
Requirement:"Name~pump" | המאפיין מכיל את הטקסט (~) |
Requirement:"Owner=" | המאפיין ריק (שום דבר אחרי =) |
Risk:"Probability>=50" | מאפיין מספרי |
Asset:"Mass>2 kg" | ערך עם יחידה: שני הצדדים מומרים (2500 g תואם; ערך במטרים אינו תואם) |
value:"Mass * 1.1 <= 12 kg" | חשבון עם יחידות על ערכי הפריט: +, -, * (או ×), / (או ÷), סוגריים והשוואה (<, <=, >, >=, =, !=). ערך הוא מאפיין, Characteristic שהפריט מוגדר על ידו (ה-Value וה-Units שלו), או הקצאת תקציב (Mass Allocation); את היחידות כותבים אחרי המספרים (12 kg, 9.81 [m/s^2]) |
value:"sum(decomposed by → Mass) > Mass Allocation" | סיכומים על פריטים קשורים: sum (או total), min, max של ערך, ו-count(decomposed by); -> עובד במקום →. פריטים ללא הערך מדולגים |
Action:"Duration>2 hours" | מאפיין משך (יחידות: second, minute, hour, day, week, month, year; שעות כשהיחידה מושמטת) |
Physical:"Coordinates=38.9,-77.0" | מאפיין מיקום (קו רוחב, קו אורך) (שוויון בלבד) |
order:name, order:name- | מיון; - בסוף ממיין בסדר יורד. גם order:number (ברירת המחדל), order:class, order:created, order:modified, order:diagrammodified, order:related, order:unsorted |
AND, OR, NOT, ( ) | שילוב מונחים. שני מונחים זה לצד זה פירושם AND. |
כיצד בדיקות מאפיינים משוות ערכים:
- מאפייני כן/לא ואיכות:
true,yesאו1פירושם כן. - מספרים: מושווים מספרית; התפלגות מושווית לפי הממוצע שלה. עם יחידה אחרי המספר (
Mass>2 kg) שני הצדדים מומרים קודם לאותה יחידה, וערך מסוג אחר (מטרים מול קילוגרמים) אינו תואם. - תאריכים: מנותחים כתאריכים, למשל
Task:"Start>2026-01-01". - בחירה מרובה:
=נכון כשאחד הערכים שנבחרו תואם. - מאפייני קובץ:
=yesתואם ישויות עם קובץ. - טקסט ובחירות: מושווים ללא תלות ברישיות.
Nameו-Numberעובדים כשמות מאפיינים בכל מחלקה:Requirement:"Number>=3".
דוגמה: class:Requirement AND NOT relationship:"verified by" מציג דרישות ללא בדיקה.
כיצד מסננים מוקלדים הופכים לשבבים
בהקשה על Enter, מונחי מסנן בתחילת החיפוש הופכים לשבבים. המונחים האלה עוברים:
- מונחי
order:,is:,class:,label:,diagram:ו-relationship:. - בדיקות מאפייני מחלקה, כמו
Requirement:"Status=Draft"אוRequirement:"Name~pump". - כל אחד מאלה כשהם מחוברים ב-
AND. - קבוצת OR בסוגריים מסוג אחד, כמו
(class:Risk OR class:Issue).
המונח הראשון שאינו מסנן נשאר בתיבת החיפוש, עם כל מה שאחריו. OR בסוף אחרי המסננים מוסיף את השבב מסננים או טקסט חיפוש: שורות תואמות למסננים או לטקסט החיפוש במקום לשניהם. תצוגות שמורות וקישורים ממשיכים לעבוד עם אותו טקסט: השבבים הם החלק המוביל של השאילתה.
מסננים
+ מסנן בשורת השאילתה פותח רשימה אחת של מסננים. אפשר להקליד כדי לצמצם אותה (גם שמות הקבוצות תואמים, כך ש-label מציג כל תווית). ↑ ו-↓ נעים, Enter או לחיצה מפעילים או מכבים את המסנן, והרשימה נשארת פתוחה לבא. Esc או לחיצה מחוץ לרשימה סוגרים אותה.
| קבוצה | אפשרויות |
|---|---|
| מבנה | ללא הורה, ללא צאצאים, ראש עץ (ללא הורה, יש צאצאים), ללא קשרים, יש דיאגרמה, נעול, תגובות שלא נפתרו, קישור לסקירה, TBD/TBR פתוחים, ממצא של בדיקת המודל. |
| סוג | עץ המחלקות עם דוגמיות צבע וספירות (ספירת מחלקה כוללת את תת-המחלקות שלה). מחלקות מוסתרות אינן מוצגות. |
| מאפייני המחלקה | קבוצה אחת לכל מחלקה בשאילתה: שם, מספר וכל מאפיין של המחלקה מלבד מאפייני איכות וקובץ. ללא שבב מחלקה הרשימה מציגה "יש להוסיף מחלקה קודם: המאפיינים שלה מוצגים כאן." |
| תווית | כשיש מחלקות בשאילתה, כל תווית שתקפה עבורן; אחרת התוויות שבשימוש (עם תוויות ההורה שלהן). תוויות מקוננות מוזחות. |
| קשר | יש יחס לכל יחס שבשימוש, עם מספר הישויות שיש להן כזה. |
| דיאגרמה | יש סוג דיאגרמה לכל סוג שקיים בפרויקט, עם מספר הישויות שיש להן כזה. |
| שילוב | התאמה למסננים או לטקסט החיפוש: שורות שעוברות את המסננים, ובנוסף שורות שתואמות לטקסט החיפוש. |
אפשרויות מאותו סוג (מחלקות, תוויות, קשרים, דיאגרמות) משתלבות ב-OR (כל אחת מהן). אפשרויות מבנה ומסנני מאפיינים חייבים כל אחד להתאים (AND). סוגים שונים משתלבים ב-AND.
מסנני מאפיינים. בחירת מאפיין פותחת את המסנן שלו באותה חלונית: השוואה וערך.
| השוואה | תואם | שאילתה |
|---|---|---|
| = שווה ל | שווה (טקסט ובחירות ללא תלות ברישיות) | Requirement:"Status=Draft" |
| מכיל | הערך מכיל את הטקסט | Requirement:"Name~pump" |
| > יותר מ, ≥ לפחות, < פחות מ, ≤ לכל היותר | מספרים, משכי זמן, תאריכים ואחוזים מושווים לפי ערך | Risk:"Probability>=50" |
| ריק | ללא ערך | Requirement:"Owner=" |
מאפייני בחירה, בחירה מרובה וכן/לא מציעים את הערכים שלהם ברשימה; מאפיינים אחרים מקבלים טקסט מוקלד, עם רמזים כמו e.g. 2 hours ו-yyyy-mm-dd. הוספת מסנן מוסיף את השבב; ‹ חזרה חוזר לרשימה. הוספת מסנן ללא ערך מציג "יש להזין ערך, או לבחור "ריק"." לחיצה על השבב מאוחר יותר מאפשרת לשנות אותו: עדכון או הסרה.
עמודות
עמודות נערכות במקומן: מכל כותרת ומעמודות ▾.
כותרות עמודות
לכל כותרת יש ▾ (נפתח גם בלחיצה ימנית על הכותרת, או עם Shift+F10):
| פקודה | מה הוא עושה |
|---|---|
| מיון בסדר עולה / מיון בסדר יורד | ממיין לפי העמודה; המיון הנוכחי מסומן. |
| הזזה שמאלה / הזזה ימינה | מזיז את העמודה מקום אחד. |
| שינוי שם… | נותן לעמודה כותרת משלה. |
| איפוס הכותרת | מוצג לעמודה ששמה שונה: חזרה לכותרת שנוצרה אוטומטית (מוצגת משמאל). |
| רוחב… | מגדיר את רוחב העמודה בפיקסלים (40 עד 2000), החלופה במקלדת לגרירת הגבול השמאלי של הכותרת; ערך ריק מחזיר לרוחב ברירת המחדל. |
| הסתרת העמודה | מסיר את העמודה, עם העמודות הקשורות שעוקבות אחריה. אי אפשר להסתיר את העמודה האחרונה. |
| הוספת עמודה… | פותח את הוספת עמודה כדי להוסיף עמודה אחרי זו: סוג (שדה ישות, מאפיין או קשר) ומה שהיא מציגה. |
| עמודה קשורה… | פותח את עמודה קשורה: הישויות שמקושרות בקשר שבוחרים לישויות שבעמודה הזו (לעמודת שדה או מאפיין, לכל שורה). קשר, הצגה (ישות, כל שדה או מאפיין של הישויות המקושרות) וכשליחס יש מאפיינים, מאפיין קשר (למשל ריבוי ב-decomposed by), שמוצג במקום הישות. עמודה קשורה עוקבת אחר 4 קשרים לכל היותר מהשורה. |
| עריכת העמודה… | לעמודות מאפיין וקשר: שינוי מה שהעמודה מציגה. |
מעקב אחר עמודה משרשר קשרים. לדוגמה, עמודת satisfied by ואחריה עמודה קשורה performed by מציגות את הנכסים שמבצעים את הפונקציות שמספקות כל דרישה.
עמודות ▾
רשימה של כל עמודה שאפשר להציג, עם תיבות סימון: שדות (ישות (מספר ושם כקישור), מספר, שם, מחלקה, תיאור, תוויות, מזהה, מזהה גלובלי, נוצר, שונה), קבוצת מאפיינים אחת לכל מחלקה (המחלקות שבשאילתה, או כל מחלקה שבשימוש), וקשרים (היחסים שהמחלקות האלה מתירות). סימון מוסיף את העמודה בסוף; ביטול הסימון מסיר אותה. אפשר להקליד כדי לצמצם את הרשימה.
בתחתית: הצגת תיאורים מלאים (אחרת תיאורים מציגים שתי שורות) ועמודות ברירת מחדל (שש ברירות המחדל, עם רוחבי ברירת מחדל).
עמודות, רוחבים, המיון, העץ והצגת תיאורים מלאים נשמרים בדפדפן הזה. ⋯ → איפוס עמודות, מיון ועץ בחלונית התצוגות משחזר את ברירות המחדל.
דוחות
ייצוא… מייצא את השורות המסומנות, או את השאילתה הנוכחית, לקובץ, בתיבת הדו-שיח ייצוא. הכותרת מציגה כמה ישויות היא מכסה והאם הן השורות המסומנות או השאילתה הנוכחית.
- יש לבחור מה לייצא בייצוא בתור. האפשרויות נקראות "<content> (<format>)" ומקובצות לפי פלט (Word, Excel, CSV, החלפה, הדפסה); הבחירה האחרונה שלך נזכרת.
- יש להגדיר את האפשרויות שלה.
- יש לערוך את שם הקובץ. ברירת המחדל היא שם הפרויקט או הישות.
- יש ללחוץ על ייצוא.
ייצוא גדול (עשרות אלפי ישויות) נכתב בשלבים: כרטיס ההתקדמות מציג מה הוא עושה ("קורא פריטים", "כותב שורות", "אורז את הקובץ") עם ספירה, והדף ממשיך להגיב בזמן ההרצה.
| ייצוא בתור | פלט ואפשרויות |
|---|---|
| טבלה (CSV) | מספר, שם, תיאור, מחלקה, ואחריהם העמודות שנבחרו. הכללת מאפיינים: כל מאפיין של המחלקות המוצגות, מקובץ תחת המחלקה שמגדירה אותו (המחלקה שרוב הפריטים המוצגים משתמשים בה קודם), כל קבוצה עם תיבת סימון לכל הקבוצה; סינון מאפיינים מצמצם את הרשימה, והכול / ללא מסמנים או מנקים את מה שהיא מציגה. הכללה: תגובות, נוצר בתאריך, כתובת URL של הישות, מזהה גלובלי, מזהה, תוויות (מופעל כברירת מחדל), תאריך שינוי, קשרים (עמודה אחת לכל יחס שבשימוש), טקסט עשיר (התיאור כ-HTML במקום טקסט רגיל), נעול. מיון לפי: מספר, מחלקה, מזהה, שם או היררכי. לפני טקסט שמתחיל ב-=, +, - או @ מתווסף גרש כדי שגיליונות אלקטרוניים יתייחסו אליו כטקסט. |
| טבלה (Excel) | עמודות מסד הנתונים, עם עמודת רמה. הקפאת שורת הכותרת (מופעל), היררכיה (צאצאים תחת ההורים שלהם), ביטול מיזוג תאים, צבירה (סיכום עמודות מספר ומשך במעלה ההיררכיה). |
| הגדרות (Excel) | בלוק אחד לכל ישות: מחלקה, מספר, שם, תיאור, תוויות, כל מאפיין וכל קשר. הקפאת שורת הכותרת (מופעל), מזהים גלובליים, מזהה, ביטול מיזוג תאים. |
| מטריצת קשרים (Excel) | השורות הן הישויות, העמודות הן הישויות הקשורות. קשר, הצגה בתאים (X (ללא מאפיין) או מאפיין קשר), הקפאת שורת הכותרת, הצללת תאים (תאים ירוקים), מזהה גלובלי. תאים ריקים מושמטים מהקובץ, כך שהגודל שלו נקבע לפי הקשרים. Excel פותח לכל היותר 16,384 עמודות ו-1,048,576 שורות: מטריצה גדולה יותר אינה מיוצאת, ותיבת הדו-שיח מציינת זאת ומפנה לקשרים (CSV). |
| קשרים (CSV) | שורה אחת לכל קשר מהישויות המיוצאות: Source Number, Source Name, Source Class, Relationship, Target Number, Target Name, Target Class ו-Attributes. קשר (אחד, או כל הקשרים). מתאים למטריצות גדולות מדי ל-Excel ולסקריפטים. |
| היסטוריה (Excel) | שורה אחת לכל שינוי שנרשם: Date, ID, Global ID, Entity, Version, Change, Field, From, To. הקפאת שורת הכותרת, מזהה גלובלי, מזהה, מספר גרסה. |
| תגובות (Excel) | מוצע כשלישויות יש תגובות. כל תגובה היא שורה עם המחלקה, השם, המספר והתיאור של הישות שלה, התגובה, המחבר, התאריך ומצב הפתרון. |
| פירוק (Word) | מוצע לישות אחת בדיוק. הפירוק ככותרות לפי רמה עם תוכן עניינים, תיאורים ותמונות של סוגי הדיאגרמות שנבחרו כשיש לישות כזו (היררכיה מופעל כברירת מחדל). |
| נתוני הפרויקט (JSON) | קובץ JSON של פרויקט עם הישויות. הכללת פריטים קשורים, כולל הערות (מופעל), כולל היסטוריה, כולל דיאגרמות (מופעל), הכללת הסכמה, סכמה ללא ישויות. מייבאים אותו דרך ניהול פרויקטים → קובצי פרויקט ▾ → ייבוא פרויקט (.json)…. |
| חבילת פרויקט (.holarch) | חבילת Holarch של הישויות עם הקשרים, הדיאגרמות, התגובות והסכמה שלהן, וכל קובץ ותמונה מצורפים. הייבוא קורא אותה בחזרה ובודק אותה קודם; ראו תבנית הגיבוי של Holarch. |
| דרישות (ReqIF) | ReqIF 1.2 XML: סוג אחד לכל מחלקה, מאפייני מחרוזת, XHTML ומניה, קשרים כ-relations, והפירוק כהיררכיית מפרט. |
| טבלה (הדפסה) | מדפיס את הטבלה מהדפדפן. |
לאופן שבו הקבצים האלה מיובאים לכלים אחרים ובחזרה ל-Holarch, ראו ייבוא וייצוא.
חלונית המאפיינים
חלונית המאפיינים מציגה את הפריט הנבחר בצד השמאלי של המעטפת. כדי להציג בה פריט, יש לבחור אותו במסד הנתונים, בדיאגרמה, במסמך או במרשם.
הכותרת היא שורה אחת: תג המחלקה, המספר והשם של הפריט, פתיחה ב- ▾, הנעץ (שמירת חלונית המאפיינים פתוחה) ו-× (סגירת הפריט). Esc מסתיר את חלונית המאפיינים.
פתיחה ב- ▾ מפרט כל תצוגה שהפריט יכול להיפתח בה:
- תצוגת פריט.
- כל סוג דיאגרמה שחל על המחלקה שלו.
- תצוגת מסמך (Artifacts ו-Statements).
- סימולטור (Actions).
- מרכז הבדיקות (Test Cases).
- מטריצה, תרשים או תוצאות הסימולציה, היכן שהם קיימים.
- מטריצת עקיבות.
החלונית היא רשימה גוללת אחת של קבוצות, בסדר שבו בדרך כלל עובדים על פריט. הקישורים שבראש הם אינדקס, לא כרטיסיות: כל אחד קופץ לקבוצה שלו, פותח אותה אם היא מקופלת ומעביר את פוקוס המקלדת לכותרת שלה, והקישור של הקבוצה שקוראים מוצג בהדגשה. הקישורים עקיבות ודיון מציגים כמה קשרים ותגובות פתוחות יש לפריט. לחיצה על כותרת של קבוצה מקפלת או פותחת אותה; Holarch זוכר זאת לכל מחלקה בדפדפן שלך. איכות מתחילה מקופלת. כיווץ הכול בקצה השמאלי של הקישורים מקפל כל קבוצה, לרשימה קצרה של כותרות; כשכל הקבוצות מקופלות הוא מציג הרחבת הכול ופותח את כולן שוב. Holarch זוכר גם זאת לכל מחלקה, כאילו לחצת על כל כותרת. הלחצן הוא תחנת מקלדת כמו הקישורים, ולחלוניות הצורה והחיבור של דיאגרמות יש אותו לחצן. בתוך עקיבות, הכותרות הקטנות יותר (דרישות, פירוק, פרויקטים אחרים) ממיינות את הקשרים של הקבוצה.
| קבוצה | מה היא מכילה |
|---|---|
| דרישה (דרישות והצהרות) או הגדרה (מחלקות אחרות) | מספר, שם, תיאור, ומה שהפריט אומר: Rationale, Source, Success Criteria; Kind, Justification, Trigger ודומיהם במחלקות אחרות |
| תהליך עבודה | לדרישות רצועת הסקירה; Priority, Criticality, Owner, אחראי, תאריך יעד ומעקב, TBD/TBR עם הבעלים ותאריך היעד שלו; סטטוס, תאריכים ומאשרים במחלקות אחרות; ואחר כך תוויות |
| אימות | Verification Method ו-Level, מאומת על ידי (מקרי הבדיקה המקושרים עם הסטטוס שלהם), ועם תוכנית רשמית שדות סגירת האימות; הסטטוס ופרטי הבדיקה של Test Case |
| ערכים | Budget Quantity, Threshold, Objective ו-Value הנוכחי, Units; כמויות, סכומים ושיעורים במחלקות אחרות |
| לוח זמנים | Start, Duration, Percent Complete, Finish |
| הערכה | דירוגי חומרה, סבירות, הסתברות והשלכה (סיכונים, סיכוני בטיחות, אופני כשל) |
| התאמה | Compliance ו-Compliance Response (תוכנית רשמית) |
| איכות | Quality Score וקריטריוני האיכות; הכותרת מציגה "N% · N מתוך M מתקיימים" |
| מאפיינים אחרים | כל מאפיין אחר, המאפיינים שלך, וערכים מתויגים של stereotypes תחת «Name» |
| עקיבות, דיון, פרטים | קשרים, תגובות, ומזהה, תאריכים, היסטוריה ותמונה |
קבוצה ללא מאפיינים מושמטת. שדות קצרים מוצגים שניים בשורה כשחלונית המאפיינים רחבה מספיק, ואחד בשורה כשהיא צרה; טקסט ארוך, קבוצות תיבות סימון וקבצים תופסים את כל הרוחב. שדה טקסט ארוך כמו Rationale הוא שורה אחת כשהוא ריק וגדל תוך כדי הקלדה. שדה ריק מציג לא הוגדר. שדות בעלים מציעים שמות תוך כדי הקלדה: השמות שכבר נמצאים בשימוש בפרויקט, ובפרויקט משותף גם החברים בו. ריחוף מעל התווית של מאפיין מציג את התיאור שלו.
מאפייני התוכנית הרשמית (Compliance, Compliance Response, Verification Closed By, Verification Closure Date, Verification Closure Notes) מוצגים כשתוכנית רשמית מופעלת בהעדפות הפרויקט, או כשלאחד מהם יש ערך.
דרישה או הגדרה
- לדרישות: הודעת בדיקת הקישורים (ראו דרישות).
- מספר ושם (בתצוגת הפריט הם שורת הכותרת של הדף), ואחריהם תיאור (טקסט עשיר; לחיצה לעריכה, או מעבר אליו עם Tab והקשה על Enter או F2) עם EARS ▾ לדרישות.
- המאפיינים שאומרים במה הפריט עוסק, כמו Rationale, Source ו-Success Criteria.
תהליך עבודה
- לדרישות, רצועת הסקירה: ה-Status (אפשר לבחור כאן מצב אחר), מי הגדיר אותו ומתי, ואישור, דחייה… או פתיחה מחדש (ראו דרישות). Status אינו חוזר כשדה נפרד.
- Priority, Criticality ו-Owner, ואחריהם אחראי ותאריך יעד. בפרויקט משותף, הודעות → מעקב (עין והמילה מעקב, במעקב כשהוא פעיל) שולח לך הודעות על הפריט (ראו התראות).
- תוויות כשבבים. × על שבב מסיר את התווית. + תווית מפרט כל תווית שתקפה למחלקה, מקוננת כמו בסכמה, עם ✓ על אלה שהוחלו; בחירה באחת מוסיפה או מסירה אותה. פריט ללא קבוצת תהליך עבודה מציג את התוויות שלו בסוף הקבוצה הראשונה שלו.
עקיבות
הקשרים מקובצים לפי מה שהם משמשים לו:
| קבוצה | יחסים |
|---|---|
| דרישות | traced from/to, satisfies/satisfied by, refines/refined by, derives/derived by, specifies/specified by, source of/sourced by |
| הקצאה | performs/performed by, generates/generated by, receives/received by, transfers/transferred by, connects to/connected by, located at/locates, consumes/consumed by, produces/produced by, seizes/seized by |
| אימות | verifies/verified by |
| פירוק | decomposes/decomposed by |
| אחר | כל יחס אחר |
- המקטע מציג את היחסים שיש להם קישורים, את היחסים שבחרת להשאיר גלויים, ואת היחסים שבדיקת מודל מסמנת. הצגת כל הקשרים מציג גם את היחסים הריקים שהמחלקה מתירה; התווית מציינת כמה מוסתרים.
- פער של בדיקת מודל מוצג תחת היחס שלו, למשל "אין מקרה בדיקה מאמת" בדרישת עלה (אותם כללים כמו באימות → בדיקות המודל, ראו עקיבות).
- כל יחס מציג את השם שלו ואת מספר הקישורים; ריחוף מעליו מציג את המחלקות שהוא מקשר אליהן. לחיצה על השם מכווצת או מרחיבה אותו.
- + ביחס: קישור פריט קיים… (חיפוש, סימון של כמה פריטים, קישור הנבחרים) או <class> חדש… (יוצר פריט ממחלקה מותרת ומקשר אותו).
- ⋯ בקבוצה: השארה גלויה כשריק עם סימון לכל יחס. הבחירה חלה על כל פריט במחלקה ונשמרת בדפדפן הזה. כברירת מחדל decomposed by, decomposes, satisfied by, satisfies, sourced by, source of, traced from, traced to, verified by ו-verifies נשארים גלויים; ב-Statements וב-Requirements מושמטים satisfies, source of ו-verifies.
- לכל פריט מקושר יש קישור, סימן סקירה ⚠ כשרלוונטי, מאפיינים למאפייני הקשר, ו-× להסרת הקשר.
- 🔒 מחליף את + כשהפריט נעול, או כשהתצוגה הנוכחית מנהלת את היחס הזה בעצמה ("לקריאה בלבד כאן: התצוגה הזו מנהלת את הקשר הזה.").
דיון
התגובות של הפריט. ראו תגובות.
פרטים
- מזהה עם העתקת קישור. המזהה הוא גם המזהה גלובלי של הפריט בייצוא, ו-התאמת ישויות קיימות לפי: מזהה גלובלי בייבוא מוצא את הפריט לפיו.
- מחלקה עם מחלקות ההורה שלה, למשל "Statement / Requirement", ואחריה נוצר, שונה ונעול כשהפריט נעול.
- היסטוריה: מספר השינויים שנרשמו; לחיצה עליו מציגה את ההיסטוריה המלאה.
- תמונה: הוספת תמונה. כשיש תמונה: תמונה ממוזערת (לחיצה עליה מציגה אותה בגודל מלא), הורדה, החלפה והסרה.
תצוגת הפריט
תצוגת הפריט מציגה פריט אחד בדף, עם אותן קבוצות כמו חלונית המאפיינים. אפשר לפתוח אותה בכל אחת מהדרכים האלה:
- לחיצה כפולה על שורה במסד הנתונים.
- לחיצה על שם של פריט בכל מקום.
- בחירה בתצוגת פריט מתוך פתיחה ב- ▾.
הכתובת היא entity/<id>.
כותרת הדף
- היסטוריה… פותח את ההיסטוריה המלאה.
- הצעת שינוי… לפריטים תחת בקרת תצורה.
- לחצן הנעילה (🔒 לנעילה, 🔓 לביטול נעילה).
- פתיחה ב- ▾: כל תצוגה שהפריט יכול להיפתח בה (ראו חלונית המאפיינים).
- שכפול.
- צאצאים ▾: מספור מחדש של הצאצאים… (כשלפריט יש צאצאים), צבירה… (כשלפריט יש צאצאים), שכפול עם הצאצאים… וחיפוש והחלפה… (הפריט וכל הצאצאים שלו).
- עוד ▾: ייצוא…, שינוי מחלקה… (שינוי מחלקה) ומחיקת הפריט….
- ה-▾ של פקד ✦ AI מפרט את כלי ה-AI לפריט הזה.
דף
- שורת הכותרת: המחלקה כשבב צבעוני, ואחריה המספר והשם. לחיצה על המספר או השם מאפשרת לערוך אותם. השבב הוא תפריט של מחלקות: בחירה במחלקה אחרת מריצה את שינוי מחלקה, וכשמשהו היה מוסר, תיבת הדו-שיח שינוי מחלקה נפתחת קודם. פריט נעול מציג את הודעת הנעילה מעל הקבוצות.
- הקבוצות של חלונית המאפיינים, מדרישה או הגדרה ועד עקיבות, דיון ופרטים. בדף רחב הקבוצה הראשונה (ההצהרה והטקסט התומך בה) ותהליך עבודה (סטטוס, אנשים, תאריכים ותוויות) מוצגות זו לצד זו; הקבוצות האחרות פרושות על פני הדף מתחתן. בדף צר כל קבוצה היא עמודה אחת.
- פרטים → היסטוריה פותח את ההיסטוריה המלאה.
הכתובת של פריט שנמחק מציגה "הפריט הזה נמחק" עם שחזור הפריט. מזהה לא מוכר מציג "הפריט לא נמצא". בשניהם יש חזרה למסד הנתונים.
סוגי מאפיינים ועורכים
| סוג | עורך והתנהגות |
|---|---|
| TEXT | טקסט בשורה אחת. |
| BIG_TEXT | טקסט רב-שורתי שגדל תוך כדי הקלדה (עד גובה של 400 px). |
| NUMBER | מספר, או התפלגות שמתחילה ב-= (ראו התפלגויות). |
| PERCENT | 0 עד 100. ערכים מחוץ לטווח נחתכים לגבולות, עם הודעה. |
| ENUMERATION | רשימת בחירה שמתחילה ב-יש לבחור אפשרות.... כשיש תהליך עבודה על המאפיין, מוצעים רק הערך הנוכחי והערכים הבאים המותרים, מסומנים ⇢ זרימת עבודה. |
| MULTISELECT | תיבות סימון; הערכים נשמרים ממוינים. "אין אפשרויות. יש להוסיף אותן למאפיין בעורך הסכמה." כשהרשימה ריקה. |
| BOOLEAN | תיבת סימון עם התווית כן או לא. |
| DATETIME | בורר תאריך ושעה. |
| DURATION | מספר או התפלגות ועוד יחידה: שניות, דקות, שעות, ימים, שבועות, חודשים, שנים. =script() מאפשר לסימולטור לקחת את המשך מה-hook duration() של הפעולה. |
| GEOPOINT | קו רוחב (−90 עד 90) וקו אורך (−180 עד 180), עם הצגה במפה ↗ (OpenStreetMap). "אין מיקום" כשהשדה ריק. |
| URI | קישור עם פתיחת הקישור ↗. לטקסט ללא סכמה מתווסף https:// (כתובות IP ו-MAC נשמרות כפי שהוקלדו). רק קישורי http, https ו-mailto נפתחים. |
| FILE | העלאה… או החלפה…, תצוגה מקדימה (תמונות, קובצי PDF וקובצי טקסט), שם הקובץ כקישור הורדה, והסרת הקובץ. |
| HTML | טקסט עשיר, כמו התיאור. |
| EQUATION | טקסט LaTeX, למשל E = mc^2. |
| COMPUTABLE | ערך מחושב. ראו מאפיינים מחושבים. |
| MULTIPLICITY | n, n..m, n..* או *. |
| QUALITY | לא נבדק, כן או לא, נקבע על ידי בדיקת האיכות. בחירת ערך ידנית היא עקיפה ידנית שמסומנת ידני, ונשמרת כשהבודק רץ שוב; אוטומטי (בדיקה חוזרת) מסיר את העקיפה. |
| QUALITY_SCORE | אחוז לקריאה בלבד מבדיקת האיכות. "אין עדיין ציון. יש לבדוק את האיכות שלה." כשלא נבדק; "איכות: לא עדכנית — יש להריץ שוב" אחרי שהטקסט השתנה. |
| USER_TEAM | טקסט שמציין אדם או צוות. |
הערכים נשמרים כשהשדה מאבד את הפוקוס או כשהבחירה משתנה. אפשר לבטל כל שמירה בביטול פעולה אחד.
התפלגויות
מאפייני מספר ומשך מקבלים התפלגות, למשל משך של Action או Amount של Cost. הסימולטור דוגם אותה בכל הרצה. צירי זמן, צבירות וחיפושים משתמשים בממוצע שלה.
הקלדת = מציגה את הרשימה. הרמז שמתחת לשדה מסביר את הפרמטרים.
| התפלגות | נוסחה | פרמטרים |
|---|---|---|
| Beta | =beta.dist(α,β) | α > 0 ו-β > 0 |
| Binomial | =binom.dist(n,p) | n מספר שלם חיובי, p גדול מ-0 ולכל היותר 1 |
| Exponential | =expon.dist(λ) | λ > 0 הוא הקצב; הממוצע הוא 1/λ |
| Gamma | =gamma.dist(k,θ) | k > 0 ו-θ > 0 |
| Log Normal | =lognorm.dist(μ,σ) | μ > 0 ו-σ > 0 |
| נורמלית | =norm.dist(μ,σ) | σ > 0 |
| Poisson | =poisson.dist(λ) | λ > 0 |
| משולשת | =triang.dist(a,b,c) | a קטן מ-b, ו-c בין a ל-b |
| אחידה | =uniform.dist(a,b) | b > a |
| Weibull | =weibull.dist(λ,k) | λ > 0 ו-k > 0 |
משכי זמן אינם יכולים להיות שליליים: ערך שנדגם מתחת ל-0 נדגם שוב, כך שמשך נורמלי נחתך ב-0.
מאפיינים מחושבים
מאפיין COMPUTABLE מכיל משוואה על מאפיינים של ישויות אחרות. מתאים לערכים נגזרים, כמו משקל ממסה.
- יש ללחוץ על הגדרה… (או עריכה…). תיבת הדו-שיח נפתחת.
- תחת משתנים, יש ללחוץ על + הוספת משתנה.
- יש להזין שם המשתנה.
- יש ללחוץ על בחירת פריט… ולבחור את הישות.
- יש לבחור את המאפיין שלה. מוצעים מאפייני מספר, אחוז, משך ומאפיינים מחושבים.
- יש להזין את המשוואה, למשל
mass * 9.81. - יש להגדיר ספרות אחרי הנקודה (0 עד 10, ברירת מחדל 2) ויחידות התוצאה.
- יש ללחוץ על חישוב כדי לבדוק.
התוצאה מוצגת.
- יש ללחוץ על שמירה.
במשוואה, משכי זמן נספרים בשעות והתפלגויות נספרות כממוצע שלהן. המשוואה תומכת ב:
- אופרטורים
+ - * / ^ %וסוגריים. - הפונקציות
sqrt,abs,sin,cos,tan,asin,acos,atan,log(בסיס 10),ln,exp,floor,ceil,round,min,maxו-pow. - הקבועים
piו-e.
הערך מחושב מחדש כשהמאפיין של משתנה משתנה (כולל שרשראות של מאפיינים מחושבים) וכשהפרויקט נפתח. חישוב מחדש מאלץ זאת.
ערכים מהצאצאים.
משתנה יכול לקרוא את הצאצאים של הפריט עצמו במקום ישות אחת, כך שסכום נשאר עדכני כשהפירוק משתנה.
- בתיבת הדו-שיח, יש ללחוץ על + ערכי הצאצאים.
- יש לבחור את הפונקציה: סכום, ממוצע, מינימום, מקסימום או ספירה.
- יש לבחור את המאפיין. הרשימה מכילה את מאפייני המספר, האחוז, המשך והמאפיינים המחושבים של המחלקה של הפריט ושל המחלקות שמתחתיה. ספירה מציע גם פריטים, שסופר את הפריטים עצמם.
- יש לבחור של הצאצאים (הצאצאים הישירים) או של הפריטים ברמה הנמוכה ביותר (העלים של הפירוק).
- כדי לשקלל כל פריט לפי הריבוי או ה-Quantity של הפירוק שלו, כמו בצבירה, יש להשאיר את × מספר החלקים מסומן. ביטול הסימון סופר כל פריט פעם אחת.
- יש להשתמש בשם המשתנה במשוואה, למשל
total * 1.1למרווח של 10 %.
כיצד נקראים ערכי הצאצאים:
- המאפיין של צאצא הוא זה שנבחר, או מאפיין עם אותו שם במחלקה של הצאצא.
- פריטים ללא ערך מדולגים. סכום או ספירה של כלום הם 0; לממוצע, מינימום או מקסימום של כלום אין תוצאה.
- הערך מחושב מחדש כחלק מאותו שינוי (ביטול פעולה אחד מבטל את שניהם) כשערך של צאצא משתנה, כשצאצא נוסף, מועבר או מוסר, וכש-Multiplicity משתנה.
- אפשר לקרוא את הערך המחושב של צאצא עצמו, כך שכל רמה יכולה לסכם את תת-העץ שלה: למשל Total Mass =
own + kids, כש-ownהוא ה-Mass של הפריט ו-kidsהוא סכום ה-Total Mass של הצאצאים.
המאפיין מציג ⟳ מהצאצאים; הצבעה על המשוואה מציגה מה כל משתנה צאצאים קורא.
כלי ישויות
שינוי מחלקה
שינוי מחלקה משנה את המחלקה של ישות אחת או יותר. פותחים אותו עם שינוי מחלקה… במסד הנתונים, או עוד ▾ → שינוי מחלקה… בתצוגת הפריט.
- יש לבחור את המחלקה חדשה.
- כדי לשנות גם את הצאצאים בפירוק, יש לסמן את שינוי גם של הצאצאים (פירוק).
- יש לקרוא את הסיכום.
הוא מציין "N פריטים יהפכו ל-Class." אחר כך הוא מפרט מה נמחק בשמירה: קשרים שאינם מותרים במחלקה החדשה, תוויות, ערכי מאפיינים ודיאגרמות. אם דבר אינו אובד, הוא מציין "אין ישויות אחרות שמושפעות."
- יש ללחוץ על שינוי מחלקה. ההודעה הקופצת מציגה "המחלקה של N פריטים שונתה."
שינוי השדה מחלקה בתצוגת הפריט מריץ את אותה בדיקה ופותח את תיבת הדו-שיח הזו רק כשמשהו היה מוסר.
צבירה
תיבת הדו-שיח צבירה (עם שם הישות בכותרת; צבירה… במסד הנתונים, צאצאים ▾ → צבירה… בתצוגת הפריט) מחשבת ערך על העלים של הפירוק.
- מאפיין: כל מאפיין מספר, משך, רשימה או בחירה מרובה של המחלקה.
- יחידות משך (משכי זמן בלבד): אוטומטי (היחידה הגדולה ביותר שבשימוש) או יחידה קבועה מאלפיות שנייה עד שנים.
- עיגול ל- (ספרות אחרי הנקודה) (ברירת מחדל 3).
- רק הפריטים שמוצגים בתצוגה הזו (זמין כשנפתח מתצוגה שמסננת ישויות).
כיצד הערך מחושב:
- מספרים מסוכמים על העלים. כל אחד מוכפל בריבוי או ב-Quantity של הפירוק שלו. התפלגות נספרת לפי הערך האופייני שלה.
- ערכי טקסט עם יחידות (למשל "2.5 kg") מומרים ומסוכמים.
- משכי זמן מסוכמים.
- מניות ובחירות מרובות מקבלות את הערך השכיח ביותר. בתיקו, בוחרים את הערך.
התוצאה מציגה "ל-N מתוך M פריטים ברמה הנמוכה ביותר יש ערך." שמירת הערך כותב את הערך לישות פעם אחת.
עדכון חי שומר במקום זאת את הסכום עדכני. הוא מופיע כשלמחלקה יש מאפיין Computed: בוחרים אותו תחת עדכון חי ב-. עדכון חי כותב למאפיין הזה משוואה שמסכמת את המאפיין שנבחר על הפריטים ברמה הנמוכה ביותר עם מספרי החלקים שלהם (ראו מאפיינים מחושבים). הוא עובד עם מאפייני מספר, אחוז ומשך; משכי זמן מסוכמים בשעות. ללא מאפיין Computed, תיבת הדו-שיח מציינת שיש להוסיף אחד בעורך הסכמה.
חיפוש והחלפה
חיפוש והחלפה ב-N פריטים מחפש בשם, במספר ובתיאור.
- יש להקליד בחיפוש ובהחלפה ב-. התאמת אותיות רישיות בלבד הופך את החיפוש לתלוי רישיות. דילוג על פריטים נעולים (מופעל) משאיר ישויות נעולות בחוץ.
- החיפוש מתחיל כשמפסיקים להקליד. הוא מתאים את הטקסט כפי שהוקלד (ללא תווים כלליים). בבחירות גדולות כרטיס ההתקדמות מציג את הספירה של החיפוש; הקלדה נוספת מתחילה חיפוש חדש.
- התאמות מציג כמה התאמות יש ומפרט אותן עם הפריט, השדה, מספר ההתאמה והטקסט שסביבה. ביטול סימון של התאמות מדלג עליהן; בחירת הכול או כלום מחליף את כולן.
- מעל 1,000 התאמות הרשימה מציגה את 1,000 הראשונות ("2,431 התאמות; 1,000 הראשונות מוצגות."). החלפה גם של N ההתאמות שאינן מוצגות (מופעל) כולל את האחרות בהחלפה; כיבוי שלו מחליף רק את ההתאמות המסומנות ברשימה.
- החלפת הנבחרים משנה את ההתאמות המסומנות, וביטול פעולה אחד מחזיר הכול לאחור. בתיאורי טקסט עשיר משתנה רק הטקסט, לעולם לא העיצוב. החלפה גדולה מציגה את ההתקדמות שלה ("מחליף טקסט", ואחר כך "שומר את הטקסט שהוחלף"); עריכות אחרות ממתינות עד שהיא מסתיימת.
מספור מחדש של הצאצאים
מספור מחדש של הצאצאים… (עם שם הפריט בכותרת) ממספר את הפירוק שמתחת לפריט. פותחים אותו מצאצאים ▾ בתצוגת הפריט, מעוד ▾ בסרגל הפעולות המרובות של מסד הנתונים (שורה אחת) או משורש הדיאגרמה.
- קידומת: הצאצאים הופכים ל-
Prefix.1,Prefix.2וכן הלאה. קידומת שמסתיימת בסימן, כמוSR-, אינה מקבלת נקודה:SR-1,SR-1.1. כדי למספר מ-1, יש להשאיר אותה ריקה. המספר של הפריט עצמו אינו משתנה. - סדר (Actions): סדר המתאר שומר על סדר המספרים הנוכחי; סדר זרימת הפעולות עוקב אחר דיאגרמת הפעולה, וצאצאים שאינם בדיאגרמה באים אחרונים.
- צאצאים ישירים בלבד ממספר רמה אחת.
- התצוגה המקדימה מפרטת כל צאצא עם המספר הנוכחי והחדש שלו; מספרים שהשתנו מודגשים, ושורה סופרת אותם. דבר אינו משתנה עד מספור מחדש, שמחיל את הרשימה, וביטול פעולה אחד מחזיר הכול לאחור. מספור מחדש אינו זמין כשכל המספרים כבר תואמים.
שיטת מספור
העדפות הפרויקט… → מספור מגדיר את ברירות המחדל של מספור מחדש של הצאצאים… בפרויקט הזה. שיטת המספור של הפרויקט… בתיבת הדו-שיח פותח את אותן הגדרות.
| הגדרה | אפשרויות | ברירת מחדל |
|---|---|---|
| סדר הצאצאים | סדר המתאר (המספרים הנוכחיים), סדר זרימת הפעולות (Actions) | סדר המתאר |
| קידומת | המספר של ההורה, ללא קידומת, טקסט קבוע (עם טקסט הקידומת, למשל SR-) | המספר של ההורה |
| מספר ראשון | התחלה מ-1, התחלה מ-0 | התחלה מ-1 |
ביטול פעולה אחד מבטל שינוי שיטה שנשמר. מסמכים שומרים על הגדרות מספור משלהם (ראו מסמכים → מספור מחדש).
העתקה עם צאצאים
תיבת הדו-שיח שכפול (עם שם הישות בכותרת) מעתיקה את הישות, הפירוק שלה והדיאגרמות שלהם כישויות חדשות. שם הישות נותן שם לעותק (ברירת מחדל "עותק של …"). עבור Actions, שכפול גם של ישויות הסימולציה (Assets ו-Costs מבצעים) מעתיק גם אותן. קשרים לישויות שמחוץ לשכפול ממשיכים להצביע על המקוריות.
שכפול
מעתיק ישות אחת (מחלקה, מספר, תיאור, מאפיינים, תוויות, תמונה וכל הקשרים עם המאפיינים שלהם) כ-"עותק של …". העותק אינו נעול.
היסטוריה וחזרה לגרסה קודמת
ההיסטוריה מציגה כל שינוי בישות ומאפשרת לחזור לגרסה קודמת. כל יצירה, עריכה, שינוי קשר, מחיקה ושחזור נרשמים.
אפשר לפתוח את ההיסטוריה בכל אחת מהדרכים האלה:
- היסטוריה… בכותרת הדף של תצוגת הפריט.
- פרטים → היסטוריה (הלחצן N שינויים…) בחלונית המאפיינים או בתצוגת הפריט.
- עוד ▾ → היסטוריה… בסרגל הפעולות המרובות של מסד הנתונים.
תיבת הדו-שיח היסטוריה מפרטת גרסאות, החדשה ביותר קודם. כל שורה מציגה גרסה N, את התאריך ולפני כמה זמן, את המחבר בשירות המתארח, ותיאור קצר של מה שהשתנה, למשל "Changed Status and Verifiable" או "Added satisfied by F1 Detect Wrong-Way Entry". היא אינה מציגה את הערכים.
לחיצה על גרסה (או הקשה על Enter או Space עליה) פותחת אותה לסקירה בחלון גדול יותר:
- כל שינוי בגרסה הזו, עם הסוג שלו, השדה והשינוי מסומן: מילים שהוסרו מחוקות בקו על רקע אדום, מילים שנוספו על רקע ירוק. הטקסט מושווה מילה במילה, ומשפט שהועבר מוצג בסגול בשני המקומות עם קישור יעד ההעברה / מקור ההעברה ביניהם; ערך קצר מוצג כישן → חדש; קשר מוצג כ-Added <item> או Removed <item>. קוראי מסך מכריזים על הסימונים כטקסט שנמחק וטקסט שהוכנס.
- ‹ הקודם (ישנה יותר) והבא › (חדשה יותר), וגם ← ו-→, עוברים בין הגרסאות באותו חלון.
- חזרה לגרסה N (לא בגרסה הנוכחית).
- Esc או סגירה חוזרים לרשימה, באותה גרסה.
סוגי השינויים:
| סוג | משמעות |
|---|---|
CREATED, REMOVED, RESTORED | הישות נוצרה, נמחקה או שוחזרה |
METADATA | שם, מספר, תוויות או שדה אחר השתנו |
DESCRIPTION | התיאור השתנה (מסומן מילה במילה) |
CLASS_ID | המחלקה השתנתה |
IMAGE_ID | התמונה השתנתה |
ATTRIBUTE | ערך של מאפיין השתנה (מ- → ל-) |
RELATIONSHIP | קשר נוסף או הוסר |
RELATIONSHIP_ATTRIBUTE | מאפיין של קשר השתנה |
WORKFLOW | רישום של אישור, בדיקת קישורים או איכות השתנה |
QUALITY | הערות בדיקת האיכות השתנו |
חזרה לגרסה N מבטל בצעד אחד כל שינוי מאוחר יותר בישות הזו, בשדות שלה ובקשרים שלה. אפשר לבטל את הפעולה.
סל המחזור של הפרויקט
סל המחזור של הפרויקט מכיל את הישויות שנמחקו בפרויקט הזה. כל רשומה נשארת 30 יום ואז מוסרת אוטומטית, גם בפרויקטים שאף אחד אינו פותח. אין מגבלה על מספר הרשומות. פריטים שכבר היו בסל המחזור לפני שמגבלת 30 הימים הוכנסה מקבלים 30 יום מהפעם הראשונה שהפרויקט נפתח אחרי השדרוג, לא ממועד המחיקה; בשרת, פרויקטים שאף אחד אינו פותח נספרים מהשדרוג. פריטים שנמחקו לעולם אינם מוצגים מחוץ לפרויקט שלהם: סל המחזור בניהול פרויקטים מכיל רק פרויקטים שנמחקו (ראו שיתוף ועבודה משותפת).
פותחים אותו עם סל המחזור בכלי הסרגל (ליד מסד הנתונים ודיאגרמות), עם ⌘K / Ctrl+K → סל המחזור, או עם פתיחת סל המחזור בהודעה שאחרי הסרה.
מה עובר לסל המחזור
- ישויות שנמחקו: Shift+Delete, מחיקת הפריט…, מחיקת הפריט…, מחיקת N פריטים… של סרגל הפעולות המרובות, מחיקות דרך ה-API ומחיקות שהוחלו מבקשות שינוי או מהצעות AI.
- ישויות שהוסרו ושדבר כבר אינו מחזיק בהן: הסרה בדיאגרמה, במסמך או במצגת מוציאה פריט מהתצוגה הזו בלבד. כשהישות נשארת בלי קשרים בכלל, היא עוברת לסל המחזור כחלק מאותו שינוי, כך שביטול פעולה אחד מחזיר את שניהם. ההודעה מציגה אז "הוסר מהדיאגרמה והועבר לסל המחזור." (או "הוסר מהמסמך והועבר לסל המחזור.", "הוסר מהמצגת והועבר לסל המחזור.") ומציעה ביטול פעולה ופתיחת סל המחזור. כשרק חלק מהישויות שהוסרו הועברו, ההודעה מציינת כמה: "הוסרו 3 ישויות מהדיאגרמה. לאחת מהן לא נשארו קשרים והיא הועברה לסל המחזור."
- ישות נשארת בפרויקט, גם ללא קשרים, כשהיא נעולה או בקו בסיס, כשהיא מסמך, כשיש לה דיאגרמה משלה, כשהיא מצוטטת בטקסט עשיר (ערך ישות, קישור, הפניה צולבת או תמונת דיאגרמה בתיאור או במסמך כלשהו), או כשהיא מופיעה בדיאגרמה או בלוח ציור אחרים.
- הסרת פריטים מלוחות שנה, מלוחות ומתרשימים משנה רק מאפיין; הישויות האלה לעולם אינן עוברות לסל המחזור.
צאצאים של ישות שנמחקה
מחיקת ישות לעולם אינה משאירה את הצאצאים שלה ללא הורה. כל צאצא עולה להורה של הישות שנמחקה, עם אותו קשר (decomposed by; source of למסמכים; referenced by ל-Test Suites), במקום של הישות שנמחקה במספור. כשלישות יש כמה הורים, ההורה שמוצג בדיאגרמה שממנה מוחקים בא ראשון. ללא הורה, הצאצאים הופכים לפריטים ברמה העליונה. זה חלק מאותו שינוי, כך שביטול פעולה אחד מחזיר הכול לאחור.
האישור מציין לאן הצאצאים הולכים, למשל '3 הצאצאים שלו עולים אל "F.1 Collect Data".' או '3 הצאצאים שלו הופכים לפריטים ברמה העליונה.'. סימון מחיקת הצאצאים גם כן מוחק במקום זאת את הענף כולו: השורה משתנה ל-'3 הצאצאים שלו ו-12 הפריטים שתחתם נמחקים גם כן.'. התיבה מתחילה לא מסומנת בכל פעם. למסמכים יש כלל משלהם: מחיקת מקטע מוחקת את התוכן שלו.
הדף סל המחזור
הרשומות מוצגות מהחדשה ביותר. כל שורה מציגה:
| עמודה | מציג |
|---|---|
| סוג | המחלקה של הישות |
| ישות | מספר ושם |
| נמחק | מתי היא נמחקה |
| סיבה | נמחק, נמחק עם N פריטים תחתיו, או הוסר מ-<view>; לא נשארו קשרים (למשל "הוסר מ-Launch Sequence (Action Diagram); לא נשארו קשרים") |
| נשמר למשך | הימים שנותרו עד להסרה האוטומטית |
| קשרים | כמה קשרים היו לה |
- יש להקליד בסינון לפי שם, מספר, מחלקה או סיבה כדי לצמצם את הרשימה.
- שחזור מחזיר את הישות עם אותו מזהה, הדיאגרמות שלה, התגובות שלה והקשרים שלה לישויות שנמצאות בפרויקט. צאצאים שעלו כשהיא נמחקה חוזרים תחתיה. ישות שנמחקה עם מחיקת הצאצאים גם כן משוחזרת עם הענף שלה.
- ⋯ → תצוגה מקדימה מציג את הרשומה לקריאה בלבד: מחלקה, מספר, זמן המחיקה, סיבה, הימים שנותרו, תיאור, מאפיינים, קשרים, הצאצאים שעלו, ומופנה ב: הטקסטים שעדיין מצטטים אותה.
- ⋯ → מחיקה לצמיתות… שואל "מוחק את "<entity>" לצמיתות: לא ניתן יהיה לשחזר אותו מסל המחזור. ביטול עם ⌘Z / Ctrl+Z." ומסיר את הרשומה.
- ישות שהוחזרה בדרך אחרת (שחזור קו בסיס של פרויקט, החזרת מסמך לקו הבסיס שלו או שחזור המסמך עבור קו בסיס יתום) יוצאת מסל המחזור כחלק מאותו שחזור; ביטול השחזור מחזיר את הרשומה שלה.
- שחזור הכול משחזר כל רשומה; עם 5,000 רשומות ומעלה מוצג כרטיס התקדמות בזמן הפעולה. ריקון סל המחזור שואל "מוחק לצמיתות את N הישויות שבסל המחזור: לא ניתן יהיה לשחזר אותן. ביטול עם ⌘Z / Ctrl+Z.".
- צופים וסוקרים רואים את סל המחזור אבל אינם יכולים לשחזר או למחוק.
שחזור ישות שנמחקה
- יש לפתוח את סל המחזור בכלי הסרגל.
- יש להקליד חלק מהשם בשדה הסינון.
- יש ללחוץ על שחזור בשורה שלה. ההודעה "שוחזר "<entity>"." מאשרת זאת, והישות חוזרת לדיאגרמות ולדפים שלה.
הערה: הפניות לישות שנמחקה בטקסט עשיר (ערכי ישות, קישורים, הפניות צולבות, תמונות דיאגרמה) מוצגות כחסרות עד שהיא משוחזרת. היא שומרת על המזהה שלה, ולכן הן חוזרות איתה.
תגובות
תגובות מצרפות הערות סקירה לישות. הן נמצאות במקטע דיון של חלונית המאפיינים ושל תצוגת הפריט, ובחלונית התגובות של מסמך.
- יש להקליד בהוספת תגובה… וללחוץ על הוספת הערה. התגובה רושמת את התאריך ואת שם החשבון שלך.
- ✎ עורך (התגובה מסומנת "(נערך)"), ✓ פותר, ↺ פותח מחדש ו-× מוחק.
- תגובה מתחת לתגובה פותח תיבת תשובה; הוספת תגובה מפרסם אותה. תשובות מוזחות מתחת לתגובה שהן עונות לה, ותשובה לתשובה מצטרפת לאותו שרשור.
- ✓ ו-↺ פועלים על כל השרשור. מחיקת התגובה הראשונה בשרשור מוחקת את התשובות שלה; Holarch שואל קודם ("למחוק את התגובה הזו ואת N התשובות שלה?").
- תגובות שנפתרו מוסתרות; הצגת שנפתרו (N) כולל אותן.
- ישות עם תגובות שלא נפתרו מציגה 💬 במסד הנתונים וספירה בקישור דיון.
is:commentedמוצא אותן. - תגובות מותרות בישויות נעולות. צופים קוראים תגובות אבל אינם יכולים להוסיף או לשנות אותן ("צפייה בלבד: הערות דורשות הרשאת עריכה.").
- החלונית דיונים פתוחים בבית מפרטת את התגובות שלא נפתרו, וייצוא… → תגובות (Excel) מייצא אותן.
נעילות
נעילת ישות מגינה עליה מפני שינויים בטעות, למשל אחרי אישור.
- נועלים ישות עם הלחצן 🔒 בכותרת הדף של תצוגת הפריט, או מסמנים שורות ולוחצים על נעילה בסרגל הפעולות המרובות של מסד הנתונים.
- ביטול נעילה הופך זאת. חלונית המאפיינים של פריט נעול מציגה "🔒 פריט נעול. יש לבטל את הנעילה כדי לערוך." עם ביטול נעילה.
- ישות נעולה דוחה עריכות של השדות שלה, שינויי מחלקה, מחיקה, והוספה או הסרה של קשרים בכל אחד מהקצוות. העורכים שלה מושבתים.
- כל מי שיש לו הרשאת עריכה יכול לנעול ולבטל נעילה. נעילות נרשמות בהיסטוריה.
is:lockedוהמסנן נעול מוצאים ישויות נעולות.
מחיקה ושחזור
- מוחקים מסרגל הפעולות המרובות (מחיקת הפריט…), מתצוגת הפריט (עוד ▾ → מחיקת הפריט…), או מדיאגרמה או ממסמך. ישויות נעולות אינן נמחקות.
- ישויות שנמחקו עוברות לסל המחזור של הפרויקט עם הקשרים, הדיאגרמות והתגובות שלהן. שחזור מחזיר אותן עם אותו מזהה.
- ביטול פעולה (⌘Z / Ctrl+Z) מבטל גם מחיקה.
גישת צפייה בלבד
בשירות המתארח, חבר בפרויקט עם תפקיד הצופה יכול לפתוח כל דף, לחפש ולהריץ דוחות, אבל אינו יכול לשנות דבר. העורכים מושבתים, וכל ניסיון שינוי מציג "צפייה בלבד: אפשר לבקש מהבעלים הרשאת עריכה."
קיצורי מקלדת ומחוות
| מקש או מחווה | היכן | פעולה |
|---|---|---|
| Enter | תיבת חיפוש | החלת השאילתה; מונחי מסנן מובילים הופכים לשבבים |
| Backspace / Esc | תיבת חיפוש ריקה / תיבת חיפוש עם טקסט | הסרת השבב האחרון / ניקוי טקסט החיפוש |
| ↑ / ↓, Enter | הרשימות + מסנן ועמודות ▾ | מעבר בין אפשרויות / הפעלה או כיבוי של אחת (הרשימה נשארת פתוחה) |
| ↑ / ↓, Home / End | שורה בפוקוס | מעבר לשורה הקודמת / הבאה / הראשונה / האחרונה |
| Esc | מסד הנתונים | ביטול הבחירה של השורה הנבחרת (כשלא מקלידים ואין תיבת דו-שיח פתוחה) |
| לחיצה | שורת טבלה | בחירה והצגה בחלונית המאפיינים |
| לחיצה כפולה | שורת טבלה | פתיחת תצוגת הפריט |
| לחיצה כפולה | תא מספר או תיאור | עריכה במקום |
| Enter / Shift+Enter / Esc | תא בעריכה | שמירה / מעבר שורה (תיאור) / ביטול |
| Shift+לחיצה | תיבת סימון של שורה | סימון או ביטול סימון של טווח |
| לחיצה ימנית, Shift+F10, מקש התפריט, נגיעה והחזקה | שורת טבלה | פתיחת תפריט הלחיצה הימנית של השורה |
| ⌥ / Alt+לחיצה ימנית | שורת טבלה | הצגת התפריט של הדפדפן עצמו |
| לחיצה / לחיצה נוספת | כותרת עמודה | מיון / היפוך |
| ▾, לחיצה ימנית | כותרת עמודה | תפריט העמודה |
| גרירה / לחיצה כפולה | קצה כותרת העמודה | שינוי גודל / איפוס הרוחב |
| גרירה | תצוגה שמורה | סידור מחדש בין תצוגות עם אותו שיתוף |
| ⌘ / Ctrl+Z / ⌘ / Ctrl+Shift+Z | בכל מקום | ביטול פעולה / ביצוע חוזר (Ctrl ב-Windows וב-Linux) |
כל הקיצורים: קיצורי מקלדת.
אפשרויות והגדרות
נשמר בדפדפן הזה:
- הגדרות תצוגת מסד הנתונים: מיון וכיוון, עמודות, רוחבי עמודות, עץ, הצגת תיאורים מלאים ומיקום הגלילה. ⋯ → איפוס עמודות, מיון ועץ בחלונית התצוגות מנקה אותן. הגדרות מגרסאות קודמות עוברות: גובה שורה מעל 1× מפעיל את הצגת תיאורים מלאים; גודל העמוד, יישור הטקסט וזכירת מיקום הגלילה כבר אינם בשימוש.
- התצוגות השמורות שלך (לא משותפות).
- יחסים שנשארים גלויים לכל מחלקה, הצגת כל הקשרים, יחסים מכווצים, הצגת שנפתרו ומצב הפתיחה של הקבוצה איכות.
נשמר בפרויקט: תצוגות משותפות, ישויות, קשרים, תגובות, היסטוריה וסל המחזור של הפרויקט.
הודעות
| הודעה | משמעות ותיקון |
|---|---|
| "אין ישויות שתואמות לחיפוש או למסננים. יש לנקות אותם כדי לראות את כל הישויות." | אף ישות אינה עוברת את החיפוש והמסננים. יש להסיר שבבים עם ה-× שלהם, או ללחוץ על ניקוי. |
| "יש להוסיף מחלקה תחילה: המאפיינים שלה מופיעים כאן." | + מסנן מפרט מאפיינים רק עבור המחלקות שבשאילתה. יש להוסיף שבב מחלקה. |
| "יש להזין ערך, או לבחור "ריק"." | מסנן מאפיין דורש ערך. |
| "עמודה קשורה עוקבת אחר 4 קשרים לכל היותר." | עמודה קשורה… אינו מוצע לעומק רב מזה. |
| "יש להוסיף ישות עם + פריט חדש, או לייבא קובץ CSV." | בפרויקט עדיין אין ישויות. |
| "הוסרו N עמודות שהמאפיין או היחס שלהן כבר אינם קיימים." | עמודה הפנתה למאפיין או ליחס שנמחקו; היא הוסרה. |
| "טבלה צריכה לפחות עמודה אחת. יש להשאיר עמודה אחת." | רשימת העמודות אינה יכולה להיות ריקה. |
| "למחלקות שנבחרו אין תוויות משותפות" | למחלקות של הישויות המסומנות אין תווית משותפת. |
| "יש לבחור קשר ולפחות יעד אחד." | קשרים… דורש את שניהם לפני החלה. |
| "נוצרו N קשרים, דולגו M שהסכמה אינה מתירה" | חלק מזוגות המקור והיעד אינם מותרים עבור היחס הזה. |
| "ל-Class לא יכול להיות "relation"" | המחלקה של השורה אינה מתירה את היחס של עמודת הקשר הזו. |
| "יש לתת לפריט שם או מספר." | השם והמספר אינם יכולים להיות ריקים שניהם. |
| "אי אפשר לשנות ישויות נעולות. יש לבטל את הנעילה שלהן קודם." | יש לבטל את הנעילה של הישות (או של הישות שבקצה השני של הקשר). |
| "אי אפשר למחוק ישויות נעולות. יש לבטל את הנעילה שלהן קודם." | ישויות נעולות במחיקה דולגו. |
| "פריטים נעולים לא יכולים לשנות מחלקה. יש לבטל את הנעילה קודם." | יש לבטל את הנעילה לפני שינוי המחלקה. |
| "מסמך יכול לשנות מחלקה רק כשיש לו צאצא אחד לכל היותר." | מוצג בשינוי מחלקה כשמחלקת היעד היא מחלקת מסמך. |
| "צפייה בלבד: אפשר לבקש מהבעלים הרשאת עריכה." | התפקיד שלך בפרויקט הזה הוא צופה. |
| "התמונה חורגת ממגבלת N MB." / "קבצים מעל N MB אינם נשמרים; נשמר רק השם." | הקובץ גדול ממגבלת הגודל לקובץ. |
| "יש להזין מספר." / "האחוז חייב להיות 0 לפחות." / "האחוז חייב להיות 100 לכל היותר." | קלט בשדה אחוז. |
| "זה אינו מספר. יש להזין מספר." / "זו אינה התפלגות תקפה." / "הצורה הצפויה היא =norm.dist(mu, sigma)" / "הפרמטרים חייבים להיות מספרים. יש להזין מספר לכל פרמטר." | קלט של מספר או התפלגות; גם בדיקות פרמטרים כמו "Sigma חייב להיות גדול מ-0." או "B חייב להיות גדול מ-A." |
| "יש להשתמש ב-n, ב-n..m או ב-n..*" | קלט ריבוי. |
| "שם משתנה לא תקף "x": הוא חייב לכלול אות, לא יכול להתחיל בספרה, ולא יכול להיות "i" או "e"." / "למשתנה "x" אין ישות (ייתכן שהיא נמחקה)." / "שם לא מוכר "x"" / "למשוואה אין תוצאה סופית. יש לבדוק חלוקה באפס." | שגיאות של מאפיינים מחושבים. |
| "אין מה לצבור: לאף ישות בהיררכיה הזו אין ערך למאפיין שנבחר." | הצבירה לא מצאה ערכים בעלים. |
| "ל-Class אין מאפייני מספר, משך או רשימה לצבירה." | צבירה אינה אפשרית למחלקה הזו. |
| "אין התאמות." / "לא נבחר דבר." | חיפוש והחלפה לא מצא דבר, או שאף התאמה אינה מסומנת. |
| "לישות הזו אין שינויים רשומים." | ההיסטוריה ריקה. |
| "אין תצוגה מקדימה לסוג הקובץ הזה. יש להוריד את הקובץ כדי לפתוח אותו." | יש להוריד את הקובץ במקום זאת. |
מגבלות
- שם ומספר: 255 תווים כל אחד.
- הטבלה מציירת את כל השורות עד 200; מעבר לזה, רק את השורות שליד מיקום הגלילה (השאר מצוירות תוך כדי גלילה).
- בוררי ישויות ורשימות יעדים של פעולות מרובות מציגים את 300 ההתאמות הראשונות; הקלדה מצמצמת אותן.
- סל המחזור של הפרויקט שומר כל רשומה 30 יום, ללא מגבלה על מספר הרשומות.
- פרויקט שומר עד 4,000 רשומות היסטוריה; מעבר לזה 1,000 הישנות ביותר יוצאות מהפרויקט. הן נשארות קריאות תחת שינויים קודמים בהיסטוריה… של פריט ודרך טעינת שינויים קודמים בפעילות (ב-app.holarch.app: תוכניות Individual ו-Team). פעולה שיוצרת יותר מ-500 פריטים (ייבוא) יוצאת כרשומת סיכום אחת, לא פריט אחר פריט.
- ביטול הפעולה שומר את 200 הצעדים האחרונים של ההפעלה. ביישום השולחני, צעדים גדולים מאוד (ייבוא או שינוי מרובה של מודל גדול) שומרים פחות: היסטוריית הביטול מחזיקה לכל היותר כ-48 מיליון תווים של נתונים שהשתנו, ותמיד את הצעד האחרון.
- עמודה קשורה עוקבת אחר 4 קשרים לכל היותר מהשורה (עמודות שנשמרו קודם עם עד 8 עדיין מוצגות).
- תמונות וקבצים: חלה מגבלת הגודל לקובץ של השירות המתארח (10 MB בתוכנית Free, 25 MB ב-Individual, 100 MB ב-Team). תמונות PNG, JPEG ו-WebP שרוחבן או גובהן מעל 4,000 px מוקטנות בשמירה.
קשור
- סכמה והרחבות: מחלקות, מאפיינים, יחסים, תוויות ותהליכי עבודה.
- דרישות: סטטוס, אישור, בדיקות איכות, TBD/TBR וקישורים לסקירה.
- עקיבות: המטריצה, הכיסוי וההשפעה.
- ייבוא וייצוא: CSV, Excel, Word, ReqIF וקובצי פרויקט.
- צעדים ראשונים: המעטפת, חלונית המאפיינים ולוח הפקודות.
- עזרה: מסד הנתונים, תצוגת פריט, תחביר שאילתות חיפוש, מסננים ותצוגות שמורות, סוגי מאפיינים והתפלגויות, תגובות וסקירות, יסודות LML.