Masowe skanowanie przy pomocy FS_Monit

Menu

1. Wprowadzenie
2. Instalacja programu FS_Monit
3. Przykład: Tworzenie różnych plików w eDokumentach

Wprowadzenie

Domyślnie system eDokumenty do skanowania wykorzystuje program BSCanServer, który jest instalowany na stanowisko pracownika obsługującego skanowanie. Jednakże istnieją sytuacje, w których narzędzie to może nie spełnić oczekiwań. Są to m.in.:

• w przypadku skanerów sieciowych, których program BScanServer nie jest w stanie wykryć,
• polityka firmy nie zezwala na "wiązanie stanowisk" ze skanowaniem ,
• liczba osób skanujących jest bardzo duża,
• oraz inne...

W takich przypadkach sugeruje się wykorzystanie programu FS_Monit. Jest to usługa, której działanie polega na nasłuchiwaniu zdefiniowanych w konfiguracji folderów w poszukiwaniu zmiany w strukturze plików, a następnie wykonaniu na tych plikach skryptu. Poniżej znajduje się opis konfiguracji tego narzędzia.

Przejdź do Menu

Konfiguracja usługi masowego skanowania

Konfigurację należy rozpocząć od pobrania i zainstalowania programu FS_Monit.exe :-). Instalacja jest bardzo prosta i wymaga przechodzenia pomiędzy ekranami przyciskiem Następny. Domyślnie program instaluje się w katalogu: Dla systemów 32-bitowych:

C:\Program Files\BetaSoft\FS_Monit

Natomiast dla 64-bitowych

C:\Program Files (x86)\BetaSoft\FS_Monit

1. W pliku wdnotify.ini (w katalogu aplikacji) ustawiamy jaki skrypt ma zostać wykonany po wykryciu zmiany w systemie plików we wskazanym katalogu np.:

[options]
# ms
pause_between_files=500

[path.1]
path="C:\SKANY\"
recursive=1
cmd=C:\Program Files\BetaSoft\FS_Monit\php\php.exe -c "C:\Program Files\BetaSoft\FS_Monit\php" -q "C:\Program Files\BetaSoft\FS_Monit\scripts\sc\doit.php" -f "%file"

Podana konfiguracja oznacza że folder SKANY na dysku C będzie obserwowany przez FS_Monit i po wykryciu nowego pliku uruchomi skrypt doit.php. (nieco niżej będzie więcej o samym skrypcie). UWAGA!!! Skrypt działa w momencie kiedy plik trafia do katalogu !!!

Następnie uruchamiamy usługę poprzez wykonanie pliku start.bat. UWAGA! Ścieżka C:\SKANY musi już istnieć!!

2. Następnie ustawiamy opcje w pliku konfiguracyjnym C:\Program Files\BetaSoft\FS_Monit\scripts\sc\config.inc - odpowiadają one za podstawowe dane dostarczane do wykonywanego później skryptu który przez protokół SOAP będzie wywoływał API systemu eDokumenty:

// Adres systemu
define('LOCATION',  'http://support.edokumenty.eu/vdemo/eDokumentyApi.php');
// Login i hasło oraz oznaczenie jednostki do API - umieszczone w config.inc na serwerze
define('EDOK_API_LOGIN', 'edokumenty_api_vdemo');
define('EDOK_API_PASSWORD', '100%apiedokumenty');
define('DEFAULT_ENTITY_SYMBOL', 'ps');

// przyklad: LOGOS_Jan Nowak_Paper_Router_20110222.pdf
define('NAME_REGEX', '/^(?<client>\d+)_(?<name>[^_]+)_(?<dctptp>[^_]+)_(?<type>[^_]+)_(?<adddat>\d{8})\.[a-zA-Z]+/');

// id jednostki organizacyjnej do której trafi utworzony dokument
define('TARGET_ORUNID', 1);

define('TARGET_USRNAM', '');

Użytkownik zdefiniowany w danej:

define('EDOK_API_LOGIN', 'edokumenty_api_user');

oraz hasło

define('EDOK_API_PASSWORD', '100%apiedokumenty');

Musi być analogicznie zdefiniowane w pliku config.inc systemu eDokumenty:

// Nazwa użytkownika wymaganego do zalogowania się do API
define('EDOK_API_LOGIN', 'edokumenty_api_user');

// Hasło dla użytkownika EDOK_API_LOGIN
define('EDOK_API_PASSWORD', '100%apiedokumenty');

// Dodatkowa stała która umożliwia pominięcie autentykacji (FALSE - nie sprawdza danych EDOK_API_LOGIN i EDOK_API_PASSWORD)
// domyślnie ustawiona na TRUE, można poprzez GET oraz WSS
define('EDOK_API_AUTH_MODE', TRUE);

3. Pozostaje jeszcze określić co będzie robił skrypt doit.php.

Załączony skrypt na przykład tworzy dokument w systemie używając danych z powyżej opisanej konfiguracji (TARGET_ORUNID).

Przejdź do Menu

Przykład: Tworzenie różnych plików w eDokumentach

Niniejszy przykład będzie opisywał automatyczne generowanie różnego rodzaju pism na podstawie różnych katalogów, do których trafiają skany. Dokładniej, to na serwerze na dysku D jest katalog Skany, a w nim udostępnione poprzez sieć dwa katalogi:

• Pisma
• Faktury

Czyli ścieżki wyglądają następująco:

D:\Skany\Pisma
D:\Skany\Faktury

Do każdego katalogu wpada odpowiedni dokument. Wobec tego konfigurację należy rozpocząć od odpowiedniego zdefiniowania pliku: wdnotify.ini. Przykładową taką konfigurację przedstawiono poniżej:

[options]

# ms
pause_between_files=500

# Pisma
[path.1]
path="D:\Skany\Pisma\"
recursive=0
cmd=C:\Program Files (x86)\BetaSoft\FS_Monit\php\php.exe -q -c "C:\Program Files (x86)\BetaSoft\FS_Monit\php" "C:\Program Files (x86)\BetaSoft\FS_Monit\scripts\paper\create_doc.php" -f "%file" -dctpid 1

#Faktury
[path.2]
path="D:\Skany\Pisma\"
recursive=0
cmd=C:\Program Files (x86)\BetaSoft\FS_Monit\php\php.exe -q -c "C:\Program Files (x86)\BetaSoft\FS_Monit\php" "C:\Program Files (x86)\BetaSoft\FS_Monit\scripts\paper\create_doc.php" -f "%file" -dctpid 2

Przejdź do Menu