System CDN Optima do wprowadzania dokumentów udostępnia API COM, oferujące metody pozwalające operować programiście bezpośrednio na obiektach Optimy. Ponieważ API dostarczone jest w takiej formie oprogramowanie korzystające z niego musi być zainstalowane a nastenie uruchamiane tam, gdzie dostene są biblioteki dll Optimy, zgodne z wersją oprogramowania działającego u klienta. Najlepszym takim miejscem jest serwer, na którym zaisntalowy jest system Optima. Na tym serwerze należy więc zainstalować usułgę PlusWorkflow-Optima, będącą pomostęm między systemami PlusWorkflow a Optimą. Usługa ta udostepnia WebService, nasłuchujący na ruch z serwera PlusWorkflow, przyjmuje dane z procesu (z zadania automatycznego) i loguje się do Optimy oraz przekazuje odebrane dane do rejestru VAT.

Instalacja usługi PlusWorkflow-Optima

W celu instalacji usługi należy pobrać najnowszą wersję programu wraz z pozostałymi plikami (w załączeniu):

PlusWorkfowOptimaService.exeICDNBase.dlllog4net.dllconfig.ini

oraz zapisać go na serwerze Optimy np w katalogu: c:\Suncode\ a następnie z poziomu command line systemu Windows znajdując sie w tym katalogu wykonać polecenie ( z uprawnieniami administracyjnymi):

c:\Windows\Microsoft.NET\Framework\v4.0.30319\InstallUtil.exe /DisplayName="PlusWorkfow-OPTIMA" /ServiceName="PlusWorkflowOptimaService" PlusWorkfowOptimaService.exe

Jeśli z jakiegokolwiek powodu chcemy odinstalować usługę należy wykonać polecenie:

c:\Windows\Microsoft.NET\Framework\v4.0.30319\InstallUtil.exe /u /DisplayName="PlusWorkfow-OPTIMA" /ServiceName="PlusWorkflowOptimaService" PlusWorkfowOptimaService.exe

Konfiguracja usługi PlusWorkflow-Optima

Usługa PlusWorkflow-Optima posiada możliwość konfiguracji pewnych elementów, zależnych od instalacji danego klienta. Poniżej przedstawiono schemat pliku konfiguracyjnego:

[zasoby]
serviceURI=http://<nazwa_serwera>:<port>/
licensedModules=<lista modułów do której istnieje licencja dla systemu Optima>
OptimaPath=<ścieżka do bibliotek dll programu Optima>

Opis parametrów:

• serviceURI - adres nasłuchiwania WebSerwisu, pod którym usługa oczekuje na komunikaty ze strony PlusWorkflow. Ważne jest by wskazany port był dostęny, i była komunikacja po tym porcie z poziomu serwera PlusWorkflow. W przypadku braku połączenia być może należy otworzyć ten port na firewall'u w systemie Windows
• licensedModules - lista modłułów systemu Optima, wymienionych po przecinku, do których użytkownik, na którgo logujemy się do systemu Optima, posiada licencję. Do poprawnego działania komunikacji zazwyczaj potrzebne są licencje (do potwierdzenia przez konsultanta systemu Optima ze strony klienta):
  
  • KP, KB
  • KB, FA
  • KBP, FA
• OptimaPath - ścieżka do bibliotek dll programu Optima, najczęściej jest to: C:\Program Files (x86)\Comarch ERP Optima\Interop\

Przykładowa konfiguracja:

[zasoby]
serviceURI=http://optimasql:8733/
licensedModules=FA,KB
OptimaPath=C:\Program Files (x86)\Comarch ERP Optima\Interop\

Uruchomienie usługi PlusWorkflow-Optima

Usługę PlusWorkflow-Optima uruchamia się jak każdą inną usługę w systemie Windows. W tym celu należy uruchomić command line (Win-R) oraz wpisac polecenie services.msc. Należy znaleźć usługę PlusWorkflow-Optima, wejść w ustawienia usługi, a nastęnie w zakładce Logowanie uzupełnić dane użytkownika windows, na którym zainicjowano (uruchomiono ręcznie klienta systemu Optima) oraz dla którego może być też wprowadzona licencja w systemie Optima:

Po uzupełnieniu powyższych danych należy przejść do zakłądki Ogólne, wybrać Tryb uruchomienia: Automatyczny, a nstępnie wybrać przycisk Uruchom. Od tej pory usługa nasłuchuje na ruch pochodzący z systemu PlusWorkflow.