Михаил Острогорский, Философт

1. Документирование
требований с помощью
DITA
Опыт
применения
технологии
Москва, 2016 г.
Е. Потапова
М. Острогорский

2. О каких требованиях
идет речь?
2
К программным средствам
К автоматизированным системам
К техническим средствам

3. Свойства требований
Дискретность, гранулярность
3
Требования к роботу
Требования к режиму передвижения
Скорость передвижения робота в помещении
Избежание столкновений с препятствиями
• стол;
• кошка;
• ведро;
…
Робот должен избегать столкновения с препятствиями:

4. Свойства требований
Взаимозависимость
4
Избежание столкновений с препятствиями
• стол;
• кошка;
• ведро;
Распознавание объектов
Коммуникативные возможности робота
Робот должен уметь погладить кошку.
Робот должен уметь …
Робот должен уметь распознавать…
Зависимость

5. Требования и документы5
Требования
Техническое
задание
(SRS)
График
работ
Расчет
стоимости
Технико-
коммерческое
предложение
Чек-лист

6. Рубежи изменения
требований
6
Требования

7. Обновление требований
и вторичных документов
7

8. Чем разрабатывать
требования?
Текстовые
процессоры
Системы
управления
требованиями ?
Удобно
оформлять
документацию
Х X
Удобно
управлять
требованиями
Х X
8

9. Что же делать?
Хочется ведь как?
Один раз требования написал,
а потом
и всё готово.
9

10. Технология DITA
Общие сведения
• Разработана в корпорации IBM
• Является стандартом OASIS
• Используется в разных индустриях
• Основана на XML-технологиях
• Применяет идеи ООП к тексту
10

11. Технология DITA
Основные составляющие
11
Спецификацияязыка разметки
DITA
DITA
Open Toolkit
Поддержка
в различных
редакторах,
CMS-системах
и т. п.

12. Технология DITA
Что она умеет?
• Применять разные стили оформления
к одному и тому же тексту
• Собирать документы с разной структурой
на основе одних и тех же разделов
– структуры (т. н. карты) документов
– фильтры (т. н. профилирование)
• Навязывать авторам структуру раздела
в зависимости от типа этого раздела
12

13. Технология DITA
Структура документа
13
Карта документа Топики
Функциональные требования
Технические требования
Техническое задание
Структура документа
со ссылками на топики
Краткие разделы с заранее
заданной структурой

14. Технология DITA
Информационные типы
14
Заголовок
Контекст
Результат
1. Шаг процедуры…
2. Шаг процедуры…
…
DTD
Формирование отчета
Введены исходные данные.
Будет сформирован отчет.
1. Выберите в меню…
2. Введите даты…
3. Нажмите кнопку OK.
Топик

15. Технология DITA
Формирование документов
15
Репозиторий
XML-редактор
DTDDTD Логика
сборки
Логика
сборки
СтилиСтили
Конвертор

16. Представление требований
с помощью DITA
16
• мебель корпусную;
Требования к режимам движения робота
Распознавание препятствий и избежание столкновения с ними
• мебель мягкую;
• собак;
Робот должен уметь различать обходить объекты следующих типов:
ID=R4503. Часы=20. Разр.=Иволгин
• кошек;
ID=R4500. Этап=3

17. Представление
справочных данных
17
Этапы проекта
# Этап Срок
1
2
3
Прототип
Ядро
Интерфейс
28.02.17
31.03.17
30.04.17
Разработчики
Разработчик Руб./час
Иволгин
Лебедев
Птицын
1500
1750
2000

18. Формирование
выходных документов
18СправочникиТребования
Сводная таблица
XSLTXSLT XSLTXSLT
Карта документа

19. Обратная связь
www.philosoft.ru
mail@philosoft.ru
7 (499) 500-44-77
19