Документация

 Разработчику

 Примеры    скриптов

 Модули

 Изменения в
версиях



 

  Часто задаваемые вопросы (FAQ).


Q-1: Что такое DocPoint II?

А:
DocPoint II - это система автоматизированного электронного документооборота, разработка над которой началась 2000 году, силами программистов ЗАО "Инмар" (г. Калининград). DocPoint II построен по технологии клиент-сервер и работает на основе сервера баз данных FireBird - InterBase. Система была задумана, как средство по упорядочению документооборота, получению и аналитическому анализу информации о прохождении всего комплекса таможенного оформления любого участника ВЭД как в режиме реального времени, так и за любой требуемый период связанного с таможенным оформлением. Система хранит и обрабатывает данные централизовано. Таким образом, общая схема организации рабочего процесса может быть адекватно сопоставлена реальной организационной схеме предприятия. Это позволяет руководителю эффективно контролировать работу предприятия, мгновенно получая исчерпывающую информацию о состоянии дел и сразу же принимать нужные решения. Система DocPoint II запатентована "Российским агентством по патентам и товарным знакам" в мае 2002 года.

Q-2: Почему в качестве сервера БД используется FireBird - InterBase?

А: Выбор сервера баз данных был сделан не случайно. Сервер баз данных FireBird - InterBase, поставляется по открытой лицензии (не требующей отдельной оплаты). Обладает высокой отказоустойчивостью в работе и хорошим механизмом восстановления БД. Что касается объема хранимой информации, то многофайловая база данных может состоять из 65535 файлов, таким образом, теоретический предел для одной базы данных InterBase - 132 терабайта. InterBase не требователен к ресурсам, что позволяет использовать его на маломощных компьютерах. Он также прекрасно работает в сетях с различной пропускной способностью и количеством пользователей.

Q-3: На какие организации ориентирована система DocPoint II?


A: В первую очередь система рассчитана на организации связанные с таможенным оформлением. Схема работы такого предприятия может быть описана следующим образом:
Компания, участвующая в процессе таможенного оформления имеет в своем составе несколько подразделений. Это могут быть отделы, декларирования, таможня, склады временного хранения, диспетчерские службы. Пакеты документов, предоставляемые клиентами, последовательно проходят с этапа на этап, где инспектора анализируют информацию и производят коррекцию электронных копий, пользуясь программным обеспечением автоматизированных рабочих мест (АРМов). Руководящее звено может наблюдать за ходом процесса документооборота, получая данные как в виде отчетов с каждого из этапов таможенного оформления, так и наблюдая за работой каждого сотрудника с помощью специализированных программных средств. В целом, можно сказать, что система DocPoint II предоставляет руководителю полную информацию о деятельности каждой своей функциональной единицы (рабочего места, программного компонента, организационной единицы) в реальном режиме времени. Поступающие данные могут быть организованы в любом аналитическом разрезе в зависимости от нужд пользователя системы.

Q-4: На сколько прозрачен процесс оформления с использованием системы DocPoint?


A: Процесс документооборота может выводиться на монитор установленный в холе организации. Таким образом, обеспечивается прозрачность оформления, когда участники ВЭД видят как, в какие сроки и в какой последовательности обрабатываются поданные ими документы. Если организация имеет прямое соединение с сетью Интернет, то при желании может предоставить доступ к мониторингу документооборота через Web-ресурсы (пример WEBTV ЗАО "ИНМАР" http://www.inmar-term.com/dp/webtv.php). Это позволит участнику ВЭД отслеживать свои документы удаленно через web-браузер или по мобильному телефону, находясь в офисе или в дороге.

Q-5: Ограничены ли возможности системы DocPoint II при работе не на таможенных терминалах?

А: Нет, не ограничены. Система представляет собой механизм транспортировки документов между участками схемы и никак не зависит от используемого на предприятии программного обеспечения для обработки таких документов. Это дает возможность устанавливать систему в организациях не связанных с таможенным оформлением и не тратить деньги на замену ранее приобретенного программного обеспечения. Например, в 2002 году DocPoint II был установлен на большинстве контрольно пропускных пунктах Калининградского региона, где ведется учет автотранспорта пересекающего границу Калининградской области и соседних государств (Литва, Польша).

Q-6: Каковы принципы организации безопасности системы Docpoint II?

A:
Основные принципы организации безопасности в системе DocPoint II заключаются в следующем.

Обеспечение безопасности доступа к данным, осуществляется путем стандартных решений СУБД Interbase.

В системе предусмотрена надстройка над системной таблицей пользователей. С помощью нее в частности ведется протоколирование действий пользователей и определение прав доступа к объектам технологической схемы.
Пользователь проходит аутентификацию и подключается непосредственно к серверу Interbase.
Существует три основных роли (объединение прав доступа к объектам БД).
- readrole - имеет ограниченные права для доступа к БД (только SELECT на несколько таблиц). Используется в частности при аутентификации клиента, для перевода имени пользователя в системное имя пользователя Interbase.
- client_role - роль, имеющая права на доступ к необходимым хранимым процедурам, и не имеющая непосредственного доступа к таблицам БД для изменения.
- reportsaccess - роль, имеющая права на доступ к объектам БД, для формирования отчетов.
На примере рабочего клиента и доступа пользователя через стандартное приложение, пользователь имеет права доступа к определенным объектам технологической схемы. При этом даже если пользователь напрямую подключится к серверу Interbase (минуя клиентское приложение) он не сможет воспользоваться вызовом процедуры, поскольку внутри хранимой процедуры осуществляется проверка прав доступа к объектам технологической схемы. За счет того, что системной роли (роли в СУБД Interbase) назначены права к выполнению определенных хранимых процедур, а последним даны права на изменение таблиц, то это гарантирует, что все изменения будут производится пользователем имеющим права на эту роль исключительно через хранимые процедуры, которые ведут протоколирование работы пользователя и следят за доступом пользователя к тем или иным объектам технологической схемы, согласно ролям технологической схемы для конкретного пользователя.
Полный доступ к объектам БД имеет только встроенный в СУБД Interbase пользователь SYSDBA (SYStem Database Administrator)

Безопасность на уровне коммутации а безопасность доступа к файлам и процессам осуществляется существующими стандартными средствами шифрования.

Q-7: Что необходимо сделать при смене IP-адреса сервера InterBase и/или Cервера отчетов системы DocPoint II?

Смена IP-адреса сервера Вашего подразделения.

При смене IP-адреса сервера вашего подразделения необходимо сделать следующие изменения:

1. В "Центре Управления" в меню "Установки" главного окна программы, выбрать пункт "Редактирование информации о подразделении".

2. В открывшемся окне внести изменения в поля "IP-адрес сервера InterBase" и/или "IP-адрес сервера отчетов" указав в них новый IP-адрес сервера.

"IP-адрес сервера InterBase" - указанный в этом поле IP-адрес должен быть адресом внешней сети, если вы работаете в иерархической структуре подразделений. В противном случае вы будете недоступны для вышестоящих подразделений.
"IP-адрес сервера отчетов" - IP-адрес сервера отчетов. Также как и IP-адрес сервера InterBase должен быть внешним.

3. В строковых параметрах реестра ServerName и RepServHost могут быть указаны как IP-адреса, так и имена компьютеров на которых установлены InterBase и/или Сервер отчетов. Вы можете использовать имена компьютеров, если в вашей сети работают WINS и/или DNS сервера, тогда при смене IP-адреса вам не придется вносить изменения в реестре.

Если в ServerName и RepServHost прописаны IP-адреса, то при смене IP-адреса сервера измените параметры реестра указав новые IP-адреса сервера InterBase и/или Сервер отчетов.

Для клиентских машин, где в строковых параметрах реестра ServerName и RepServHost были также использованы IP-адреса, укажите новое значение IP-адреса севера InterBase и Сервера отчетов.

[HKEY_LOCAL_MACHINE\SOFTWARE\DocPointII]
"ServerName"="ip-адрес/имя_сервера"
[HKEY_LOCAL_MACHINE\SOFTWARE\DocPointII\Reports\RepClient]
"RepServHost"="ip-адрес/имя_сервера"

Для внесения изменений можно воспользоваться стандартной утилитой проверки скриптов и настройки реестра c:\Client\CheckUtil.exe поставляемой в комплекте DocPoint II или запустить редактор реестра Windows - regedit.exe.

Примечание: при отсутствии или выходе из строя WINS и/или DNS сервера компьютеры, которые идентифицировались по именам будут не доступны.


Смена IP-адреса сервера при работе с подразделениями.

Если подразделение где изменяется IP-адрес сервера InterBase и/или сервера отчетов, является нижестоящим в иерархической структуре подразделений, то лицу ответственному за работоспособность системы (Администратору сети), необходимо сообщить новый IP-адрес вышестоящему подразделению, за которым он закреплен. В свою очередь Администратор вышестоящего подразделения должен ввести новый IP-адрес полученный от Администратора нижестоящего подразделения.

Для этого Администратору вышестоящего подразделения необходимо:

1. В "Центре Управления" в меню "Установки" главного окна программы, выбрать пункт "Настройка нижестоящих подразделений".

2. В открывшемся окне, выбрать требуемое подразделение, нажать кнопку "Изменить" и указать новое значение IP-адреса сервера InterBase и/или сервера отчетов в полях "IP-адрес сервера InterBase" и/или "IP-адрес сервера отчетов".

Обратите внимание, что для настроек "Редактирование информации о подразделении" и "Настройка нижестоящих подразделений" настоятельно рекомендуется использовать именно IP-адреса серверов, а не их имена (HostName), т.к. при отсутствии или выходе из строя DNS-сервера работа системы будет нарушена! Также необходимо помнить, что IP-адреса сервера должен быть адресом внешней сети, в противном случае вы будете недоступны для вышестоящих подразделений.

Q-8: Можно ли использовать несколько Серверов отчетов?

A:
Да, можно. Если нагрузка на машину, где установлен Сервер отчетов, велика или на нем одновременно выполняется большое количество отчетов, в том числе и объемных, можно использовать несколько Серверов отчетов запущенных на разных машинах. Для этого определите компьютеры, на которых будут запущены Сервера отчетов, и с помощью серверной части установочного пакета DocPoint II инсталлируйте на них программу. Далее разделите клиентские машины на группы, и пропишите для каждой свой Сервер отчетов. Для этого, на всех клиентских машинах одной группы, в строковом параметре реестра RepServHost ([HKEY_LOCAL_MACHINE\SOFTWARE\DocPointII\Reports\RepClient] "RepServHost"="ip-адрес") укажите IP-адрес соответствующего Сервера отчета. Для изменения реестра используйте стандартную утилиту проверки скриптов и настройки реестра c:\Client\CheckUtil.exe поставляемой в комплекте DocPoint II или запустить редактор реестра Windows - regedit.exe. Если в вашей сети работает WINS и/или DNS-сервер вы можете использовать в качестве строкового параметра RepServHost, имя компьютера на котором установлен Сервер отчетов вместо его IP-адреса. Также вы можете использовать разные Сервера отчетов для внутреннего и внешнего пользования. Если Сервера отчетов настоен для внешнего пользования (вышестоящих подразделений), необходимо учитывать тот факт, что назначенный ему IP-адрес должен быть адресом внешней сети или именем по которому его можно будет идентифицировать вышестоящим подразделениям.

Q-9: Почему при обработке декларации в рабочем каталоге должна находится только одна декларация?

A:
Базовое понятие "документ" в DocPoint определяет собой некий электронный документ, который может содержать один файл, например архив файлов декларации. И в этом архиве может лежать и не одна декларация, а несколько, но поскольку за понятие документ принята единица 1 декларация= 1 документ, это и определяет то, что декларация в рабочем каталоге будет одна. Т.е. при обработке одной декларации система производит ее выгрузку и запускает скрипт, в котором есть вызов АРМа позволяющего редактировать эту декларацию, затем система "забирает" эту декларацию к себе и хранит до тех пор, пока к ней не обратится другой пользователь.

Q-10: Как настроить работу с системой "Входной контроль" фирмы Softland и какие есть особенности настройки?

A:
Необходимо полностью развернуть дистрибутив ВК на клиентской машине, запустить arm_ti.exe и настроить программу для работы следующим образом. Все настройки справочников ведутся в обычном варианте. Настройка рабочего каталога ОТО происходит в каталог, куда посредством скрипта будет выкладываться набор DBF файлов декларации. Для работы ВК совместно с DocPoint необходимо наличие arm_ti.dll (поставляется в дистрибутиве ВК). Никаких дополнительный настроек, кроме вышеописанных не требуется. Дополнительную информацию по настройке скрипта, вы можете найти в руководстве администратора - Маршрутизатор.



Q-11: В чем особенность установки системы на ОС Windows 95?

A:
В ОС Windows 95 для работы с соединениями TCP/IP используется системная библиотека WinSock 1.1. Для обеспечения нормальной работоспособности системы, данный компонент системы необходимо обновить до версии WinSock 2. Скачать WinSock 2 можно из раздела Downloads.

Q-12: В чем особенность установки системы на ОС Windows 95, Windows 98, WindowsNT 4.0?

A:
Перед инсталляцией DocPoint II на компьютеры с ОС Windows95, Windows98 (кроме Windows98 SE) и WindowsNT 4.0, требуется установить Internet Explorer 5.0 или выше. Это необходимо для обновления системных компонентов Windows.
Скачать Internet Explorer можно по следующим адресам:
http://www.microsoft.com/downloads/search.asp?LangID=17&LangDIR=RU
или
http://www.microsoft.com/

Q-13: Какого размера инсталяционный пакет DocPoint и нужно ли при установке отдельно устанавливать какую-нибудь СУБД или другие приложения?

A:
Для установки DocPoint, кроме операционной системы ничего не нужно. Установочная программа выполнит всю установку полностью сама, в том числе установит сервер INTERBASE. И серверная и клиентская части инсталяционного пакета занимают в среднем по 14Мб каждая.


Q-14: Как АВТОМАТИЗИРОВАТЬ Backup и Restore для DocPoint?


А: Процесс создания архивной копии (Backup) базы данных и ее восстановления (Restore) может быть автоматизирован с помощью командных cmd-файлов. В таких файлах содержится стандартный набор команд интерпретатора команд WinNT и сервера InterBase. Также для закрытия приложений работающих с базой данных, в скриптах можно использовать утилиту closeapp или ключ /t для Сервера отчетов или Сервера сообщений (см. также Q-15: Какие приложения системы могут быть запущены или остановлены из командной строки?). Используя планировщик задач WinNT (вызывается командой AT из консоли), можно составить расписание, в какое время следует запускать cmd-файлы.

Создание архивной копии - файл backup.cmd
По ходу выполнения файла backup.cmd будет удалена резервная копия предыдущей архивной копии базы данных, создана резервная (docpoint2_1.gbk) копия текущей (docpoint2.gbk) архивной копии базы данных, затем БД будет остановлена (shutdown) , сделан ее Backup и удален мусор (sweep). Ход выполнения cmd-файла заносится в лог-файл (backup.log).

В качестве входных параметров должны быть указаны соответствующие вашему случаю значения:

ВХОДНЫЕ ПАРАМЕТРЫ

%1 - путь источника БД
- указывается полный путь к каталогу куда будет восстановлена архивная копия базы. Как правило это каталог где хранится рабочая база DocPoint, по умолчанию это с:\Client\Data.

%2 - путь назначения (куда класть резервную копию)
- указывается полный путь к каталогу куда будет сделана резервная копия архивной копии базы.

%3 - путь к Bin каталогу Interbase
- указывается полный путь к Bin каталогу, который находится в поддиректории InterBase. Если InterBase был установлен с помощью инсталяционного пакета DocPoint, то путь будет C:\client\IBServer\bin\.

%4 - пароль для sysdba - т.к. Restore может быть выполнен только администратором базы данных (sysdba), то необходимо указать его пароль.


Пример cmd-файла backup.cmd для создания архивной копии БД.

@ECHO OFF

rem ВХОДНЫЕ ПАРАМЕТРЫ
rem %1 - путь источника БД
rem %2 - путь назначения (куда класть резервную копию)
rem %3 - путь к Bin каталогу Interbase
rem %4 - пароль для sysdba

date /T >>%2\backup.log

rem Удаляем старую копию backup
echo y|del %2\docpoint2_1.gbk >>%2\backup.log
echo deleted 2nd copy >>%2\backup.log

rem Обязательно удаляем предыдущий лог
echo y|del %2\gbak.log

rem Копируем прошлый backup в резерв
copy %2\docpoint2.gbk %2\docpoint2_1.gbk >>%2\backup.log
echo coped 2nd file >>%2\backup.log

rem перед тем как делать Backup делаем shutdown для базы, чтоб никто не смел работать с ней
%3\gfix -shut -force 0 -user "sysdba" -password "%4" %1\docpoint2.gdb
echo database shutdown >>%2\backup.log

rem выполняем Backup
%3\gbak.exe -B -user "sysdba" -password %4 -v -y %2\gbak.log %1\docpoint2.gdb %2\docpoint2.gbk
echo maked main backup >>%2\backup.log

rem Собираем мусор в основной базе
%3\gfix.exe -sweep -user "sysdba" -password %4 %1\docpoint2.gdb
echo sweep comleted >>%2\backup.log

rem Восстанавливаем online у базы, доступ на подключения после всех операций
%3\gfix %1\docpoint2.gdb -user "sysdba" -password %4 -online
echo database online >>%2\backup.log

echo =================== End ==================== >>%2\backup.log


Скачать: backup.cmd [ ~ 700 byte ] от 11.03.2003.


Восстановление БД из архивной копии - файл restore.cmd
По ходу выполнения файла restore.cmd будет остановлен сервис InterBase, создана резервная (docpoint2.gdb) копия базы, запущен сервис InterBase и сделан Restore из имеющейся архивной (docpoint2.gbk) копии базы. Ход выполнения cmd-файла заносится в лог-файл (backup.log).

Примечание:
Резервная копия - это копия базы данных сделанная простым копированием файла базы docpoint2.gdb из одной директории в другую.
Архивная копия - это копия базы данных сделанная через Backup.

В качестве входных параметров должны быть указаны соответствующие вашему случаю значения:

ВХОДНЫЕ ПАРАМЕТРЫ

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

%2 - путь назначения (куда восстанавливать) - указывается полный путь к каталогу куда будет восстановлена архивная копия базы. Как правило это каталог где хранится рабочая база DocPoint, по умолчанию это с:\Client\Data.

%3 - путь к Bin каталогу Interbase - указывается полный путь к Bin каталогу, который находится в поддиректории InterBase. Если InterBase был установлен с помощью инсталяционного пакета DocPoint, то путь будет C:\client\IBServer\bin\.

%4 - пароль для sysdba - т.к. Restore может быть выполнен только администратором базы данных (sysdba), то необходимо указать его пароль.


Пример cmd-файла restore.cmd для восстановление БД из архивной копии.

@ECHO OFF

rem ВХОДНЫЕ ПАРАМЕТРЫ
rem %1 - путь к месту, где лежит резервная копия
rem %2 - путь назначения (куда восстанавливать)
rem %3 - путь к Bin каталогу Interbase
rem %4 - пароль для sysdba

rem Стартуем сервис Interbase (на случай, если не запущен)
%3\instsvc.exe start


date /T >>%1\backup.log
echo Restore! >>%1\backup.log

rem Обязательно удаляем предыдущий лог
echo y|del %1\gres.log

rem перед тем как ... делаем shutdown для базы, чтоб никто не смел работать с ней (в случае когда будет нужна резерваня копия, ее нужно сделать online)
%3\gfix -shut -force 0 -user "sysdba" -password "%4" %1\docpoint2.gdb
echo database shutdown >>%1\backup.log

rem Останавливаем сервис Interbase
%3\instsvc.exe stop

rem Копируем базу в резерв
copy /Y %2\docpoint2.gdb %1\docpoint2.gdb >>%1\backup.log
echo coped main file >>%1\backup.log

rem Стартуем сервис Interbase
%3\instsvc.exe start

rem выполняем Restore
%3\gbak.exe -r -user "sysdba" -password %4 -v -y %1\gres.log %1\docpoint2.gbk %2\docpoint2.gdb
echo maked main restore >>%1\backup.log

echo ==================== End==================== >>%1\backup.log

Скачать: restore.cmd [ ~ 700 byte ] от 11.03.2003.


Несмотря на то, что данные примеры cmd-файлов являются полностью рабочими, при архивации БД следует придерживаться следующих правил:

1. По мере выполнения Backup и Restore, проверять лог-файлы хода архивации базы - gbak.log и восстановления базы - gres.log, на наличие ошибок. Также проверять backup.log на предмет ошибок при выполнении cmd-файла. Если ошибки обнаружены, попытаться определить и устранить причину их возникновения.

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

3. Не делать Restore поверх рабочей базы, если у вас нет ее резервной копии.


Q-15: Какие приложения системы могут быть запущены или остановлены из командной строки.


A: Используя имя и пароль пользователя в качестве параметров исполняемого файла, такие приложения как, Автоматический клиент, Сервер отчетов, Сервер сообщений могут быть запущены или остановлены из командной строки.

Пример использования:
Запуск сервера отчетов.
C:\client\RepServ\RepServ.exe sysdba masterkey
где
sysdba - имя пользователя наделенного правами SYSDBA.
masterkey - пароль пользователя наделенного правами SYSDBA.

Запуск автоматического клиента.
C:\client C:\client\AutoClient.exe avtomat avtouser
где
avtimat - имя пользователя для работы с автоматом.
avtouser - пароль пользователя для работы с автоматом.

Закрытие сервера отчетов.
c:\client\RepServ\RepServ.exe /t

Закрытие автоматического клиента.
c:\client\AutoClient.exe /t

Закрытие сервера сообщений.
c:\client\ControlServer.exe /t

Область применения:
Автозапуск приложений при старте.
Можно создать ярлык и в его свойствах прописать требуемые параметры:

Объект: C:\client\RepServ\RepServ.exe sysdba masterkey

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

Использование в скриптах командных файлов.
Например, при автоматизации процесса архивации базы данных системы, помощью командных cmd-файлов. Для закрытия и запуска вышеописанных приложений могут быть использованы соответствующие ключи или утилиты.
(см. также Q-14: Как АВТОМАТИЗИРОВАТЬ Backup и Restore для DocPoint?)

Q-16: Какие версии Excel могут работать с поставляемыми отчетами?
Какие настройки Excel нужны для подготовки отчета на сервере?
Какие настройки нужны на клиентском рабочем месте?


А: 1. Microsoft Excel 97 Service Release 2; Microsoft Excel 2000; Microsoft Excel 2002 (XP).

2. На сервере необходимы следжующие настройки:
Для Excel 97 и Excel 2000 - Сервис|Макрос|Редактор Visual Basic, далее Tools|Options|General, снять флажок "Notify before state loss" и СОХРАНИТЬ открытый документ.
Для Excel XP - Сервис|Параметры|Безопасность|Безопасность Макросов|Надежные источники, установить флажок "Доверять доступ к Visual Basic Project"

3. Клиентская строна в специальных настройках не нуждается, т.к. просто получает подготовленный XLS файл.

В верх

ЗАО ИНМАР
Россия 236034
г. Калининград,
ул. Дзержинского 248
тел. 8-(0112)-46-42-95
www.inmar-term.com

Зам. ген. директора по связи и информации: Демидов Андрей inmar-term

Руководитель проекта: Сидоренко Андрей inmar-term

Ведущий программист: Путинцев Дмитрий inmar-term

Тех. поддержка: Киньшин Михаил inmar-term
тел. 8-(0112)-46-42-95

webmaster

Copyright © 2001-2005 INMAR. All Rights Reserved