Holarch

דרישות

דרישות

כתיבה, בדיקה, אישור, קביעת קו בסיס וייבוא של דרישות, ומעקב אחר פריטי TBD/TBR פתוחים וקישורים לבדיקה.

אופן השימוש ←

בדף זה
  1. סקירה כללית
  2. מושגים
    1. Requirement ו-Statement
    2. מאפייני הדרישה
    3. תוויות הדרישה
    4. זרימת העבודה של הדרישות
    5. פריטים פתוחים: TBD, TBR ו-TBS
    6. קווי בסיס
  3. איך להשתמש בה
    1. מתי ולמה
    2. כתיבת דרישה
    3. בדיקת הניסוח
    4. כתיבה עם תבניות EARS
    5. אישור דרישות
    6. הקפאת מסמך לסקירה
    7. טיפול בשינוי אחרי קו הבסיס
    8. סגירת פריטי TBD ו-TBR
    9. ייבוא מפרט קיים
    10. דוגמה מעשית: הדגמת CubeSat EO-1
    11. עצות ושיטות עבודה טובות
    12. טעויות נפוצות
    13. כיצד זה מתחבר לתכונות אחרות
  4. הדף דרישות
  5. איכות הדרישות
    1. פריסת הדף
    2. סינון הדף איכות
    3. קריטריונים ובדיקות
    4. שתי דרישות באחת (R19)
    5. דרישות בשפות אחרות
    6. עקיפות ידניות
    7. תוצאות לא עדכניות
    8. בדיקת איכות ממסמך
    9. בדיקת דרישות עם AI
    10. ייצוא איכות
  6. אישורים
    1. תיבת האישור
  7. מרשם TBD/TBR
  8. קישורים לבדיקה
    1. מה מסמן קישור לבדיקה
    2. היכן מוצגים קישורים לבדיקה
    3. הדף קישורים לבדיקה
  9. קווי בסיס והשוואת גרסאות
    1. קווי בסיס של מסמך
    2. השוואת גרסאות
    3. הדף קווי בסיס וגרסאות
  10. ייבוא דרישות
    1. שלב 1: קובץ
    2. שלב 2: מיפוי
    3. שלב 3: סקירה
    4. איך כל פורמט נקרא
    5. עדכון דרישות מגיליון אלקטרוני
    6. הודעות ייבוא
  11. קיצורי דרך לדרישות
  12. הגדרות
  13. הודעות
  14. מגבלות
  15. קשור

סקירה כללית

דפי הדרישות משמשים לכתיבה, לבדיקה, לאישור ולקביעת קו בסיס של דרישות, ולמעקב אחרי מה שעדיין פתוח. דרישה היא ישות של מחלקת LML Requirement: יכולת, מאפיין או גורם איכות שחייבים להיות למערכת.

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

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

דףמה היא מציגה
מסמכיםמפרטים והמתארים שלהם. כאן כותבים דרישות.
דרישותכל דרישה בטבלה אחת (מסד הנתונים מסונן לפי class:Requirement).
איכותאיכות הדרישות: ציון על פי תשעה קריטריונים לכל דרישה.
TBD/TBRהמרשם של ערכים פתוחים שעדיין צריך לקבוע או לבדוק.
קישורים לבדיקהקישורים שהדרישה במעלה הזרם שלהם השתנתה אחרי הבדיקה האחרונה של הקישור.
אישוריםדרישות שה-Status שלהן הוא In Review.
ייבוא וייצואייבוא מ-Word, Excel, CSV, ReqIF, טקסט פשוט, XMI וקובצי פרויקט, דרך אזור שחרור אחד, ופורמטי הייצוא של המודל.

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

מושגים

Requirement ו-Statement

Statement היא מחלקת ההורה של Requirement.

  • משתמשים ב-Statement לטקסט שאינו מחייב: כותרות מקטעים, הנחות, הקשר.
  • משתמשים ב-Requirement לכל הצהרת "shall" מחייבת.

רק Requirements מקבלים ציון בבדיקת האיכות, מופיעים במרשם TBD/TBR, מסומנים לבדיקה כשהם משתנים ונספרים ב-RVTM. Statements מדולגים.

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

מאפייני הדרישה

מאפייןסוג וערכיםמשמעות
נימוקטקסט ארוךהסיבה שמאחורי הדרישה.
מצבDraft, In Review, Approved, Rejectedהיכן הדרישה נמצאת בזרימת העבודה של האישור.
PriorityHigh, Medium, Lowעד כמה הדרישה חשובה לבעלי העניין.
CriticalityHigh, Medium, Lowההשלכה על המשימה או על הבטיחות אם הדרישה לא מתקיימת.
בעליםטקסטאדם או צוות שאחראים לדרישה.
מקורטקסטבעל עניין, מסמך או תקן שהדרישה מגיעה ממנו.
Verification Methodבחירה מרובה: Analysis, Demonstration, Inspection, Testאיך הדרישה מאומתת.
Verification LevelComponent, Subsystem, Systemרמת ההרכבה שבה הדרישה מאומתת.
Success Criteriaטקסט ארוךתוצאה מדידה שמראה שהדרישה מתקיימת.
TBD/TBRNone, TBD, TBRTBD = ערך שעדיין צריך לקבוע; TBR = ערך שצריך לבדוק. מוחזר ל-None כשהפריט נסגר.
TBD Ownerטקסטהאדם שאחראי לסגירת ה-TBD/TBR.
TBD Due Dateתאריך ושעההתאריך שעד אליו יש לסגור את ה-TBD/TBR. תאריך יעד בקבוצה זרימת עבודה מציג ומגדיר את אותו תאריך (ראו מרשם TBD/TBR).
Quality Scoreאחוז, מחושבהתוצאה של בדיקת האיכות האחרונה.
Appropriate, Complete, Conforming, Correct, Feasible, Necessary, Singular, Unambiguous, Verifiableכן/לא, מחושב או מוגדר ידניתתשעת קריטריוני האיכות.

חלונית המאפיינים מקבצת את השדות של דרישה (ראו חלונית המאפיינים): דרישה (Number, Name, Description, Labels, Rationale, Source, Success Criteria), זרימת עבודה (רצועת הסקירה עם Status, Priority, Criticality, Owner, Assignee, Due date, TBD/TBR, TBD Owner, TBD Due Date), אימות (Verification Method ו-Level, Verified by, ושדות הסגירה עם התוכנית הפורמלית), ערכים (Budget Quantity, Threshold, Objective ו-Value הנוכחי, Units), התאמה (התוכנית הפורמלית) ואיכות.

הציון ותשעת הקריטריונים נמצאים בקבוצה איכות, מקופלת בהתחלה. הכותרת שלה מציגה, לדוגמה, "89% · 8 מתוך 9 מתקיימים", או "עדיין לא נבדק". Holarch זוכר אם הקבוצה נשארה פתוחה, לכל מחלקה.

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

תוויות הדרישה

תוויות מסווגות דרישות בלי לשנות את המחלקה שלהן. תוויות הדרישה המובנות הן:

  • Functional Requirement, Performance Requirement, Interface Requirement.
  • Environmental Requirement, Reliability Requirement, Safety Requirement.
  • Verification Requirement.
  • Stakeholder Need: צורך שבעל עניין ניסח, לפני שהוא הופך לדרישות מערכת.

Verification Method היא גם קבוצת תוויות, עם התוויות Analysis, Demonstration, Inspection ו-Test. התווית והמאפיין נשארים מסונכרנים, באותו צעד ביטול:

  • הוספת התווית Test מגדירה את Verification Method ל-Test.
  • בחירת Test במאפיין מוסיפה את התווית.

פרויקטים ישנים וקובצי ייבוא שנושאים רק את התוויות ממוזגים לתוך המאפיין כשהפרויקט נפתח.

זרימת העבודה של הדרישות

כל דרישה עוברת בארבעה סטטוסים:

  1. Draft: בכתיבה.
  2. In Review: ממתינה להחלטה. מופיעה בדף אישורים.
  3. Approved או Rejected: הוחלט. כל החלטה מתעדת מי קיבל אותה, מתי, וסיבה אופציונלית.

אחרי האישור, שלושה מנגנונים שומרים על אמינות הרשומה:

  • סקירה חוזרת בעריכה. עריכה של השם או התיאור של דרישה במצב Approved מחזירה אותה ל-In Review, עם ההערה "הטקסט השתנה אחרי האישור".
  • איכות לא עדכנית. עריכה של השם או התיאור מסמנת את תוצאות האיכות שלה כלא עדכניות ומנקה עקיפות איכות ידניות.
  • קישורים לבדיקה. עריכה של השם, התיאור או מאפיין מפתח מסמנת לבדיקה את הקישורים לפריטים שבמורד הזרם שלה.

שלושתם חלק מהעריכה, כך שביטול פעולה אחד (⌘Z / Ctrl+Z) מבטל את כולם יחד.

פריטים פתוחים: TBD, TBR ו-TBS

פריט פתוח הוא ערך שעדיין לא נקבע. דרישה היא פריט פתוח כשמתקיים אחד מאלה:

  • התכונה TBD/TBR שלה היא TBD או TBR.
  • השם או התיאור שלה מכילים את המילה TBD, TBR או TBS.

פריטים פתוחים מופיעים במרשם TBD/TBR עד שהם נסגרים.

קווי בסיס

קו בסיס הוא תמונת מצב לקריאה בלבד. יש שני סוגים:

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

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

איך להשתמש בה

מתי ולמה

עבודת הדרישות פורשת על הצד השמאלי של ה-V של הנדסת המערכות:

  1. לכידת צורכי בעלי העניין.
  2. גזירת דרישות מערכת.
  3. בדיקה שכל הצהרה מנוסחת היטב.
  4. קבלת אישור לדרישות.
  5. הקפאתן בסקירה (SRR, PDR, CDR).

אחרי קו הבסיס, העבודה עוברת לבקרת שינויים. כל שינוי נסקר מחדש וההשפעה שלו במורד הזרם נבדקת. ערכי TBD/TBR הפתוחים נסגרים לפני שמתחייבים לתכן.

דפי הדרישות עונים על השאלות האלה:

שאלהדף
האם כל דרישה כתובה היטב?איכות
אילו ערכים עדיין לא ידועים, מי אחראי להם, והאם הם באיחור?TBD/TBR
מה צריך לבדוק מחדש כי דרישה השתנתה?קישורים לבדיקה
מה ממתין להחלטה?אישורים
מה השתנה מאז הסקירה?גרסה ▾ ← השוואת גרסאות… במסמך, קווי בסיס וגרסאות
האם כל דרישה מוקצית ומאומתת?מטריצת עקיבות ו-RVTM

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

כתיבת דרישה

  1. יש לפתוח את צרכים ודרישות ← מסמכים.
  2. יש לפתוח את מסמך הדרישות.

    כדי להתחיל מסמך חדש, יש ללחוץ על + מסמך חדש (ראו מסמכים).

  3. בסרגל הוספה מהירה שמתחת למסמך, יש לבחור לאן הפריט נכנס, לדוגמה Under 3 Electrical Power.
  4. יש להקליד את הצהרת הדרישה ולהקיש Enter.

    Holarch מוסיף פריט ממחלקת ברירת המחדל של המסמך (Requirement במסמך דרישות). הוא ממוספר אחרי האחים שלו.

  5. כשהדרישה נבחרה, יש לפתוח את חלונית המאפיינים משמאל.
  6. יש למלא את Rationale, Source ו-Success Criteria בקבוצה דרישה, את Priority, Criticality ו-Owner בזרימת עבודה, ואת Verification Method ו-Verification Level באימות.
  7. יש להוסיף תווית סוג עם + תווית בקבוצה דרישה של חלונית המאפיינים, לדוגמה Performance Requirement. (העמודה תוויות נמצאת תחת תצוגה ▾ ← עמודות ▸.)

לדרישה יש Status Draft והיא מופיעה ב-צרכים ודרישות ← דרישות.

אם ערך עדיין לא ידוע:

  1. יש לכתוב בהצהרה את ההערכה הטובה ביותר.
  2. יש להגדיר את TBD/TBR ל-TBD.
  3. יש למלא את TBD Owner, ולהגדיר את התאריך ב-תאריך יעד בקבוצה זרימת עבודה.

    הדרישה מופיעה עכשיו גם במרשם TBD/TBR, עם תאריך היעד הזה.

בדיקת הניסוח

  1. יש לפתוח את צרכים ודרישות → איכות.

    ממסמך, יש לבחור במקום זאת בדיקה ▾ ← בדיקת איכות.

  2. בסרגל ההיקף, יש לבחור כל הדרישות או Document: <name>.
  3. יש ללחוץ על בדיקת איכות בכותרת הדף.

    ההודעה הקופצת מציגה "נבדקו 32 דרישות" (או המספר אצלך). כל דרישה מקבלת ציון מ-0 עד 100% ו-✔ או ✘ לכל קריטריון.

    עם יותר מ-2,000 דרישות הבדיקה רצה ברקע: כרטיס ההתקדמות מציג "בודק דרישות", את הספירה ואת הזמן שנותר, ואפשר להמשיך לעבוד. לחיצה על ביטול בכרטיס עוצרת; שום דבר לא משתנה. אחר כך הכרטיס מציג "שומר את תוצאות האיכות" עם מספר התוצאות שנשמרו; בזמן השמירה, עריכות אחרות נדחות עם "שומר את תוצאות האיכות. אפשר לנסות שוב כשהשמירה מסתיימת." רק דרישות שהתוצאות שלהן השתנו נשמרות, כך שבדיקה חוזרת בלי שינויים לא שומרת דבר. הבדיקה כולה היא צעד אחד: ⌘Z / Ctrl+Z אחד מסיר אותה.

  4. יש לקרוא את האריחים: דרישות, ציון ממוצע, טוב (≥ 67%), דורש עיבוד מחדש (< 67%) וכשיש כאלה, לא עדכני (הטקסט השתנה).
  5. לכל דרישה מתחת ל-67%, יש לקרוא את העמודה הצעות.

    או להצביע על ✘ כדי לראות את ההודעות של הקריטריון הזה.

  6. יש ללחוץ על שם הדרישה כדי לפתוח אותה, ולתקן את הטקסט.
  7. יש להריץ את הבדיקה שוב.

Correct ו-Feasible דורשים תמיד שיקול דעת של אדם. הבדיקה לעולם לא מסמנת אותם כמתקיימים, לא משנה מה הבדיקות האחרות מוצאות. לכן הבדיקה האוטומטית מגיעה לכל היותר ל-7 מתוך 9 קריטריונים (78%). דרישה בלי בדיקה או דרישה שמאמתת אותה מגיעה ל-6 מתוך 9 (67%). לכל דרישה, יש להחליט עליהם בעצמך:

  • אחרי סקירת הדרישה, לחיצה על ✘ מסמנת את הקריטריון כ-Yes.
  • לחוות דעת ראשונה, אפשר להשתמש ב-✦ AI ▾ ← בדיקה עם AI (N דרישות)… (בדיקת הדרישות עם AI).

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

כתיבה עם תבניות EARS

EARS (Easy Approach to Requirements Syntax) כותב כל דרישה כמשפט אחד: תנאי אופציונלי, ואחריו "the [system] shall [response]". המילה הראשונה של התנאי קובעת את התבנית.

תבניתתבנית טקסטדוגמה
UbiquitousThe [system] shall [response].The pump controller shall record every start command with its time.
Event-drivenWhen [trigger], the [system] shall [response].When the tank level falls below 20 %, the pump controller shall start the backup pump.
State-drivenWhile [state], the [system] shall [response].While the vehicle is charging, the battery manager shall keep each cell below 45 °C.
Unwanted behaviorIf [unwanted condition], then the [system] shall [response].If the supply voltage drops below 10 V, then the flight computer shall switch to the reserve battery.
Optional featureWhere [feature is included], the [system] shall [response].Where a heated windshield is fitted, the climate controller shall clear frost within 5 minutes.
ComplexWhile [state], when [trigger], the [system] shall [response].While the drill is in standby, when the operator presses Start, the drill controller shall reach full speed within 3 s.
  1. יש לפתוח דרישה בחלונית המאפיינים או בתצוגת הפריט.
  2. יש ללחוץ על EARS ▾ ליד תיאור.

    השורה הראשונה מציגה את התבנית של ההצהרה (✓ Event-driven) או מה צריך לתקן (No EARS pattern: 1 to fix).

  3. יש לבחור תבנית.

    התבנית שלה הופכת לתיאור. אם לדרישה כבר יש תיאור, יש לאשר עם החלפה; ההצהרה הישנה נשארת בהיסטוריה של הפריט. ⌘Z / Ctrl+Z אחד מבטל זאת.

  4. יש להחליף את המילים שבסוגריים המרובעים.

כדי לבדוק כל דרישה, יש להגדיר את Requirement.11 ל-אזהרה או שגיאה בבדיקות המודל ← הגדרות. כברירת מחדל הוא כבוי.

בפרויקט SysML v2, EARS ▾ נמצא תחת תיעוד של דרישה בחלונית המאפיינים וכותב את הערת התיעוד שלה.

אישור דרישות

  1. כשדרישה מוכנה, יש להגדיר את ה-Status שלה ל-In Review.

    עושים זאת בחלונית המאפיינים (ה-Status ברצועת הסקירה של הקבוצה זרימת עבודה), במסד הנתונים או בעמודה של מסמך.

  2. הסוקר פותח את צרכים ודרישות ← אישורים.

    הדף מציג כל דרישה שה-Status שלה הוא In Review.

  3. יש ללחוץ על שורה.

    הקבוצה זרימת עבודה בחלונית המאפיינים מציגה את רצועת הסקירה: ה-Status, מי הגדיר אותו ומתי ("by J. Rivera · Mar 9, 2026 at 9:58 AM") והלחצנים.

  4. יש ללחוץ על אישור.

    או ללחוץ על דחייה… ולהזין סיבה אופציונלית.

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

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

כדי להחזיר דרישה שהוחלט עליה לסקירה, יש ללחוץ על פתיחה מחדש. ההודעה הקופצת מציגה "הועבר ל-In Review".

אם לפרויקט יש זרימת עבודה על Status של דרישות (סכמה ← זרימת עבודה), רצועת הסקירה מציגה את המעברים של זרימת העבודה הזו במקום אישור, דחייה… ופתיחה מחדש. מעבר שדורש אישור מסתיים ב-… ופותח את בקשת אישור: ראו בקשת אישור לשינוי מצב. בדרישה שבקו בסיס, בקשת אישור ותיבת הדו-שיח אישור… של בקשת השינוי מציגות את אותה רשימת דורש בדיקה חוזרת.

הקפאת מסמך לסקירה

  1. בבלוק הכותרת של המסמך, יש ללחוץ על גרסה ▾.
  2. יש לבחור שמירת קו בסיס….

    או לבחור מסירה ▾ ← גרסה ▸ שמירת קו בסיס….

  3. יש להשאיר או לשנות את השם. ברירת המחדל היא "<document> Baseline <n>".
  4. תחת אישורים, יש למלא שורה אחת לכל מאשר: שם, תפקיד והצהרה (ברירת מחדל "מאושר לשחרור.").

    + הוספת מאשר מוסיף שורה; × מסיר שורה.

  5. יש ללחוץ על יצירה.

    ההודעה הקופצת מציגה "קו הבסיס נשמר". גרסה ▾ מציג "נוכחית · קו הבסיס האחרון <name>".

מעכשיו, כל שורה מקבלת פס שינוי כשהיא שונה מקו הבסיס האחרון.

טיפול בשינוי אחרי קו הבסיס

  1. יש לערוך את טקסט הדרישה במסמך.

    הודעה קופצת מסכמת מה קרה, לדוגמה "דרישה מאושרת אחת הועברה ל-In Review; 6 קישורים סומנו לבדיקה." כחלק מהעריכה שלך (ביטול פעולה אחד מחזיר הכול לאחור):

    • דרישה במצב Approved עוברת ל-In Review.
    • תוצאות האיכות שלה הופכות ללא עדכניות ("איכות: לא עדכנית — יש להריץ שוב").
    • הקישורים שלה במורד הזרם מסומנים לבדיקה.
  2. יש לפתוח את צרכים ודרישות ← קישורים לבדיקה.
  3. בכל שורה, יש ללחוץ על השוואה כדי לראות את שינוי הטקסט, ולבדוק את הפריט המקושר.
  4. כשפריט מקושר עדיין תקף, יש ללחוץ על סימון כנבדק… בשורה שלו.

    כדי לסמן כמה בבת אחת, יש לבחור את השורות שלהם וללחוץ על סימון הנבחרים כנבדקים….

  5. יש לכתוב מה נבדק וללחוץ על סימון כנבדק.
  6. יש להריץ שוב את בדיקת האיכות.
  7. יש להחזיר את הדרישה לתהליך האישור.
  8. יש ללחוץ על גרסה ▾ ← השוואת גרסאות…, לבחור את קו הבסיס תחת מ ואת הגרסה הנוכחית תחת אל.

    הדוח מציג כל שינוי מאז קו הבסיס.

  9. יש ללחוץ על שינויים (Excel) עבור ועדת השינויים.

סגירת פריטי TBD ו-TBR

  1. יש לפתוח את צרכים ודרישות ← TBD/TBR.
  2. יש לקרוא את האריחים: TBD/TBR פתוחים, באיחור, ללא בעלים, ואת הספירה לכל מסמך.
  3. יש לטפל קודם בשורות שבאיחור. הן צבועות, עם "באיחור" מתחת לתאריך היעד.
  4. כשהבעלים מוצג כ-"—", יש להקצות TBD Owner.
  5. כשערך נקבע, יש לערוך את טקסט הדרישה לערך הסופי.
  6. יש ללחוץ על סגירה בשורה.

    סגירה מגדירה את TBD/TBR ל-None, והשורה יוצאת מהמרשם.

כדי לשלוח את המרשם לבעלים, יש ללחוץ על ייצוא XLSX.

ייבוא מפרט קיים

  1. יש לפתוח את צרכים ודרישות ← ייבוא וייצוא.
  2. יש לשחרר את הקובץ באזור השחרור, או ללחוץ עליו כדי לבחור את הקובץ: Word (.docx), Excel או CSV, ReqIF או טקסט פשוט.

    שורת המצב מציגה, לדוגמה, "נותח “SRS.docx”: 48 שורות, 5 עמודות." פורמט מציג את הפורמט שזוהה.

  3. יש ללחוץ על המשך.
  4. יש לבדוק למה כל עמודה ממופה, ולהגדיר את מחלקה לשורות ללא מחלקה ל-Requirement.
  5. יש ללחוץ על המשך.
  6. יש להשאיר את Create a requirements document from these N requirements מסומן, לבדוק את סוג המסמך ואת השם שלו, ולבדוק את הפריטים החדשים והמעודכנים ואת האזהרות.
  7. יש ללחוץ על Import N items.

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

בכרטיס הייבוא הושלם יש לחצנים לפתיחת המסמך, מסד הנתונים, דיאגרמת Spider או עץ, או בדיקת האיכות. ⌘Z / Ctrl+Z אחד מסיר את הייבוא כולו.

דוגמה מעשית: הדגמת CubeSat EO-1

יש ליצור את פרויקט ההדגמה CubeSat EO-1 — Earth Observation Demo מ-ניהול פרויקטים. יש בו מפרט של 32 דרישות, SRS-001 EO-1 System Requirements Specification, עם קו בסיס SRR ושינויים שנעשו אחריו.

איכות.

  1. יש לפתוח את צרכים ודרישות ← איכות וללחוץ על בדיקת איכות.

    האריחים מציגים 32 דרישות, ממוצע של 92%, 29 טובות ו-3 שדורשות עיבוד מחדש.

שלוש הדרישות החלשות כתובות כך בכוונה. כל אחת מקבלת 44%:

  • 2.5 Safe Mode Recovery: "The spacecraft should recover from safe mode quickly and resume imaging as appropriate". ההצעות כוללות:
    • "R34 - מונחי ביצועים שאי אפשר למדוד: [quickly]"
    • "R8 - סעיפי מילוט מחלישים את הדרישה: [as appropriate]"
    • "R19 - מחבר שתי דרישות; יש לפצל לדרישות נפרדות: [and]"
    • "יש לסיים את ההצהרה בנקודה."
    • "יש לקשר Test Case או Requirement שמאמתים אותה."
  • 3.5 Battery Thermal Control: "…keep the battery warm enough (TBD)." ההצעות הן "R21 - מכיל סוגריים; יש להעביר את הטקסט שבסוגריים לנימוק." ו-"יש להחליף את מציני המיקום TBD/TBR."
  • 6.4 Operator Interface: "…shall be user friendly and/or easy to use." ההצעות הן "R34 - מונחי ביצועים שאי אפשר למדוד: [user friendly, easy to use]" ו-"R19 - "and/or" אינו חד-משמעי; יש לציין אם הכוונה לשניהם או לאחד: [and/or]".

כדי לתקן את 2.5:

  1. יש לנסח אותה מחדש כ-"The spacecraft shall resume imaging within 6 hours of a safe mode entry."
  2. יש לקשר מקרה בדיקה עם verified by.
  3. יש להריץ את הבדיקה שוב.

    ההודעות על המחבר, סעיף המילוט והמונח המעורפל נעלמות.

TBD/TBR. יש לפתוח את TBD/TBR. הוא מציג שלושה פריטים פתוחים:

  • 3.5 Battery Thermal Control: TBD שבאחריות ה-Thermal Engineer. הוא באיחור.
  • 2.4 Target Slew (ADCS Lead) ו-5.3 Downlink Link Margin (Comms Lead): פריטי TBR שמועד היעד שלהם מאוחר יותר.

שינוי אחרי קו הבסיס. גרסה ▾ של המסמך מציג את SRR Baseline. הוא אושר על ידי J. Rivera (Systems Lead), R. Okafor (Mission Principal Investigator) ו-L. Brandt (Program Manager).

אחרי SRR, הדרישה 3.1 Orbit Average Power השתנתה מ-28 W ל-30 W. מכיוון ש-3.1 הייתה Approved, היא חזרה ל-In Review עם ההערה "הטקסט השתנה אחרי האישור".

קישורים לבדיקה מציג שישה קישורים מ-3.1:

  • 1.3.1 Solar Arrays
  • F3 Generate and Store Power ו-F3.1 Convert Sunlight to Power
  • EQ-1.1 Solar Power Generation ו-EQ-1.4 Power Margin Check
  • TC-06 Solar Array Power Test

לחיצה על השוואה בכל שורה: "28 W" מחוק ו-"30 W" נוסף. אחר כך יש לבדוק את הפריטים:

  • TC-06 מצפה להספק שיא ≥ 72 W ומדד 75.1 W. דרך EQ-1.3 Orbit-Average Array Power (שיא × 0.62 שבר זמן מואר × 0.6 נצילות מסלול ההספק), 75.1 W הם 27.9 W ממוצע מסלול, מתחת ל-30 W החדשים. את הקישור הזה יש להשאיר לא נבדק ולהוסיף את התגובה "75.1 W peak = 27.9 W orbit average; re-test against about 80.6 W peak". הבדיקה צריכה תוצאה צפויה חדשה והרצה חדשה.
  • לפני סימון 1.3.1 כנבדק, יש לוודא שקביעת הגודל של מערך השמש עדיין נסגרת.

השוואה לנוכחי. יש לבחור SRR Baseline ב-גרסה ▾, ואז ללחוץ על השוואה לנוכחי בבאנר שלו. הדוח מציג:

  • השינויים ב-Description, Rationale, Status ו-Quality Score של 3.1.
  • שינוי ה-Status של 2.4 Target Slew (Draft ← In Review).
  • הדרישה החדשה 4.4 Downlink Encryption, עם שני קישורי satisfies החדשים שלה.

אישורים. יש לפתוח את אישורים. תשע דרישות נמצאות ב-In Review, כולל 3.1, 1.5 Daily Collection Volume ו-5.3 Downlink Link Margin.

עצות ושיטות עבודה טובות

  • יש לכתוב "shall" אחד לכל דרישה, בקול פעיל, עם מספר, יחידה ותנאי. בדיקת האיכות מתגמלת בדיוק את זה.
  • את הסיבה יש לשים ב-Rationale, לא בהצהרה. ביטויי תכלית ("so that", "in order to") וסוגריים מסומנים כ-R20 ו-R21.
  • יש למלא את Verification Method בזמן הכתיבה. דרישה עם שיטה אבל בלי מקרה בדיקה מוצגת אז כ-Planned-only ב-RVTM, במקום Unverified.
  • יש להגדיר את TBD/TBR עם בעלים ותאריך יעד, במקום רק להקליד "TBD" בטקסט. המאפיין נותן למרשם בעלים ותאריך יעד למעקב.
  • יש לקבוע קו בסיס לפני כל סקירה. פסי השינוי והשוואה לנוכחי עובדים רק מול קו בסיס.
  • יש לסמן קישורים כנבדקים עם תגובה. התגובה נוספת לפריט המקושר ומתועדת בקישור, כך שהסקירה משאירה שובל ביקורת.

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

תסמיןסיבהתיקון
דרישה לא מקבלת ציון, לא מופיעה במרשם או לא מופיעה ב-RVTM.היא Statement, לא Requirement.יש לשנות את המחלקה שלה ל-Requirement בחלונית המאפיינים.
Correct ו-Feasible מציגים ✘ בכל דרישה.הם דורשים שיקול דעת של אדם ("Needs a reviewer’s judgment").יש לסקור כל אחת וללחוץ על ✘ כדי לסמן Yes, או להריץ את בדיקת הדרישות עם AI.
הציון מציג "לא עדכני — יש להריץ שוב".הטקסט השתנה אחרי הבדיקה האחרונה.יש ללחוץ על בדיקת איכות, או להפעיל את בדיקה חוזרת אוטומטית כשהטקסט משתנה.
עקיפות Yes/No ידניות נעלמו.עריכת הטקסט מנקה אותן.יש להגדיר אותן שוב אחרי הסקירה; ביטול הפעולה משחזר אותן, והן נשארות בהיסטוריה.
דרישה יצאה מ-Approved אחרי תיקון שגיאת הקלדה.כל עריכה של שם או תיאור פותחת מחדש דרישה מאושרת.יש לאשר אותה שוב. את שגיאות ההקלדה יש לתקן לפני האישור.
"סגירה" חסר בשורת TBD/TBR.הפריט הפתוח נובע רק מהטקסט.יש לערוך את הטקסט ולהסיר את TBD, TBR או TBS.
ייבוא יצר עותקים במקום לעדכן.התאמת ישויות קיימות לפי לא מצא התאמה.יש לייצא עם העמודה מזהה, לערוך, ולייבא עם התאמת ישויות קיימות לפי: מזהה גלובלי (ראו עדכון דרישות מגיליון אלקטרוני).

כיצד זה מתחבר לתכונות אחרות

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

הדף דרישות

הדף דרישות מציג ומאפשר לערוך כל דרישה בטבלה אחת. צרכים ודרישות ← דרישות הוא מסד הנתונים מסונן לפי class:Requirement.

כל תכונה של מסד הנתונים עובדת כאן:

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

לחיצה על שורה מציגה את הדרישה בחלונית המאפיינים. לחיצה כפולה פותחת את תצוגת הפריט שלה. דרישה עם קישור לבדיקה מציגה תג ⚠ בדיקה בשורה שלה. לחיצה ימנית על שורה פותחת את התפריט שלה: עד שלוש פעולות מוצעות עם הסיבות שלהן (לדוגמה ✦ הוספת קריטריונים מדידים… כשהדרישה נכשלת ב-Unambiguous, ✦ יצירת מקרה בדיקה… כשהיא לא מאומתת), ✦ עוד AI ▸, ואחריהן פתיחה, שינוי שם…, שכפול, הוספת צאצא…, סטטוס ▸, עדיפות ▸, יצירת קשר אל ▸, הוספה למסמך ▸, הצגה בדיאגרמה ▸, העתקת קישור, העתקת המספר ומחיקה… (ראו תפריט לחיצה ימנית).

ראו המודל ומסד הנתונים לטבלה, לשאילתות ולעריכה המרובה.

שאילתות שימושיות:

שאילתהמציג
class:Requirementכל דרישה.
Requirement:"Status=In Review"רשימת האישורים.
Requirement:"Status=Draft"דרישות שעדיין לא נשלחו לסקירה.
class:Requirement AND is:leafדרישות עלה (בלי דרישות צאצא).
class:Requirement AND NOT relationship:"verified by"דרישות בלי פריט מאמת.

איכות הדרישות

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

תשעת הקריטריונים ומספרי הכללים בהצעות (R2, R19 וכן הלאה) עוקבים אחרי המאפיינים והכללים ב-Guide to Writing Requirements של INCOSE. רשימות המילים והתבניות של Holarch מקרבות את הכללים האלה; הן אינן הטקסט של המדריך, וחלק מהכללים דורשים שיקול דעת של סוקר.

  • ציון = 100 × (קריטריונים שמתקיימים) / 9, מעוגל. קריטריון שלא נבדק (–, ראו דרישות בשפות אחרות) מושמט: 100 × מתקיימים / 8.
  • 67% ומעלה הוא טוב. מתחת ל-67% הוא דורש עיבוד מחדש.
  • הפס אדום מתחת ל-34%, צהוב מ-34% עד 66%, וירוק מ-67%.

פריסת הדף

  • כותרת הדף:
    • עוד ▾: ניקוי הדירוגים הידניים מאפס כל Yes/No ידני של הדרישות המוצגות ומריץ את הבדיקה מחדש. פתיחה בדרישות פותח את הדרישות המוצגות בטבלת הדרישות. פתיחת המסמך מופיע כשההיקף הוא מסמך.
    • ייצוא ▾: Excel (.xlsx) ו-CSV, של הדרישות המוצגות.
    • בדיקת איכות: בודק כל דרישה בהיקף, בלי קשר למה שהמסננים מציגים (כלל הכפילויות משווה כל דרישה לאחרות בהיקף).
  • ✦ AI ▾ (בסרגל העליון): בדיקה עם AI (N דרישות)…, בדיקת הדרישות עם AI של הדרישות המוצגות.
  • סרגל ההיקף: טווח (כל הדרישות או Document: <name>) ותיבת הסימון בדיקה חוזרת אוטומטית כשהטקסט משתנה. קישורים לבדיקה, TBD/TBR ואישורים נמצאים ליד איכות בסרגל הניווט.
  • שורת השאילתה: + מסנן, צ׳יפי המסננים וטקסט החיפוש, ניקוי, ? (תחביר החיפוש) ותצוגות ▾: אותו סרגל כמו בדף דרישות (ראו סינון הדף איכות).
  • אריחים: דרישות ("12 מתוך 40" תחת הדרישות המוצגות כשמסננים מסתירים חלק), ציון ממוצע, טוב (≥ 67%), דורש עיבוד מחדש (< 67%), ולא עדכני (הטקסט השתנה) כשיש תוצאות לא עדכניות. ציונים לא עדכניים מושמטים מהממוצע.
  • ההערה מתחת לאריחים: "בדיקות אוטומטיות מגיעות לכל היותר ל-7 מתוך 9 מאפיינים (78%); Correct ו-Feasible דורשים אימות אנושי — לחיצה על ✘ מסמנת Yes. כל לחיצה עוברת בין Yes ידני, No ידני וחזרה לאוטומטי."
  • טבלה: מספר, שם (עם התיאור מתחתיו), ציון איכות, עמודה לכל קריטריון, והצעות. הצעות מציג כל הודעה, עם הקריטריון שלה כקידומת. השורות ממוינות לפי מספר. לחיצה ימנית על שורה, או Shift+F10 עליה, פותחת את תפריט השורה של מסד הנתונים: פעולות מוצעות עם הסיבות שלהן (הניסוח מחדש שמתקן קריטריון שנכשל בא ראשון), ✦ עוד AI ▸, פתיחה, שינוי שם…, שכפול, הוספת צאצא…, סטטוס ▸, עדיפות ▸, יצירת קשר אל ▸, הוספה למסמך ▸, הצגה בדיאגרמה ▸, העתקת קישור, העתקת המספר ומחיקה…. השורה הופכת לבחירה.
  • כמה שורות: ⌘ / Ctrl-לחיצה (Ctrl-לחיצה ב-Windows וב-Linux) מחליפה מצב של שורה, ⇧ / Shift-לחיצה בוחרת את הטווח מהשורה האחרונה שנלחצה, ⌘ / Ctrl+⇧ / Shift-לחיצה מוסיפה את הטווח הזה, ו-⌘A / Ctrl+A או ⇧ / Shift+↑ / ⇧ / Shift+↓ על שורה ממוקדת בוחרים את כל השורות או מרחיבים את הבחירה. סרגל הכלים מציג את הספירה; Esc מנקה אותה. לחיצה ימנית על שורה שנבחרה פועלת על כולן: ✦ בדיקה עם AI (n דרישות)…, ✦ ניסוח מחדש (n) ▸, ✦ יצירת מקרי בדיקה (n)…, ✦ לשאול את ה-AI עליהם (n)…, ✦ הצעת קשרי עקיבות (n)… (כל אחת עם תצוגה מקדימה אחת; ראו AI על כמה פריטים שנבחרו), שכפול n ישויות, הגדרת סטטוס ▸, הגדרת עדיפות ▸, הוספה למסמך ▸ ו-מחיקת n פריטים…; ביטול פעולה אחד מבטל כל אחת מהן. מרשם TBD/TBR וקישורים לבדיקה עובדים באותו אופן; בקישורים לבדיקה הבחירה גם מסמנת את השורות עבור סימון הנבחרים כנבדקים….

מקרים מיוחדים:

  • שורה בלי תוצאה מציגה "לא הורץ" בעמודת הציון.
  • שורה לא עדכנית מציגה "לא עדכני — יש להריץ שוב".
  • כשאין דרישות בהיקף, הדף מציג "אין דרישות" ו-"רק ישויות מהמחלקה Requirement מקבלות ציון; Statements מדולגים."
  • כשמסננים או טקסט חיפוש מסתירים כל דרישה, הדף מציג "אין דרישות תואמות" ו-"אין דרישות שתואמות לחיפוש או למסננים. יש לנקות אותם כדי לראות את כל הדרישות."

סינון הדף איכות

שורת השאילתה עובדת כמו בדף דרישות (ראו איך מסננים מוקלדים הופכים לצ׳יפים): מונחי סינון מוקלדים הופכים לצ׳יפים בהקשה על Enter, שאר הטקסט מתאים לשם, למספר ולתיאור, Backspace בחיפוש ריק מסיר את הצ׳יפ האחרון, וניקוי מסיר את כולם. האריחים, הטבלה, ייצוא ▾ ו-✦ AI ▾ ← בדיקה עם AI עוקבים אחרי המסננים.

+ מסנן מציג, עם ספירות להיקף:

קבוצהמסנניםמונח
איכותטוב (≥ 67%), דורש עיבוד מחדש (< 67%), לא הורץ, לא עדכני (הטקסט השתנה), דירוגים ידניים, ממצא AIquality:good, quality:rework, quality:notrun, quality:stale, quality:manual, quality:ai
נכשל בקריטריוןאחד לכל קריטריון: דורג Noquality:Verifiable=no (=yes: דורג Yes)
ממצא כללהכללים שנמצאו בהיקף, כמו R7 Imprecise wording או R30 Closely resembles (כפילויות אפשריות)quality:R7
מבנה, מחלקה, מאפייני הדרישה, תווית, קשר, דיאגרמהכמו בדף דרישות; מאפייני הדרישה מוצגים בלי צ׳יפ מחלקהis:tbd, Requirement:"Status=Draft", label:"…"

מסננים מאותה קבוצה משתלבים עם או; קבוצות שונות משתלבות עם וגם. טווחי ציונים משתמשים במאפיין: Requirement:"Quality Score>=50". מונחי quality: עובדים גם בדף דרישות ובמסד הנתונים.

תצוגות ▾ מחיל תצוגה מובנית (דורש עיבוד מחדש, עדיין לא נבדק, תוצאות לא עדכניות, עמום, לא ניתן לאימות, כפילויות אפשריות, דירוגים ידניים) או אחת מהתצוגות השמורות שלך. שמירת תצוגה… שומר את המסננים ואת טקסט החיפוש הנוכחיים בדפדפן הזה, לכל פרויקט; Delete "<name>" מופיע כל עוד תצוגה שמורה בשימוש. כל הדרישות מנקה את המסננים. הכתובת quality?q=<query> פותחת את הדף מסונן.

הסינון קורא את התוצאות השמורות ואינו בודק שוב. ב-50,000 דרישות שינוי של מסנן או חיפוש לוקח הרבה פחות מעשירית שנייה.

קריטריונים ובדיקות

כל קריטריון מציג אחד משלושה סימנים:

  • ✔ (Yes): אין הודעות.
  • ✘ (No): הודעה אחת לפחות.
  • –: לא נבדק.

הבדיקות מתאימות מילים וביטויים שלמים, בלי הבחנה בין אותיות רישיות לקטנות. רק הצורות שמפורטות נספרות: "effective" ו-"effectively" שתיהן מפורטות, "effectiveness" לא. גם מילים בתוך מירכאות נספרות. ההודעות שבהמשך הן הטקסט המדויק שמוצג. הרשימה שבסוגריים המרובעים בסוף הודעה מציינת את המילים שנמצאו.

חד-משמעית

כללהודעהמופעל על
R6R6 - יחידות לא מזוהות; יש להשתמש ביחידות SI סטנדרטיות, מקובלות בארה״ב או אימפריאליות: [...]מספר שאחריו מילה שאינה יחידה מוכרת (לדוגמה "12 sorties"). היחידות המוכרות כוללות יחידות SI, יחידות מקובלות בארה״ב ויחידות אימפריאליות והקיצורים שלהן, %, מעלות, °C ו-°F.
R2R2 - יש להשתמש בצורת פעיל: [...]"shall/must/will/should be" ואחריו בינוני פעול ("shall be measured").
R5R5 - יש להשתמש בה״א הידיעה ("the") במקום: [...]"a" או "an".
R7R7 - ניסוח לא מדויק: [...]some, many, several, few, little, much, various, appropriate(ly), adequate(ly), efficient(ly), effective(ly), sufficient(ly), reasonable, reasonably, suitable, suitably, significant(ly), minimal(ly), maximal(ly), approximately, almost, nearly, generally, usually, typically, normally, robust(ly), flexible, flexibly, easy, easily, etc, similar, relevant, substantial(ly), large, small, good, bad, better, best, worst, proper, properly, acceptable, acceptably, accurate(ly), extreme, high-contrast, high contrast.
R8R8 - סעיפי מילוט מחלישים את הדרישה: [...]if necessary, where possible, as appropriate, as practicable, as far as possible, if practical, as required, as needed, to the extent possible, if possible.
R10R10 - ביטויי מקור מיותרים: [...]to be designed to, to be able to, to be capable of, to enable, to allow, be able to, be capable of.
R16R16 - יש להימנע משלילה: [...]not, n't, never.
R17R17 - יש להימנע מקו נטוי ("/").קו נטוי בין שתי מילים, מלבד km/h, m/s, and/or והמקבילות שלו בגרמנית, בצרפתית, בספרדית, באיטלקית ובהולנדית.
R24R24 - כינויי גוף במקום שמות עצם מפורשים: [...]it, its, they, them, their, he, she, him, her, someone, something, anyone, anything, anybody, somebody, this, these, those.
R32R32 - יש להשתמש ב-"each" במקום מכמתים כלליים: [...]all, any, both, every, everything, everyone.
R34R34 - מונחי ביצועים שאי אפשר למדוד: [...]fast, quick, quickly, user friendly, user-friendly, high speed(s), high-speed, best practice(s), state of the art, state-of-the-art, seamless(ly), intuitive(ly), easy to use, timely, rapid, rapidly, real-time, real time. "Real-time clock" אינו נספר: הוא שם של רכיב.
R35R35 - מילות תזמון לא ברורות: [...]as, eventually, before, after, until, meanwhile, simultaneous(ly), soon, later, sometimes, occasionally, often, subsequently, previously.
—יש להחליף את מציני המיקום TBD/TBR.TBD, TBR או TBS בתיאור (באותיות רישיות).
—AI: עמום — <reason>ממצא AI שהתקבל מבדיקת הדרישות עם AI.
—מציין מקסימום ("up to"); אם הכוונה למינימום, יש להשתמש ב-"at least"."up to" ואחריו מספר, בספרות או במילים ("up to 72 hours", "up to five tonnes"). "Up to date" אינו נספר.

שלמה

כללהודעהמופעל על
—חסר תיאור.תיאור ריק.
—חסר שם.שם ריק.
R9R9 - ניסוח של רשימה פתוחה: [...]including but not limited to, etc, and so on, and so forth, such as, among others.

יחידה

כללהודעהמופעל על
R18R18 - יש לכתוב משפט יחיד (נמצאו N).יותר ממשפט אחד (גם משפטים ביפנית ובסינית שמסתיימים ב-。, ! או ?).
—יש לסיים את ההצהרה בנקודה.תיאור שאינו מסתיים ב-"." (או 。).
R19R19 - מחבר שתי דרישות; יש לפצל לדרישות נפרדות: [...]and, or, but, however או whereas שמחברים שתי פעולות או שתי חובות ("shall log and report each fault", "… and the operator shall …"), "nor shall", משפט שני אחרי ";"; "and/or" לפני פעולה שנייה. ראו שתי דרישות באחת (R19).
R19R19 - "and/or" אינו חד-משמעי; יש לציין אם הכוונה לשניהם או לאחד: [and/or]"and/or" בין ערכים או בתנאי.
R19R19 - מחבר שני ערכים; יש לפצל אם כל אחד מאומת בנפרד: [...]and, or שמחברים שני אובייקטים או ערכים אחרי פעולה אחת ("measure the temperature and the humidity"). הערה: Singular נשאר Yes.
R20R20 - מכיל ביטויי תכלית; יש להעביר לנימוק: [...]purpose of, in order to, so that, for the purpose of, so as to.
R21R21 - מכיל סוגריים; יש להעביר את הטקסט שבסוגריים לנימוק."(" או "[" (גם סוגריים ברוחב מלא).

תואמת

הודעהמופעל על
יש להשתמש בפועל מודאלי: [need, shall, will, should, must]אף אחת מהמילים האלה לא מופיעה.

הולמת

כללהודעהמופעל על
R31R31 - כופה פתרון: [...]using, by means of, utilizing, utilising, implemented in, implemented with, via a, via the, built with, written in.

נחוצה

כללהודעהמופעל על
R30R30 - דומה מאוד: [3.2 Battery Capacity (81.3% similar), ...]דרישה אחרת בהיקף שהתיאור שלה דומה ב-75% לפחות (דמיון של זוגות תווים). הממצא מציין עד חמש ומונה את השאר ("and 3 more"). ההורה הישיר והצאצאים של הדרישה (decomposed by, decomposes) אינם מושווים: עידון חוזר לעיתים קרובות על הניסוח של ההורה שלו. אחים ודרישות לא קשורות כן מושווים.

ניתנת לאימות

הודעהמופעל על
יש לקשר Test Case או Requirement שמאמתים אותה.לדרישה אין קישור verified by ל-Requirement או ל-Test Case.
AI: לא ניתן לאימות כפי שנכתב — <reason>ממצא AI שהתקבל מבדיקת הדרישות עם AI.

ישימה

כללהודעהמופעל על
R26R26 - מונחים מוחלטים שקשה להשיג: [...]always, never, 100%, 100 percent, all the time, totally, completely, absolutely, zero defects, forever, continuous, continuously, uninterrupted.
—דורש שיקול דעת של סוקרלא נמצאו מונחים מוחלטים ולא כמעט-כפילויות; אדם צריך להחליט.

נכונה

הודעהמופעל על
דורש שיקול דעת של סוקרכל בדיקת טקסט (Appropriate, Complete, Conforming, Necessary, Singular, Unambiguous) עברה; אדם צריך להחליט.

מכיוון ש-Correct ו-Feasible מסתיימים ב-"דורש שיקול דעת של סוקר" עד שמישהו מחליט, הציון האוטומטי הגבוה ביותר הוא 7 מתוך 9 (78%).

שתי דרישות באחת (R19)

דרישה מציינת דבר אחד. R19 בוחן כל "and", "or", "nor", "but", "however", "whereas", "as well as" ו-"and/or" וממיין אותו לאחד מהסוגים האלה:

סוגדוגמהתוצאה
שתי דרישות"The unit shall log and report each fault." "The pump shall stop, and the operator shall be alerted." "… to acknowledge alarms and to silence the horn." "…; it shall also …"ממצא. Singular הוא No.
"and/or" עמום"The log shall record the user ID and/or the badge number."ממצא: יש לציין אם הכוונה לשניהם או לאחד. Singular הוא No.
שני ערכים"The station shall measure the temperature and the humidity."הערה: יש לפצל אם כל ערך מאומת בנפרד. Singular נשאר Yes; ההערה מוצגת באפור ואינה מורידה את הציון.
אין ממצא"between 5 °C and 30 °C"; "When A and B, the unit shall …"; "… when the door is open and the fan is off"; "requirements 2.1 and 2.2"; טקסט במירכאות; "The command and control unit shall …"; "ASME Boiler and Pressure Vessel Code"; "5 Nm at 3000 rpm and 24 V"; "including batteries and strap"; "either open or closed"כלום.

שני ערכים של אותו גודל ("at -20 °C and 60 °C") מקבלים את ההערה. ", and" מסיים תנאי: "… when the level falls below 10 %, and restart when …" הוא ממצא. נושא שפועל כאחד ("The Owner and the Contractor shall agree …", "The power and data connector shall …") לא מקבל הערה; שני נושאים שכל אחד מהם פועל ("The pump and the valve shall close …") מקבלים את ההערה. משווים ("12 or more") אינם מסומנים. אי אפשר להבחין בין שם שבא אחרי הפעולה לבין שני ערכים, ולכן יש להוסיף אותו לרשימה תחת שמות מורכבים.

שמות מורכבים. בדף איכות, עוד ▾ ← שמות מורכבים… פותח את רשימת הפרויקט של שמות שמכילים "and" או "or" אבל מציינים דבר אחד, אחד בכל שורה (לדוגמה "power and data connector"). R19 אינו מסמן אותם. גם הרחבות במילון ראשי התיבות של הפרויקט (הצהרות Acronym, ראו מציאת ראשי תיבות) נספרות, וכמה שמות נפוצים מובנים ("command and control", "research and development", "operations and maintenance", …). הרשימה נשמרת עם הפרויקט ואפשר לבטל שינויים בה. כדי להחיל שינוי, יש ללחוץ שוב על בדיקת איכות.

דרישות בשפות אחרות

Holarch מזהה את השפה של כל דרישה מהטקסט שלה. כללי המילים (R2–R10, R16, R19, R20, R24, R26, R31–R35, "up to", הפועל המודאלי, היחידות) נותנים ציון לדרישות באנגלית.

גרמנית, צרפתית וספרדית (בטא). הדרישות האלה מקבלות את אותם כללים בשפה שלהן, לדוגמה "angemessen" או "bei Bedarf" בגרמנית, "approprié" או "si possible" בצרפתית, "adecuado" או "según corresponda" בספרדית. כל עוד הכללים של שפה נמצאים בבטא:

  • כל ממצא הוא הצעה שמסומנת (בטא). הוא מוצג באפור עם ההערות האחרות ולעולם אינו מוריד קריטריון או את הציון;
  • מוצגת ההערה "כללי הניסוח לשפה הזו בגרסת בטא: הצעות בלבד, ללא ציון. בדיקות המבנה חלות.", ו-Unambiguous הוא – (לא נבדק) עד שהניסוח נבדק עם AI או מדורג ידנית;
  • המילים ל-"each" (jede, chaque, cada) הן הבחירה הנכונה ואינן מסומנות, וגם לא "alle 5 s" או "tous les 5 s" (כל 5 שניות).

כלל מתחיל להיספר בשפה רק אחרי שנמדד על 300 הצהרות לפחות שנכתבו בשפה הזו ונסקרו על ידי מהנדס דרישות דובר השפה כשפת אם (90% לפחות מהממצאים שלו נכונים), והסוקר אישר אותו. כשזה קורה, הציונים לשפה הזו עשויים להשתנות בבדיקה הבאה; הערות השחרור מציינות זאת.

שפות אחרות (יפנית, איטלקית, סינית והשאר) מקבלות:

  • את ההערה "כללי הניסוח מכסים אנגלית. בדיקות המבנה חלות." ו-– (לא נבדק) עבור Unambiguous: מושמט מהציון עד שהניסוח נבדק או מדורג ידנית. ממצא Unambiguous אחר, כמו TBD, עדיין מכשיל אותו;
  • את הבדיקות לכל שפה: R18 (גם 。), הנקודה בסוף (גם 。), R17, R21, TBD/TBR, R30, השם, התיאור וקישור האימות.

כל שפה, בבטא או לא, מקבלת גם את הבדיקות האלה. ההצעות נשמרות באנגלית עם המילים במירכאות כפי שנכתבו ("R7 - Imprecise wording: [angemessen] (beta)"), כך שהמסנן quality:R7 והייצוא עובדים באותו אופן בכל שפה. ה-API הציבורי מחזיר אותן עם הכלל, המילים והמצב שלהן (findings).

בדיקת ניסוח עם AI. ✦ AI ▾ ← בדיקת ניסוח עם AI… בדף איכות (או ✦ עוד AI ▸ בדרישה אחת) מחיל את אותם כללים דרך ה-AI שהוגדר, בשפה של כל דרישה. התצוגה המקדימה מציגה את הממצאים וניסוח מחדש אופציונלי בשפה הזו (לא מסומן). החלת הנבחרים מוסיף את הממצאים כממצאי AI ומסיר את ההערה (הצעות הבטא נשארות כהערות), כצעד ביטול אחד. עריכת הטקסט מנקה אותם. נדרשת תוכנית עם AI.

עקיפות ידניות

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

  • בדף איכות: לחיצה על תא של קריטריון עוברת בין המצבים שלו: הלחיצה הראשונה מגדירה Yes ידני (✔), הבאה No ידני (✘), והשלישית מנקה את הערך הידני כך שהבדיקה האוטומטית מחליטה שוב. תא ידני מציג סמן ידני; טיפ הכלים שלו מציין "(הוגדר ידנית)" ומה הלחיצה הבאה עושה.
  • בחלונית המאפיינים או בתצוגת הפריט: כל קריטריון הוא רשימה עם כן ולא. קריטריון שהוגדר ידנית מציע גם אוטומטי (בדיקה חוזרת), שמחזיר אותו לתוצאה האוטומטית. ערכים שהוגדרו ידנית מציגים "ידני".

ערך ידני נשמר כשהבדיקה רצה מחדש. No ידני בלי הודעה אחרת מציג "סומן No ידנית."

עקיפות מנוקות בשני מקרים:

  • השם או התיאור של הדרישה משתנים. העקיפות נשארות בהיסטוריה, וביטול הפעולה מחזיר אותן.
  • בחירה ב-עוד ▾ ← ניקוי הדירוגים הידניים. זה מנקה גם ממצאי AI שהתקבלו.

תוצאות לא עדכניות

כשהשם או התיאור של דרישה משתנים אחרי בדיקה, התוצאות שלה מסומנות כלא עדכניות:

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

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

בדיקת איכות ממסמך

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

התוצאות נפתחות בתיבת הדו-שיח Check Quality — <name>, עם האריחים והטבלה. הלחצנים שלה הם ייצוא CSV, ייצוא XLSX, פתיחה באיכות וסגירה.

מסמך בלי דרישות מציג "אין במסמך הזה Requirements לבדיקה. Statements לא מקבלים ציון."

בדיקת דרישות עם AI

בדיקת הדרישות עם AI נותנת חוות דעת ראשונה על הקריטריונים שכלל אינו יכול להכריע בהם: Correct, Feasible ו-Necessary. היא מחפשת גם ניסוח שהכללים מפספסים תחת Unambiguous (לדוגמה "up to 72 hours" כשנראה שהכוונה למינימום, או "accurately" בלי מדד) ו-Verifiable (שום בדיקה, ניתוח, בחינה או הדגמה לא יכולים להראות שהדרישה מתקיימת כפי שנכתבה). ה-AI מקבל את ממצאי הכללים ומדווח רק על מה שהם מפספסים.

  1. יש לבחור ✦ AI ▾ ← בדיקה עם AI (N דרישות)….

    לדרישה אחת, יש לבחור בדיקה עם AI (הדרישה הזו)… בתפריט ✦ AI ▾ שלה, או ✦ עוד AI ▸ ← ✦ בדיקה עם AI… בתפריט הלחיצה הימנית שלה.

    Claude סוקר את הדרישות. הן נשלחות בקבוצות של 20, עם עד 300 דרישות אחרות לבדיקת כפילויות. ב-AI הכלול, הבדיקה נספרת כבקשה אחת לכל 100 דרישות (מעוגל כלפי מעלה); לפני שבדיקה של יותר מ-100 דרישות רצה, תיבת דו-שיח מציינת בכמה בקשות היא משתמשת, לדוגמה "הסקירה הזו משתמשת ב-3 מתוך 52 בקשות ה-AI הכלולות שנותרו לך החודש (בקשה אחת לכל 100 דרישות)." בדיקה שצריכה יותר בקשות ממה שנותר אינה מתחילה.

  2. יש לסקור כל דרישה בתיבת הדו-שיח.

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

  3. יש לסמן את השינויים והניסוחים מחדש שמתקבלים.

    השורה שמעל הלחצנים סופרת מה ההחלה עושה, לדוגמה "מחיל 7 ערכים ו-2 ניסוחים מחדש על 5 דרישות." כשלא סומן דבר היא מציגה "לא נבחר דבר." והחלת הנבחרים מעומעם.

  4. יש ללחוץ על החלת הנבחרים.

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

לכל דרישה, תיבת הדו-שיח מציגה:

  • הכרעת Yes/No ונימוק עבור Correct, Feasible, Necessary, Unambiguous ו-Verifiable.
  • מתחת לכל הכרעה, תיבת סימון שהתווית שלה מציינת מה ההחלה משנה, או "ללא שינוי" בלי תיבת סימון כשהערך השמור כבר תואם:
    • Correct, Feasible ו-Necessary: "No ← Yes" או "Yes ← No" כשההכרעה שונה מהערך השמור, "הגדרה ל-Yes" או "הגדרה ל-No" כשאין ערך.
    • Unambiguous ו-Verifiable: "מוסיף ממצא" כשה-AI מצא בעיה, ו-"מנקה את הממצא הקודם" כשממצא AI קודם כבר אינו תקף.
  • תגובה אופציונלית.
  • כשה-AI מציע ניסוח מחדש, תיבת סימון החלת הניסוח מחדש: עם השוואת מילים.

מה מתחיל מסומן:

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

סימון ניסוח מחדש מעמעם את תיבות Unambiguous ו-Verifiable של הדרישה ומתייג אותן "נבדק שוב אחרי הניסוח מחדש": בדיקות הכללים רצות שוב על הטקסט החדש. ביטול הסימון של הניסוח מחדש מחזיר את התיבות כפי שהיו. Correct, Feasible ו-Necessary עדיין מוחלים.

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

מה ההחלה עושה:

  • Correct, Feasible ו-Necessary הופכים לערכי Yes/No ידניים.
  • No ב-Unambiguous או ב-Verifiable הופך לממצא AI: הדף איכות מציג אותו עם ממצאי הכללים, כ-"AI: עמום — <reason>" או "AI: לא ניתן לאימות כפי שנכתב — <reason>", והקריטריון מציג ✘. Yes מסיר ממצא AI קודם.
  • ממצאי AI מנוקים כשהשם או התיאור של הדרישה משתנים (גם על ידי ניסוח מחדש שהתקבל) ועל ידי עוד ▾ ← ניקוי הדירוגים הידניים.

מה החלת הנבחרים עושה:

  • הכרעות הופכות לערכים ידניים, עם ההודעה "AI: <reason>". הן נשמרות כשהבדיקה רצה מחדש.
  • ניסוחים מחדש מחליפים את התיאור ומריצים את הבדיקה מחדש.

ייצוא איכות

ייצואתוכן
ייצוא ▾ ← CSV (quality_report.csv)שורה אחת לכל דרישה וקריטריון: Number, Name, Description, Quality Score, Attribute, Message, Result.
ייצוא ▾ ← Excel (.xlsx) (quality_report.xlsx)Number, Name, Description, Rationale, Quality Score, Attribute, Message, Result, כשתאי הדרישה ממוזגים לאורך תשע השורות שלה, Yes בירוק ו-No באדום, וציון הדוח (תשובות Yes מתוך כל התשובות) בסוף.
במסמך מסירה ▾ ← כל הייצואים… ← ממצאי איכות (Excel)אותה פריסה למסמך אחד, עם עמודות התצוגה של המסמך.

אישורים

צרכים ודרישות ← אישורים מציג את כל מה שממתין להחלטה. הוא פותח את מסד הנתונים עם השאילתה Requirement:"Status=In Review".

יש בו כל תכונה של מסד הנתונים:

  • בחירת כמה שורות ושימוש בסרגל הפעולות המרובות כדי להגדיר Status או תוויות יחד.
  • ייצוא הרשימה.
  • לחיצה כפולה על שורה פותחת את תצוגת הפריט ואת ההיסטוריה המלאה.

תיבת האישור

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

  • הסטטוס הנוכחי כצ׳יפ צבעוני (Draft כשלא הוגדר סטטוס).
  • ההחלטה האחרונה שתועדה: "<status> by <name> · <date and time>", ואחריה "— <note>" כשיש הערה (לדוגמה "— הטקסט השתנה אחרי האישור"), או "לא נרשם אישור".
  • הלחצנים שחלים על הסטטוס הנוכחי:
לחצןמוצג כאשרהשפעה
אישורהסטטוס אינו Approved ואינו Rejectedמגדיר Approved ומתעד אותך ואת השעה. הודעה קופצת: "מאושר".
דחייה…הסטטוס אינו Approved ואינו Rejectedמבקש סיבה (אופציונלי) בתיבת הדו-שיח דחיית הדרישה, ואז מגדיר Rejected. הודעה קופצת: "נדחה".
פתיחה מחדשהסטטוס הוא Approved או Rejectedמגדיר In Review. הודעה קופצת: "הועבר ל-In Review".

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

כשזרימת עבודה מעבירה את המעבר ל-Approved דרך בקשת שינוי, התיבה מציגה במקום זאת את הבקשה הפתוחה ואת הספירה שלה, לדוגמה CR-4: 1 of 3 approvals. אחרי ההחלה, ההחלטה מציינת כל מאשר ואת הבקשה: "Approved by Ann Lead, Bob Discipline · <date and time> · CR-4".

הערה: עריכה של השם או התיאור של דרישה במצב Approved מגדירה אותה ל-In Review, עם ההערה "הטקסט השתנה אחרי האישור". ההודעה הקופצת מדווחת "N דרישות מאושרות הועברו ל-In Review." שינוי מאפיינים אחרים אינו פותח אותה מחדש.

מרשם TBD/TBR

המרשם משמש למעקב אחרי כל פריט פתוח עד שהוא נסגר. יש לפתוח את צרכים ודרישות ← TBD/TBR. ממסמך, יש לבחור בדיקה ▾ ← מרשם TBD/TBR כדי לפתוח את המרשם בהיקף של המסמך הזה.

  • כותרת הדף: ייצוא XLSX (מושבת כשהמרשם ריק).
  • סרגל ההיקף: טווח (כל הדרישות או Document: <name>).
  • אריחים: TBD/TBR פתוחים, באיחור, ללא בעלים, וצ׳יפים של לפי מסמך ("<document>: <count>") שפותחים כל מסמך.
  • פריטים פתוחים לאורך זמן: תרשים burn-down של מספר הפריטים הפתוחים. הוא נבנה מחדש מההיסטוריה של הדרישות, עם עד 60 נקודות מהדרישה הוותיקה ביותר ועד עכשיו. הצבעה על נקודה מציגה את התאריך ואת הספירה שלה. כשאין מספיק היסטוריה מוצג "אין עדיין מספיק היסטוריה לתרשים burn-down."
  • עמודות הטבלה:
    • מספר, ושם עם התיאור.
    • מסמך.
    • סוג: TBD, TBR או TBS, עם "attribute", "in text" או שניהם.
    • בעלים: ה-TBD Owner, אחרת ה-Owner של הדרישה, אחרת "—".
    • תאריך יעד: תאריך היעד האחד של הדרישה, אותו תאריך כמו תאריך יעד בקבוצה זרימת עבודה של חלונית המאפיינים ובתצוגת הפריט. זה המאפיין TBD Due Date כשיש בו תאריך, אחרת תאריך היעד של הדרישה. מציג "באיחור" מתחת לתאריך שעבר. שורות באיחור צבועות.
    • גיל: הימים מאז שהפריט נפתח.
    • סגירה.

לחיצה ימנית על שורה, או Shift+F10 עליה, פותחת את אותו תפריט שורה כמו במסד הנתונים: פעולות מוצעות עם הסיבות שלהן, ✦ עוד AI ▸, פתיחה, שינוי שם…, שכפול, הוספת צאצא…, סטטוס ▸, עדיפות ▸, יצירת קשר אל ▸, הוספה למסמך ▸, הצגה בדיאגרמה ▸, העתקת קישור, העתקת המספר ומחיקה…. בתפריטי לחיצה ימנית אחרים, דרישה עם TBD או TBR פתוח מתחילה ב-פתרון TBD…, שפותח את המרשם הזה כשהדרישה נבחרה.

המרשם הוא לקריאה בלבד. כדי לשנות תאריך יעד, יש לבחור את השורה ולהגדיר תאריך יעד בחלונית המאפיינים. Holarch מגדיר את תאריך היעד של הדרישה, וכשהמאפיין TBD Due Date מכיל תאריך, גם את המאפיין הזה (תוך שמירה על השעה שלו), וביטול פעולה אחד מחזיר הכול לאחור. ניקוי תאריך יעד מנקה את שניהם.

סגירה מופיע רק כשהמאפיין TBD/TBR מוגדר. הוא מגדיר את המאפיין ל-None:

  • כשלא נשאר דבר בטקסט, ההודעה הקופצת מציגה "סגור".
  • כש-TBD, TBR או TBS עדיין בטקסט, ההודעה הקופצת מציגה "המאפיין נסגר; הטקסט עדיין מכיל TBD."
  • לפריט שנובע רק מהטקסט אין לחצן סגירה; כדי לסגור אותו יש לערוך את הטקסט.

כששום דבר אינו פתוח, הדף מציג "אין פריטי TBD/TBR פתוחים. כדי להציג דרישה כאן, יש להגדיר את המאפיין TBD/TBR שלה, או לכתוב TBD, TBR או TBS בטקסט שלה."

ייצוא XLSX כותב את TBD-TBR Register.xlsx עם Number, Name, Document, Type, Source (מאפיין, טקסט או שניהם), Owner, Due Date, Opened, Age (ימים), Overdue (Yes באדום) ו-Description.

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

השינויים האלה בדרישה מסמנים את הקישורים שלה לבדיקה:

  • שם או תיאור.
  • Priority, Criticality, Verification Method או Verification Level.
  • כל מאפיין מספרי, של אחוז או של משך.

Holarch מסמן אז כל אחד מהקישורים של הדרישה מהסוגים האלה: decomposed by, derived by, refined by, satisfied by, verified by ו-traced to.

שינוי ב-Verification Method או ב-Verification Level מסמן רק את קישורי verified by. הגדרת השיטה או הרמה הראשונות של דרישה אינה מסמנת דבר: היא מתכננת את האימות ואינה משנה דבר שנבדק.

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

  • הדף קישורים לבדיקה: שורה אחת לכל קישור לבדיקה.
  • מסמכים ומסד הנתונים: תג ⚠ בדיקה בשורה של הפריט ("הפריט בקצה השני השתנה אחרי הבדיקה האחרונה של הקישור. יש לוודא שהקישור עדיין תקף ואז לסמן אותו כנבדק. לחיצה לבדיקה.").
  • חלונית המאפיינים ותצוגת הפריט: באנר "⚠ בדיקה: <requirement> השתנה אחרי הבדיקה האחרונה של הקישור. יש לוודא שהקישור עדיין תקף ואז לסמן אותו כנבדק." הלחצן בדיקה… שלו פותח את תיבת הדו-שיח Links to Review — <item> עבור הפריט הזה, עם קישורים פתוחים לבדיקה וסגירה.
  • המקטע עקיבות בחלונית המאפיינים: ⚠ ליד כל קישור לבדיקה, עם השדות שהשתנו והתאריך בטיפ הכלים שלו.
  • RVTM: ⚠ אחרי דרישה עם קישור לבדיקה באחד הקצוות (היא השתנתה, או שהפריט במעלה הזרם שלה השתנה); לחיצה עליו בודקת את הקישורים האלה. ⚠ אחרי מקרה בדיקה ב-מאומת על ידי מסמן את קישור האימות הזה.

הדף מסביר את הכלל בראש הדף ומציג טבלה:

עמודהתוכן
(תיבת סימון)בחירה עבור סימון הנבחרים כנבדקים…. תיבת הסימון בכותרת בוחרת הכול.
שונההדרישה שהשתנתה.
שינויהשדות שהשתנו, לדוגמה "Description" או "Priority, Verification Level".
מתי / על ידי מיהתאריך והשעה של השינוי ומי ביצע אותו.
קשרסוג הקישור, כפי שהוא נקרא מהדרישה שהשתנתה (לדוגמה "satisfied by").
פריט לסקירההפריט שבקצה השני של הקישור.
(פעולות)השוואה וסימון כנבדק….

לחיצה ימנית על שורה, או Shift+F10 עליה, פותחת את תפריט השורה של הפריט, כמו במסד הנתונים: פעולות מוצעות, ✦ עוד AI ▸, פתיחה, שינוי שם…, שכפול, הוספת צאצא…, סטטוס ▸, עדיפות ▸, יצירת קשר אל ▸, הוספה למסמך ▸, הצגה בדיאגרמה ▸, העתקת קישור, העתקת המספר ומחיקה…. בתפריטי לחיצה ימנית אחרים (מסד הנתונים, מסמכים), פריט עם קישור לבדיקה מתחיל ב-בדיקת הקישור…, שפותח את הבדיקה עבורו.

השוואה פותח את Change — <requirement> עם השוואת מילים של השם והתיאור. כשרק מאפיינים השתנו, מוצג "רק מאפיינים השתנו: <fields>. לפרטים יש לפתוח את היסטוריית הישות." היסטוריה… פותח את ההיסטוריה של הדרישה.

כדי לסמן קישורים כנבדקים:

  1. יש ללחוץ על סימון כנבדק… בשורה, על סימון הנבחרים כנבדקים… עבור השורות המסומנות, או על Mark All Reviewed (N)….

    נפתח Mark N Link(s) Reviewed: "יש לאשר שהפריטים המקושרים עדיין תקפים אחרי השינוי. תגובה נוספת לכל פריט מקושר."

  2. אפשר להקליד תגובה, לדוגמה "הצאצא עדיין תקף; אין צורך בשינוי."
  3. יש ללחוץ על סימון כנבדק.

    ההודעה הקופצת מציגה "N קישורים סומנו כנבדקים."

סימון הנבחרים כנבדקים… כשלא נבחר דבר מציג "יש לבחור קודם קישורים לסימון כנבדקים."

סימון קישור כנבדק מתעד את הבדיקה בקישור: מי, מתי, התגובה והשדות. כשנכתבה תגובה, Holarch מוסיף גם "הקישור נבדק (<requirement> השתנה: <fields>): <comment>" לתגובות של כל פריט. ביטול הפעולה מבטל זאת.

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

קווי בסיס והשוואת גרסאות

קווי בסיס של מסמך

יוצרים קווי בסיס של מסמך ומשתמשים בהם עם גרסה ▾ בבלוק הכותרת של המסמך. הוא מציג:

  • הגרסה הנוכחית: המסמך החי.
  • כל קו בסיס של המסמך הזה, החדש ביותר קודם, עם התאריך שלו.
  • תחת קווי בסיס של הפרויקט, כל קו בסיס של הפרויקט.
  • שמירת קו בסיס… והשוואת גרסאות… (מעומעם עד שיש למסמך קו בסיס: "יש לשמור קו בסיס תחילה").

שמירת קו בסיס… פותח את שמירת קו בסיס:

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

בחירת קו בסיס ב-גרסה ▾ מציגה אותו. המסמך הופך לקריאה בלבד, עם הבאנר "קו הבסיס “<name>”, לקריאה בלבד, נשמר <date>" ורשימת האישורים. הלחצנים האלה מופיעים:

לחצןהשפעה
חזרה לנוכחיחוזר למסמך החי.
עריכהעריכת קו הבסיס: שינוי השם שלו והוספת רשומות אישור. אישורים (נעולים) מציג את הרשומות הקיימות, שאינן יכולות להשתנות; רשומות חדשות "מתוארכות כעת ומתווספות לרשימה". רק בקווי בסיס של מסמך.
השוואה לנוכחיפותח את השוואת גרסאות מקו הבסיס הזה. רק בקווי בסיס של מסמך.
שחזור קו הבסיסקו בסיס של מסמך: "לדרוס את הישויות, הסדר והמבנה של המסמך הזה בקו הבסיס "<name>"? ישויות שנוספו מאז מוסרות מהמסמך (לא נמחקות). אפשר לבטל את הפעולה." קו בסיס של פרויקט: החלפת הפרויקט בקו הבסיס, "להחליף את הפרויקט כולו בקו הבסיס של הפרויקט "<name>"? אפשר לבטל את הפעולה."
מחיקה"למחוק את קו הבסיס "<name>"?"

במסמך החי, כל שורה נושאת פס שינוי: חדשה מאז קו הבסיס, השתנתה מאז קו הבסיס, או ללא שינוי. ההשוואה היא מול קו הבסיס האחרון של המסמך, או מול קו הבסיס האחרון של הפרויקט כשאין למסמך קו בסיס.

השוואת גרסאות

דוח השינויים מציג בדיוק מה השתנה מאז סקירה.

  1. יש ללחוץ על גרסה ▾ ← השוואת גרסאות…, או על השוואה לנוכחי בבאנר של קו בסיס.

    נפתח השוואת גרסאות.

  2. יש לבחור מ: קו בסיס.
  3. יש לבחור אל: קו בסיס מאוחר יותר, או הגרסה הנוכחית.

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

סוגי שינוי:

סוג שינוימשמעות
נוסף / הוסרהישות הצטרפה למסמך או יצאה ממנו.
שונהשדה השתנה: Name, Number, Description, Class, Image או כל מאפיין (השדה מצוין בשמו).
התווית נוספה / התווית הוסרהתווית נוספה או הוסרה.
הקשר נוסף / הקשר הוסרקישור שנוגע במסמך נוסף או הוסר.
מאפיין קשרהמאפיינים של קשר השתנו.

שינויים (Excel) כותב את "<document> (Changes).xlsx" עם Number, Name, Class, Change Type, Field, Old Value ו-New Value. סימון שינויים (Word) כותב את אותה השוואה כשינויים במעקב של Word.

מסירה ▾ ← שינויים (Excel)… של המסמך (גם בכל הייצואים…) מייצא את אותו דוח עם מ ואל. הוא נכשל עם "אין למסמך הזה קו בסיס. יש לשמור קו בסיס קודם." כשאין קו בסיס.

מסמך (Word) ממלא את טבלאות היסטוריית הגרסאות והאישורים בפלט ה-Word מקווי הבסיס של המסמך.

הדף קווי בסיס וגרסאות

בקרה וסקירות ← קווי בסיס וגרסאות משמש לניהול כל קו בסיס בפרויקט. קווי בסיס של פרויקט מכילים כל ישות; קווי בסיס של מסמך מכילים מסמך אחד ונוצרים עם גרסה ▾ ← שמירת קו בסיס… של המסמך. בכותרת הדף יש שחזור גרסה קודמת…, שמחזיר שמירה אוטומטית קודמת של הפרויקט כולו, ו+ שמירת קו בסיס….

כדי ליצור קו בסיס של פרויקט:

  1. יש ללחוץ על + שמירת קו בסיס… בכותרת הדף.

    תיבת הדו-שיח שמירת קו בסיס של הפרויקט מציגה את מספרי הישויות והקשרים הנוכחיים. ברירת המחדל של השם היא "Baseline <n>"; מציין המיקום מציג "שם, לדוגמה "SRR"".

  2. יש להקליד שם, ואז להקיש Enter או ללחוץ על שמירת קו בסיס. שם ריק נדחה ("יש להזין שם.").

    ההודעה הקופצת מציגה "קו הבסיס נשמר".

הכרטיסים של הדף:

  • הכרטיס קווי בסיס: המספרים הנוכחיים ("נוכחי: <n> פריטים, <n> קשרים") ומסנן: כל קווי הבסיס, קווי בסיס ברמת הפרויקט או Document: <name>. עמודות:
    • שם.
    • מסמך: קישור לצפייה במסמך כפי שהיה בקו הבסיס הזה, או "פרויקט".
    • נוצר.
    • אישורים: "✔" ושמות המאשרים. הצבעה עליהם מציגה תפקיד, תאריך והצהרה. "by <name>" מציין את היוצר.
    • ישויות וקשרים.
    • השוואה: מגדיר את קו הבסיס הזה כ-מ ואת עותק העבודה הנוכחי כ-אל.
    • ⋯ (פעולות נוספות):
      • שינוי שם…: שינוי שם קו הבסיס.
      • ייצוא (JSON): מוריד את "<name>.json" (פורמט holarch-baseline, עם תמונת המצב והאישורים).
      • שחזור קו בסיס… (קו בסיס של פרויקט): "להחליף את כל הישויות והקשרים הנוכחיים בקו הבסיס "<name>"? אפשר לבטל את הפעולה (⌘Z / Ctrl+Z)." הודעה קופצת: ""<name>" שוחזר".
      • החזרת המסמך… (קו בסיס של מסמך): "לשחזר את המסמך "<doc>" לקו הבסיס "<name>"? רק הישויות והמבנה של המסמך הזה משתנים. אפשר לבטל את הפעולה." מושבת כשהמסמך נמחק.
      • מחיקה…. בשירות המתארח רק בעלי הפרויקט משנים שם של קו בסיס או מוחקים אותו; עבור אחרים הפריטים האלה מעומעמים עם הסיבה.
  • קווי בסיס יתומים (מוצג לפי הצורך): "N קווי בסיס של מסמכים שנמחקו". לכל אחד יש שחזור המסמך, שיוצר מחדש את ה-Artifact של המסמך ואת הישויות שלו מקו הבסיס, ומחיקה.
  • הכרטיס השוואה: יש לבחור מ (הישן יותר) ואל (החדש יותר). אל הוא הגרסה הנוכחית או קו בסיס אחר מאותו היקף.
    • אריחים: ישויות שנוספו, ישויות שהוסרו, ישויות שהשתנו, שינויי קשרים.
    • הטבלה מציגה ישות, שינוי, שדה והבדל (השוואת מילים). מאפייני תאריך מוצגים בתבנית התאריך של האפליקציה.
    • ייצוא CSV וייצוא XLSX כותבים את "Changes <from> to <to>".
    • כשאין מה להציג: "אין הבדלים בין “<from>” לבין “<to>”."

כשאין קווי בסיס: "אין קווי בסיס. כדי לתעד את המצב הנוכחי של הפרויקט, יש ליצור אחד."

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

ייבוא דרישות

צרכים ודרישות ← ייבוא וייצוא משמש להכנסת דרישות מקבצים. הוא עובד בארבעה שלבים: קובץ ← מיפוי ← סקירה ← ייבוא.

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

הפורמטים הם Word (.docx), קובצי פרויקט של Holarch (.holarch, .json), Excel / CSV (.xlsx, .csv), טקסט פשוט (.txt), UML/SysML (.xmi, .uml, .mdzip) ו-ReqIF (.reqif).

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

שלב 1: קובץ

יש לשחרר קובץ על "יש לשחרר כאן קובץ או ללחוץ כדי לבחור קובץ", או להדביק טקסט בתיבה וללחוץ על ניתוח הטקסט (CSV עם שורת כותרת, ReqIF XML, XMI, JSON או טקסט של מסמך).

אפשרותערכיםהשפעה
פורמטששת הפורמטים שלמעלהמציג את הפורמט שזוהה. בחירה בפורמט אחר קוראת את אותו תוכן בדרך אחרת.
קידוד הטקסט (CSV, טקסט)אוטומטי, UTF-8, ISO-8859-1 / Windows-1252, Shift_JIS, Big5, UTF-16איך הבתים של הקובץ נקראים. שינוי שלו קורא את הקובץ מחדש.
גיליון (חוברות עבודה)"<name> (N שורות)"הגיליון לייבוא. הגיליון הראשון עם נתונים נבחר מראש.
  • טקסט פשוט: התיבה משאירה את התוכן המיובא ניתן לעריכה. אפשר לערוך אותו וללחוץ על הרצת הניתוח מחדש.
  • שורת המצב מציגה "נותח “<file>”: N שורות, M עמודות." (ועוד "(גיליון “<name>”)" וב-Word גם ", N טבלאות").

שלב 2: מיפוי

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

שדה ב-Holarchתוכן
שם, מספר, תיאורהשדות של הפריט עצמו.
מחלקה, תוויותשם המחלקה; שמות תוויות מופרדים ב-; , או |.
מספר ההורה, מזהה גלובליהמספר של ההורה; המזהה שמשמש להתאמת ישויות קיימות.
מאפייןכל מאפיין של המחלקה לשורות ללא מחלקה.
קשרכמה יעדים מפרידים ב-;.
מזהה שורה, מזהה שורת ההורה, מאפיין חדש (נוסף לסכמה)מבנה מקובצי ReqIF ו-XMI, ומאפיינים חדשים.

✦ AI ▾ ← הצעת מיפוי מציע שדה לכל עמודה. מיפוי מוצע מציג את השינויים, מסומנים, עם הנימוק של ה-AI; החלת המסומנים משנה את המיפוי. עדיין לא מיובא דבר.

Holarch מנחש את המיפוי מהכותרת:

כותרתממופה אל
Number, No, Num, #, ID Number, Req Number, Requirement Numberמספר
Name, Title, Short Name, Requirement Nameשם
Description, Text, Requirement, Requirement Text, Statement, Descתיאור
Class, Type, Entity Classסוג
Labels, Label, Tagsתוויות (ערכים מפרידים ב-; , או |)
Parent, Parent Numberמספר ההורה
Global ID, ID, GUID, UUIDמזהה גלובלי
שם של מאפיין (לדוגמה Priority, Rationale, Status)המאפיין הזה. "Method" ו-"Verification" ממופים ל-Verification Method.
שם של קבוצת תוויות (לדוגמה Verification Method כשאין מאפיין כזה)תוויות
שם של קשר (לדוגמה satisfied by)הקשר הזה; כמה יעדים מפרידים ב-;
Object Identifier, Origin IDמזהה גלובלי
Object Number, ReqIF.ChapterName, ReqIF.ForeignIDמספר
Object Heading, ReqIF.Name, Long Nameשם
Object Text, ReqIF.Text, ReqIF.Descriptionתיאור
ReqIF.Categoryסוג
ReqIF ID, XMI ID, Row ID / Parent IDמזהה שורה / מזהה שורת ההורה

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

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

אי אפשר למפות קריטריוני איכות, מאפיינים מחושבים ומאפייני קובץ.

מתחת לעמודות:

אפשרותערכיםהשפעה
מחלקה לשורות ללא מחלקהכל מחלקה; ברירת מחדל Requirementהמחלקה של שורות בלי ערך בעמודת Class ובלי כלל מחלקה תואם.
כללי מחלקותהתיאור מכיל מילה או ביטוי ← מחלקה+ כלל מוסיף כלל, × מסיר אותו. הכלל התואם הראשון חל על שורות בלי ערך Class.
התאמת ישויות קיימות לפימזהה גלובלי, שם, מספרשורות שתואמות ישות קיימת מעדכנות אותה במקום ליצור עותק. התאמות לפי שם ולפי מספר דורשות גם את אותה מחלקה.
התאמת ישויות קשורות לפימזהה גלובלי, שם, מספראיך ערכים בעמודות קשרים מוצאים את היעדים שלהם.
תבנית התאריך של עמודות תאריך (CSV)אוטומטי, yyyy-MM-dd HH:mm:ss, dd/MM/yyyy, MM/dd/yyyy, yyyyMMdd, מותאם אישית…איך תאי תאריך נקראים. מותאם אישית… מציג שדה לתבנית משלך (לדוגמה dd.MM.yyyy HH:mm) עם yyyy, MM, dd, HH, mm ו-ss.
תבנית המספור (Word, טקסט)ריק (אוטומטי), או סמנים כמו 1. a) (i), או מספרי נתיב כמו 1.1 או 1.1.aאיך פסקאות ממוספרות הופכות למתאר. בטקסט, התבנית מזוהה מהמספור וממולאת. סגנונות כותרת ומספור רשימות של Word אינם צריכים תבנית. ראו תבנית המספור.
מספור צאצאים מתחת להורה שלהם (1 → 1.1) (Word, טקסט)מופעל כברירת מחדלמספרי צאצאים שנוצרים הופכים ל-"3.1", "3.2" במקום "1", "2".

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

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

  • יש להגדיר כל טבלה כ-ישויות (אחת לכל שורה) או טבלה בתיאור.
  • יש למפות את העמודות שלה למספר, שם, תיאור, מחלקה, תוויות, מאפיין, מאפיין חדש או דילוג.
  • כותרות כמו ID, Req ID, Requirement ID, Ref או Paragraph ממופות למספר.
  • Shall, Shall Statement, Requirement Statement, Requirement Text, Statement או Text ממופות לתיאור.

טבלה עם עמודת מספר או תיאור ושורות "shall" מתחילה כישויות.

האזהרות שנמצאו עד כה מופיעות מתחת לעמודות, או "אין אזהרות."

שלב 3: סקירה

בודקים את התוצאה לפני ששום דבר משתנה. הסקירה מציגה את השינויים כפי שקווי בסיס וגרסאות משווה גרסאות (ראו קווי בסיס והשוואת גרסאות):

  • השורה הראשונה מציינת את הקובץ, את הפורמט ואת מספר הפריטים לכל מחלקה.
  • Create a requirements document from these N requirements מופיע כשכל פריט הוא Statement או Requirement (או תת-מחלקה), מסומן. בקבצים אחרים מוצג Create a document from these N items, לא מסומן. כשהוא מסומן, יש לבחור את סוג המסמך (ברירת מחדל מסמך דרישות), את השם (ברירת מחדל: שם הקובץ) והאם לבצע מספור מחדש של כל המסמך אחרי הייבוא.
  • אחר כך מוצגות האזהרות.
  • אריחים סופרים את הפריטים חדשים, הפריטים שעודכנו, הפריטים שההותאם, ללא שינוי והקשרים מהקובץ.
  • טבלת השינויים מציגה כל פריט חדש עם התיאור שלו, וכל שדה שהשתנה בפריט שעודכן עם השוואת מילים של הערך הישן והחדש (500 השינויים הראשונים).

יש ללחוץ על Import N items. ההודעה הקופצת מציגה "יובאו N חדשים, M עודכנו".

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

התיאור של המסמך החדש מציג את אזהרות הייבוא.

איך כל פורמט נקרא

Word (.docx):

  • כותרות ומספור רשימות של Word הופכים למתאר ושומרים על המספרים שלהם.
  • כותרת הופכת ל-Statement. טקסט גוף מתחתיה הופך לתיאור שלה.
  • פסקה עם shall, must, will או should הופכת ל-Requirement צאצא, ששמו נלקח מהמילים שאחרי הפועל המודאלי. גם פריט ברשימה ממוספרת; בלי פועל מודאלי הוא הופך ל-Statement.
  • תבליטים, תמונות וטבלאות מצטרפים לתיאור של הפריט שהם באים אחריו, ושומרים על הדגשה, נטייה, רשימות וטבלאות.
  • קובץ ה-.docx המקורי מצורף למסמך החדש כשהוא בתוך מגבלת הקבצים המצורפים לכל קובץ.
  • תמונות PNG, JPEG, GIF, WebP ו-SVG נשמרות. פורמטים אחרים של תמונות מדולגים עם אזהרה.

Excel (.xlsx, .xlsm) ו-CSV:

  • שורה אחת לכל ישות, כל עמודה שהיא. השורה הראשונה היא הכותרת.
  • תאים מרובי שורות שומרים על מעברי השורה שלהם.
  • קובצי Excel 97-2003 (.xls) אינם נקראים. יש לשמור אותם קודם כ-.xlsx או כ-.csv.

ReqIF (.reqif, .reqifz):

  • כל SPEC-OBJECT הופך לשורה עם ReqIF ID, Parent ID (מהיררכיית המפרט), Type (סוג האובייקט שלו, ממופה ל-Class), Long Name ועמודה לכל הגדרת מאפיין.
  • עמודות בלי התאמה מקבלות כברירת מחדל מאפיין חדש. מאפייני XHTML הופכים למאפייני טקסט עשיר, ומאפייני מנייה הופכים לרשימות אפשרויות.
  • SPEC-RELATIONs הופכים לקשרים לפי שם. כשהשם אינו תואם קשר שהסכמה מתירה, הם הופכים ל-traced to.
  • ארכיון .reqifz נפרס אוטומטית.

טקסט פשוט (.txt) או טקסט מודבק:

  • שורה ממוספרת ("3.1 Battery"), או שורה קצרה בלי נקודה, הופכת לכותרת (Statement).
  • כל משפט עם shall, must, will או should הופך ל-Requirement תחת הכותרת הנוכחית.
  • טקסט אחר מצטרף לתיאור של הפריט הקודם.
  • עם תבנית מספור (שזוהתה מהטקסט, או הוקלדה), התבנית קובעת את הרמות.

עדכון דרישות מגיליון אלקטרוני

כך משנים הרבה דרישות בבת אחת בגיליון אלקטרוני.

  1. במסד הנתונים (או בדף דרישות), יש ללחוץ על ייצוא… ולבחור טבלה (CSV).
  2. יש לסמן את המאפיינים לעריכה. תחת הכללה, יש לסמן מזהה, ואז ללחוץ על ייצוא.
  3. יש לערוך את הערכים בגיליון האלקטרוני. אין לשנות את העמודה מזהה.
  4. יש לייבא את הקובץ. ב-מיפוי, יש לוודא שהעמודה מזהה ממופה ל-מזהה גלובלי ולהגדיר את התאמת ישויות קיימות לפי ל-מזהה גלובלי.
  5. ב-סקירה, יש לבטל את הסימון של Create a document….

    שורות שהותאמו נספרות כפריטים שעודכנו, עם כל שדה שהשתנה.

  6. יש ללחוץ על Import N items.

ערך I_… מקובץ שיוצא לפני הגרסה הזו אינו מתאים; יש להשתמש בעמודה מזהה. לכל שלב ואפשרות, ראו ייבוא וייצוא.

מה עדכון כותב:

  • רק את העמודות הממופות. כשעמודת Description חסרה, כל תיאור קיים נשמר.
  • תוויות מהקובץ מתווספות לתוויות הקיימות.
  • בלי עמודת Class, שורה שהותאמה לפי מזהה גלובלי שומרת על המחלקה של הישות שלה.

הודעות ייבוא

הודעהמשמעות ותיקון
אף עמודה אינה ממופה לשם או למספר. יש למפות אחת מהן.יש למפות לפחות עמודה אחת לשם או למספר.
שורה N: מחלקה לא מוכרת "X", משתמש ב-<class>.ערך ה-Class אינו תואם אף מחלקה. יש לתקן את הערך או למפות את העמודה לדילוג.
שורה N: התווית הלא מוכרת "X" נשמטה.יש ליצור קודם את התווית בסכמה, או לתקן את הערך.
שורה N: "<attribute>" אינו חל על המחלקה <class>.למחלקה של השורה אין את המאפיין הזה.
שורה N: "<value>" אינו <type> תקין עבור "<attribute>".אי אפשר לקרוא את הערך כמספר, תאריך, אפשרות וכן הלאה. יש לבדוק את האפשרות של תבנית התאריך.
שורה N: השם ארוך מ-255 תווים וקוצר. / שורה N: המספר ארוך מ-255 תווים וקוצר.שמות ומספרים מוגבלים ל-255 תווים.
מספר כפול X (שורות A ו-B).שתי שורות חולקות מספר; ההיררכיה עשויה לחבר צאצאים לראשונה.
שורה N: מספר ההורה P חסר עבור X; חובר ל-Q. / …; יובא ברמה העליונה.מספר ההורה הישיר אינו בקובץ.
שורה N: מספר ההורה P לא נמצא. / שורה N: ההורה P לא נמצא.Parent Number או Parent Row ID מפנים לשורה שאינה בקובץ.
שורה N: היעד "X" של "<relationship>" לא נמצא.עמודת הקשר מציינת ישות שאינה קיימת. יש לבדוק את התאמת ישויות קשורות לפי.
שורה N: "<relationship>" מ-A אל B אינו מותר בסכמה (נוצר בכל זאת).הקישור נוצר אף שהסכמה אינה מפרטת אותו.
הקשר "X" בין A לבין B אינו מותר בסכמה; דולג.לא ניתן היה ליצור קשר ReqIF או XMI, אפילו כ-traced to.
תמונה X: תמונות .ext אינן נתמכות ודולגו. כדי לשמור אותה, יש לשמור את התמונה כ-PNG או כ-JPEG ב-Word.תמונת Word בפורמט שאינו נתמך.
תמונה X (size) חורגת ממגבלת הקבצים המצורפים <limit> ודולגה.התמונה גדולה מהמגבלה לכל קובץ.
לא נמצאו שורות נתונים.בקובץ או בגיליון יש רק כותרת, או שהם ריקים.
לא ניתן היה לקרוא את הקובץ: קובצי Excel 97-2003 (.xls) אינם נתמכים. ב-Excel, יש לשמור את הקובץ כ-.xlsx או כ-.csv, ואז לייבא אותו שוביש להמיר את הקובץ.
לא ניתן היה לקרוא את הקובץ: XML עם הצהרת DOCTYPE או ENTITY אינו מתקבל. יש לשמור את הקובץ בלעדיה ולייבא אותו שוביש להסיר את ההצהרה מקובץ ה-ReqIF או ה-XML.
לא ניתן היה לקרוא את הקובץ: XML לא תקיןקובץ ה-ReqIF אינו XML תקני.
הייבוא נכשל: <reason>הייבוא נעצר; שום דבר לא השתנה.

קיצורי דרך לדרישות

מקשיםהיכןפעולה
Enterהזנה מהירה במסמךהוספת הדרישה שהוקלדה.
⌘ / Ctrl+Enter / ⌥ / Alt+⌘ / Ctrl+Enterמסמך, פריט נבחרהוספת אח / צאצא.
Enter או Spaceשורות באיכות, ב-TBD/TBR ובקישורים לבדיקההצגת הדרישה של השורה או הפריט לסקירה בחלונית המאפיינים.
↑ / ↓אותן שורות, שורה ממוקדתמעבר לשורה הקודמת או הבאה.
⌘ / Ctrl-לחיצה, ⇧ / Shift-לחיצה, ⌘ / Ctrl+⇧ / Shift-לחיצהשורות באיכות, ב-TBD/TBR ובקישורים לבדיקה; שורות במסד הנתונים; פריטים במסמךהחלפת מצב של שורה, בחירת הטווח מהשורה האחרונה שנלחצה, הוספת הטווח הזה.
⌘A / Ctrl+A, ⇧ / Shift+↑ / ⇧ / Shift+↓אותן שורות, שורה ממוקדתבחירת כל שורה מוצגת; הרחבת הבחירה מהשורה הממוקדת.
לחיצה ימנית, Shift+F10 או מקש התפריטשורות בדרישות, באיכות, ב-TBD/TBR ובקישורים לבדיקה; פריטים במסמך ורשומות במתארפתיחת התפריט של השורה: קודם פעולות מוצעות עם הסיבות שלהן ו-✦ עוד AI ▸, ואחריהן הפקודות של הפריט.
Escאיכות, TBD/TBR, קישורים לבדיקה, RVTMביטול הבחירה בשורה.
Enterשדה השם בקווי בסיס וגרסאותיצירת קו הבסיס של הפרויקט.
⌘Z / Ctrl+Zבכל מקוםביטול השינוי האחרון, כולל ייבוא שלם, סימון קישורים כנבדקים או שינוי סטטוס.

לכל קיצורי הדרך באפליקציה, ראו קיצורי מקלדת.

הגדרות

הגדרההיכןברירת מחדלטווח
בדיקה חוזרת אוטומטית כשהטקסט משתנהסרגל ההיקף בדף איכותכבויהדפדפן הזה
קבוצות בחלונית המאפיינים מקופלות או פתוחות (איכות והאחרות)לחיצה על כותרת של קבוצה בחלונית המאפיינים, או על כיווץ הכול / הרחבת הכול בסוף הקישורים שלהאיכות מקופלת, השאר פתוחותהדפדפן הזה, לכל מחלקה
השם שלך באישורים, בהחלטות ובתגובותשם החשבון שלך—חשבון
מצב עקיבות (נקודות על דרישות)תצוגה ▾ של המסמךעלמסמך

הודעות

הודעההיכןמשמעות
נבדקו N דרישותאיכותהבדיקה רצה על ההיקף.
אין דרישות בהיקף הזה.איכותאין דרישות בהיקף.
אין במסמך הזה Requirements לבדיקה. Statements לא מקבלים ציון.בדיקת איכות במסמךיש לשנות פריטים ל-Requirement או לבדוק מסמך אחר.
לא עדכני — יש להריץ שוב / לא עדכני / איכות: לא עדכנית — יש להריץ שובאיכות, מסמכים, חלונית המאפייניםהטקסט השתנה אחרי הבדיקה האחרונה.
דורש שיקול דעת של סוקראיכות (Correct, Feasible)אדם צריך להחליט; לחיצה על ✘ מסמנת Yes.
סומן No ידנית.איכותסוקר הגדיר את הקריטריון ל-No.
N דרישות מאושרות הועברו ל-In Review; N קישורים סומנו לבדיקה.אחרי עריכההעריכה פתחה מחדש אישורים וסימנה קישורים לבדיקה.
מאושר / נדחה / הועבר ל-In Reviewתיבת האישורההחלטה תועדה.
N קישורים סומנו כנבדקים.קישורים לבדיקההבדיקות תועדו.
יש לבחור קודם קישורים לסימון כנבדקים.קישורים לבדיקהיש לסמן שורות לפני סימון הנבחרים כנבדקים….
סגור / המאפיין נסגר; הטקסט עדיין מכיל TBD.TBD/TBRהמאפיין הוגדר ל-None.
הטקסט עדיין מכיל TBD. כדי לסגור אותו יש לערוך את הטקסט.TBD/TBRמוצג בסגירה של פריט שנובע רק מהטקסט.
קו הבסיס נשמרמסמכים, קווי בסיס וגרסאותתמונת המצב נשמרה.
אין למסמך הזה קו בסיס. יש לשמור קו בסיס קודם.השוואה לנוכחי, דוחות שינוייםאין למסמך קו בסיס.
הוחזר ל-"<name>" / "<name>" שוחזרקווי בסיסהמסמך או הפרויקט הוחזרו לאחור; אפשר לבטל את הפעולה.
אין דרישות לסקירה. יש לבחור או לפתוח דרישות קודם.בדיקת דרישות עם AIאין דרישות בהיקף.

מגבלות

  • בדיקת איכות: כל דרישה בהיקף מושווית לאחרות לאיתור כפילויות (סף דמיון של 75%).
  • בדיקת דרישות עם AI: 20 דרישות לכל בקשת AI, עם עד 300 דרישות אחרות כהקשר.
  • ההשוואה בבדיקת הקישורים שומרת את 500 התווים הראשונים של השם הישן ו-4,000 של התיאור הישן.
  • burn-down של TBD/TBR: עד 60 נקודות.
  • ייבוא:
    • שמות ומספרים עד 255 תווים.
    • התצוגה המקדימה מציגה את 500 השורות הראשונות. 50 האזהרות הראשונות מוצגות ("…ועוד N").
    • לתבנית מספור יש לכל היותר 6 רמות ("לתבנית המספור יש יותר מ-6 רמות. יש להשתמש ב-6 סמנים לכל היותר.").
    • קובצי ReqIF/XML עד 100 מיליון תווים ו-3,000,000 רכיבים.
    • ארכיוני .reqifz ו-.docx עד 10,000 רשומות, 300 MB לרשומה ו-600 MB בסך הכול.
    • תמונות וקובץ ה-Word המקורי נשמרים רק בתוך מגבלת הקבצים המצורפים לכל קובץ (10 MB בתוכנית Free, 25 MB ב-Individual, 100 MB ב-Team).