Holarch
Розділи курсів

Навчання · Курс 6. Перехід на Holarch · Розділ 6.3 з 5

6.3 Вимоги з Word і ReqIF 2:22

Імпортуйте специфікацію Word як документ, а файл ReqIF постачальника — з його ієрархією та зв’язками.

Показано Holarch 2.21.

← 6.2 Вимоги з Excel і CSV · Усі розділи · 6.4 Моделі з інших інструментів →

Що ви дізнаєтеся

  • Пояснити, які частини файлу Word стають розділами, а які — вимогами
  • Імпортувати специфікацію Word як пронумерований документ вимог
  • Імпортувати файл ReqIF з його ієрархією, атрибутами й зв’язками
  • Перевірити імпортований зв’язок у розділі «Трасування»

Імпортуйте специфікацію корисного навантаження Plant Inspection Drone з Word, де заголовки стають розділами, а речення з shall — вимогами, і вимоги постачальника батареї з ReqIF з їхньою ієрархією, атрибутами та зв’язком refines.

Файли проєкту

  • Початковий проєкт (.holarch.json; Керування проєктами → Файли проєкту ▾ → Імпортувати проєкт (.json)…)
  • Готовий проєкт (.holarch.json; Керування проєктами → Файли проєкту ▾ → Імпортувати проєкт (.json)…)

Відео відтворюється з holarch.app; див. Політику конфіденційності.

Практика

Виконайте це самостійно в Holarch на демопроєкті CubeSat EO-1.

  1. Відкрийте свій демопроєкт EO-1 (якщо його немає, створіть: Керування проєктами → Файли проєкту ▾ → Новий демопроєкт → CubeSat (системна інженерія з посібником)). Відкрийте Документи → EO-1 System Requirements Specification і натисніть Видати ▾ → Специфікація (Word).
  2. У тому самому документі натисніть Видати ▾ → Вимоги (ReqIF)… і натисніть Експортувати.
  3. У Керуванні проєктами натисніть + Новий проєкт, назвіть його EO-1 Import Practice і натисніть Створити проєкт. Відкрийте Потреби та вимоги → Імпорт і експорт, перетягніть .docx, двічі натисніть Продовжити й імпортуйте файл.
  4. Порівняйте новий документ із SRS: зверніть увагу, які заголовки стали Statement, а які речення з shall — Requirement, і як їх названо.
  5. Імпортуйте файл .reqif у той самий проєкт, потім відкрийте створений ним документ і виберіть 1.6 Revisit Time, щоб перевірити її дочірні елементи й мітки.

Завдання виконано, коли проєкт містить два документи, один з Word і один з ReqIF, і ви можете сказати, який зберіг початкові назви й номери.

Перевірте себе

  1. Що імпорт Word сприймає як розділ, а що — як вимогу?
  2. Постачальник може надіслати Word або ReqIF. Чому варто просити ReqIF?
  3. Зв’язок ReqIF має назву, якої Holarch не знає. Що відбувається?
Показати відповіді
  1. Що імпорт Word сприймає як розділ, а що — як вимогу?

    Абзаци зі стилями заголовків Word стають Statement (розділами). Абзац із shall, must, will чи should стає Requirement з назвою за першими словами після дієслова. Заголовки, набрані звичайним жирним текстом, читаються як звичайний текст.

  2. Постачальник може надіслати Word або ReqIF. Чому варто просити ReqIF?

    ReqIF передає ідентифікатор, ієрархію, атрибути й зв’язки кожної вимоги. Коли постачальник надсилає новіший файл, його імпорт оновлює ті самі елементи, а не додає копії.

  3. Зв’язок 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.