Структура проекта
Содержание |
Программный комплекс "АвтоПарк" состоит из двух частей: СУБД "Atol System Base" (ASB) и прикладной части, так называемого проекта, который включает в себя базу данных и прикладные модули для работы с ней. Каждую из этих двух частей, в свою очередь, можно разделить на клиентскую (т.е. используемую на рабочей станции) и серверную (т.е. используемую непосредственно на сервере) половины.
Связь с серверной частью СУБД осуществляется по двум протоколам:
- ASBP – основной протокол обмена данными между ASB-клиентом и ASB-сервером.
- HTTP – стандартный протокол обмена между Web-браузером и Web-сервером, в роли которого выступает ASB-сервер. Используется для просмотра состояния и администрирования ASB-сервера.
Состав папок
В ходе установки АвтоПарка и ASB на сервер Windows 2003/2008 создается 6 общих папок: AP_Support, AutoPark, AutoParkSrv, ASBClient, ASBServer и Data. Если предполагается использование сервера приложений ASB, дополнительно появляется общая папка ASBApSrv.
Общая папка AP_Support
Соответствует папке "C:\AP_Support" на сервере.
Используется только Разработчиками (группа пользователей AP_Support).
Общая папка AutoPark
Соответствует папке "C:\AutoPark" на сервере.
Клиентская часть проекта. Содержит программы, меню, экранные формы, DOT и XLT-шаблоны, а также готовые отчеты. С этими файлами работает клиент ASB.
Структура подпапок:
- $_LIB. Cодержит библиотечные модули (самое актуальное содержимое этой папки всегда есть у разработчика):
- ASL – программные модули.
- MNU – описание структуры меню.
- WDO – описание форм ввода.
- XLT – шаблоны Excel-отчетов.
- DOT – системные шаблоны для печати документов в MS Word.
- ASL. Содержит программные модули и конвертеры (самое актуальное содержимое этой папки всегда есть у разработчика):
- CARDS – сменные модули, используемые для расчета зарплаты, обработки путевых листов и т.п.
- TMP_LIB – содержит временные программные модули.
- BY_USER – программные модули, написанные пользователем.
- BASIS. Состоит из множества подкаталогов, создаваемых при первоначальном запуске Excel-отчета. В каждом таком подкаталоге содержатся файлы, необходимые для отображения Excel-отчета – txt, csv, xls. (см. размещение папки хранения отчетов вне папки AutoPark)
- DEF. Содержит файл протокола выполнения обновлений Upgrade.log и файлы-маркеры обновлений с расширениями upd.
- DOT – содержит локальные шаблоны, предоставляемые разработчиками для печати документов в MS Word.
- TMP_LIB – содержит временные шаблоны для печати документов в MS Word.
- BY_USER – содержит шаблоны для печати документов в MS Word, модифицированные пользователем (т.е. Вами).
- MNU. Содержит модули описания меню (самое актуальное содержимое этой папки всегда есть у разработчика).
- TMP_LIB - Содержит временные модули описания меню.
- REP. Содержит все когда либо сформированные в Системе отчеты. Состоит из ряда подкаталогов:
- $$ – все отчеты.
- 01 ... 12 – важные отчеты, формируемые ежемесячно (название подкаталога соответствует порядковому номеру месяца в году).
- ANK – транспортные файлы и отчеты для передачи в ПФ РФ.
- TJR. Содержит протоколы ошибок/предупреждений (файлы с расширениями ead, ecn, erh, eeh) и файлы индивидуальных настроек пользователей (параметры окон, параметры печати) с расширениями ses.
- TMP. Каталог временных файлов, создаваемых Системой по техническим причинам. Может использоваться для импорта данных в Систему.
- TXT. Также может использоваться для временного хранения данных для импорта в Систему. Содержит текстовые шаблоны приказов по персоналу edo?????.txt.
- WDO. Содержит локальные и временные формы ввода Системы (самое актуальное содержимое этой папки всегда есть у разработчика).
- TMP_LIB - временные формы ввода.
- XLT. Содержит пользовательские шаблоны Excel-отчетов.
- LOCAL - Содержит локальные шаблоны Excel-отчетов.
- TMP_LIB - Временные шаблоны Excel-отчетов.
- SAVE. Содержит старые версии модулей проекта, которые были заменены или удалены автоматическим обновлением системы АвтоПарк. (см. размещение папки для сохранения прежних версий обновляемых файлов проекта вне папки AutoPark)
- IMAGES. Каталог для хранения графических файлов.
- PHOTO - Содержит фотографии работников предприятия. При использовании Фотостудии изображения сохраняются в этом каталоге.
Общая папка AutoParkSrv
Соответствует папке C:\AutoParkSrv на сервере.
Серверная часть проекта. Здесь хранятся собственно файлы базы данных, с ними работает сервер ASB.
Структура подпапок:
- DAT – файлы данных.
- KEY – файлы индексов.
- DAP – архивные части файлов данных.
- KAP – архивные части файлов индексов.
- SDEF – содержит DBD-файл, содержащий описание структуры проекта.
- STJR – системная информация, в частности о незавершенных транзакциях.
Общая папка ASBClient
Соответствует папке "C:\Program Files\ASBClient" на сервере.
Клиентская часть СУБД (клиент ASB). Папка содержит исполняемый модуль клиента ASB v32.exe, сетевой инсталлятор клиента ap_setup.exe, модули утилит и библиотек Системы.
Структура подпапок:
- MSOFFICE – набор шаблонов и макросов для взаимодействия Системы и приложений MS-Office.
- OPTIONAL - отладочные утилиты Системы.
- REDISTR - дистрибутивы и исполняемые модули сторонних производителей ПО, часто используемые при работе в Системе: дистрибутивы компонентов COM, дистрибутивы драйверов бесконтактных считывателей, штрих-кодовые шрифты и пр.
- SYS – системные меню, программы, сертификаты и пр.
Общая папка ASBServer
Соответствует папке "C:\Program Files\ASBServer" на сервере.
Серверная часть СУБД (сервер ASB). Папка содержит исполняемый модуль сервера ASB asbsrv.exe, файл настроек сервера ASB asbsrv.ini, инсталлятор средств управления сервером ASB st_setup.exe.
Структура подпапок:
- HTTP – шаблоны страниц состояния ASB-сервера.
- TOOLS – средства управления сервером ASB.
Общая папка ASBApSrv
Соответствует папке "C:\Program Files\ASB Application Server" на сервере.
Сервер приложений ASB. Папка содержит собственно исполняемый модуль сервера приложений ASB asbapsrv.exe, файл настроек сервера приложений ASB asbapsrv.ini и инсталлятор средств управления сервером приложений ASB as_setup.exe.
Структура подпапок:
- TOOLS - средства управления сервером приложений ASB.
Общая папка Data
Соответствует папке "C:\Data" на сервере
Строго говоря, эта папка частью Системы не является. Автоматические обновления Системы помещают в подпапку RECEIVE этой папки все обновления в распакованном виде на случай, если понадобится выполнить какие-либо действия вручную.
Создание копии проекта АвтоПарк
Что такое копия проекта АвтоПарк
Для чего это может быть нужно
Если требуется разработать какие-либо изменения в обработке первичных данных, особенно - предусматривающих существенное изменение справочников, то можно сделать это в копии проекта на реальных данных прошлых месяцев. Например, для подготовки изменений в положении об оплате.
Как это работает
В созданную в стороне от реального проекта копию помещается копия данных и программных модулей из реального проекта. Эта копия никак не связана с реальным проектом, изменения в ней никак не отразятся в реальном проекте. Можно, не боясь испортить данные прошлого месяца, внести в них предполагаемые изменения и сравнить результаты с результатами в реальном проекте.
Важные предостережения!
Выполнять инструкцию следует предельно аккуратно. Особенно при модификации файлов. Ошибка в одном символе может привести к плачевным результатам.
Требуется особое внимание при выборе "настоящего" АвтоПарк или его копии! Обидно обнаружить, что находишься в копии после нескольких часов работы. Еще обиднее испортить важный справочник в реальном проекте, думая, что "играешься" в копии.
Не экономьте время на стадии подготовки копии проекта - это поможет минимизировать риск большого разочарования:
- Настройте ярлык для открытия проекта-копии как рекомендуется ниже, чтобы в заголовке окна клиента ASB отображалось слово "!!!КОПИЯ!!!".
- Сделайте новую иконку. Разработчик иконки не предоставляет.
- Заведите новую специальную группу пользователей для назначения разрешений NTFS на клиентскую часть проекта-копии именно этой группе пользователей, а не какой-либо из уже существующих.
Плохой идеей является распечатать данную инструкцию и действовать "по бумажке". Во-первых, текст инструкции может устареть за время между печатью и использованием напечатанной инструкции. Во-вторых, при выполнении инструкции следует пользоваться возможностью копирования через буфер приведенных в ней команд, это уменьшает шансы ошибиться.
Как организовать копию проекта АвтоПарк
Создание структуры проекта
Выполняется на сервере АвтоПарк.
- Если копию АвтоПарк уже делали ранее, следует полностью удалить предыдущую копию.
- Копирование следует выполнять от имени администратора домена, а под Windows 2008 - от имени администратора домена с наивысшим уровнем привилегий. Под Windows 2008 запустите командную строку или FAR при помощи пункта контекстного меню "Запуск от имени администратора" и выполняйте копирование из этой консоли.
- Создать клиентскую часть проекта-копии.
- Для копирования программ, меню, форм ввода, шаблонов вместе с разрешениями NTFS выполнить следующие команды:
«xcopy c:\AutoPark c:\AutoParkCopy /S /E /I /H /R /K /O /X /Y /T»
«xcopy c:\AutoPark\$_LIB c:\AutoParkCopy\$_LIB /S /E /I /H /R /K /O /X /Y»
«xcopy c:\AutoPark\ASL c:\AutoParkCopy\ASL /S /E /I /H /R /K /O /X /Y»
«xcopy c:\AutoPark\DEF c:\AutoParkCopy\DEF /S /E /I /H /R /K /O /X /Y»
«xcopy c:\AutoPark\MNU c:\AutoParkCopy\MNU /S /E /I /H /R /K /O /X /Y»
«xcopy c:\AutoPark\TXT c:\AutoParkCopy\TXT /S /E /I /H /R /K /O /X /Y»
«xcopy c:\AutoPark\WDO c:\AutoParkCopy\WDO /S /E /I /H /R /K /O /X /Y»
«xcopy c:\AutoPark\XLT c:\AutoParkCopy\XLT /S /E /I /H /R /K /O /X /Y» - Скопировать из «C:\AutoPark» в «C:\AutoParkCopy» файл <ИмяПроекта>.red. Внести в него следующие изменения.
- В секции "ASB Client" исправить значение параметра "LocationAtServer".
[ASB Client]
LocationAtServer=AutoParkCopy - В секции "ASB Special Folders" исправить значение параметра "ServerProjectRoot".
[ASB Special Folders]
ServerProjectRoot=\\<ИмяСервераАвтоПарк>\AutoParkSrv\AutoParkCopy
- В секции "ASB Client" исправить значение параметра "LocationAtServer".
- Открыть общий доступ к папке "C:\AutoParkCopy". Имя общей папки: "AutoParkCopy", разрешения общей папки: всем - полный доступ.
- Поместить в папку «C:\AutoParkCopy\DEF» выбранную иконку под именем «<ИмяПроекта>.ico». Окно копии АвтоПарк будет отображаться с этой иконкой вместо стандартной, что поможет не перепутать копию с реальным проектом. Разработчик иконки не предоставляет.
- Для копирования программ, меню, форм ввода, шаблонов вместе с разрешениями NTFS выполнить следующие команды:
- Создать серверную часть проекта-копии.
- Определиться, какие данные будут использованы в копии АвтоПарк. Если требуются самые актуальные данные, необходимо выполнить в АвтоПарк „Главное меню-Прочее-Администратор-Создание резервной копии“ (резервная копия текущих данных будет сохранена в папке «C:\AutoParkSrv\Backup\Actual»), либо использовать резервную копию базы данных за определенную дату (созданную процедурой резервного копирования). Внимание! Работоспособность АвтоПарк при использовании резервной копии базы данных не гарантируется, так как с момента создания резервной копии могут быть изменения как клиентской части, так и структуры базы данных. Копия Автопарк с неактуальными данными создается, как правило, ТОЛЬКО для выявления изменений в данных, внесенных после создания резервной копии базы данных. Для всех остальных задач следует использовать актуальную копию базы данных. В дальнейшем для ссылки на папку с данными, которые будут размещены в копии АвтоПарк, будет использован термин "Данные для копии".
- В папке «C:\AutoParkSrv» создать подпапку «C:\AutoParkSrv\AutoParkCopy».
- В «C:\AutoParkSrv\AutoParkCopy» создать подпапки: DAP, DAT, KAP, KEY, SDEF, STJR.
- Скопировать файлы *.rgs и *.asb из папки «Данные для копии» в папку «C:\AutoParkSrv\AutoParkCopy\DAT». Здесь и далее выполнять обычное копирование без переноса разрешений NTFS.
- Скопировать «Данные для копии\<ИмяПроекта>.dbd» в папку «C:\AutoParkSrv\AutoParkCopy\SDEF».
- Скопировать «C:\AutoParkSrv\<ИмяПроекта>.red» в папку «C:\AutoParkSrv\AutoParkCopy».
- Если в копии Автопарк требуются данные архивной половины, скопировать файлы DAP из папки "Данные для копии", либо создать пустые DAP-файлы, выполнив команду
«\\<ИмяСервераАвтоПарк>\ASBClient\v32.exe -ind \\<ИмяСервераАвтоПарк>\AutoParkCopy -H:A *»
. После запуска команды будет большая загрузка сервера, возможно, покажется, что программа "висит" - это не так. Через какое-то время будут появляться сообщения об отсутствии DAP-файлов. На предложение создать пустой DAP-файл отвечать "y" (чуть более 30 раз).
Создание ярлыка копии на рабочей станции
Создать ярлык для открытия проекта-копии АвтоПарк.
- Объект:
\\<ИмяСервераАвтоПарк>\ASBClient\v32.exe -SesEnv:Comment="!!!КОПИЯ!!!"
- Рабочая папка:
\\<ИмяСервераАвтоПарк>\AutoParkCopy
- Окно:
Обычный размер окна
- Значок (кнопка "Сменить значок..."):
\\<ИмяСервераАвтоПарк>\AutoParkCopy\DEF\<ИмяПроекта>.ico
Удаление копии проекта
Когда копия проекта больше не нужна ее можно удалить.
- Удалить созданные ярлыки копии.
- Удалить каталоги C:\AutoParkSrv\AutoParkCopy и C:\AutoParkCopy. Для этого потребуются права администратора домена и выгрузка копии проекта из серверной части АвтоПарк. Последнее произойдет автоматически через 10 минут после завершения работы в копии АвтоПарк, либо можно выполнить вручную через утилиту Состояние сервера ASB.