System operacyjny dla serwera IIS

Silnik aplikacji Comarch DMS czyli aplikacje webową można zainstalować na następujących systemach operacyjnych:

Komponenty systemu IIS

Comarch DMS korzysta z następujących komponentów systemowych:

Serwer SQL

Comarch DMS może działać w oparciu o następujące wersje i edycje Microsoft SQL Server:

Wymagane komponenty SQL

W przypadku instalacji ręcznej (z pominięciem instalatora), wymagane jest posiadania narzędzia sqlcmd.exe na stanowisku, na którym będzie uruchamiany plik install.bat. SQLCMD może być zainstalowane razem z Microsoft SQL Server Management Studio lub pobrane w ramach Microsoft® Command Line Utilities.

Zalecana konfiguracja sprzętowa serwera IIS

Wymagany sprzęt – zalecenia minimalne:

Zapewnienie możliwości rozbudowy:

Wymagane oprogramowanie serwera IIS

System operacyjny (jedna z poniższych możliwości):

Dodatkowe wymagania:

Wymagane licencje na oprogramowanie dla serwera IIS

Licencja na system operacyjny

Jeden z dostępnych rodzajów licencji:

Licencje klienckie (dostępowe) do serwera SQL

Liczba wymaganych licencji dostępowych powinna odpowiadać ilości użytkowników lub urządzeń posiadających dostęp do serwera IIS (logujących się do Comarch DMS). W związku z tym, w niektórych przypadkach bardziej korzystnym rozwiązaniem może okazać się zakup licencji „per Core”.

Wymagane licencje:

Ograniczenia i uwagi

Zalecana konfiguracja sprzętowa serwera SQL

Zalecaną konfiguracją współpracy Comarch DMS z serwerem MS SQL jest użycie serwera MS SQL przygotowanego dla ERP XL. W przypadku konfiguracji „Standalone” lub konfiguracji z wykorzystaniem dwóch serwerów MS SQL, zalecane wymagania sprzętowe zostały przedstawione poniżej.

Wymagany sprzęt – zalecenia minimalne:

Wymagane oprogramowanie SQL

System operacyjny:

Baza danych:

Licencje:

Obciążenie serwera uruchomioną aplikacją DMS w sesji terminalowej.

Obciążenie na jedną sesje terminalową z uruchomioną aplikacją Comarch DMS:

Konfiguracja sprzętowa dla stacji roboczej

Wymagany sprzęt – zalecenia minimalne:

Wymagane oprogramowanie dla stacji roboczej

System operacyjny:

.Net Framework:

Wydajność systemu Comarch DMS

Wydajność Comarch DMS zależy w znacznym stopniu od złożoności realizowanych procesów, tj. od liczby kontrolek zdefiniowanych na karcie obiegu, wykorzystania mechanizmów inicjowania wartości kontrolek skryptami SQL i C# oraz od liczby kolumn zdefiniowanych na liście dokumentów.

Od wersji 2019.3 w Comarch DMS wprowadzono weryfikację zgodności wersji komponentów systemu. Podczas uruchamiania aplikacji desktop i web następuje weryfikacja zgodności numeru wersji:

1. Aplikacji web,
2. Aplikacji desktop,
3. Pliku web.config,
4. Pliku DMS.exe.config (lub pliku ObiegDokumentow.exe.config dla wersji wcześniejszych niż 2020.2.1),
5. Skryptów SQL,
6. Skryptów SQL XL,
7. Skryptów SQL Optima,
8. Skryptów SQL Altum.

W sytuacji, gdy weryfikacja wersji wykaże niezgodność, zamiast okna logowania do aplikacji zostanie wyświetlony komunikat.

Dla aplikacji stacjonarnej uruchomionej poprzez połączenie terminalowe udostępniono kanały wirtualne umożliwiające załączanie plików oraz skanów dokumentów ze skanera podpiętego do lokalnego komputera, na którym pracuje użytkownik.

W celu korzystania z kanałów wirtualnych niezbędne jest zainstalowanie na komputerze lokalnym, z którego uruchamiane jest połączenie terminalowe, paczki sterowników – OnlineFp.exe – Comarch ERP Sterowniki i usługi terminalowe. Plik OnlineFp.exe dostępny jest w katalogu Sterowniki umieszczonym w katalogu instalacyjnym Comarch DMS.

W pliku DMS.exe.config udostępniono dwa klucze, z domyślnie ustawioną wartością „false”, oznaczającą, że kanały wirtualne są wyłączone, w celu włączenia należy zmienić wartość na „true”.
Dla wersji Comarch DMS wcześniejszych niż 2020.2.1 klucze znajdują się w pliku ObiegDokumentow.exe.config.

Klucze odpowiadające za włączenie kanałów wirtualnych w pliku DMS.exe.config

Klucz VirtualChannelToLocalMachineFiles odpowiada za możliwość załączania plików z lokalnego komputera do aplikacji Comarch DMS uruchomionej na wirtualnej maszynie.

Gdy kanał wirtualny VirtualChannelToLocalMachineFiles jest włączony, nie ma możliwości dodawania załączników z katalogów umieszczonych na maszynie wirtualnej, wywoływane są wyłącznie okna z komputera lokalnego, na którym uruchomiono połączenie terminalowe.

Możliwe jest załączanie plików zarówno z lokalnego komputera jak i maszyny wirtualnej, o ile w opcjach podłączania pulpitu zdalnego udostępniono dyski komputera lokalnego. W takiej konfiguracji należy wartość klucza VirtualChannelToLocalMachineFiles ustawić na „false”.

Klucz VirtualChannelToLocalMachineScanner odpowiada za możliwość załączenia w aplikacji Comarch DMS uruchomionej na wirtualnej maszynie skanu dokumentu bezpośrednio ze skanera podłączonego do lokalnego komputera użytkownika.

Po wybraniu w kontrolce typu Załącznik opcji „Skan”, zostaje wyświetlone okno:

Funkcjonalność zrealizowana za pomocą sterowników OnlineFp pozwala na skanowanie jedno i wielostronicowe. Skanowanie jednostronicowe pozwala zapisać obrazy w formatach: jpg, tif, pdf, png. Skanowanie wielostronicowe pozwala zapisać pliki wyłącznie z rozszerzeniem tif.

Wybranie przycisku „Skan” uruchamia skanowanie na skanerze podpiętym do lokalnego komputera.

Z pobranego pliku instalacyjnego, do instalacji Comarch DMS we współpracy z Comarch ERP Altum należy wykorzystać:

1. Katalog do instalacji ręcznej – Comarch DMS {wersja}

lub

1. Katalog z instalatorem do współpracy z Comarch ERP Altum – Comarch DMS {wersja} Altum instalator aplikacji web
2. Katalog z instalatorem aplikacji desktop do współpracy z Comarch ERP Altum – Comarch DMS {wersja}  instalator aplikacji desktop

Podstawowym elementem systemu Comarch DMS jest aplikacja webowa. Dlatego w pierwszej kolejności należy zainstalować aplikację webową następnie skonfigurować aplikację stacjonarną.

Zalecamy przeprowadzenie instalacji aplikacji webowej, przy użyciu instalatora znajdującego się w katalogu Comarch DMS {wersja} Altum instalator aplikacji web oraz instalacji aplikacji desktop, przy użyciu instalatora znajdującego się w katalogu Comarch DMS {wersja} instalator aplikacji desktop. Istnieje również możliwość instalacji ręcznej.

W pobranym pliku instalacyjnym należy wejść do katalogu Comarch DMS {wersja}, następnie zawartość katalogu DMS Desktop przekopiować do nowo utworzonego folderu na lokalnym dysku. Np. do C:\inetpub\wwwroot\DMS

Następnie należy otworzyć do edycji plik DMS.exe.config i w kluczu ServerUri wprowadzić adres URL którym uruchamiana jest aplikacja webowa.

Np. <add key=”ServerUri” value=”http://localhost/DMS” />

Po zapisaniu pliku DMS.exe.config należy sprawdzić działanie aplikacji uruchamiając plik DMS.exe

Dla wersji Comarch DMS wcześniejszych niż 2020.2.1 istnieje konieczność wykonywania powyższych kroków na pliku ObiegDokumentow.exe.config, aplikacja uruchamiana jest plikiem ObiegDokumentow.exe.

Plik konfiguracyjny DMS.exe.config, adres URL którym uruchamiana jest aplikacja web

Weryfikacja poprawności konfiguracji aplikacji stacjonarnej (desktop)

W utworzonym katalogu (np. C:\inetpub\wwwrooot\DMS) należy odszukać i uruchomić plik DMS.exe. Zostanie otwarte okno logowania do aplikacji stacjonarnej, w którym należy się zalogować na operatora administrator (bez hasła).

Okno logowania do aplikacji stacjonarnej w trybie jednofirmowym

Okno logowania do aplikacji stacjonarnej w trybie wielofirmowym

Instalację aplikacji webowej należy przeprowadzić na serwerze (komputerze) z zainstalowanym serwisem IIS (Internet Information Services).

W katalogu Comarch DMS {wersja} Altum wersja instalacyjna należy odszukać i uruchomić Install.exe

Zostanie uruchomiony instalator aplikacji webowej, dzięki któremu możliwe jest:

Po uruchomieniu instalatora wyświetlane jest okno:

Po wybraniu opcji „Zainstaluj” wyświetlone będzie okno z warunkami korzystania z oprogramowania Comarch DMS.

Przejście do kolejnego kroku instalacji wymaga akceptacji warunków korzystania z oprogramowania Comarch DMS.

Konfiguracja IIS

W pierwszym etapie instalacji następuje konfiguracja Internetowych Usług Informacyjnych. Instalator weryfikuje, czy wszystkie niezbędne komponenty IIS są zainstalowane.
Brakujące elementy zostaną wyszczególnione na liście, a ich instalacja zostanie zainicjowana po naciśnięciu uaktywnionego przycisku: .

Gdy składniki IIS zostaną zainstalowane w celu przejścia do kolejnego etapu instalacji, należy nacisnąć przycisk: .

Pula Aplikacji

Kolejnym krokiem jest konfiguracja puli aplikacji. Utworzenie nowej puli aplikacji odbywa się poprzez wpisanie jej nazwy i kliknięcie w przycisk . Po dodaniu nowa pula aplikacji zostanie wyświetlona na liście aplikacji.

Po zaznaczeniu wybranej puli i wyświetleniu się informacji należy przejść do kolejnego kroku za pomocą przycisku .

Aplikacja

Następny etap instalacji to kreowanie aplikacji w witrynie IIS. Aplikacja może być utworzona w już istniejącej lub nowej witrynie:

Jako aplikacja w wybranej witrynie – aplikacja w wybranej witrynie jest domyślnie zaznaczona. W takiej sytuacji nie jest potrzebne podawanie hosta do witryny ani numeru portu (czyli adresu, pod jakim uruchamiamy aplikację). Aplikacja będzie działała na hoście witryny, do której zostanie podpięta. Dla aplikacji należy:

Jako domyślna aplikacja w nowej witrynie – aplikacja będzie działała w nowej witrynie, dla której należy podać:

Po wykonaniu opisanych wyżej czynności, należy nacisnąć przycisk: , a następnie nacisnąć przycisk: . Domyślnie aplikacja DMS zostaje utworzona w lokalizacji: c:\inetpub\wwwroot w katalogu z nazwą witryny.

Opcje instalacji

Wybór opcji instalacji Comarch DMS

Niezależna baza danych Comarch DMS – jeżeli opcja pozostanie niezaznaczona, wówczas skrypty tworzące tabele dla Comarch DMS zostaną uruchomione bazie firmowej ERP Altum.  Jeżeli opcja zostanie zaznaczona, w kolejnym kroku utworzona zostanie oddzielna baza Comarch DMS, w ramach której będzie odbywała się praca. Na tej bazie zostaną uruchomione skrypty i założą się tabele obiegowe.

Prezentuj zmianę języka na ekranie logowania – zaznaczenie powoduje, że na ekranie logowania do aplikacji użytkownik będzie mógł wybrać język, w którym będzie pracował w aplikacji.

Przestrzegaj polityki bezpieczeństwa haseł – wymusza stosowanie polityki mocnych haseł przez operatorów Comarch DMS (min 8 znaków, wielka litera, znak specjalny)

Wersja Premium – umożliwia modelowanie procesów w systemie za pomocą kodu C#.

Aby przejść do wskazania szczegółów, należy nacisnąć przycisk: .

W kolejnym kroku należy połączyć się z serwerem SQL, podając login i hasło lub wybierając logowanie zintegrowane.

Następnie za pomocą przycisku instalator połączy się z serwerem SQL. Na rozwijanej liście baz danych wyświetlone zostaną wszystkie bazy dostępne na wskazanym serwerze, należy wskazać bazę firmową Comarch ERP Altum, dla której konfigurowana jest współpraca z Comarch DMS.

Po wskazaniu bazy wymagane jest ustawienie hasła dla operatora ODUser, który dodawany jest do serwera SQL z hasłem określonym w niniejszym kroku instalacji. Po wybraniu przycisku należy wpisać hasło dla użytkownika ODUser.

Hasło zostanie również wpisane do wszystkich „connection string” znajdujących się pliku web.config aplikacji WWW. Jeżeli definiujemy połączenia bazodanowe w trybie wielospółkowym, należy pamiętać, aby nowe hasło podać we wszystkich połączeniach definicji spółek.

W przypadku aktualizacji Comarch DMS instalator wymusza ustawienie hasła operatora ODUser. Hasło może zostać zmienione (zalecane), ale można również wprowadzić aktualne hasło. Przy zmienionym haśle i włączonym trybie wielospółkowym należy nowe hasło ustawić we wszystkich konfiguracjach wielospółkowych połączeń do baz danych. W przypadku instalacji kilku aplikacji Comarch DMS, korzystających z jednego MS SQL Server, przy zmianie hasła podczas instalacji należy pamiętać, aby zmienione hasło dla ODUser zmienić w plikach web.config oraz w konfiguracji spółek, jeżeli aplikacje pracują w trybie wielospółkowym.

Wprowadzone hasło należy zapisać i za pomocą przycisku należy uruchomić skrypty, które przygotują bazę Comarch ERP Altum do współpracy z Comarch DMS.

Gdy skrypty SQL zostaną wykonane pomyślnie, można przejść do kolejnego etapu za pomocą przycisku .

W przypadku gdy w opcjach instalacji wskazano, że Comarch DMS zostanie zainstalowany na osobnej bazie SQL, kolejnym krokiem instalacji jest utworzenie tej bazy. Analogicznie do poprzedniego etapu należy wskazać typ logowania do serwera SQL, w przypadku logowania SQL wpisać nazwę użytkownika SQL i hasło oraz za pomocą przycisku połączyć się z serwerem SQL.

Następnie należy wskazać istniejącą bazę Comarch DMS lub za pomocą przycisku utworzyć nową bazę Comarch DMS.

Po wskazaniu/dodaniu bazy danych należy użyć przycisku aby przygotować bazę danych do pracy.

Gdy skrypty zostały wykonane pomyślnie, należy przejść do kolejnego etapu używając przycisku

W kolejnym etapie należy wprowadzić nazwę serwera klucza licencji dla Comarch DMS. Po jego uzupełnieniu należy nacisnąć przycisk .

Po prawidłowym wykonaniu czynności opisanych powyżej, pojawi się ekran informujący o pomyślnym zakończeniu instalacji. Należy nacisnąć przycisk: , co spowoduje zamknięcie okna instalatora.

Konfiguracja Menedżera Internetowych Usług Informatycznych (IIS)

Do instalacji aplikacji Comarch DMS wymagane jest posiadanie dodatku Microsoft.Net Framework w wersji 4.7.2 lub wyższej (zalecana 4.8) oraz zainstalowanie serwera IIS. Po zainstalowaniu serwera IIS, należy włączyć następujące komponenty:

W pobranym pliku instalacyjnym należy wejść do katalogu Comarch DMS {wersja} i przekopiować zawartość katalogu DMS Web do nowo utworzonego folderu na dysku C:\inetpub\wwwroot\DMS.

Nazwa folderu będzie zarazem nazwą aplikacji webowej uruchamianą poprzez przeglądarkę, w tym przypadku jest to również DMS.

Po uruchomieniu Menedżera Internetowych Usług Informatycznych należy podświetlić nazwę serwera i przejść do opcji „Ograniczenia ISAPI i CGI”.

Dla wpisów z Framework ASP.NetV4.0.* należy wybrać z menu kontekstowego opcję „Zezwalaj”.

W kolejnym kroku należy dodać/wybrać pulę aplikacji, na której będzie uruchamiana aplikacja Comarch DMS. Nową pulę aplikacji dodajemy klikając prawym przyciskiem myszy na kategorię „Pule aplikacji”.

Pojawi się okno dodawania puli aplikacji. Należy wpisać w nim nazwę „DMS” i wybrać wersję Net Framework v4.0 lub wyższą, a następnie ustawić „Zarządzany tryb potokowy” na Zintegrowany i zaznaczyć opcję „Uruchom pulę aplikacji natychmiast”.

Dla wybranej puli należy skonfigurować ustawienia zaawansowane.

Pojawi się okno, w którym należy ustawić opcję „Włącz aplikacje 32-bitowe” jako False, natomiast jako „Tożsamość” należy wybrać opcję „ApplicationPoolIdentity”, a następnie sprawdzić czy pozostałe parametry zostały ustawione jak poniżej:

Następnie należy skonwertować katalog DMS na aplikację i przypisać do niej utworzoną pulę.

Przygotowanie baz danych

W kolejnym kroku instalacji należy przygotować bazę danych dla aplikacji Comarch DMS oraz bazy dla Comarch ERP Altum.

Aplikacja może pracować na odrębnych bazach danych (baza Comarch DMS, baza konfiguracyjna Comarch ERP Altum i baza firmowa Comarch ERP Altum) lub bez bazy Comarch DMS. Skrypty dla Comarch DMS można uruchomić na bazie firmowej Comarch ERP Altum.

Aby utworzyć nową bazę danych Comarch DMS, należy uruchomić program Microsoft SQL Server Management Studio i za pomocą opcji „New Database” wykreować nową bazę.

Zostanie wyświetlone okno, w którym należy podać nazwę bazy danych.

Konfiguracja pliku web.config

W pliku konfiguracyjnym Web.config znajdującym się w katalogu C:\inetpub\wwwroot\{nazwa aplikacji} należy wprowadzić następujące informacje:

• Definicje connection stringów używane w obu trybach:
  • W kluczu „strConnectDMS” należy wprowadzić connection string do bazy danych Comarch DMS.
• Definicje connection stringów używane w trybie jednofirmowym:
  • W kluczu „strConnectERPComp” należy wprowadzić connection string do bazy Comarch ERP XL lub bazy firmowej Comarch ERP Optima / Comarch ERP Altum. Klucz jest wymagany do poprawnego działania integracji. Wprowadzenie klucza nie jest wymagane, jeżeli Comarch DMS pracuje w trybie wielospółkowym.
  • W kluczu „strConnectERPConf1” należy wprowadzić connection string do bazy konfiguracyjnej Comarch ERP Optima lub Comarch ERP Altum. Klucz ten jest wymagany po poprawnego działania integracji Comarch DMS z Comarch ERP Optima lub Comarch ERP Altum. Klucz jest również wymagany w trybie chmurowym Comarch ERP Optima. Wprowadzenie klucza nie jest konieczne w przypadku pracy Comarch DMS w trybie wielofirmowym.
• Definicje connection stringów używane w trybie wielofirmowym 
  • Klucze „strConnectERPConf2”, „strConnectERPConf3” itd. mogą być używane w trybie chmurowym Comarch ERP Optima. Poprzez wprowadzenie connection stringów możliwe jest dodanie kilku baz konfiguracyjnych, które dostępne będą w Comarch DMS w oknie definiowanie połączeń spółki z bazą ERP.
• Ustawienia kluczy używane w obu trybach
  • <add key=”WorkMode” value=”XL” /> – określenie współpracy Comarch DMS z systemami ERP,
    • dla Comarch ERP Optima – wartość = „Optima”,
    • dla Comarch ERP XL – wartość = „XL”,
    • dla Comarch ERP Altum – wartość = „Altum”,
    • bez współpracy z systemem EPR – wartość = „Standalone”.
  • <add key=”MultiCompany” value=”false” /> – ustawienie trybu pracy jednofirmowy (false) i wielofirmowy (true).
  • <add key=”MaximumNumberOfControlCardColumns” value=”10″ /> – definicja maksymalnej liczby kolumn karty obiegu, która będzie dostępna w konfiguracji typu obiegu.
  • <add key=”PremiumFunctionality” value=”true” /> – klucz odpowiada za dostęp do funkcjonalności modelowania procesów w Comarch DMS za pomocą kodu w języku C#. Wartość „true” – funkcjonalność dostępna, wartość „false” – funkcjonalność niedostępna.
  • <add key=”LicenceKeyServerDMS” value=”nazwa serwera klucza OD” /> – należy wpisać nazwę serwera licencji dla aplikacji Comarch DMS.
  • <add key=”ShowChangeLanguage” value=”true” /> – wartość „true” włącza możliwość wyboru języka pracy aplikacji Comarch DMS w oknie logowania. Wartość „false” wyłącza tą możliwość.
  • <add key=”UseStrongPassword” value=”false” /> – wartość „true” wymusza stosowanie polityki mocnych haseł przez operatorów Comarch DMS (min 8 znaków, wielka litera, znak specjalny).
  • <add key=”ExternalRegistrationEnabled” value=”false” /> – wartość „true” klucza umożliwia rejestrowanie użytkowników z poziomu aplikacji web i aktywuje funkcje wpisywane do tabeli do.DF_ConfOSEmployeesQueue – tabeli z danymi rejestracji użytkowników. Okno rejestracji można wyświetlić do dodaniu do adresu aplikacji członu „/ExternalRegistration”, np. http://localhost/DMS/ExternalRegistration. Wartość klucza = „false” oznacza, że rejestracja użytkowników w aplikacji web jest niemożliwa.
    • <add key=”TaxPayerIdRequired” value=”false” /> – klucz określa, czy użytkownik będzie musiał podać NIP podczas rejestracji. Wartość „true” oznacza konieczność podania NIP, wartość „false” oznacza brak konieczności.
    • <add key=”PersonalDataProcessingConsentRequired” value=”false” /> – klucz określa, czy w oknie rejestracji będzie wyświetlany parametr „Akceptuję regulamin oraz zapoznałem się z informacją o przetwarzaniu danych osobowych”. Wartość „true” spowoduje, że parametr będzie wyświetlany, a jego zaznaczenie będzie wymagane do rejestracji konta. Tekst regulaminu i informacji o przetwarzaniu danych osobowych należy wprowadzić odpowiednio do plików Rules_pl.txt i gdpr_pl.txt znajdujących się w folderze TextResources. Wartość „false” powoduje, że parametr nie jest wyświetlany i jego zaznaczenie nie jest wymagane do rejestracji.
    • <add key=”WorkingConditionsAcceptanceRequired” value=”false” /> – klucz określa, czy w oknie rejestracji będzie wyświetlany parametr „Akceptuję warunki pracy”. Wartość „true” powoduje, że parametr będzie wyświetlany, a jego zaznaczenie będzie wymagane do rejestracji konta. Treść informacji o warunkach pracy należy wprowadzić do pliku workingConditions_pl.txt w folderze TextResources. Wartość „false” powoduje, że parametr nie jest wyświetlany i jego zaznaczenie nie jest wymagane do rejestracji.

Uwaga

Do właściwego działania rejestracji użytkownika z poziomu aplikacji web konieczne jest poprawne wypełnienie przez administratora pól sekcji Ustawienia konta pocztowego w ramach zakładki Ustawienia w aplikacji desktopowej

• • <add key=”DocumentListDateRange” value=”150″ /> – możliwość zdefiniowania filtra zawężającego wyszukiwanie dokumentów, dla których przekazanie do kolejnego etapu odbyło się określoną ilość dni temu. Wartość klucza odpowiada liczbie dni. Niezależnie od ustawienia, operator może usunąć lub zmienić zdefiniowany filtr. Ustawienie wartość = 0 wyłącza domyślny filtr.
  • <add key=”AskAboutDocumentSave” value=”True” /> – parametr odpowiedzialny za wyświetlanie komunikatów z pytaniem „Czy zapisać zmiany?” na szczegółach dokumentów Comarch DMS. W przypadku ustawienia value=”True”, komunikaty będą wyświetlane w aplikacji, w przypadku value=”False” komunikaty nie będą wyświetlane w aplikacji.

Uwaga

Gdy wartość klucza „AskAboutDocumentSave” zostanie ustawiona na „False”, w ustawieniach typu obiegu nie będzie możliwe włączenie funkcjonalności automatycznego zapisu po zainicjowaniu dokumentu.

• • <add key=”CombinationCompanies” value=”false”/> – klucz odpowiada za możliwość ustawienia różnych spółek dla kontrolek na definicji obiegu. Wyłączona możliwość ustawienia różnych spółek dla wszystkich kontrolek: value = „false”, włączona: value = „true”.
  • <add key=”CompanyNameSearchModeEnabled” value=”false” /> – klucz działa w trybie wielospółkowym, wartość „true” powoduje możliwość zawężania listy wyświetlanych spółek po wpisaniu frazy w okno wyszukiwania. Jeżeli wartość = „false”, spółkę należy znaleźć i wybrać z rozwijanej listy.
  • <add key=”DocumentCounterMinutesInterval” value=”1″/> – parametr odpowiedzialny za wyświetlanie liczby dokumentów utworzonych w ramach danego typu obiegu, liczba dokumentów prezentowana jest w nawiasie obok każdego typu obiegu na drzewie typów obiegów. Domyślnie funkcjonalność jest włączona z wartością 1, czyli odświeżenie danych o liczbie dokumentów w ramach danego typu/grupy typów obiegu odbywa się co 1 minutę. Klucz może przyjmować wartości:
    • „-1” – wartość oznaczająca, że funkcjonalność jest wyłączona, na drzewie typów obiegów nie są prezentowane wartości z liczbą dokumentów.
    • „0” – wartość oznaczająca, że funkcjonalność jest włączona i sumowanie liczby dokumentów odbywa się przy każdym wejściu na listę dokumentów
    • „<liczba całkowita>” – wartość oznaczająca, że funkcjonalność jest włączona, wpisana liczba określa wyrażony w minutach czas, po którym nastąpi automatyczne odświeżenie danych.
  • <!– <add key=”XLAPIOpeHaslo” value=”haslo” / />–> – musi pozostać zakomentowane. Parametr aktywny jeżeli ustawiono <add key=”WorkMode” value=”XL” />. Umożliwia pracę na wspólnym haśle podczas generowania dokumentów.

Uwaga

Odkomentowanie klucza o nazwie”XLAPIOpeHaslo” spowoduje zamianę wszystkich haseł operatorów Comarch ERP XL na hasło ustawione w kluczu.

• Ustawienia kluczy używane w trybie jednofirmowym
  • <add key=”CompanyName” value=”<nazwa firmy>” /> – można zdefiniować nazwę firmy, która zostanie wyświetlona w aplikacji przed loginem zalogowanego operatora.
  • <add key=”LicenceKeyServerERP” value=”<nazwa serwera klucza ERP>” /> – należy wpisać nazwę serwera licencji dla Comarch ERP XL / Comarch ERP Optima / Comarch ERP Altum.
  • <add key=”EnableAnaliticDescription” value=”false” /> – parametr aktywny jeżeli ustawiono <add key=”WorkMode” value=”XL” />. Umożliwia dekretację kosztów i generowanie dokumentów.
  • <add key=”DestinationAttachmentsWorkflow” value=”DO” /> – parametr umożliwia wybór bazy, w której przechowywane będą załączniki dodane do dokumentów:
    • baza DMS – value = „DO”,
    • baza ERP XL – value = „XL”,
    • usługa IBARD – value = „IBARD”.
  • <add key=”DestinationAttachmentsRepository” value=”DO” /> – parametr umożliwia wybór bazy, w której przechowywane będą pliki dodane do Managera dokumentów lub usługi Comarch DMS Repozytorium:
    • baza DMS – value = „DO”,
    • usługa IBARD – value = „IBARD”.
  • <add key=”DMUsersIdAllowedToReorderDirectiories” value=”” /> – wartość klucza określa, którzy operatorzy są uprawnieni do zarządzania układem katalogów na drzewie w Managerze dokumentów. Domyślnie wartość klucza jest pusta, oznacza to, że wszyscy operatorzy mogą zarządzać kolejnością katalogów na drzewie. Jeżeli w kluczu zostaną wskazane identyfikatory operatorów DMS (DCD_ID), będzie to oznaczać, że jedynie wskazani operatorzy posiadają uprawnienie do reorganizacji struktury katalogów. Identyfikatory operatorów powinny być rozdzielane przecinkiem.
  • <add key=”AnalitycalDescriptionWorkMode” value=”1″ /> – parametr określa tryb pobierania wymiarów opisu analitycznego. Klucz przyjmuje następujące wartości:
    • 1 – bezpośrednie pobieranie wymiarów z bazy Comarch ERP XL,
    • 2 – tryb z buforowaniem i doczytywaniem wymiarów do nowej daty utworzenia dokumentów (tryb, w którym dotychczas były pobierane wymiary opisu analitycznego),
    • 3 – tryb z buforowaniem, ale bez doczytywania wymiarów (warunek: w Comarch ERP XL wymiary nie posiadają zakresów czasowych).
  • <add key=”CdnApiVersion” value=”20201″ /> – nr wersji systemu ERP XL, z którym współpracuje Comarch DMS.
  • <add key=”UrlERP” value=”UrlERP” /> – klucz należy uzupełnić przy konfigurowaniu współpracy Comarch DMS z Comarch ERP Enterprise (CEE). Należy wprowadzić adres URL do systemu CEE. np. „https://nazwa_aplikacji.cisag.com”. Nie ma konieczności uzupełniania klucza w przypadku pracy w trybie wielospółkowym.
  • <add key=”CertificateNameERP” value=”CertificateNameERP” /> – należy uzupełnić klucz certyfikatu dla CEE. Nie ma konieczności uzupełniania klucza w przypadku pracy w trybie wielospółkowym.
  • <add key=”RestServiceERP” value=”RestServiceERP” /> –  w kluczu należy umieścić adres serwisu rest systemu Comarch ERP Enterprise.
  • <add key=”DatabaseERP” value=”DatabaseERP” /> – należy wprowadzić nazwę bazy CEE. Nie ma konieczności uzupełniania klucza w przypadku pracy w trybie wielospółkowym.
  • <add key=”OrganizationERPId” value=”OrganizationERP” /> – należy wprowadzić unikalny identyfikator (w formie GUID) domyślnej organizacji w CEE. Nie ma konieczności uzupełniania klucza w przypadku pracy w trybie wielospółkowym.
  • <add key=”OrganizationERPName” value=”DefaultOrganizationIdentifier” /> – należy wprowadzić nazwę organizacji nadaną w systemie Comarch ERP Enterprise.
  • <add key=”OCRComarchUri” value=”https://ocr.erp.comarch.pl/v1.0/api/” /> – adres serwera usługi Comarch OCR, na który wysyłane są pliki do rozpoznania w Comarch OCR.
  • <add key=”OCRComarchTimeout” value=”15″ /> – wartość to wyrażony w minutach czas, po którym przetwarzanie pliku zostanie przerwane i wyświetlony zostanie błąd (!), a program przejdzie do przetwarzania następnego dokumentu w kolejce.
  • <add key=”Version” value=”5048495746514648″ /> – parametr określający numer wersji Comarch DMS.
  • <add key=”UseRepository” value=”false” /> – parametr określający, czy do przechowywania dokumentów będzie używany moduł Manager dokumentów (wartość „false”), czy funkcjonalność Comarch DMS Repozytorium (wartość „true”).
  • <add key=”RepositoryUrl” value=”” /> – w przypadku korzystania z funkcjonalności Comarch DMS Repozytorium, należy wprowadzić adres URL aplikacji DocumentManager.WebApi,
    np. http://localhost/DocumentManager.WebApi
  • <add key=”RepositoryClientUrl” value=”” /> – w przypadku korzystania z funkcjonalności Comarch DMS Repozytorium, należy wprowadzić adres URL aplikacji DocumentManager.WebClient,
    http://localhost/DocumentManager.WebClient

Uruchamianie skryptów

W katalogu DMS Web \ Sql znajduje się plik Install.bat, który służy do instalacji skryptów na bazie Comarch DMS. Plik należy uruchomić z linii poleceń wpisując:
Install.bat <nazwa_serwera> <nazwa_bazy>

Analogiczny scenariusz należy wykonać dla katalogu DMS Web \ SqlAltum. W katalogu tym znajdują się dwa pliki instalacyjne:

1. InstallAltumComp.bat – plik należy uruchomić na wszystkich firmowych bazach ERP Altum.
   Przykład: InstallAltumComp.bat <nazwa_serwera> <nazwa_bazy>
2. InstallAltumConf.bat – plik należy uruchomić na konfiguracyjnej bazie ERP Altum.
   Przykład: InstallAltumConf.bat <nazwa_serwera> <nazwa_bazy>

Reindeksacja bazy

W katalogu DMS Web \ SQL znajduje się plik reindex.bat, który umożliwia:

Weryfikacja poprawności konfiguracji aplikacji web

Poprawność instalacji można zweryfikować poprzez uruchomienie skonfigurowanej aplikacji web i zalogowanie się na użytkownika „administrator” (bez hasła).

Okno logowania do aplikacji web

Aby możliwe było korzystanie z możliwości podpinania artykułów, kontrahentów i dokumentów z Comarch ERP Altum w kontrolkach typu Towar, Kontrahent, Dokument elektroniczny, wymagana jest dodatkowa konfiguracja:

Tryb jednofirmowy Comarch DMS

Do pracy w trybie jednofirmowym Comarch DMS należy w pliku web.config uzupełnić następujące informacje:

• W kluczu „strConnectDMS” należy wprowadzić connection string do bazy danych Comarch DMS.
• W kluczu „strConnectERPConf1” należy wprowadzić connection string do konfiguracyjnej bazy Comarch ERP Altum.
• W kluczu „strConnectERPComp” należy wprowadzić connection string do firmowej bazy danych Comarch ERP Altum.
• <add key=”WorkMode” value=”ALTUM” /> określenie współpracy Comarch DMS z Comarch ERP Altum – należy wpisać wartość „ALTUM”.
• <add key=”MultiCompany” value=”false” /> ustawienie trybu pracy – jednofirmowy („false”), w przypadku zmiany trybu na wielofirmowy należy zmienić wartość na „true”.
• <add key=”MaximumNumberOfControlCardColumns” value=”10″ /> definicja maksymalnej liczby kolumn karty obiegu, która będzie dostępna w konfiguracji typu obiegu.
• <add key=”PremiumFunctionality” value=”true” /> – klucz odpowiada za dostęp do funkcjonalności modelowania procesów w Comarch DMS za pomocą kodu w języku C#. Wartość „true” – funkcjonalność dostępna, wartość „false” – funkcjonalność niedostępna.
• <add key=”LicenceKeyServerDMS” value=”nazwa serwera klucza DMS” /> należy wpisać nazwę serwera licencji dla aplikacji Comarch DMS.
• <add key=”ShowChangeLanguage” value=”true” /> włącza możliwość wyboru języka pracy aplikacji Comarch DMS na oknie logowania. Wartość „false” wyłącza funkcjonalność.
• <add key=”UseStrongPassword” value=”false” /> wartość „true” wymusza stosowanie polityki mocnych haseł przez operatorów Comarch DMS (min 8 znaków, wielka litera, znak specjalny).
• <add key=”ExternalRegistrationEnabled” value=”false” /> – wartość „true” klucza umożliwia rejestrowanie użytkowników z poziomu aplikacji web i aktywuje funkcje wpisywane do tabeli do.DF_ConfOSEmployeesQueue – tabeli z danymi rejestracji użytkowników. Okno rejestracji można wyświetlić do dodaniu do adresu aplikacji członu „/ExternalRegistration”, np. http://localhost/DMS/ExternalRegistration. Wartość klucza = „false” oznacza, że rejestracja użytkowników w aplikacji web jest niemożliwa.
  • <add key=”TaxPayerIdRequired” value=”false” /> – klucz określa, czy użytkownik będzie musiał podać NIP podczas rejestracji. Wartość „true” oznacza konieczność podania NIP, wartość „false” oznacza brak konieczności.
  • <add key=”PersonalDataProcessingConsentRequired” value=”false” /> – klucz określa, czy w oknie rejestracji będzie wyświetlany parametr „Akceptuję regulamin oraz zapoznałem się z informacją o przetwarzaniu danych osobowych”. Wartość „true” spowoduje, że parametr będzie wyświetlany, a jego zaznaczenie będzie wymagane do rejestracji konta. Tekst regulaminu i informacji o przetwarzaniu danych osobowych należy wprowadzić odpowiednio do plików Rules_pl.txt i gdpr_pl.txt znajdujących się w folderze TextResources. Wartość „false” powoduje, że parametr nie jest wyświetlany i jego zaznaczenie nie jest wymagane do rejestracji.
  • <add key=”WorkingConditionsAcceptanceRequired” value=”false” /> – klucz określa, czy w oknie rejestracji będzie wyświetlany parametr „Akceptuję warunki pracy”. Wartość „true” powoduje, że parametr będzie wyświetlany, a jego zaznaczenie będzie wymagane do rejestracji konta. Treść informacji o warunkach pracy należy wprowadzić do pliku workingConditions_pl.txt w folderze TextResources. Wartość „false” powoduje, że parametr nie jest wyświetlany i jego zaznaczenie nie jest wymagane do rejestracji.

Uwaga

Do właściwego działania rejestracji użytkownika z poziomu aplikacji web konieczne jest poprawne wypełnienie przez administratora pól sekcji Ustawienia konta pocztowego w ramach zakładki Ustawienia w aplikacji desktopowej

• <add key=”DocumentListDateRange” value=”150″ /> Możliwość zdefiniowania filtra zawężającego wyszukiwanie dokumentów, dla których przekazanie do kolejnego etapu odbyło się określoną w kluczu ilość dni temu. Niezależnie od ustawienia operator może usunąć lub zmienić zdefiniowany filtr. Ustawienie wartość = 0 wyłącza domyślny filtr.
• <add key=”ERPXLCloud” value=”false” /> – wartość „true” umożliwia współpracę Comarch DMS z Comarch ERP XL w trybie chmurowym.
• <add key=”OptimaCloudMode” value=”false” /> – wartość „true” umożliwia współpracę Comarch DMS z Comarch ERP Optima w trybie chmurowym.
• <add key=”AskAboutDocumentSave” value=”True” /> – parametr odpowiedzialny za wyświetlanie komunikatów z pytaniem „Czy zapisać zmiany?” na szczegółach dokumentów Comarch DMS. W przypadku ustawienia value=”True”, komunikaty będą wyświetlane w aplikacji, w przypadku value=”False” komunikaty nie będą wyświetlane w aplikacji.

Uwaga

Gdy wartość klucza „AskAboutDocumentSave” zostanie ustawiona na „False”, w ustawieniach typu obiegu nie będzie możliwe włączenie funkcjonalności automatycznego zapisu po zainicjowaniu dokumentu.

• <add key=”CombinationCompanies” value=”false”/> – klucz odpowiada za możliwość ustawienia różnych spółek dla kontrolek na definicji obiegu. Wyłączona możliwość ustawienia różnych spółek dla wszystkich kontrolek: value = „false”, włączona: value = „true”.
• <add key=”CompanyNameSearchModeEnabled” value=”false” /> – klucz działa w trybie wielospółkowym, wartość „true” powoduje możliwość zawężania listy wyświetlanych spółek po wpisaniu frazy w okno wyszukiwania. Jeżeli wartość = „false”, spółkę należy znaleźć i wybrać z rozwijanej listy.
• <add key=”DocumentCounterMinutesInterval” value=”1″/> – parametr odpowiedzialny za wyświetlanie liczby dokumentów utworzonych w ramach danego typu obiegu, liczba dokumentów prezentowana jest w nawiasie obok każdego typu obiegu na drzewie typów obiegów. Domyślnie funkcjonalność jest włączona z wartością 1, czyli odświeżenie danych o liczbie dokumentów w ramach danego typu/grupy typów obiegu odbywa się co 1 minutę. Klucz może przyjmować wartości:
  • „-1” – wartość oznaczająca, że funkcjonalność jest wyłączona, na drzewie typów obiegów nie są prezentowane wartości z liczbą dokumentów.
  • „0” – wartość oznaczająca, że funkcjonalność jest włączona i sumowanie liczby dokumentów odbywa się przy każdym wejściu na listę dokumentów.
  • „<liczba całkowita>” – wartość oznaczająca, że funkcjonalność jest włączona, wpisana liczba określa wyrażony w minutach czas, po którym nastąpi automatyczne odświeżenie danych.
• <!– <add key=”XLAPIOpeHaslo” value=”haslo” / />–> musi pozostać zakomentowane. Parametr dostępny, jeżeli ustawiono <add key=”WorkMode” value=”XL” />. Umożliwia pracę na wspólnym haśle podczas generowania dokumentów.

Uwaga

Odkomentowanie klucza o nazwie”XLAPIOpeHaslo” spowoduje zamianę wszystkich haseł operatorów Comarch ERP XL na hasło ustawione w kluczu.

• <add key=”CompanyName” value=”nazwa firmy” /> można zdefiniować nazwę firmy, która zostanie wyświetlona w aplikacjach przed loginem zalogowanego operatora.
• <add key=”LicenceKeyServerERP” value=”nazwa serwera klucza ERP” /> należy wpisać nazwę serwera licencji dla ERP Altum.
• <add key=”EnableAnaliticDescription” value=”false” /> parametr aktywny jeżeli ustawiono <add key=”WorkMode” value=”XL” />. Umożliwia dekretację kosztów i generowanie dokumentów.
• <add key=”DestinationAttachmentsWorkflow” value=”DO” /> – parametr umożliwia wybór bazy, w której przechowywane będą załączniki dodane do dokumentów:
  • baza DMS – value = „DO”,
  • baza ERP XL – value = „XL”,
  • usługa IBARD – value = „IBARD”.
• <add key=”DestinationAttachmentsRepository” value=”DO” /> – parametr umożliwia wybór bazy, w której przechowywane będą pliki dodane do Managera dokumentów lub usługi Comarch DMS Repozytorium:
  • baza DMS – value = „DO”,
  • usługa IBARD – value = „IBARD”.
• <add key=”DMUsersIdAllowedToReorderDirectiories” value=”” /> – wartość klucza określa, którzy operatorzy są uprawnieni do zarządzania układem katalogów na drzewie w Managerze dokumentów. Domyślnie wartość klucza jest pusta, oznacza to, że wszyscy operatorzy mogą zarządzać kolejnością katalogów na drzewie. Jeżeli w kluczu zostaną wskazane identyfikatory operatorów DMS (DCD_ID), będzie to oznaczać, że jedynie wskazani operatorzy posiadają uprawnienie do reorganizacji struktury katalogów. Identyfikatory operatorów powinny być rozdzielane przecinkiem.
• <add key=”AnalitycalDescriptionWorkMode” value=”1″ /> – parametr określa tryb pobierania wymiarów opisu analitycznego. Klucz przyjmuje następujące wartości:
  • „1” – bezpośrednie pobieranie wymiarów z bazy Comarch ERP XL,
  • „2” – tryb z buforowaniem i doczytywaniem wymiarów do nowej daty utworzenia dokumentów (tryb, w którym dotychczas były pobierane wymiary opisu analitycznego),
  • „3” – tryb z buforowaniem, ale bez doczytywania wymiarów (warunek: w Comarch ERP XL wymiary nie posiadają zakresów czasowych).
• <add key=”CdnApiVersion” value=”201761″ /> parametr aktywny jeżeli ustawiono tryb pracy ‘XL’ lub ‘Optima’. Nr wersji systemu ERP z którym współpracuje Comarch DMS.

Tryb wielofirmowy Comarch DMS

Konfiguracja pracy w trybie wielofirmowym DMS odbywa się w pierwszej kolejności w pliku Web.config, gdzie należy zmienić wartość klucza „MultiCompany” na „true”. Po wprowadzeniu zmiany i ponownym uruchomieniu aplikacji stacjonarnej, na zakładce „Ustawienia” zostanie wyświetlona zakładka „Połączenia z ERP”.

Aby zdefiniować nową spółkę Comarch ERP Altum należy uzupełnić informacje:

Nazwa spółki – po połączeniu z bazą konfiguracyjną prezentowane są wszystkie bazy firmowe Comarch ERP Altum.

Spółka (skrót) – skrót nazwy spółki, maksymalnie 5 znaków.

Baza firmowa – po wskazaniu bazy w polu „Nazwa spółki”, automatycznie uzupełniane są dane do połączenia z bazą firmową.

Nazwa firmy Altum – w polu należy wskazać firmę, na liście rozwijanej dostępne są do wyboru wszystkie firmy ze wskazanej baz firmowej.

Domyślny login operatora ERP – w polu należy wpisać login operatora Comarch ERP Altum. Konto wskazanego operatora będzie wykorzystywane do uruchamiania obiektów (list i kart kontrahentów, list i kart artykułów, list i formularzy dokumentów). Operator powinien być dodany w Systemie Comarch ERP Altum oraz posiadać uprawnienia do obiektów, które będą wywoływane poprzez jego konto.

Hasło operatora ERP – w polu należy wpisać hasło operatora.

Używaj domeny – określa czy logowanie do Comarch DMS będzie odbywało się poprzez konto domenowe.

Nazwa domeny – należy wybrać domenę z rozwijanej listy. Opcja dostępna jedynie po zaznaczeniu parametru „Używaj domeny”.

Grupa – należy wybrać grupę z rozwijanej listy. Wyświetlane są dostępne w danej domenie grupy. Opcja dostępna jedynie po zaznaczeniu parametru „Używaj domeny”.

Od wersji Comarch DMS 2022.0 istnieje możliwość instalacji aplikacji stacjonarnej za pomocą instalatora. W tym celu w pobranym pliku instalacyjnym należy wejść do katalogu Comarch DMS {wersja} instalator aplikacji desktop.

Następnie należy uruchomić znajdujący się w folderze plik Comarch DMS Instalator.exe

Zostanie wówczas uruchomiony instalator aplikacji desktopowej, który umożliwia:

Po uruchomieniu instalatora zostaje wyświetlone okno początkowe, gdzie należy nacisnąć przycisk „Dalej”

W kolejnym kroku zostaje wyświetlone okno zawierające warunki korzystania z oprogramowania Comarch DMS. Aby przejść do kolejnego kroku instalacji, należy zaznaczyć parametr ” Akceptuję warunki gwarancji i korzystania z oprogramowania Comarch DMS” i nacisnąć przycisk „Dalej”.

W następnym kroku wymagany jest wybór folderu docelowego, w którym zostanie zainstalowana aplikacja stacjonarna. Lokalizację można zmienić, wpisując odpowiednią ścieżkę w polu „Folder:” lub wybierając folder po naciśnięciu przycisku „Przeglądaj”. Po wyborze folderu docelowego należy wybrać „Dalej”.

W kolejnym kroku należy wprowadzić adres URL aplikacji web Comarch DMS.

Wskazówka

Adres URL aplikacji web można sprawdzić w Menedżerze internetowych usług informacyjnych, po kliknięciu na nazwę danej aplikacji (np. „Standalone”) i wyborze opcji „Przeglądaj*:80 (http)”, dostępnej w oknie „Akcje” po prawej stronie. W przeglądarce zostanie wówczas wyświetlony adres aplikacji web, który można skopiować i wkleić w instalatorze.

Następnie konieczne jest sprawdzenie poprawności połączenia za pomocą przycisku „Sprawdź połączenie”. Jeżeli wpisano poprawny adres URL, pod przyciskiem powinna pojawić się informacja „Wprowadzony adres URL jest prawidłowy”. Po wprowadzeniu  adresu URL i jego pozytywnej weryfikacji należy nacisnąć „Dalej”.

Instalator jest już gotowy do instalacji. Aby do niej przystąpić, konieczne jest wybranie przycisku „Instaluj”

Po wyborze przycisku „Instaluj” rozpoczyna się kilkuminutowa instalacja aplikacji stacjonarnej. Instalator dodaje pliki aplikacji stacjonarnej w lokalizacji wybranej przez operatora i dokonuje modyfikacji pliku dms.exe.config zgodnie z zaznaczonymi podczas instalacji wyborami.

Po zakończeniu instalacji zostaje wyświetlone okno „Instalacja Comarch DMS została zakończona”, w którym należy nacisnąć przycisk „Zakończ”. Jeżeli operator zaznaczy wcześniej parametr „Uruchom Comarch DMS”, zostanie uruchomiona aplikacja desktopowa.

Aplikację desktopową DMS.exe można znaleźć w  wybranym folderze domyślnym, np. C:\Program Files (x86)\Comarch S.A\Comarch DMS.