8. Правила оформления приложений

В приложения выносятся дополнительные и справочные материалы: таблицы исходных данных, результаты расчетов и экспериментов, протоколы испытаний, и другие материалы, которые позволяют более полно представить исходные данные и результаты разработки.

В приложение включить графические спецификации, указанные в п.п. 2.3.

Приложения оформляются как продолжение дипломной работы на ее последних страницах после списка использованных источников. По форме они могут представлять собой текст, таблицы, схемы, диаграммы, графики, карты. Приложения обозначают заглавными буквами русского алфавита, начиная с буквы А, за исключением букв Ё, З, Й, О, Ч, Ь, Ы, Ъ.

Связь основного текста с приложениями осуществляется через ссылки, которые употребляются со словом «смотри», оно обычно сокращается и заключается вместе с шифром в круглые скобки по форме. Например: (см. Приложение Б).

9. Требования по оформлению графических иллюстраций и приложений вкр

Графическая часть является необходимым условием оформления дипломной работы. Перечень (не менее 5 спецификаций), содержание графических (демонстрационных) документов и их количество согласовывается с руководителем и указывается им в задании на выполнение ВКР.

Конструкторская документация выполняется в соответствии с требованиями ЕСКД. Технологическая документация - в соответствии с требованиями ЕСТД.

В соответствии с ЕСКД к графическим (демонстрационным) документам относятся: чертежи, схемы, диаграммы, модели продукта или его частей.

Графические приложения оформляются на белых листах стандартного формата от А4 до А1. Ориентация бумаги может быть как книжная, так и альбомная.

10. Общие требования к выполнению плакатов и электронных презентаций

Правила выполнения плакатов устанавливает ГОСТ 2.605-68.Плакаты могут использоваться для иллюстрации излагаемого в докладе материала, например, при описании задач исследования. Плакаты могут быть выполнены карандашом, черной и цветной тушью, гуашью, фломастером. Их выполняют произвольным образом без соблюдения стандартов, в черно-белом изображении или в цвете.

Плакат должен иметь название и может иметь поясняющий текст. Название плаката размещается в верхней части листа, поясняющий текст - в нижней части листа. В правом нижнем углу листа необходимо указать фамилию, инициалы, группу дипломника и год защиты.

Шрифт для заголовка плаката рекомендуется выбирать в пределах 14-40 мм.

Рекомендуется полностью использовать все поле плаката. Состав и вид графической информации не регламентируется.

Допускается замена плакатов электронными презентациями. Текст и схемы на слайдах презентации должны выполняться контрастным цветом по отношению к цвету фона слайда (темный фон – светлый текст и наоборот). Например, белый текст на черном или синем фоне.

Количество строк текста на одном слайде не должно превышать 10 строк.

11. Схемы алгоритмов, программ, данных и систем

Условные графические обозначения в схемах выполняются по ГОСТ 19.701 - 90 "ЕСПД. Схемы алгоритмов, программ, данных и систем. Ус­ловные обозначения и правила выполнения". Схемы состоят из имеющих заданное значение символов, краткого пояснительного текста и со­единительных линий. Уровень детализации должен быть таким, чтобы различные части и взаимосвязь между ними были понятны в целом.

ВКР, выполняемые в области информатизации, оформляются с учетом требований единой системы программной документации (ЕСПД)

Простейшей структурной единицей любого алгоритма являются символы процесса, обозначающие один элементарный (наг переработки и преобразования информации, причем действия, производимые над вход­ными данными, могут быть различными. К наиболее часто употребляе­мым относятся следующие символы, изображенные на рис 1.

Символ процесса (рис. 1,а) отображает функцию обработки данных любого вида, т. е. выполнение определенной операции или группы операций, приводящих к изменению значения, формы или размещения информации.

Символ данных (рис. 1,6) отображает данные, представленные на произвольном носителе.

Символ предопределенного процесса (рис. 1,в) отображает процесс, состоящий из одной или нескольких операций или шагов программы, которые определены в другом месте программы, программы, модуля.

Символ подготовки (рис, 1,г) отображает модификацию команды или группы команд с целью воздействия на некоторую последующую функцию, например, модификацию индексного регистра и т. д.

Символ решения отображает решение или функцию переключательного типа (рис. 1,д), имеющий один вход и рад выходов, лишь один из которых может быть активизирован после вычисления условий, определенных внутри этого символа. Результаты вычислений можно записать по соседству с линиями, которые отображают соответствующие альтернативные пути.

Символ параллельных действий (рис. 1,е) отображает синхронизацию не­скольких параллельных операций, выполнение которых может начинаться лишь после завершения процесса, указанного на схеме до настоящего знака.

Символ границы цикла состоит из двух частей и отображает начало и конец цикла (рис. 1 .ж). Обе части символа имеют один и тот же идентификатор. Условия для идентификации, приращения, завершения и т. д. помешаются внутри символа в начале или конце в зависимости от рас­положения операции, проверяющей условие.

Следующая группа символов используется для правильного оформления алгоритма.

Рис. 1.

Символ линии (рис. 1,з) отображает направления потоков данных.

Символ соединителя (рис. 1,и) отображает выход из части схемы и вход в другую часть схемы и используется для обрыва линии и продолжения ее в другом месте. Соответствующие символы-соединители должны содержать одно и то же уникальное обозначение.

Символ терминатора (рис. 1,к) отображает выход во внешнюю среду и вход из внешней среды, например, начало и конец, схемы программы, внешнее использование и источник или пункт назначения данных.

Символ комментария (рис. 1,л) используется для добавления описательных комментариев или пояснительных записей в целях объяснения. Пунктирные линии в символе комментария связаны с соответствующим символом или могут обводить группу символов. Текст комментариев или примечаний должен быть помещен около ограничивающей прямоугольной скобки.

Символ пропуска (рис. 1,м) используется в схемах для отображения пропуска символа или группы символов, в которых не определены ни тип, ни число символов. Символ используют только в символах линии или между ними. Он используется, главным образом, в схемах, изображающих общие решения с неизвестным числом повторений.

Символ пунктирной линии (рис. 1,н) отображает альтернативную связь между двумя или более символами. Кроме того, символ используют для обведения аннотированного, например, комментарием, участка.

При выполнении схем алгоритмов следует придерживаться следующих правил.

Символы в схеме должны располагаться равномерно. Следует придерживаться разумной длины соединений и минимального числа длинных линий.

Формы символов должны оставаться неизменными. Не должны изменяться углы и другие параметры, влияющие на соответствующую форму символов. Символы должны быть, по возможности, одного размера. Предпочтительным является горизонтальное расположение символов.

Минимальное количество текста, необходимого для понимания функции данного символа, следует помещать внутри данного символа (рис. 2,а). Текст для чтения должен записываться слева направо и сверху вниз независимо от направления потока. Если объем текста, помещаемого внутри символа, превышает его размеры, следует использовать символ комментария.

В схемах следует использовать идентификатор символов, представляющий собой комбинацию из букв и чисел, предназначенную для ссылок на данный символ в других документах, например, в листинге программы или пояснительной записке. Идентификатор символа должен располагаться слева над символом (рис. 2,6)

а) б)

Рис.2.

Потоки данных или потоки управления в схемах показываются линиями. Направление потока слева направо и сверху вниз считается стандартным. В случаях, когда необходимо внести большую ясность в схему, на линиях используются стрелки. Если поток имеет направле­ние, отличное от стандартного, стрелки должны указывать это направление. В схемах следует избегать пересечения линий. Пересекающиеся линии не имеют логической связи между собой, поэтому, как показано на рис. 3,а, изменения направления в точках пересечения не допускаются. Две или более входящих линий потоков информации могут объединяться в одну исходящую линию, при этом место объединения должно быть смещено (рис. 3,6). Линии потоков должны подходить к символу справа (сверху), а исходить слева (снизу). Линии должны быть направлены к центру символа.

а) б)

Рис. 3.

При необходимости линии в схемах следует разрывать для избегания излишних пересечений или слишком длинных линий, а так же если схема состоит из нескольких страниц. Соединитель в начале разрыва называется внешним соединителем, а соединитель в конце разрыва - внутренним соеди­нителем. Ссылки на страницы, с которыми обязаны соединители, могут быть приведены, как показано на рис. 4, в комментариях для соединителей.

Внешний соединитель Внутренний соединитель

к с.129

из с. 127

Рис. 4.

к с.129

Если из символа выходит несколько выходов, то их можно показывать или несколькими линиями от данного символа к другим символам (рис. 5,а), или одной линией от данного символа, которая затем разветвляется, как показано на рис. 5,6, в соответствующее число линий. Каждый выход из символа должен сопровождаться соответствующими значениями условий, чтобы показать логический путь, который он представляет, с тем, чтобы эти условия и соответствующие ссылки были идентифицированы.

28

А=[1…3]

A=3

A=2

A=1

A=0

A=вне диапазона

а) б)

Рис. 5.

Отдельно поясним символ предопределенного процесса, который часто используется для обозначения так называемых вспомогательных или подчиненных алгоритмов. При обращении к ранее определенным частям программ или при многократном использовании одних и тех же модулей программы, вход в которые возможен, из различных точек главного алгоритма, используют обозначение предопределенного процесса. Готовые алгоритмы, целиком включаемые в состав разрабатываемого алгоритма, называются вспомогательными или подчиненными в отличие от главного или основного алгоритма. Использование вспомогательных алгоритмов вызывает необходимость оформлять их особым образом, используя обозначение рис. 1,в. Формальные способы оформления таких алгоритмов широко применяются в языках программирования, а сами вспомогательные алгоритмы, написанные на языках программиро­вания, называют подпрограммами или процедурами.

Диаграмма потоков данных (DFD) (Приложение Т) является основным средством моделирования функциональных требований проектируемой системы. С их помощью эти требования разбиваются на функциональные компоненты (процессы) и представляются в виде сети, связанной потоками данных. Главная цель таких средств - продемонстрировать, как каждый процесс преобразует свои входные данные в выходные, а также выявить отношения между этими процессами.

Для изображения DFD традиционно используются две различные нотации: Йодана (Yourdon) и Гейна-Сарсона (Gane-Sarson).

Основные символы DFD изображены на рис.2.1.

Рис. 2.1. Основные символы диаграммы потоков данных

ПОТОКИ ДАННЫХ являются механизмами, использующимися для моделирования передачи информации (или даже физических компонент) из одной части системы в другую. Потоки на диаграммах обычно изображаются именованными стрелками, ориентация которых указывает направление движения информации. Иногда информация может двигаться в одном направлении, обрабатываться и возвращаться назад в ее источник. Такая ситуация может моделироваться либо двумя различными потоками, либо одним - двунаправленным.

Назначение ПРОЦЕССА состоит в продуцировании выходных потоков из входных в соответствии с действием, задаваемым именем процесса. Это имя должно содержать глагол в неопределенной форме с последующим дополнением (например, ВЫЧИСЛИТЬ МАКСИМАЛЬНУЮ ВЫСОТУ).

ХРАНИЛИЩЕ (НАКОПИТЕЛЬ) ДАННЫХ позволяет на определенных участках определять данные, которые будут сохраняться в памяти между процессами. Имя хранилища должно идентифицировать его содержимое и быть существительным.

ВНЕШНЯЯ СУЩНОСТЬ (или ТЕРМИНАТОР) представляет сущность вне контекста системы, являющуюся источником или приемником системных данных. Ее имя должно содержать существительное, например, СКЛАД ТОВАРОВ. Предполагается, что объекты, представленные такими узлами, не должны участвовать ни в какой обработке.

Диаграмма вариантов использования (Приложение П). Вариант использования представляет собой последовательность действий (транзакций), выполняемых системой в ответ на событие, инициируемое некоторым внешним объектом (действующим лицом). Вариант использования описывает типичное взаимодействие между пользователем и системой. В простейшем случае вариант использования определяется в процессе обсуждения с пользователем тех функций, которые он хотел бы реализовать. На языке UML вариант использования изображают следующим образом:

Рис.2. Вариант использования

Д ействующее лицо (actor) – это роль, которую пользователь играет по отношению к системе. Действующие лица представляют собой роли, а не конкретных людей или наименования работ. Несмотря на то, что на диаграммах вариантов использования они изображаются в виде стилизованных человеческих фигурок, действующее лицо может также быть внешней системой, которой необходима некоторая информация от данной системы. Показывать на диаграмме действующих лиц следует только в том случае, когда им действительно необходимы некоторые варианты использования. На языке UML действующие лица представляют в виде фигур:

Рис.3. Действующее лицо (актер)

Действующие лица делятся на три основных типа:

- пользователи;

- системы;

- другие системы, взаимодействующие с данной;

- время.

Время становится действующим лицом, если от него зависит запуск каких-либо событий в системе.

Связи между вариантами использования и действующими лицами

В языке UML на диаграммах вариантов использования поддерживается несколько типов связей между элементами диаграммы. Это связи коммуникации (communication), включения (include), расширения (extend) и обобщения (generalization).

Связь коммуникации – это связь между вариантом использования и действующим лицом. На языке UML связи коммуникации показывают с помощью однонаправленной ассоциации (сплошной линии).

Рис.4. Пример связи коммуникации

Связь включения применяется в тех ситуациях, когда имеется какой-либо фрагмент поведения системы, который повторяется более чем в одном варианте использования. С помощью таких связей обычно моделируют многократно используемую функциональность.

Связь расширения применяется при описании изменений в нормальном поведении системы. Она позволяет варианту использования только при необходимости использовать функциональные возможности другого.

Рис.5. Пример связи включения и расширения

С помощью связи обобщения показывают, что у нескольких действующих лиц имеются общие черты.

Рис.6. Пример связи обобщения

Диаграмма деятельности (Приложение Р) — UML-диаграмма, на которой показано разложение некоторой деятельности на её составные части. Под деятельностью понимается спецификация исполняемого поведения в виде координированного последовательного и параллельного выполнения подчинённых элементов — вложенных видов деятельности и отдельных действий, соединённых между собой потоками, которые идут от выходов одного узла ко входам другого.

Диаграммы деятельности используются при моделировании бизнес-процессов, технологических процессов, последовательных и параллельных вычислений.

Диаграммы деятельности состоят из ограниченного количества фигур, соединённых стрелками. Основные фигуры:

1. Прямоугольники с закруглениями — действия;

2. Ромбы — решения;

3. Широкие полосы — начало (разветвление) и окончание (схождение) ветвления действий;

4. Чёрный круг — начало процесса (начальный узел);

5. Чёрный круг с обводкой — окончание процесса (финальный узел).

Стрелки идут от начала к концу процесса и показывают потоки управления или потоки объектов (данных).

Разработка алгоритма программы (блок-схема) (Приложение С). Алгоритмом называют формально описанную последовательность действий, которые необходимо выполнить для получения требуемого результата.

Формальное описание алгоритмов осуществляют с использованием схем алгоритмов и псевдокодов.

При разработке алгоритма каждое действие обозначают соответствующим блоком, показывая их последовательность линиями, идущими слева направо и сверху вниз. Для удобства чтения схемы желательно, чтобы линия входила в блок сверху, а выходила снизу. Если направление линии отлично от стандартного, то в конце линии ставится стрелка, в противном случае ее можно не ставить.

Схема данных (ER-диаграмма) (Приложение М). ER-модель (от англ. entity-relationship model, модель «сущность — связь») — модель данных, позволяющая описывать концептуальные схемы предметной области.

ER-модель используется при высокоуровневом (концептуальном) проектировании баз данных. С её помощью можно выделить ключевые сущности и обозначить связи, которые могут устанавливаться между этими сущностями.

Физическая модель данных (Приложение У). Физическая модель данных (ФМД) – это модель данных, описанная с помощью средств конкретной СУБД. ФМД строится на базе даталогической путем добавления особенностей конкретной СУБД. К таким особенностям могут относиться поддерживаемые СУБД типы данных, соглашения о присвоении имен таблицам, атрибутам и т.д. ФМД фактически является готовым заданием на создание БД, имея которое можно реализовать БД в выбранной СУБД.

Структурная схема программного обеспечения (Приложение Л). Структурной называют схему, отражающую состав и взаимодействие по управлению частей разрабатываемого программного обеспечения.

Самый простой вид программного обеспечения - программа, которая в качестве структурных компонентов может включать только подпрограммы и библиотеки ресурсов. Разработку структурной схемы программы обычно выполняют методом пошаговой детализации.

Структурными компонентами программной системы или комплекса могут служить программы, подсистемы, базы данных, библиотеки ресурсов и т. п.

Схема пользовательского интерфейса (Приложение Н). предполагает визуальное отображение всех используемых форм и их вариантов, в зависимости от действий пользователя.

Принципы разработки пользовательского интерфейса:

1) Принцип структуризации. Пользовательский интерфейс должен быть структурирован так, чтобы близкие по смыслу, родственные его части были связаны видимым образом, а независимые – разделены; похожие элементы должны выглядеть похоже, а непохожие – различаться.

2) Принцип простоты. Наиболее распространённые действия должны выполняться максимально просто, чтобы существенно снизить затрачиваемые усилия.

3) Принцип наблюдаемости. Все операции и данные, необходимые для решения определённой задачи, должны быть хорошо видны, когда пользователь пытается её решить. Излишняя и ненужная информация не должна отвлекать внимание пользователя.

4) Принцип обратной связи. Пользователь должен получать сообщения о действиях программы и о важных событиях внутри неё. Сообщения должны быть ясными, краткими, недвусмысленными и написанными на языке, понятном пользователю.

5) Принцип толерантности. Интерфейс должен быть гибким и терпимым к ошибкам пользователей. Ущерб от ошибок должен снижаться за счёт возможности отмены или повтора действий, а также за счёт разумной интерпретации любых разумных действий пользователя и введённых им данных (например, допускать различную последовательность выполнения этапов задачи и различные формы ввода исходных данных).

6) Принцип повторного использования. Чтобы поведение программы было предсказуемо, полезно повторно использовать известные приёмы и решения, применяемые при разработке интерфейсов для других программ.