- •Методология структурного анализа и проектирования sadt (Structured Analysis & Design Technique)
- •Глава 11. Соглашения по построению диаграмм
- •Часть I. Принципы функционального моделирования
- •Глава 1. Системы и модели
- •1.1. Sadt-модели
- •1.2. Модель отвечает на вопросы
- •1.3. Модель имеет единственный субъект
- •1.4. У модели может быть только одна точка зрения
- •1.5. Модели как взаимосвязанные наборы диаграмм
- •1.6. Резюме
- •Глава 2. Синтаксис и применение диаграмм
- •2.1. Диаграммы содержат блоки и дуги
- •2.2. Блоки представляют функции
- •2.3. Блоки имеют доминирование
- •2.4. Дуги изображают объекты
- •2.5. Дуги изображают взаимосвязи между блоками
- •2.6. Дуги представляют наборы объектов
- •2.6.1. Разветвление дуг
- •2.6.2. Слияние дуг
- •2.7. Идентификация версий диаграмм с-номерами
- •2.8. Резюме
- •Глава 3. Синтаксис моделей и работа с ними
- •3.1. Система представляется одним блоком
- •3.2. Идентификация декомпозиции номерами узлов
- •3.3. Связывание декомпозиции с помощью с-номеров
- •3.4. Коды icom гарантируют стыковку диаграмм
- •3.5. Обозначения для менее распространенных интерфейсов по дугам
- •3.6. Резюме
- •Глава 4. Процесс моделирования
- •4.1. Получение знаний в процессе опроса
- •4.2. Документирование полученных знаний
- •4.3. Корректность модели проверяется в процессе итеративного рецензирования
- •4.4. Координация процесса рецензирования
- •4.5. Модели используются после их одобрения
- •4.6. Резюме
- •Глава 5. Более глубокие концепции диаграмм
- •5.1. Дуги имеют различное содержание
- •5.2. Дуги могут быть декомпозированы
- •5.3. Дуги могут быть "помещены в тоннель"
- •5.4. Различие между входными дугами и дугами управления
- •5.5. Дуги механизмов определяют способы реализации функций
- •5.6. Обратная связь по управлению и по потоку данных
- •5.7. Резюме
- •Глава 6. Более глубокие концепции моделей
- •6.1. Модели sadt структурируют естественный язык
- •6.2. Точка зрения модели влияет на расстановку акцентов и терминологию
- •6.3. Декомпозиция в ходе моделирования
- •6.4. Некоторые стратегии декомпозиции
- •6.5. Выбор стратегии декомпозиции
- •6.6. Момент прекращения декомпозиции определяется точностью
- •6.7. Резюме
- •Часть II. Создание функциональных моделей и диаграмм
- •Глава 7. Сбор информации
- •7.1. Источники информации
- •7.2. Типы опроса
- •7.3. Процесс опроса
- •7.3.1. Подготовка
- •7.3.2. Проведение опроса
- •7.3.3. Завершение
- •7.4. Что нужно помнить при опросе
- •7.5. Резюме
- •Глава 8. Начало моделирования
- •8.1. Основные этапы
- •8.2. Выбор цели и точки зрения
- •8.3. Составление списка данных
- •8.4. Составление списка функций
- •8.5. Построение диаграммы ао
- •8.6. Обобщение диаграммы ао
- •8.7. Резюме
- •Глава 9. Продолжение моделирования
- •9.1. Декомпозиция ограниченного объекта
- •9.1.1. Выбор блока
- •9.1.2. Объект, определяемый блоком
- •9.1.3. Создание новой диаграммы
- •9.2. Выявление интерфейсных ошибок
- •9.3. Принципы и приемы расположения дуг
- •9.4. Резюме
- •Глава 10. Проверка диаграммы автором
- •10.1. Процесс авторской проверки
- •10.2. Выявление недостатков новой диаграммы
- •10.2.1. Вопросы о блоках
- •10.2.2. Вопросы о связи с родительской диаграммой
- •10.2.3. Вопросы о внутренних дугах
- •10.3. Создание альтернативных декомпозиций
- •10.3.1. Альтернативная декомпозиция и объединение функций
- •10.3.2. Альтернативное объединение и разъединение дуг
- •10.3.3. Тестирование
- •10.3.4. Схематичное изображение декомпозиции следующего уровня
- •10.4. Корректировка новой диаграммы
- •10.4.1. Переопределение доминирования
- •10.4.2. Содержательные названия блоков
- •10.4.3. Дуги, хорошо передающие информацию о себе
- •10.4.4. Пояснения
- •10.5. Исправление взаимосвязанных диаграмм
- •10.6. Резюме
- •Глава 11. Соглашения по построению диаграмм
- •11.1. Соглашения по размещению блоков
- •11.2. Соглашения по размещению дуг
- •11.3. Соглашения по размещению блоков и дуг
- •11.4. Резюме
- •Часть III. Рецензирование диаграмм и моделей
- •Глава 12. Цикл автор/читатель
- •12.1. Составление исходной документации
- •12.2. Комментирование работы
- •12.3. Ответы на комментарии
- •12.4. Совершенствование моделей
- •12.5. Цикл автор/читатель
- •12.6. Резюме
- •Глава 13. Подготовка папки
- •13.1. Обмен информацией с помощью папок
- •13.2. Титульный лист
- •13.3. Организация папки
- •3.4. Размеры папки
- •13.5. Когда формировать папку
- •13.6. Резюме
- •Глава 14. Чтение диаграмм и моделей
- •14.1. Процедура чтения
- •14.2. Изучение деталей диаграммы
- •14.2.1. Прочитайте название и номер узла
- •14.2.2. Изучите каждый блок
- •14.2.3. Изучите внутренние дуги
- •14.2.4. Прочитайте авторские замечания
- •14.2.5. Прочитайте приложения к диаграмме
- •14.3. Изучение ближайшего контекста диаграммы
- •14.3.1. Чтение родительского блока и его дуг
- •14.5. Критическая оценка содержания диаграммы
- •14.5.1. Вопросы о синтаксисе
- •14.5.2. Вопросы о понимании диаграммы
- •14.5.3. Вопросы о согласии с автором
- •14.6. Резюме
- •Глава 15. Конструктивное комментирование
- •15.1. Запись о продолжительности работы
- •15.2. Проверка заполнения полей бланка диаграммы
- •15.3. Обозначения согласия и несогласия с автором
- •15.4. Замечания
- •15.5. Язык ссылок sadt
- •15.6. Повторное чтение папки
- •15.7. Конструктивная критика
- •15.8. Резюме
- •Глава 16. Ответы на комментарии и их обобщение
- •16.1. Чтение и ответы на замечания
- •16.2. Беседа автор/читатель
- •16.3. Обобщение читательских комментариев
- •16.4. Переделка диаграмм
- •16.5. Резюме
- •Часть IV. Завершение моделирования. Руководство моделированием
- •Глава 17. Завершение моделирования
- •17.1. Размер sadt-моделей
- •17.2. Прекращение декомпозиции
- •17.3. Достаточная детализированность
- •17.4. Изменение уровня абстракции
- •17.5. Изменение точки зрения
- •17.6. Сходные функции
- •17.7. Тривиальные функции
- •17.8. Принятие решения о завершении моделирования
- •17.9. Резюме
- •Глава 18. Дополнения к диаграммам и моделям
- •18.1. Дополнения к диаграммам
- •18.2. Определение терминологии с помощью глоссария
- •18.3. Пояснение содержания с помощью текста
- •18.4. Пояснение с помощью рисунков
- •18.5. Дополнение моделей
- •18.6. Резюме
- •Глава 19. Примечания на диаграммах и моделях
- •19.1. Информация о свойствах
- •19.2. Правила действия
- •19.3. Генерация правил действия
- •19.4. Резюме
- •Глава 20. Управление проектом
- •20.1. Начало проекта
- •20.2. Создание и рецензирование результатов работы
- •20.3. Создание модели
- •20.4. Стратегии дополнения модели
- •20.5. Резюме
- •Глава 21. Средства автоматизации
- •21.1. Autoidefo
- •21.2. Specif_x
- •21.3. Design/idef
- •21.4. Сводный список для оценки автоматизированной поддержки sadt
- •21.5. Резюме
- •Часть V. Создание функциональной модели и спецификации. Уроки
- •Глава 22. Уроки 1-7
- •Глава 23. Уроки 8-10
- •Глава 24. Уроки 11-14
- •Глава 25. Уроки 15-17
- •Глава 26. Уроки 18-21
- •Глава 27. Уроки 22-25
- •Глава 22. Начало моделирования
- •Глава 23. Построение декомпозиции первого уровня
- •Глава 24. Разделение интерфейсов верхнего уровня
15.6. Повторное чтение папки
После комментирования рабочих материалов, содержащихся в папке, разумно вернуться назад и перечитать их. Это не пустая работа. Как и другие письменные материалы, первые наброски редко сразу годятся для публикации. Поэтому, просматривая свои комментарии, вы можете отметить важные замечания галочкой, зачеркнуть ненужные, уточнить неясные, добавить новые замечания и кратко изложить рецензию на титульном листе. Только в редких случаях рецензию в ходе перечитывания нельзя улучшить. Наш опыт показывает, что качество рецензии резко повышается, если потратить пару минут на повторный просмотр всей папки
Таблица 15-1. Примеры языка ссылок SADT
Код |
Формат |
Значение |
3 |
Блок |
Блок 3 |
5 |
Замечание |
Замечание 5 |
01 |
Вершина дуги |
Граничная дуга |
312 |
Блок+вершина дуг |
Вторая входная |
|
. |
дуга блока 3 |
… |
… |
Смотри |
Е.2 |
Страница+блок |
На стр.Е см. блок 2 |
A.I |
Страница+ замечание |
На диаграмме А |
|
|
см. замечание 1 |
А42.3 |
Диаграмма+блок |
На диаграмме А42 |
|
|
см. блок 3 |
В.401 |
Страница+вершина дуги |
На стр. В см. |
|
|
первую выходную |
|
|
дугу блока 4 |
15.7. Конструктивная критика
Никто не любит, когда его работу критикуют, не предлагая ничего взамен. SADT настоятельно рекомендует позитивный и конструктивный стиль комментирования. Конструктивные комментарии коротки, ясны, позитивны и конкретны. Например, замечания 4 и 5 на рис. 15-2 не только позволяют исправить ошибку автора, но и поясняют, почему исходная метка дуги неверна.
Особенно важно оказать помощь, если автор допустил серьезный просчет, неправильно понял основную терминологию или построил диаграмму, не отвечающую цели или точке зрения модели. В таких случаях мы советуем сделать на титульном листе замечание, описывающее ситуацию так, как вы ее видите, и предложить автору встретиться для обсуждения проблемы. В течение последующего диалога автор/ читатель используйте папку в качестве перечня вопросов для встречи и рассмотрите спорные вопросы в порядке номеров замечаний. Папка поможет вам сфокусировать тему беседы и сократить время встречи.
Опытные SADT-читатели не останавливаются в случае, если они не находят ошибок. Их задача тогда отметить все верное. Таким образом можно обнаружить пропуски важных моментов, неуместность отдельных частей диаграммы, неверную точку зрения или неправильно понятую цель. Вот почему хорошее нужно указывать так же, как плохое. Авторы должны знать, что они на верном пути, даже если есть недочеты. Например, на рис. 15-2 в замечании к дуге оборудованное рабочее место содержится похвала автору за верное понимание предмета рассмотрения и выразительное название.
Квалифицированные SADT-читатели вкладывают максимально возможное в свои комментарии. Лучше всего для комментариев использовать графический язык SADT. С его помощью читатель может быстро исправить синтаксис, предложить другие метки, направить дуги к другим блокам и рекомендовать другие декомпозиции. Используйте графику всегда, когда это возможно, потому что "меньше слов" часто означает "больше информации". На рис. 16-3 приведен пример графического замечания.