Holarch
Главы курса

Обучение · Курс 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.

  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.