Курс 4. Документы и результаты работ: лист упражнений
Для инженеров и руководителей. По одному практическому заданию и нескольку вопросов к каждой главе, чтобы проработать после каждого видео. Распечатайте эту страницу из браузера или работайте на экране. Ответы начинаются с новой страницы в конце.
Перед началом
- Сначала пройдите
- Глава 1.5 «Документы»; курсы 2 и 3 делают матрицы полезнее.
- Тариф
- Бесплатно
- Проект
- Bike-Share Dock: у каждой главы свой начальный файл.
4.1 Шаблоны документов
Смотреть главу 4.1 (2:54)
Практика
На демо-проекте CubeSat EO-1:
- Откройте свой демо-проект EO-1 или создайте его: Управление проектами → Файлы проекта ▾ → Новый демо-проект → CubeSat (пошаговая системная инженерия).
- Откройте Потребности и требования → Документы и нажмите + Новый документ. Назовите его
EO-1 Interface Control Document. - В разделе Шаблоны для выберите Документ управления интерфейсом, установите флажок Включить рекомендации по написанию, выберите карточку Документ управления интерфейсом (ICD) и нажмите Создать.
- Выберите раздел 2.3 Interface Owners and Change Authority и прочитайте его рекомендации. Щёлкните его описание, замените рекомендации владельцами интерфейсов EO-1 (например, Payload Lead и Comms Lead) и нажмите ⌘ / Ctrl↵, чтобы сохранить.
- Выберите раздел 3.2 Interface Matrix и прочитайте живую матрицу интерфейсов, которую туда поместил шаблон.
- Для пошагового прохождения с проверкой запустите учебный материал 11 «Produce the Deliverable» (Справка → Учебные материалы).
Готово, когда новый ICD показывает в 2.3 ваш собственный текст вместо рекомендаций, а в 3.2 — матрицу компонентов EO-1.
Вопросы
- От чего зависит, какие шаблоны «Новый документ» предлагает первыми?
- Чем шаблон с рекомендациями по написанию отличается от шаблона без них?
- Почему важно, что каждый раздел — элемент модели?
4.2 Живые матрицы в документах
Смотреть главу 4.2 (2:48)
Практика
На демо-проекте CubeSat EO-1:
- Откройте свой демо-проект EO-1 или создайте его: Управление проектами → Файлы проекта ▾ → Новый демо-проект → CubeSat (пошаговая системная инженерия).
- Откройте Потребности и требования → Документы → EO-1 System Requirements Specification и щёлкните описание раздела 2 Attitude Determination and Control, чтобы изменить его.
- На панели форматирования текста откройте + и выберите Матрица…. Выберите Матрица распределения требований, оставьте областью этот документ, нажмите Вставить и нажмите ⌘ / Ctrl↵, чтобы сохранить.
- Прочитайте подпись и затенённые строки. 2.5 Safe Mode Recovery — пробел: его ничто не удовлетворяет.
- Выберите 2.5 и в его разделе Трассировка свяжите F10 Enter Safe Mode в satisfied by. Вернитесь к разделу 2 и снова прочитайте матрицу.
Готово, когда строка 2.5 матрицы распределения показывает F10 Enter Safe Mode и больше не затенена.
Вопросы
- Чем живая матрица отличается от таблицы, которую вы набираете вручную?
- Почему пробел закрывают в модели, а не в матрице?
- Какие области может охватывать матрица?
4.3 Вывод в Word и Excel
Смотреть главу 4.3 (2:10)
Практика
На демо-проекте CubeSat EO-1:
- Откройте свой демо-проект EO-1 или создайте его: Управление проектами → Файлы проекта ▾ → Новый демо-проект → CubeSat (пошаговая системная инженерия).
- Откройте EO-1 System Requirements Specification и выберите Поставка ▾ → Параметры страницы…. В разделе Гриф выберите Собственный гриф и задайте верхний и нижний колонтитулы, например
EO-1 Program Internal. - Установите флажок Титульная страница с Версия
2.0и ПодготовилEO-1 Systems Team, установите флажок Номера страниц и нажмите Применить. - Выберите Поставка ▾ → Копия для рецензирования (Word) и откройте файл: альбомные страницы со столбцами атрибутов под каждым элементом и грифом на каждой странице.
- Выберите Поставка ▾ → Матрица прослеживаемости…. Выберите RVTM, задайте для Модель значение SRR Baseline, а для Экспортировать как — Матрица (Excel), прочитайте число строк и пробелов и нажмите Экспорт.
Готово, когда у вас есть файл Word с титульной страницей, грифом и номерами страниц и RVTM в Excel по SRR Baseline с затенёнными пробелами.
Вопросы
- Какой гриф использует документ?
- Чем шаблон Word отличается от шаблона документа?
- Откуда берутся таблицы «История изменений» и «Утверждения» при экспорте в Word?
- Зачем экспортировать матрицу из базовой линии, а не из текущей модели?
4.4 Пакеты рецензирования и базовые линии
Смотреть главу 4.4 (2:35)
Практика
На демо-проекте CubeSat EO-1:
- Откройте свой демо-проект EO-1 или создайте его: Управление проектами → Файлы проекта ▾ → Новый демо-проект → CubeSat (пошаговая системная инженерия). В этом задании также используется EO-1 Interface Control Document из главы «Шаблоны документов»; если вы пропустили эту главу, сначала создайте его.
- Откройте EO-1 System Requirements Specification, нажмите Запросить рецензирование рядом с типом документа, не отмечайте никого и нажмите Запросить рецензирование. Полоса под заголовком показывает рецензирование.
- Нажмите Версия ▾ → Сохранить базовую линию…, назовите её
PDR Baseline, укажите свою роль, нажмите + Добавить утверждающего для второго утверждающего и нажмите Создать. - Измените 2.4 Target Slew на 45 секунд. Затем выберите Версия ▾ → Сравнить версии… с Откуда PDR Baseline и Куда Текущая версия и нажмите Изменения (Excel).
- Откройте Управление и рецензирование → Рецензирование, нажмите + Новый пакет рецензирования и назовите его
PDR review package. Дважды выберите Правка ▾ → Вставить ▸ Документ…, чтобы добавить SRS и ICD. - Выберите Поставка ▾ → Настройка поставки… и задайте для части SRS в Экспортировать каждую часть из значение PDR Baseline, затем выберите Поставка ▾ → Спецификация (Word).
Готово, когда отчёт об изменениях показывает правку 2.4, а файл Word пакета содержит Part A и Part B, причём часть SRS взята из PDR Baseline.
Вопросы
- Что содержит базовая линия документа и может ли она измениться позже?
- Чем базовая линия документа отличается от базовой линии проекта?
- Пакет должен экспортировать SRS из базовой линии, а не сегодняшние правки. Как это сделать?
- Что происходит с рецензированием после нажатия «Запросить рецензирование»?
4.5 Презентации из модели
Смотреть главу 4.5 (1:59)
Практика
На демо-проекте CubeSat EO-1:
- Откройте свой демо-проект EO-1 или создайте его: Управление проектами → Файлы проекта ▾ → Новый демо-проект → CubeSat (пошаговая системная инженерия).
- Откройте Планирование → Презентации и нажмите + Новая презентация. Назовите её
EO-1 PDR Briefing, задайте для Начать с значение Структура документа с EO-1 System Requirements Specification и нажмите Создать. - Дважды щёлкните заголовок на первом слайде, введите
EO-1 Preliminary Design Reviewи нажмите Esc. - Нажмите + Новый слайд ▾, выберите Пустой, затем Изображение ▾ → Изображение… и выберите FFBD функции F0 Perform EO-1 Mission.
- Нажмите ▶ Показ ▾ → Показ с текущего слайда, переходите по слайдам клавишей → и завершите клавишей Esc. Затем нажмите Экспортировать… и выберите Презентация (PowerPoint).
Готово, когда в презентации есть титульный слайд, по одному слайду на каждый раздел SRS и живое изображение FFBD, а у вас есть файл PowerPoint.
Вопросы
- Что поддерживает изображение на слайде в актуальном состоянии?
- Когда стоит начинать презентацию со структуры документа?
- В какие форматы можно экспортировать презентацию?
Ответы
4.1 Шаблоны документов
- От типа документа, выбранного в «Шаблоны для». Шаблоны других типов по-прежнему перечислены в разделе «Другие шаблоны»; документ получает тип выбранного шаблона.
- Оба дают одинаковые нумерованные разделы и начальные таблицы. С рекомендациями каждый раздел также начинается с краткого описания того, что в нём должно быть, и вы заменяете его по мере написания.
- Раздел — это Statement, поэтому его можно связывать, комментировать и включать в базовую линию, как требование, а документ остаётся представлением модели.
4.2 Живые матрицы в документах
- Блок хранит только то, какую матрицу и какую область показывать. Holarch перестраивает строки из модели каждый раз, когда документ показывается или экспортируется, поэтому матрица никогда не устаревает.
- Живую матрицу нельзя править по ячейкам. Пробел — это отсутствующая связь или атрибут в модели, и исправление там обновляет все матрицы и представления, которые его показывают.
- Элементы одного документа, все части сборника или весь проект. Матрицы интерфейсов и N² могут также охватывать дочерние элементы одного Asset или Action.
4.3 Вывод в Word и Excel
- Ближайший: собственный гриф документа, иначе гриф проекта, иначе гриф организации. Без грифа документ остаётся без пометки.
- Шаблон документа задаёт содержание: разделы и начальные таблицы. Шаблон Word задаёт файл Word: оглавление, нумерацию подписей, размер страницы и таблицы вводной части.
- Из базовых линий документа и записей об их утверждении, если шаблон Word их включает, как «Спецификация».
- Совет по рецензированию размечает то, что было согласовано. Выбор базовой линии в «Модель» экспортирует матрицу в том виде, в каком она была в этой базовой линии, а не в сегодняшнем.
4.4 Пакеты рецензирования и базовые линии
- Снимок документа только для чтения: его элементы, их атрибуты и связи, а также элементы на расстоянии одной связи. Её можно переименовать и добавить утверждения, но существующие записи об утверждении изменить нельзя.
- Базовая линия документа содержит один документ и сохраняется через его меню «Версия ▾». Базовая линия проекта содержит все элементы проекта и сохраняется командой «+ Сохранить базовую линию…» в разделе «Управление и рецензирование → Базовые линии и версии».
- В пакете откройте «Настройка поставки…» и выберите эту базовую линию в «Экспортировать каждую часть из». Закреплённая часть показывает 📌 и имя базовой линии и экспортирует содержимое базовой линии.
- Документ переходит в статус «На рецензировании». Рецензенты проекта или названные вами люди получают его в разделе «Документы на рецензирование» на странице «Мои задачи» и утверждают или отклоняют его там или в полосе под заголовком.
4.5 Презентации из модели
- Изображение, созданное через «Изображение…», показывает представление модели, а не копию. Когда меняется диаграмма, документ или график, слайд показывает изменение.
- Когда брифинг следует за документом: вы получаете титульный слайд и по одному слайду на каждый раздел верхнего уровня с его текстом, готовые к сокращению.
- PowerPoint, Word и веб-страница для всей презентации, а также PNG или SVG для текущего слайда.
Издатель: Holarch