Организация работы с 
требованиями и документацией 
на основе Team Foundation Server 
oshamrai@softserveinc.com
Общие проблемы
На уровне аналитики 
▪ Сложно понять как работает существующая система 
– Требования не велись и внесение дополнительных 
изменений может «сломать» функционал или 
производительность 
▪ В распределенных командах требования остаются 
скрытыми 
– На выходе работы удаленной или подрядной команды 
код и большое количество документации 
– Неправильная расстановка приоритетов для требований 
ведет к несогласованности действий 
▪ Высокая зависимость от существующих 
компетенций 
– Увольнение или временное отсутствие ключевых 
сотрудников приводит к задержке работ
На уровне проектов 
▪ Невозможно оценить сложность входящих 
запросов от заинтересованных лиц 
– Оценка трудозатрат берется с потолка*2 
▪ Срыв обещанных сроков или качества 
– Согласованные планы не выдерживаются 
– Для выдерживания сроков меньше внимания 
уделяется качеству 
▪ Перерасход затрат 
– Запланировать реальный бюджет невозможно
Общие принципы TFS
Основные свойства 
▪ Атрибуты для объектов 
– Каждый объект имеет атрибуты, которые 
позволяют выполнять оценку сложности, риска 
– Состояние позволяет определить где сейчас 
требование и в какую версию вошло 
▪ Трассируемость между всеми объектами 
– Любой объект может связан для определения 
его происхождения, связи и т.д. 
▪ Гибкость взаимодействия 
– Открытое API позволяет интегрироваться с 
любой системой
Пример взаимосвязей 
Запрос 
заинтересова 
нного лица 
Требование 
Задача 
Тест 
Ошибка Код 
Документ
Требования в TFS
Требования в документе
Пример организации хранилища 
документов
Процесс создания новых 
требований 
Разработка 
документа 
Экспорт 
требований 
Отслеживание 
реализации
Процесс изменения или 
дополнения существующих 
требований 
Поиск и 
импорт 
изменяемых 
требований в 
документ 
Доработка 
требований 
Экспорт 
измененных 
требований 
Отслеживание 
реализации
Процесс создания документации 
требований 
Техническое 
задание Пояснительная 
записка к 
техническому 
проекту 
Описание 
автоматизируемых 
функций 
Описание 
постановки задач 
(комплекса задач)
Типы требований 
▪ Автоматизированная система 
– состоит из персонала и комплекса средств автоматизации его 
деятельности, реализующая информационную технологию 
выполнения установленных функций 
▪ Функция (комплекс задач) 
– Совокупность действий АС, направленная на достижение 
определенной цели. 
▪ Задача 
– Функция или часть функции АС, представляющая собой 
формализованную совокупность автоматических действий, 
выполнение которых приводит к результату заданного вида. 
▪ Требование 
– Задокументированные характеристики, которым должна 
соответствовать система.
Требования и Техническое задание 
▪ Техническое задание 
1. Подсистема 
2. Цели и назначение 
системы 
3. Функции 
системы/подсистемы 
4. Требования к 
безопасности, 
надежности и т.д. 
▪ Требование TFS 
1. Требование – 
подсистема 
2. Требование - бизнес- 
цель 
3. Требование – функция 
4. Требование – 
безопасность, 
надежность и т.д.
Требования и Пояснительная 
записка 
▪ Пояснительная записка 
1. Подсистема 
2. Цели и назначение 
системы 
3. Описание процесса 
деятельности 
4. Функции выполняемые 
системой 
▪ Требование TFS 
1. Требование – 
подсистема 
2. Требование - бизнес- 
цель 
3. Требование – бизнес- 
процесс 
4. Требование – функция
Требования и Описание 
автоматизируемых функций 
▪ Описание 
автоматизируемых 
функций 
1. Подсистема 
2. Цели и назначение 
системы 
3. Перечень 
автоматизируемых 
функций 
4. Описание процесса 
выполнения функций 
5. Входы/Выходы 
▪ Требование TFS 
1. Требование – 
подсистема 
2. Требование - бизнес- 
цель 
3. Требование – функция 
4. Требование – сценарий 
5. Требование – интерфейс
Инструментальная 
поддержка
Salma – общие возможности 
▪ Создание требований на основе готовой 
документации 
▪ Связывание требований 
▪ Создание отчетной информации 
▪ Матрица трассировки
Salma – пример создания 
требований
Word4TFS – создание общей 
документации 
▪ Формирование документов на основе 
последней информации в TFS 
▪ Создание собственных шаблонов, по 
которым будет выполняться создание 
документов. 
▪ Обновление документации на основе 
измененных требований.
Word4TFS – пример создания 
документации
Тестирование
Артефакты TFS и Программа 
методика испытаний 
▪ ПМИ 
– Требования из ТЗ для 
проверки 
– Испытания 
▪ Артефакты TFS 
– Требование – функция 
– Тестовый сценарий
Пример написания кода для 
генерирования ПМИ
Вопросы?

Организация работы с требованиями и документацией в TFS

  • 1.
    Организация работы с требованиями и документацией на основе Team Foundation Server oshamrai@softserveinc.com
  • 2.
  • 3.
    На уровне аналитики ▪ Сложно понять как работает существующая система – Требования не велись и внесение дополнительных изменений может «сломать» функционал или производительность ▪ В распределенных командах требования остаются скрытыми – На выходе работы удаленной или подрядной команды код и большое количество документации – Неправильная расстановка приоритетов для требований ведет к несогласованности действий ▪ Высокая зависимость от существующих компетенций – Увольнение или временное отсутствие ключевых сотрудников приводит к задержке работ
  • 4.
    На уровне проектов ▪ Невозможно оценить сложность входящих запросов от заинтересованных лиц – Оценка трудозатрат берется с потолка*2 ▪ Срыв обещанных сроков или качества – Согласованные планы не выдерживаются – Для выдерживания сроков меньше внимания уделяется качеству ▪ Перерасход затрат – Запланировать реальный бюджет невозможно
  • 5.
  • 6.
    Основные свойства ▪Атрибуты для объектов – Каждый объект имеет атрибуты, которые позволяют выполнять оценку сложности, риска – Состояние позволяет определить где сейчас требование и в какую версию вошло ▪ Трассируемость между всеми объектами – Любой объект может связан для определения его происхождения, связи и т.д. ▪ Гибкость взаимодействия – Открытое API позволяет интегрироваться с любой системой
  • 7.
    Пример взаимосвязей Запрос заинтересова нного лица Требование Задача Тест Ошибка Код Документ
  • 8.
  • 9.
  • 10.
  • 11.
    Процесс создания новых требований Разработка документа Экспорт требований Отслеживание реализации
  • 12.
    Процесс изменения или дополнения существующих требований Поиск и импорт изменяемых требований в документ Доработка требований Экспорт измененных требований Отслеживание реализации
  • 13.
    Процесс создания документации требований Техническое задание Пояснительная записка к техническому проекту Описание автоматизируемых функций Описание постановки задач (комплекса задач)
  • 14.
    Типы требований ▪Автоматизированная система – состоит из персонала и комплекса средств автоматизации его деятельности, реализующая информационную технологию выполнения установленных функций ▪ Функция (комплекс задач) – Совокупность действий АС, направленная на достижение определенной цели. ▪ Задача – Функция или часть функции АС, представляющая собой формализованную совокупность автоматических действий, выполнение которых приводит к результату заданного вида. ▪ Требование – Задокументированные характеристики, которым должна соответствовать система.
  • 15.
    Требования и Техническоезадание ▪ Техническое задание 1. Подсистема 2. Цели и назначение системы 3. Функции системы/подсистемы 4. Требования к безопасности, надежности и т.д. ▪ Требование TFS 1. Требование – подсистема 2. Требование - бизнес- цель 3. Требование – функция 4. Требование – безопасность, надежность и т.д.
  • 16.
    Требования и Пояснительная записка ▪ Пояснительная записка 1. Подсистема 2. Цели и назначение системы 3. Описание процесса деятельности 4. Функции выполняемые системой ▪ Требование TFS 1. Требование – подсистема 2. Требование - бизнес- цель 3. Требование – бизнес- процесс 4. Требование – функция
  • 17.
    Требования и Описание автоматизируемых функций ▪ Описание автоматизируемых функций 1. Подсистема 2. Цели и назначение системы 3. Перечень автоматизируемых функций 4. Описание процесса выполнения функций 5. Входы/Выходы ▪ Требование TFS 1. Требование – подсистема 2. Требование - бизнес- цель 3. Требование – функция 4. Требование – сценарий 5. Требование – интерфейс
  • 18.
  • 19.
    Salma – общиевозможности ▪ Создание требований на основе готовой документации ▪ Связывание требований ▪ Создание отчетной информации ▪ Матрица трассировки
  • 20.
    Salma – примерсоздания требований
  • 21.
    Word4TFS – созданиеобщей документации ▪ Формирование документов на основе последней информации в TFS ▪ Создание собственных шаблонов, по которым будет выполняться создание документов. ▪ Обновление документации на основе измененных требований.
  • 22.
    Word4TFS – примерсоздания документации
  • 23.
  • 24.
    Артефакты TFS иПрограмма методика испытаний ▪ ПМИ – Требования из ТЗ для проверки – Испытания ▪ Артефакты TFS – Требование – функция – Тестовый сценарий
  • 25.
    Пример написания кодадля генерирования ПМИ
  • 26.