11.3.2 Розробка програмної документації

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

Для виконання таких схем в програмі Visio створено трафарети, які зосереджені в розділах:

Flowchart – трафарети Basic Flowchart, Data Flow Diagram, IDEF0 Diagram, Miscellaneous Flowchart Shapes, SDL Diagram Shapes, які допомагають створювати блок-схеми алгоритмів та діаграми;

Software – трафарети UML Activity, UML Collaboration, UML Component, UML Deploment, які дозволяють будувати UML-діаграми та загальні схеми управління базами даних.

При необхідності детальної розробки програмних документів процес бажано автоматизувати з використанням SWITCH-технології. У цьому випадку треба скачати (www.geocities.com/goloveshin) конвертор Visio2SWITCH, який необхідний для автоматичної генерації C/C⁺⁺ коду по автоматним графам, виконаним в Visio у відповідності до вимог SWITCH-технології (www.softcraft.ru). Для побудови автоматного графа рекомендується використання спеціально розробленого трафарету SWITCH, показаного на рисунку 11.8.

До трафарету входять 9 майстрів. Параметри автомату вносяться в майстер SW_Auto (рис. 11.9). Для внесення та редагування інформації треба виділити фігуру, навести хрестоподібну стрілку покажчика на місце, де передбачається внесення даних, та натиснути F2.

Рисунок 11.9 – Заповнення параметрів автомату в майстрі SW_Auto

Формат імені – будь-яка комбінація з арабських цифр, латинських букв верхнього та нижнього регістрів (крім букв e, x, y, z), а також підкреслювання [ _ ]. У даному прикладі ім'я визначено як [0], відповідно, автоматна функція отримує ім'я [A0], а змінна стану – [y0].

Якщо такий об'єкт є на листі Visio, то автоматний граф вважається як визначений і конвертор буде обробляти стани, групи станів і дуги. Якщо такий об'єкт відсутній, то конвертор ігнорує названі об'єкти.

Другий майстер – SW_State – визначає параметри одного стану автомату (рис. 11.10).

Рисунок 11.10 – Заповнення майстру SW_State

Формат першого рядка: {число} [.] {довільний рядок символів}.

Формат другого рядка (набір вкладених автоматів): [A:] {імена автоматів через кому}.

Формат третього рядка (набір дій): [z:] {імена дій через кому}.

Третій основний компонент трафарета SWITCH – коннектори SW_Connector1(2,3). Вони застосовуються як дуги автоматного графу.

Коннектори відрізняються тільки формою подання. Вони повинні бути забезпечені параметрами переходів в такому форматі:

{число} [:] {умови переходу} [/z:] {імена дій через кому}.

При цьому обов'язково треба вказувати тільки умови переходу, а решта може бути опущена.

Умови переходу можуть представлятися логічними виразами, наприклад: e10x20 + x110_0 (y80_0 = 5).

Решта майстрів використовується для коментарів.

Після побудови графа і внесення описів автомата, переходів (станів) та дуг запускається програма конвертування v2s (Wisio2SWITCH).

ДОДАТОК А