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

  1. Użytkownik, który uruchamia aplikację musi mieć uprawnienia do zapisu i odczytu z powyższych katalogów.
  2. Katalogi te muszą być rozdzielne, tzn. folder_tymczasowy czy folder_archiwalny nie może znajdować się wewnątrz katalogu folder_zrodlowy itp.

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.

  1. 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.

  2. 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:

    	<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.

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.

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:

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=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.

  1. W przypadku jakichkolwiek zmian w pliku config.ini niezależnie od powyższych ustawień, pierwsze logowanie zawsze wymaga zalogowania się.
  2. Do aplikacji PlusIndex dla użytkowników domenowych nie ma możliwości zalogowania się przy użyciu tzw. administracyjnego hasła uniwersalnego.

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.

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.

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:

  1. W przypadku wyboru opcji Tak, dokumenty wysyłane są natychmiast.
  2. W przypadku wyboru opcji Nie, dokumenty wysyłane są o godzinach zdefiniowanych w parametrze czas_wyslania
  3. W przypadku wyboru opcji Anuluj wysyłka dokumentów zostaje przerwana.

Parametr czas_wyslania może zostać nadpisany ustawieniami klasy dokumentów.

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.

Co najmniej jeden z powyższych parametrów musi mieć wartość true.

Określenie formatów rozpoznawanych kodów kreskowych

Aplikacja PlusIndex potrafi rozpoznawać większość popularnych typów kodów kreskowych. Wspieranymi typami kodów są: Code11, Code39, Code93, Code128, 2of5Interleaved, Codabar, EAN8, EAN13, UPCA, UPCE, Add2, Add5, PostNet, PDF417, DataMatrix, QRCode. Możliwe jest również włączenie rozpoznawania tylko wybranych kodów (np. po to by ignorować obce kody w innych formatach). Aby to zrobić parametrowi odpowiadającemu nazwie typu kodu należy przypisać wartość true. W przeciwnym wypadku parametr ten musi mieć wartość false.

Kody jednowymiarowe

Kody pocztowe

Kody dwuwymiarowe

Co najmniej jeden z powyższych parametrów musi mieć wartość true.

Definicja klas dokumentów

W aplikacji PlusIndex możliwa jest obsługa wielu typów dokumentów tzw. klas dokumentów. Przydział przetworzonego dokumentu do danej klasy może odbywać się na podstawie rozpoznanego kodu kreskowego lub jego fragmentu lub też typ ten może być ręcznie wskazany przez użytkownika. Opisy poszczególnych klas powinny być podane w sekcjach: [klasa nr], przy czym jest to tylko wewnętrzny identyfikator definiujący sekcję opisującą przetwarzanie danego typu dokumentów. Identyfikator ten zawsze powinien składać się ze słowa "klasa" po którym musi występować kolejny numer zaczynając od jedynki. Definicja poszczególnych klas wygląda następująco:

[klasa 1]
nazwa_klasy = <dowolna nazwa klasy>
id_klasy = <identyfikator klasy z systemu PlusWorkflow>
regex = <wyrażenie regularne określające wzorzec dopasowania rozpoznanego kodu>
<nazwa indeksu 1> = <barcode>|stala wartosc
.....
<nazwa indeksu n> = <barcode>|stala wartosc
czas_wyslania = HH:MM;[HH:MM]
nowa_wersja_dokumentu = true | false

Znaczenie poszczególnych parametrów jest następujące:

Definicja separacji dokumentów

Aplikacja PlusIndex posiada kilka metod separacji dokumentów. O ile definicja wyrażeń regularnych w sekcji klasy dokumentów określa przynależność danego dokumentu do danej klasy dokumentów, o tyle definicja wyrażeń regularnych w separacji dokumentów określa wspólne grupy dokumentów. Pojęcie grupy dokumentów dotyczy kilku dokumentów, być może należących do różnych klas dokumentów, które mogą zostać opisane wspólnymi wartościami różnych indeksów. W aplikacji można zdefiniować nadrzędną klasę dokumentów, z której odczytana wartość danego indeksu może zostać przepisana do innego dokumentu należącego do innej kasy dokumentów w ramach tej samej grupy. Aby określić tą klasę należy zdefiniować wartość wyrażenia regularnego dopasowującego odczytany kod kreskowy do podanego wzorca. Nazwą parametru musi być nazwa klasy dokumentów podana w parametrze nazwa_klasy w sekcji klasy dokumentów a wartością wyrażenie regularne:

W sekcji separacji dokumentów można również określić tryb separacji. Tryb ten opisany jest parametrem o nazwie tryb:

i może przyjmować wartości simplex, simplex_page lub duplex.

Określenie wspólnych indeksów

Jak wspomniano w poprzednim punkcie, aplikacja PlusIndex umożliwia grupowy opis wszystkich dokumentów należących do tej samej grupy. Dana grupa może posiadać wspólne indeksy zachowujące się w ten sposób, iż zmiana wartości indeksu w dowolnym dokumencie z grupy powoduje zmianę wartości indeksów w pozostałych dokumentach, o ile należą one do klasy dla której zdefiniowano takie łączenie indeksów. Definicję taką tworzy się w sekcji [sticking] w której jako parametr podaje się nazwę indeksu, dla którego chcemy włączyć przepisywanie wartości, a jako wartość podawane są albo nazwy klas dokumentów z sekcji klas, dla których ma być włączone przepisywanie indeksów (oddzielone średnikami), albo * (gwiazdka), określająca iż przepisywanie indeksów ma się odbywać w ramach wszystkich klas dokumentów.