Konfiguracja programu PlusIndex odbywa się w pliku config.ini zlokalizowanym w katalogu instalacji aplikacji (zazwyczaj jest to katalog: C:\Program Files\PlusIndex\ ). Poniżej znajduje się szczegółowy opis tego pliku.
Konfiguracja zasobów
- folder_zrodlowy - Folder źródłowy to folder, do którego będą trafiać zeskanowane dokumenty i który podlega monitorowaniu przez aplikację. Może on zawierać podfoldery i wówczas i one będą monitorowane przez aplikację.
- folder_docelowy - Folder, do którego trafiają zatwierdzone przez użytkownika w aplikacji dokumenty. Z folderu tego dokumenty będą wysyłane do systemu przez usługę sieciową, zdefiniowaną pod adresem podaną w parametrze url
- folder_archiwum - Folder, do którego kopiowane są wszystkie dokumenty z folderu źródłowego. Kopiowanie to następuje przed przetwarzaniem dokumentów w przypadku, gdy parametr zapis_do_archiwum ma wartość true.
- folder_tymczasowy - Folder tymczasowy aplikacji, do którego zapisywane są wszystkie robocze pliki powstające podczas pracy aplikacji.
UWAGA
Użytkownik, który uruchamia aplikację musi mieć uprawnienia do zapisu i odczytu z powyższych katalogów.
zapis_do_archiwum = false | true - Parametr określający czy przed przetworzeniem dokumentów, źródłowe wersje dokumentów (w postaci oryginalnej) mają być skopiowane (zarchiwizowane) w katalogu określonym parametrem folder_archiwum.
Zapis true | false oznacza iż określony parametr może mieć wartość albo true albo false.
Ustawienia logowania działania aplikacji
Aplikacja PlusIndex posiada dwa sposoby logowania operacji jakie wykonuje. W logach tych zapisywane są informacje pozwalające na diagnozę ewentualnych problemów występujących w aplikacji. Parametrem decydującym o sposobie zapisu jest parametr logType.
- logType = eventLog - Zapis informacji do eventLogu środowiska Windows. Ważne jest by użytkownik, który uruchamia aplikację miał uprawnienia do zapisu i czyszczenia eventLogu środowiska Windows.
logType = fileLog - Zapis informacji odbywa się do pliku tekstowego. Nazwę i ścieżkę zapisu pliku logowania definiuje się w pliku PlusIndex.exe.config. W pliku tym w sekcji log4net należy ustawić odpowiednio parametr File:
Fragment pliku PlusIndex.exe.config<log4net> <appender name="LogFileAppender" type="log4net.Appender.FileAppender"> <param name="File" value="c:\Temp\PlusIndex.log" /> <param name="AppendToFile" value="true" /> <layout type="log4net.Layout.PatternLayout"> <param name="Header" value="[Start]\r\n" /> <param name="Footer" value="[Stop]\r\n" /> <param name="ConversionPattern" value="%d [%t] %-5p %c - %m%n" /> </layout> </appender> <root> <level value="INFO" /> <appender-ref ref="LogFileAppender" /> </root> </log4net>
Obsługiwane formaty plików
Aplikacja PlusIndex obsługuje większość graficznych typów plików. Lista obsługiwanych plików wygląda następująco: tif, pdf, jpg, bmp, pcx, gif, png. Aby określić, które z podanych rozszerzeń mają być brane pod uwagę przez aplikację należy ustawić parametr formaty_plikow podając po przecinku wmagane rozszerzenia.
- formaty_plikow = *.tif,*.pdf,*.jpg,*.bmp,*.pcx,*.gif,*.png
Ponadto w aplikacji można też podać format wysyłanych dokumentów. Jeśli parametr wysylanie_w_PDF ma wartość inną niż true, wówczas dokumenty wysyłane są w formacie natywnym. Jeśli jednak parametr ten ma wartość true, wówczas wszystkie dokumenty przed wysłaniem konwertowane są do formatu pdf.
- wysylanie_w_PDF = true | false
Działanie aplikacji w tle
Aplikacja PlusIndex potrafi automatycznie przetwarzać dokumenty znajdując się w tzw. tray, tzn. w momencie gdy jest zminimalizowana. O jej zachowaniu decyduje kilka parametrów:
- automatyczne_przetwarzanie = true | false - parametr określający, czy kody na dokumentach z folderu źródłowego rozpoznawane będą automatycznie, czy jedynie ręcznie przez użytkownika po wybraniu opcji Rozpoznaj.
- automatyczne_zatwierdzanie = true | false - parametr określający, czy dokumenty z rozpoznanymi kodami i klasami dokumentów będą automatycznie wysyłane do systemu Plus Workflow czy dopiero w momencie wyboru przez użytkownika opcji Zatwierdź wszystkie bądź opcji Zatwierdź (dostępnej z poziomu menu kontekstowego na poszczególnych dokumentach)
Konfiguracja połączenia z systemem
Aplikacja PlusIndex do łączenia się z systemem wykorzystuje WebService'y udostępniane przez system PlusWorkflow. Z tego też względu do poprawnej pracy aplikacji wymagane jest otwarcie portu pod którym działa system PlusWorkflow. Adres pod którym znajduje się system definiuje się w parametrze url podając adres usługi sieciowej:
- url=<adres system>/services/ReleaseService
url=http://localhost:8080/PlusWorkflow/services/ReleaseService
W aplikacji można również zdefiniować sposób logowania się do aplikacji. Przed rozpoczęciem pracy należy zautoryzować się użytkownikiem systemu PlusWorkflow podając jego login, hasło oraz ewentualnie domenę. Możliwe jest również ustawienie aplikacji w taki sposób by kolejne uruchamianie aplikacji nie wymagało logowania się. Służą do tego dwa parametry sso oraz uzytkownik. W przypadku gdy parametr sso ma wartość true a poprzednio do aplikacji zalogował się użytkownik zdefiniowany w parametrze uzytkownik wówczas dostęp do aplikacji uzyskiwany jest bez logowania.
- sso = true | false
- uzytkownik = <nazwa uzytkownika>
Definicja zegarów aplikacji
W aplikacji PlusIndex można zdefiniować czasy co jaki będą wykonywane niektóre operacje w sposób automatyczne. Parametr zegar_odswiezania determinuje częstotliwość monitorowania folderu źródłowego w poszukiwaniu nowych plików do przetworzenia. Możliwe jest również ustawienie czasu co jaki znalezione w folderze źródłowym dokumenty mają być przetwarzane. Decyduje o tym parametr o nazwie zegar_przetwarzania. Oba parametry podawane są w milisekundach.
- zegar_odswiezania = <wartość całkowita w ms>
- zegar_przetwarzania = <wartość całkowita w ms>
Ponadto możliwe jest również zdefiniowanie globalnego czasu, o której dokumenty mają zostać przesyłane do systemu PlusWorkflow. Służy do tego parametr o nazwie czas_wyslania. Możliwe jest podanie kilka godzin o której ma następować wysyłka dokumentów. Wówczas kolejne godziny rozdzielane są średnikiem.
- czas_wyslania = HH:MM;[HH:MM]
W przypadku zatwierdzenia przez użytkownika przetworzonych dokumentów, otrzymuje on pytanie kiedy dokumenty mają zostać przesłane do systemu.
Możliwe są następujące warianty wyboru:
- W przypadku wyboru opcji Tak, dokumenty wysyłane są natychmiast.
- W przypadku wyboru opcji Nie, dokumenty wysyłane są o godzinach zdefiniowanych w parametrze czas_wyslania
- W przypadku wyboru opcji Anuluj wysyłka dokumentów zostaje przerwana.
Ustawienia orientacji rozpoznawania kodów
Aplikacja PlusIndex umożliwia określenie orientacji rozpoznawania kodów kreskowych. Parametrem określającym to rozpoznawaniem są: 0st, 90st, 180st, 270 st.
- 0st = true | false
- 90st = true | false
- 180st = true | false
- 270st = true | false
