Глава 13. Подготовка папки
- 13.1. Обмен информацией с помощью папок
- 13.2. Титульный лист
- 13.3. Организация папки
- 13.4. Размеры папки
- 13.5. Когда формировать папку
- 13.6. Резюме
Обычно от начало моделирования, а иногда и декомпозиции до рассылки материалов на рецензирование проходит небольшой период времени. Это дает возможность другим участникам SADT-проекта лучше понять выполненную работу. Для ее оценки автор проекта инициирует цикл автор/читатель, оформив рабочие материалы в виде папки. В этой главе описано, что такое SADT-папка, и показано, как она формируется. В главах 14-16 подробно рассматривается работа с папкой других участников SADT-проекта.
13.1. Обмен информацией с помощью папок
Термин "папка" относится в SADT к части материалов, предназначенных для рецензирования. Понятие папки появилось в связи с тем, что SADT-проекты технически организованы вокруг автора и группы читателей. Автор опрашивает экспертов, создает набор взаимосвязанных диаграмм, а затем обращается с просьбой к экспертам (а возможно, и к другим авторам) помочь в оценке своей работы. Те эксперты, которые получают папку, составляют часть читательской аудитории - группы людей, заинтересованных в том, чтобы работа автора была точной. Таким образом, папка является основной единицей информации, которой обмениваются участники SADT-проекта. Иными словами, папки есть основное средство общения между участниками SADT-проекта.
Процесс общения с помощью папок дает возможность проводить асинхронное и альтернативное рецензирование рабочих материалов. Автор посылает папку группе читателей. Читатели сообщают о замеченных недостатках автору с помощью вносимых прямо в папку замечаний, которые называются комментариями. Автор читает эти комментарии и отвечает на них письменно. Эта запись автора называется ответ. Папки, содержащие письменные комментарии и ответы, снова возвращаются к читателям.
Взаимодействие между автором и читательской аудиторией изображено на рис. 13-1 в виде цикла, в ходе которого созданные автором папки изучаются читателями и возвращаются к автору, который читает их и снова отсылает читателям.
Первой страницей любой SADT-папки является титульный лист - специальная форма, в которой объединены рабочие материалы, описано содержание папки и отражающая ход ее обработки участниками проекта. Для этих целей титульный лист имеет специальные поля. Титульный лист SADT разделен жирными линиями на три поля. Верхнее и нижнее поля заполняются автором, среднее предназначено для библиотекаря проекта.
Кроме того, на титульном листе написаны большие цифры, разбивающие его на пять областей. Область 1 - область идентификации, - авторы заполняют, так же как на диаграммах, проставляя свою фамилию, дату, название проекта,
Рис. 13-1. Папки циклически перемещаются между автором и читателями
статус материалов и С-номера. В области 2, предназначенной для информации о содержании папки, авторы записывают номер узла и название папки, а также номер узла, название и С-номер для каждой страницы папки. В области 3 записываются фамилии тех, кому папка должна быть послана. Замечания о папке в целом автор помещает в область 4, а в области 5 он размещает специальные инструкции для библиотекаря.
SADT-папка состоит из титульного листа, одной или более диаграмм и, возможно, дополнительного материала. Титульный лист содержит название и краткое содержание рабочих материалов и служит для сопровождения папки в цикле общения автора с читателями. Диаграммы располагаются после титульного листа в порядке возрастания номеров узлов. Листы иллюстраций и глоссария, которые дополняют диаграммы, располагаются сразу же после тех диаграмм, к которым они относятся (дополнения к диаграммам подробно рассматриваются в главе 18).
На рис. 13-3 показана SADT-папка, содержащая результаты анализа, проведенного в части I, где обсуждались начало разработки и частичная декомпозиция модели экспериментального механического цеха. На титульном листе указано, что эта папка относится к декомпозиции объекта выполнить задание, на диаграмме ЭМЦ/А2. Кроме того, на титульном листе помещено замечание автора, в котором он просит объяснить понятие деталь. Диаграмма ЭМЦ/АО изготовить нестандартную деталь расположена перед диаграммой выполнить задание для того, чтобы обеспечить читателей контекстом. Лист глоссария ЭМЦ/А2Г1 определяет терминологию, введенную на диаграмме выполнить задание. Он расположен после диаграммы.
SADT-папка не всегда формируется для каждой новой диаграммы. Размеры папок могут быть различными и зависят как от проекта, так и от работающих над ним. Сложность изучаемой системы, доступность экспертов и опытность аналитиков также влияют на объем информации, включаемой в папку. Однако для большинства SADT-проектов типичным является рабочая папка, включающая контекстную диаграмму, основную диаграмму и лист глоссария. Мы рекомендуем составлять папки именно такого размера во всех случаях, когда вы сомневаетесь в объеме информации,
Рис. 13-3. Заполненный титульный SADT-папки
Рис. 13-4. Подготовка страницы глоссария
приемлемом для читателей. Одна диаграмма, декомпозиция хотя бы одного из ее блоков и, возможно, лист глоссария или иллюстрация представляют собой оптимальный размер папки (более подробное рассмотрение факторов, влияющих на размеры папки, см. в главе 20), Мы рекомендуем такой объем в качестве стандарта, чтобы вы никогда не включали в папку для рецензирования слишком много информации. Наш опыт показывает, что, независимо от обстоятельств, папка не должна содержать более одной диаграммы и ее прямых потомков - в общей сложности не более шести диаграмм. Если в папку включен дополнительный материал, количество диаграмм следует уменьшить. Папка с более чем 6 страницами информации может перегрузить ваших читателей, и вы получите очень слабый отклик. Поэтому лучше ошибиться в сторону уменьшения объема информации, чем предъявлять завышенные требования к читательской аудитории. Если большие папки станут для вас нормой, вы можете через некоторое время столкнуться с падением активности читательской аудитории. Единственным исключением является публикация всей модели в виде папки в конце аналитического проекта. Читатели готовы к тому, что такие папки должны быть объемны, но в то же время они знают, что их будет очень немного.
13.5. Когда формировать папкуМомент для формирования папки в процессе проектирования выбирается отнюдь не случайно. Вообще говоря, папка составляется, если автор чувствует, что появилось достаточно новой информации, чтобы отправить ее на рецензирование. Однако это не единственный повод для формирования папки. Папку также следует составлять, когда автору не хватает информации для продолжения работы или он сомневается в верности сделанного. В этих случаях мы рекомендуем послать папку небольшому числу вполне определенных специалистов, которые могут вам помочь. Например, пошлите незаконченные рабочие материалы самым опытным экспертам или самым опытным SADT-авторам, чьи знания помогут вам. Получив от них замечания, вы сможете, как правило, довести свою работу до степени, необходимой для рассылки папок всей вашей читательской аудитории для получения новых замечаний. В главе 20 обсуждаются подробности рассылки серии папок для достижения консенсуса.
SADT-папка представляет собой небольшой набор взаимосвязанных SADT-диаграмм и других материалов, отобранных автором для рецензирования читательской аудиторией. Папки составляются, как только автор почувствует, что накопилось достаточно новой информации для рецензирования. Размеры папок должны быть небольшими, чтобы обеспечить быстрое рецензирование. Титульный лист папки содержит название папки, ее краткое содержание и фамилии экспертов, которые должны прочитать папку.
Дополнительная литература
-
Connor, M.: "Structured Analysis and Design Technique - SADT", Auerbach portfolio 32-04-02, 1979.
-
King, L: "Guidelines for an SADT Chief Author", SofTech Deliverable no. 9595-2, 1980.
-
Ross, D. and Schoman, K.: "Structured Analysis for Requirements Definitions", IEEE Transactions on Software Engineering, vol. SE-3, no. 1, January 1977.