פרקי הקורס
הדרכה · מסלול 6. מעבר ל-Holarch · פרק 6.3 מתוך 5
6.3 דרישות מ-Word ומ-ReqIF 2:22
מייבאים מפרט Word כמסמך, וקובץ ReqIF של ספק עם ההיררכיה והקישורים שלו.
מציג את Holarch 2.21.
מה תלמדו
- להסביר אילו חלקים של קובץ Word הופכים לסעיפים ואילו לדרישות
- לייבא מפרט Word כמסמך דרישות ממוספר
- לייבא קובץ ReqIF עם ההיררכיה, המאפיינים והקשרים שלו
- לבדוק קשר מיובא בסעיף העקיבות
מייבאים את מפרט המטען של Plant Inspection Drone מ-Word, שבו כותרות הופכות לסעיפים ומשפטי shall הופכים לדרישות, ואת הדרישות של ספק הסוללות מ-ReqIF, עם ההיררכיה, המאפיינים וקשר refines.
קובצי פרויקט
- פרויקט התחלה (.holarch.json; ניהול פרויקטים ← קובצי פרויקט ▾ ← ייבוא פרויקט (.json)…)
- פרויקט גמור (.holarch.json; ניהול פרויקטים ← קובצי פרויקט ▾ ← ייבוא פרויקט (.json)…)
הסרטון מוצג מ-holarch.app; ראו את מדיניות הפרטיות.
תרגול
עשו זאת בעצמכם ב-Holarch, על פרויקט ההדגמה CubeSat EO-1.
- פותחים את פרויקט ההדגמה EO-1 (אם אין לכם, יוצרים אותו: ניהול פרויקטים ← קובצי פרויקט ▾ ← פרויקט הדגמה חדש ← CubeSat (הנדסת מערכות מודרכת)). פותחים את מסמכים ← EO-1 System Requirements Specification ולוחצים על מסירה ▾ ← מפרט (Word).
- באותו מסמך לוחצים על מסירה ▾ ← דרישות (ReqIF)… ולוחצים על ייצוא.
- בניהול פרויקטים לוחצים על + פרויקט חדש, נותנים לו את השם
EO-1 Import Practiceולוחצים על יצירת פרויקט. פותחים את צרכים ודרישות ← ייבוא וייצוא, משחררים את קובץ ה-.docx, לוחצים פעמיים על המשך ומייבאים אותו. - משווים את המסמך החדש ל-SRS: שמים לב אילו כותרות הפכו ל-Statements ואילו משפטי shall הפכו ל-Requirements, ואיך הם נקראו.
- מייבאים את קובץ ה-.reqif לאותו פרויקט, ואז פותחים את המסמך שהוא יוצר ובוחרים את 1.6 Revisit Time כדי לבדוק את הצאצאים והתוויות שלה.
סיימתם כשבפרויקט יש שני מסמכים, אחד מ-Word ואחד מ-ReqIF, ואתם יכולים לומר איזה מהם שמר על השמות והמספרים המקוריים.
בדיקה עצמית
- מה ייבוא ה-Word קורא כסעיף, ומה כדרישה?
- ספק יכול לשלוח Word או ReqIF. למה לבקש ReqIF?
- לקשר ב-ReqIF יש שם ש-Holarch לא מכיר. מה קורה?
הצגת התשובות
מה ייבוא ה-Word קורא כסעיף, ומה כדרישה?
פסקאות בסגנונות כותרת של Word הופכות ל-Statements (סעיפים). פסקה עם shall, must, will או should הופכת ל-Requirement, שנקראת על שם המילים הראשונות אחרי הפועל. כותרות שהוקלדו כטקסט מודגש רגיל נקראות כטקסט רגיל.
ספק יכול לשלוח Word או ReqIF. למה לבקש ReqIF?
ReqIF נושא את המזהה, ההיררכיה, המאפיינים והקשרים של כל דרישה. כשהספק שולח קובץ חדש יותר, הייבוא שלו מעדכן את אותם פריטים במקום להוסיף עותקים.
לקשר ב-ReqIF יש שם ש-Holarch לא מכיר. מה קורה?
הוא נכנס כ-traced to. אם הסכמה לא מתירה traced to בין שתי המחלקות, הקשר מדולג עם אזהרה.
קריאה נוספת
תמליל
הצגת התמליל (הקריינות ומה שמוצג על המסך)
Introduction
Chapter three: requirements from Word and ReqIF. Many specifications live in Word, and many suppliers exchange requirements as ReqIF files. Both come in through the same Import and Export page.
We import the payload specification and the battery supplier's requirements into the Plant Inspection Drone project.
Word
The Word file uses heading styles for its sections, and plain sentences with shall for its requirements. That is what the Word import reads. Heading styles or Word's list numbering matter: headings typed as ordinary bold text are read as ordinary text.
On screen: Card: what Holarch reads in Word.
Open Import and Export, and drop the file. Holarch detects Word from the file and analyzes it.
On screen: Import and Export → drop the .docx → Word detected.
Click Continue. The numbering pattern stays automatic, which uses numbered headings and shall sentences. Click Continue for the review: Holarch creates a requirements document with the name of the file, and lists the sections and the requirements under them.
On screen: Continue → Map: numbering → Continue → Review.
Click Import. The document opens, numbered from the Word headings, with each shall sentence as a requirement you can now trace and check.
On screen: Import → the document.
ReqIF
Now the supplier's file. ReqIF is the standard exchange format between requirements tools. Open Import and Export again, and drop the file.
On screen: Import and Export → drop the .reqif → ReqIF detected.
Click Continue. Each requirement in the file is a row. Its ReqIF identifier and its parent rebuild the hierarchy, its type becomes the class, and its attributes map by name: the chapter name to the number, the name, and the text to the description.
On screen: Continue → Map.
Click Continue, check the review, and click Import.
On screen: Continue → Review → Import.
Check the result
The supplier's relations come in as relationships. Select Charge Time, and open Trace: it refines Pack Capacity, just as the file says.
On screen: Select B.4 Charge Time → Trace.
Recap
Let's recap. You imported a Word specification, where headings became sections and shall sentences requirements, and a supplier's ReqIF file, with its hierarchy, attributes and relations.
Next, a whole model from another tool.