Описание+программы+Служба+загрузки(Испр.)_psh

УТВЕРЖДЕН
«КОМПЛЕКС ПРОГРАММНЫХ СРЕДСТВ ПОДСИСТЕМЫ ВВОДА И
ХРАНЕНИЯ ИНФОРМАЦИИ».
Программный компонент
«Служба загрузки и выгрузки данных»
Описание программы
Листов 14
Москва
2009 г.
2
ПК «FileLoader»
АННОТАЦИЯ
Настоящий документ содержит сведения о назначении программного
компонента (ПК) «Служба загрузки и выгрузки данных», входящего в
состав
программного
комплекса
«Бухгалтерия»
(ИС
«Бухгалтерия»),
описание условий выполнения ПК и действий оператора при работе с ним.
Изм.
Подп.
Дата
СОДЕРЖАНИЕ
1. ОБЩИЕ СВЕДЕНИЯ................................................................................ 4
2. ФУНКЦИОНАЛЬНОЕ НАЗНАЧЕНИЕ ................................................. 5
3. ОПИСАНИЕ ЛОГИЧЕСКОЙ СТРУКТУРЫ ......................................... 6
4. ИСПОЛЬЗУЕМЫЕ ТЕХНИЧЕСКИЕ СРЕДСТВА ............................... 7
5. ВЫЗОВ И ЗАГРУЗКА .............................................................................. 8
6. ВХОДНЫЕ И ВЫХОДНЫЕ ДАННЫЕ................................................ 12
ПРИЛОЖЕНИЕ 1. ПЕРЕЧЕНЬ КОДОВ ИСТОЧНИКОВ И
НАПРАВЛЕНИЙ. ....................................................................................... 15
4
ПК «FileLoader»
1. Общие сведения
1. Наименование программы - Программный компонент (ПК) «Служба
загрузки и выгрузки данных»
2. Для функционирования программного компонента «Служба загрузки
и выгрузки данных» необходимо следующее программное обеспечение:
Операционная система Windows 2000, XP;
Библиотека Access Data Object (ADO) (начиная с Win2000 поставляется
совместно с операционной системой).
3. Язык программирования – Object Pascal.
Cреда разработки – Delphi 7.
Изм.
Подп.
Дата
5
ПК «FileLoader»
2. Функциональное назначение
ПК «Служба загрузки и выгрузки данных» является интегрирующей
составляющей программного комплекса «Бухгалтерия». С помощью данного
ПК производится загрузка файлов из директории в базу данных и выгрузка из
базы данных в директорию.
Основной функциональной частью ПК «Служба загрузки и выгрузки
данных» является шлюз сопряжения с СУБД Firebird.
Шлюз сопряжения, реализованный в виде службы операционной
системы, служит для взаимодействия с базой данных, сформированной в
результате работы ИС «Бухгалтерия». Выполняется циклический опрос
директории на предмет обнаружения новых файлов и загрузка найденных
файлов в базу данных.
Функционирование ПК «Служба загрузки и выгрузки данных»
возможно как в условиях локальной вычислительной сети, так и в
однопользовательском варианте (на автономном рабочем месте /ПЭВМ/).
Для работы с базой данных, на машине, являющейся сервером базы
данных, должна быть запущена СУБД Firebird и предоставлен сетевой доступ
к каталогам, предназначенным для обмена файлами.
Изм.
Подп.
Дата
6
ПК «FileLoader»
3. Описание логической структуры
Общий алгоритм работы ПК «Служба загрузки и выгрузки данных»
состоит в следующем:
1. Опрос каталога на предмет обнаружения новых файлов;
2. Загрузка найденных файлов в базу данных;
3. Опрос
базы
данных
на
предмет
обнаружения
файлов,
предназначенных для выгрузки в директорию;
4. Выгрузка необходимых файлов в директорию и передача в базу
данных информации об их успешной выгрузке;
Изм.
Подп.
Дата
7
ПК «FileLoader»
4. Используемые технические средства
ПК «Служба загрузки и выгрузки данных» предназначен для
использования в среде операционной системы Windows 2000, XP. Для
нормальной работы ПК «Служба загрузки и выгрузки данных» необходимо
иметь, как минимум, компьютер с процессором Pentium II и 128 Мбайт
оперативной памяти. Функционирование ПК «Служба загрузки и выгрузки
данных» возможно как в условиях локальной вычислительной сети, так и в
однопользовательском варианте.
Изм.
Подп.
Дата
8
ПК «FileLoader»
5. Вызов и загрузка
Вызов и использование в ПК«Бухгалтерия» является внутренним и
производится через программный интерфейс.
Для установки и запуска службы выполните следующие действия:
1.
Скопируйте в корень диска "С" папку FileLoader, содержащую
исполняемый
файл
службы
FileLoaderService.exe
и
файл
настроек
FileLoader.ini.
2.
Откройте файл FileLoader.ini и проставьте следующие значения:
 dbPath=
путь
к
базе
данных
в
формате
ИМЯ_МАШИНЫ:ПОЛНЫЙ ПУТЬ К ФАЙЛУ GDB.
Важным условием, является то,что путь к базе данных
должен полностью совпадать с тем путём,который прописан
в строке подключения ПК «Бухгалтерия».
 interval=интервал опроса каталога с загружаемыми файлами
в миллисекундах. Не рекомендуется указывать значение
меньше 10000.
 incomingFolder=полный путь к каталогу с загружаемыми
файлами
 outcomingFolder=полный путь к каталогу с выгружаемыми
файлами
Также, важно убедиться,чтобы на каталог для выгружаемых
файлов имеет права на запись для пользователя,под которым
запущена служба.
 startTime,stopTime = ЧЧ:ММ время начала и окончания
работы службы;
Изм.
Подп.
Дата
9
ПК «FileLoader»
 source_allowed = <список, значений, через, запятую>
перечень источников, файлы для которых разрешены для
выгрузки из БД;
 source_except = <список, значений, через, запятую>
перечень источников, файлы для которых запрещены для
выгрузки из БД;
 napr_allowed
= <список, значений, через, запятую>
перечень направлений, файлы для которых разрешены для
выгрузки из БД;
 napr_except = <список, значений, через, запятую> перечень
направлений, файлы для которых запрещены для выгрузки
из БД.
Параметр source_except имеет больший приоритет, чем параметр
source_allowed. Параметр napr_except имеет больший приоритет, чем
параметр napr_allowed. Параметры source_allowed и napr_allowed не должны
быть пустыми. Значение «*» для любого из этих параметров трактуется как
«все возможные значения».
Параметр source_except проверяется только в том случае, когда
соответствующий ему параметр source_allowed принимает значение «*».
Аналогично, параметр napr_except проверяется только в том случае, когда
соответствующий ему параметр napr_allowed принимает значение «*».
При
выборке
файлов
сначала
накладываются ограничения
по
источникам, потом по направлениям, таким образом, если в списке
разрешённых присутствуют направления от запрещённого источника, в
выборку они не попадут.
Перечень кодов направлений и источников для использования см. в
приложении 1.
Изм.
Подп.
Дата
10
ПК «FileLoader»
Примеры использования:
а) разрешить выгрузку всех файлов:
source_allowed=*
source_except=
napr_allowed=*
napr_except=
б) разрешить выгрузку всех файлов, кроме файлов источника МГК:
source_allowed=*
source_except=mgk
napr_allowed=*
napr_except=
в) разрешить выгрузку только файлов для УФК по направлению
«Банк»:
source_allowed=ufk
source_except=
napr_allowed=ufk_bnk
napr_except=
в) запретить выгрузку всех файлов:
source_allowed=*
source_except=*
napr_allowed=*
napr_except=*
3. Для установки службы выполните команду следующего вида:
C:\path\to\file\FileLoaderService.exe /install <service_name> <service_description>
Изм.
Подп.
Дата
11
ПК «FileLoader»
Или запустите файл InstallService.bat, лежащий рядом с исполняемым
файлом, который выполнит ту же самую команду с параметрами по
умолчанию.
Об успешной регистрации службы свидетельствует сообщение:
«Служба успешно установлена».
4.
Далее запустите оснастку управления службами: Пуск-Панель
управления-Администрирование-Службы и запустите установленную службу
(по умолчанию её имя будет «Budget21 File Loader Service»).
5. В случае успешного выполнения вышеперечисленных шагов в
каталоге C:\FileLoader появится файл журнала службы FileLoader.txt с
сообщением:
16.09.08 22:35:08 Запуск службы
Изм.
Подп.
Дата
12
ПК «FileLoader»
16.09.08
22:35:08
Инициализация
параметров
службы.Interval=10000;incomingFolder=c:\FKU;dbPath=localhost:D:\Budjet\BU
DJET_DF\ДФ\BUD95.GDB
6. Для успешной связи службы с СУБД Firebird должен быть открыт
сетевой порт 3050.
Результатом бесперебойной работы службы будет являться регулярный
перенос и последующее удаление из каталога загружаемых файлов. В случае
накопления загружаемых файлов, причину ошибки смотрите в файле
FileLoader.txt.
Пример ошибки подключения к базе данных:
24.08.09 01:34:07 Отсутствует соединение с БД: I/O error for file
"D:\Budjet\BUDJET_DF\ДФ\BUD.GDB"
Error while trying to open file
Не удается найти указанный файл.
localhost:D:\Budjet\BUDJET_DF\ДФ\BUD.GDB
6. Входные и выходные данные
Входными и выходными данными ПК «Служба загрузки и выгрузки
данных» являются файлы и записи в базе данных, по наличию которых
инициализируется процесс загрузки и выгрузки.
Изм.
Подп.
Дата
13
ПК «FileLoader»
ЛИСТ РЕГИСТРАЦИИ ИЗМЕНЕНИЙ
Номера страниц (листов)
з Изменен-
Заме-
Изм.
ных
ненных
1
2
3
Новых
4
Изм.
Входящий №
Дата
№
сопроводительног
внесения
документа
о документа и
изменения и
дата
подпись
8
9
Всего листов
Аннули-
(страниц) в
рованных
докум.
5
6
Подп.
7
Дата
14
ПК «FileLoader»
Изм.
Подп.
Дата
15
ПК «FileLoader»
Приложение 1. Перечень кодов источников и
направлений.
Источник
Код
Банки
bnk
CORONA
МГК
corona
mgk
Направление
Лицевые счета
Отчеты и формы по
бюджетной
инструкции для
CORONA
Неопределённый
источник
Изм.
none
corona_buh
mgk_bnk
Договора в формате
московского
городского
казначейства
mgk_dog
Госконтракт для
Федерального
казначейства
ufk
bnk_ls
БАНК
Уведомления по
расходам
Банк
Бюджетные
обязательства
УФК
Код
mgk_uved
ufk_bnk
ufk_bo
ufk_gk
Документы по РМ
КАССА для
Федерального
казначейства
ufk_kassa
Смета по ПДД
ufk_pd_sm
Документы по РМ
СМЕТА для
Федерального
казначейства
ufk_smeta
Неопределённое
направление
none
Подп.
Дата