Holarch

הדרכה · מסלול 6. מעבר ל-Holarch

מסלול 6. מעבר ל-Holarch: דף תרגילים

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

לפני שמתחילים

מומלץ קודם
מסלול 1. תחילת עבודה, פרקים 1.1 עד 1.3.
תוכנית
Free
פרויקט
קובצי הדרישות שלכם, או קבצים שמייצאים מהדגמת EO-1 לצורך תרגול.

6.1 תכנון הגירה

צפייה בפרק 6.1 (3:00)

תרגול

על פרויקט ההדגמה CubeSat EO-1:

  1. פותחים את פרויקט ההדגמה EO-1 (אם אין לכם, יוצרים אותו: ניהול פרויקטים ← קובצי פרויקט ▾ ← פרויקט הדגמה חדש ← CubeSat (הנדסת מערכות מודרכת)).
  2. פותחים את הגדרות ← סכמה בפס הניווט, לוחצים על דרישה תחת מחלקות, ורושמים את המאפיינים שגיליון דרישות יכול למלא (למשל Priority, Owner, Verification Method).
  3. פותחים את הדף תוויות של הסכמה ומוצאים היכן נשמרים סוגים כמו Performance Requirement.
  4. נניח שבמעקב של ספק יש עמודה Supplier Ref שאין לה מקום: ב-דרישה לוחצים על + מאפיין, נותנים לו את השם Supplier Ref, בוחרים סוג טקסט ולוחצים על הוספת מאפיין.
  5. פותחים את צרכים ודרישות ← ייבוא וייצוא וקוראים אילו פורמטים אזור השחרור מקבל ומה הכרטיס ייצוא מציע.

סיימתם כש-Supplier Ref הוא האחרון ברשימת המאפיינים של Requirement ואתם יכולים לומר לאן תלך כל עמודה של מעקב טיפוסי.

שאלות

  1. למה להחליט לאן הולך כל סוג נתונים לפני הייבוא?
  2. לעמודה אין מאפיין תואם. מהן האפשרויות?
  3. ייבוא השתבש. איך מבטלים אותו?
  4. מתי משתמשים ב“ניהול פרויקטים ← ייבוא פרויקט (.json)…” במקום בדף הייבוא?

6.2 דרישות מ-Excel ומ-CSV

צפייה בפרק 6.2 (2:32)

תרגול

על פרויקט ההדגמה CubeSat EO-1:

  1. פותחים את פרויקט ההדגמה EO-1 (אם אין לכם, יוצרים אותו: ניהול פרויקטים ← קובצי פרויקט ▾ ← פרויקט הדגמה חדש ← CubeSat (הנדסת מערכות מודרכת)). במסד הנתונים מחפשים class:Requirement, לוחצים על ייצוא…, בוחרים טבלה (CSV), מסמנים סטטוס ו-עדיפות (משאירים את תוויות מסומן) ולוחצים על ייצוא.
  2. פותחים את הקובץ ביישום גיליונות אלקטרוניים. משאירים את הכותרת ואת השורות של סעיפים 1 ו-2, ומוסיפים שתי שורות בראש: 1, ‏Mission Imaging, ‏Class Statement, וכן 2, ‏Attitude Determination and Control, ‏Class Statement. שומרים כ-.xlsx או כ-.csv.
  3. בניהול פרויקטים לוחצים על + פרויקט חדש, נותנים לו את השם EO-1 Import Practice ולוחצים על יצירת פרויקט.
  4. פותחים את צרכים ודרישות ← ייבוא וייצוא, משחררים את הקובץ, לוחצים על המשך ובודקים את שדה Holarch של כל עמודה (כל עמודה שלא רוצים מגדירים ל-דילוג).
  5. לוחצים על המשך, משאירים את יצירת מסמך מ-N הפריטים האלה מסומן ולוחצים על ייבוא N פריטים.
  6. במסמך החדש בודקים ש-1.6.1 ו-1.6.2 נמצאים תחת 1.6, ובוחרים את 1.5 כדי לראות את התוויות והסטטוס שלה.

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

שאלות

  1. איך Holarch בונה מחדש את ההיררכיה של שורות הגיליון?
  2. חלק מהשורות נכנסו עם מחלקה שגויה. למה?
  3. רוצים לעדכן את הבעלים של 50 דרישות קיימות מגיליון, בלי ליצור עותקים. איך?

6.3 דרישות מ-Word ומ-ReqIF

צפייה בפרק 6.3 (2:22)

תרגול

על פרויקט ההדגמה CubeSat EO-1:

  1. פותחים את פרויקט ההדגמה EO-1 (אם אין לכם, יוצרים אותו: ניהול פרויקטים ← קובצי פרויקט ▾ ← פרויקט הדגמה חדש ← CubeSat (הנדסת מערכות מודרכת)). פותחים את מסמכים ← EO-1 System Requirements Specification ולוחצים על מסירה ▾ ← מפרט (Word).
  2. באותו מסמך לוחצים על מסירה ▾ ← דרישות (ReqIF)… ולוחצים על ייצוא.
  3. בניהול פרויקטים לוחצים על + פרויקט חדש, נותנים לו את השם EO-1 Import Practice ולוחצים על יצירת פרויקט. פותחים את צרכים ודרישות ← ייבוא וייצוא, משחררים את קובץ ה-.docx, לוחצים פעמיים על המשך ומייבאים אותו.
  4. משווים את המסמך החדש ל-SRS: שמים לב אילו כותרות הפכו ל-Statements ואילו משפטי shall הפכו ל-Requirements, ואיך הם נקראו.
  5. מייבאים את קובץ ה-.reqif לאותו פרויקט, ואז פותחים את המסמך שהוא יוצר ובוחרים את 1.6 Revisit Time כדי לבדוק את הצאצאים והתוויות שלה.

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

שאלות

  1. מה ייבוא ה-Word קורא כסעיף, ומה כדרישה?
  2. ספק יכול לשלוח Word או ReqIF. למה לבקש ReqIF?
  3. לקשר ב-ReqIF יש שם ש-Holarch לא מכיר. מה קורה?

6.4 מודלים מכלים אחרים

צפייה בפרק 6.4 (2:44)

תרגול

על פרויקט ההדגמה CubeSat EO-1:

  1. פותחים את פרויקט ההדגמה EO-1 (אם אין לכם, יוצרים אותו: ניהול פרויקטים ← קובצי פרויקט ▾ ← פרויקט הדגמה חדש ← CubeSat (הנדסת מערכות מודרכת)). פותחים את צרכים ודרישות ← ייבוא וייצוא, לוחצים על ייצוא UML/SysML (XMI)… בכרטיס הייצוא, משאירים את פורמט על OMG XMI 2.5.1 (.xmi) ולוחצים על ייצוא. הקובץ הזה מחליף ייצוא מכלי SysML כמו Cameo או Enterprise Architect.
  2. בניהול פרויקטים לוחצים על + פרויקט חדש, נותנים לו את השם EO-1 Import Practice ולוחצים על יצירת פרויקט. פותחים את צרכים ודרישות ← ייבוא וייצוא, משחררים את קובץ ה-.xmi, בודקים שפורמט מציג UML/SysML (.xmi, .uml, .mdzip), לוחצים פעמיים על המשך, קוראים את סקירה ולוחצים על ייבוא N פריטים.
  3. במסד הנתונים מחפשים class:Asset, בוחרים את Payload Camera ובודקים בעקיבות שהיא חלק מ-EO-1 Spacecraft ואילו פעולות היא מבצעת.
  4. פותחים את דיאגרמות, לוחצים על + דיאגרמה חדשה, בוחרים דיאגרמת Asset, בוחרים את EO-1 Spacecraft ב-דיאגרמה של ולוחצים על יצירה.
  5. מפעילים את Actions מבוצעות כדי להציג את הפונקציות של כל תת-מערכת.

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

שאלות

  1. אילו קבצים מכלי SysML v1 אפשר לייבא ל-Holarch, ואיך משיגים אותם?
  2. למה אפשר לבנות מחדש דיאגרמות במהירות אחרי ייבוא?
  3. מייבאים ייצוא מאוחר יותר של אותו מודל. למה לא מתקבלים עותקים?

6.5 ניקוי אחרי ייבוא

צפייה בפרק 6.5 (2:40)

תרגול

על פרויקט ההדגמה CubeSat EO-1:

  1. פותחים את הפרויקט EO-1 Import Practice מהפרקים הקודמים (או מייבאים קובץ CSV של הדרישות של EO-1 כמו בפרק 2).
  2. פותחים את צרכים ודרישות ← איכות, בוחרים אחד מהמסמכים המיובאים בסרגל ההיקף ולוחצים על בדיקת איכות.
  3. אם ייבאתם את אותן דרישות פעמיים (Word ו-ReqIF), מסמנים את השורה של דרישה כפולה במסד הנתונים ומוחקים אותה עם מחיקת הפריט… בסרגל הפעולות המרובות. מנסחים מחדש את 2.5 Safe Mode Recovery כך שתהיה מדידה, ואז בודקים שוב את האיכות.
  4. פותחים את אימות ← בדיקות המודל ופותחים את הכלל Requirement.8, דרישות עלה ששום ישות תכן לא עונה עליהן.
  5. אם ייבאתם גם את הנכסים (פרק 4), בוחרים את 2.1 Pointing Accuracy, ובעקיבות מוסיפים satisfied by עם + ← קישור פריט קיים… אל ADCS. מריצים שוב את בדיקות המודל.

סיימתם כש-2.5 מקבלת ציון גבוה יותר מקודם ו-Requirement.8 כבר לא מציג את 2.1.

שאלות

  1. על מה בדיקת האיכות מסתכלת, ועל מה בדיקות המודל מסתכלות?
  2. למה ציון האיכות האוטומטי אף פעם לא עולה מעל 78%?
  3. למה לחבר דרישות וחלקים מיד אחרי מעבר?

מפתח תשובות

6.1 תכנון הגירה

  1. נתונים שנכנסים למחלקות, לתוויות, למאפיינים ולקשרים הנכונים עובדים מיד בעקיבות, בבדיקות האיכות ובדוחות. תיקון שלהם אחרי הייבוא פירושו עריכה ידנית של פריטים רבים.
  2. מוסיפים את המאפיין ב“הגדרות ← סכמה” לפני הייבוא, או ממפים את העמודה ל“מאפיין חדש (נוסף לסכמה)” בשלב המיפוי.
  3. לוחצים פעם אחת ⌘Z / Ctrl+Z: ייבוא מדף הייבוא הוא צעד ביטול אחד.
  4. כדי לשחזר פרויקט שלם כפרויקט חדש ונפרד. דף הייבוא ממזג את הפריטים של קובץ לתוך הפרויקט הפתוח.

6.2 דרישות מ-Excel ומ-CSV

  1. מעמודת “מזהה שורת ההורה” או “מספר ההורה” אם מופו, ואחרת ממספר המתאר: 1.2 נכנס תחת 1. אם ההורה חסר, משתמשים באב הקדמון הקיים הקרוב ביותר.
  2. עמודת Class עם שמות שהסכמה לא מכירה חוזרת אל “מחלקה לשורות ללא מחלקה”, עם אזהרה. יש להשתמש בשמות המחלקות מעורך הסכמה.
  3. מייצאים אותן עם עמודת ה-ID, עורכים את הקובץ ומייבאים אותו כשעמודת ה-ID ממופה ל“מזהה גלובלי” ו“התאמת ישויות קיימות לפי” מוגדר ל“מזהה גלובלי”. שלב הסקירה מציג אותן אז תחת “פריטים שעודכנו”.

6.3 דרישות מ-Word ומ-ReqIF

  1. פסקאות בסגנונות כותרת של Word הופכות ל-Statements (סעיפים). פסקה עם shall,‏ must,‏ will או should הופכת ל-Requirement, שנקראת על שם המילים הראשונות אחרי הפועל. כותרות שהוקלדו כטקסט מודגש רגיל נקראות כטקסט רגיל.
  2. ReqIF נושא את המזהה, ההיררכיה, המאפיינים והקשרים של כל דרישה. כשהספק שולח קובץ חדש יותר, הייבוא שלו מעדכן את אותם פריטים במקום להוסיף עותקים.
  3. הוא נכנס כ-traced to. אם הסכמה לא מתירה traced to בין שתי המחלקות, הקשר מדולג עם אזהרה.

6.4 מודלים מכלים אחרים

  1. XMI 2.x עם פרופיל SysML 1.x מ-Cameo/MagicDraw,‏ Enterprise Architect,‏ Rhapsody או Papyrus (מייצאים אותו מהכלי), פרויקט Cameo או MagicDraw בפורמט .mdzip ישירות, וקובץ Papyrus בפורמט .uml. דרישות בלבד יכולות להגיע גם כ-ReqIF, וטבלאות כ-Excel או CSV.
  2. פריסות דיאגרמות מכלי אחר לא מיובאות, אבל הקשרים כן. Holarch משרטט דיאגרמות Asset, היררכיה ואחרות מתוך הקשרים האלה.
  3. כל פריט מיובא שומר את מזהה ה-XMI שלו, ו“התאמת ישויות קיימות לפי” מוגדר כברירת מחדל ל-XMI ID עבור קובצי XMI, כך שהייבוא המאוחר מעדכן את אותם פריטים. קשרים שכבר קיימים לא נוספים פעמיים.

6.5 ניקוי אחרי ייבוא

  1. בדיקת האיכות נותנת ציון לניסוח של כל דרישה מול התכונות של דרישה טובה. בדיקות המודל מסתכלות על המודל כולו ומחפשות פערים כמו דרישות ששום דבר לא מקיים, פריטים שעומדים לבד או פעולות שאף אחד לא מבצע.
  2. Correct ו-Feasible דורשות שיקול דעת של אדם, ולכן הבדיקה אף פעם לא מסמנת אותן כמתקיימות. אתם מסמנים אותן אחרי סקירת הדרישה.
  3. הן מגיעות מקבצים שונים בלי קישורים ביניהן. כל קישור satisfied by מזין מאז את העקיבות, הכיסוי ובדיקות המודל.

פורסם על ידי Holarch