Ustawienia opcji regionalnych

Aby program działał prawidłowo, konieczne jest ustawienie opcji regionalnych systemu na polskie.

 

W tym celu dla systemu Windows 8/ Windows 10 należy:

  • w ramach opcji Ustawienia wybrać Region i w polu Kraj lub region  – „Polska”

 

Wybór opcji „Polska” w polu „Kraj lub region”

  • w ramach opcji Panel sterowania wybrać ustawienia Zegar i region, a później Region

 

Wybór ustawień regionu

 

  • następnie w ramach zakladki  „Formaty” wybrać format „Polski (Polska)”

 

Opcja „Format” z ustawieniem „Polski (Polska)”

 

  • później w ramach zakładki „Administracyjne”  upewnić się, czy w polu Bieżący język dla programów nieobsługujących kodu Unicode: wybrane zostało ustawienie „Polski (Polska)”. Ustawienie mozna zmienić   po kliknięciu na przycisk „Zmień ustawienia regionalne systemu” – w otwartym wówczas oknie „Ustawienia regionalne” nalezy również dodatkowo sprawdzić, czy checkbox Użyj formatu Unicode UTF-8 do obsługi języków z całego świata jest zaznaczony – jeśli jest, należy go odznaczyć.

 

Zakładka „Administracyjne” – wybór zmiany ustawień regionalnych systemu

 

Prawidłowe ustawienia regionalne systemu dla rynku polskiego

 

Uwaga
Opisane ustawienia to ustawienia na rynek polski. W przypadku stosowania Comarch DMS w innych krajach konieczne jest zastosowanie ustawień, które są rekomendowane przez firmę Microsoft dla danego kraju albo krajów.




Przygotowanie instalacji – serwer IIS i serwer bazodanowy

System operacyjny dla serwera IIS

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

  • Windows Server 2016
  • Windows Server 2019
  • Windows Server 2022

 

Komponenty systemu IIS

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

  • Internetowe usługi informacyjne (IIS) w wersji 7.x lub nowszej (zalecane IIS 10.0)
  • Net Framework w wersji 4.7.2 lub wyższej (zalecana 4.8)

Serwer SQL

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

  • MS SQL Server 2014 Express/Standard/Enterprise Edition SP2 x86/x64
  • MS SQL Server 2016 Express/Workgroup/Standard/Enterprise Edition x86/x64
  • MS SQL Server 2017 Express/Workgroup/Standard/Enterprise Edition x86/x64
  • MS SQL Server 2019 Express/Workgroup/Standard/Enterprise Edition x86/x64
  • MS SQL Server 2022 Express/Workgroup/Standard/Enterprise Edition x86/x64

 

Uwaga
Podczas ręcznej instalacji silnika bazy danych  Microsoft SQL  Server należy zwrócić uwagę, aby po zaznaczeniu parametru „Windows collation designator and sort order” w polu „Collation designator” została wybrana wartość „Polish” oraz aby został  zaznaczony checkbox „Accent-sensitive”.

Ustawienie parametru sortowania/porównywania znaków dla rynku polskiego

 

Prawidłowa konfiguracja parametru sortowania/porównywania znaków, widoczna w zakładce „Collation” to: POLISH_CI_AS

Ustawienie parametru „Database Engine” dla rynku polskiego

Jeżeli użytkownik będzie chciał dokonać zmiany ustawień w późniejszym terminie, może się okazać konieczna reinstalacja silnika bazy.

Opisane ustawienia to ustawienia na rynek polski. W przypadku stosowania Comarch DMS w innych krajach konieczne jest zastosowanie ustawień, które są rekomendowane przez firmę Microsoft dla danego kraju albo krajów.

 

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.




Wymagania sprzętowe, oprogramowanie i licencje serwerowe

Uwaga
Zalecamy, aby serwer IIS, serwer SQL oraz serwer MongoDB były zainstalowane na osobnych maszynach.

 

Zalecane przeglądarki

Do pracy z modułem zalecane są przeglądarki:

  • Microsoft Edge;
  • Google Chrome;
  • Mozilla Firefox;
  • Opera.

 

Porty, które powinny zostać otwarte dla Comarch DMS

    • Na serwerze MSSQL należy odblokować domyślny port 1433, aby móc nawiązać komunikację z serwerem IIS i ewentualnie innymi serwerami, w przypadku instalacji na wielu różnych maszynach
    • Na maszynie, na której zainstalowano Comarch ERP Menadżer Kluczy należy otworzyć port SSL 443, aby umożliwić komunikację z serwerami Comarch
    • Można włączyć komunikację na porcie 5150, połączenie to wspiera komunikację Comarch ERP Menadżer Kluczy z serwerem IIS
    • Dodatkowo:
      • W SQL Management Studio należy włączyć „Authentification mixed mode”, a także upewnić się, że został utworzony użytkownik „SA”

 

Zalecana konfiguracja sprzętowa serwera IIS

Wymagany sprzęt – zalecenia minimalne:

      • VCPU – 2 x 2.2 GHz
      • RAM – 8 GB
      • HDD/SSD – 120 GB
      • Kontroler z obsługą RAID
      • Konfiguracja RAID – RAID1
      • NIC – Interfejs sieciowy 100/1000 Mb/s (w zależności od całości infrastruktury)

Zapewnienie możliwości rozbudowy:

      • Możliwość rozbudowy do 4 CPU
      • Możliwość rozszerzenia pamięci RAM powyżej 8 GB

Wymagane oprogramowanie serwera IIS

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

      • Windows Server 2016
      • Windows Server 2019
      • Windows Server 2022

Dodatkowe wymagania:

      • IIS w wersji 7.x lub nowszej
      • .Net Framework 4.7.2 lub wyższa (zalecana 4.8)
      • IIS URL Rewrite 7.2.1993 lub większy
      • IIS Application Request Routing 3.0 lub większy
      • .Net Core Hosting Bundle 6.0.31-6.9.9

 

Wymagane licencje na oprogramowanie dla serwera IIS

Licencja na system operacyjny

Jeden z dostępnych rodzajów licencji:

      • BOX
      • OEM
      • MOLP

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:

      • CAL SQL Server 2014/2016/2017/2019/2022 lub
      • CAL SQL Server 2014/2016/2017/2019/2022 Runtime i
      • CAL Windows Server 2016/2019/2022 lub licencja External Connector (dotyczy użytkowników zewnętrznych)

Ograniczenia i uwagi

      • Nie można łączyć licencji na serwer z licencjami CAL w sytuacji, kiedy są one dedykowane dla różnych wersji językowych.

 

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:

      • VCPU – 8 x 2.2 GHz
      • RAM – 16 GB, zalecane 31 GB
      • HDD/SSD – 200 GB (dla 100 tys. dokumentów DMS bez załączników należy zarezerwować 3 GB + rozmiar na załączniki przy założeniu: 200 kb dla jednej strony załącznika czarno-białego, 500 kb dla jednej strony załącznika kolorowego)
      • Kontroler z obsługą RAID
      • NIC – Interfejs sieciowy 100/1000 Mb/s (w zależności od całości infrastruktury)

 

Wymagane oprogramowanie SQL

System operacyjny:

      • Windows Server 2016 Standard/Datacenter Edition
      • Windows Server 2019 Standard/Datacenter Edition
      • Windows Server 2022 Standard/Datacenter Edition

Baza danych:

      • MS SQL 2014 Server Standard/Enterprise Edition x86/x64
      • MS SQL 2016 Server Standard/Enterprise Edition x86/x64
      • MS SQL 2017 Server Standard/Enterprise Edition x86/x64
      • MS SQL 2019 Server Standard/Enterprise Edition x86/x64
      • MS SQL 2022 Server Standard/Enterprise Edition x86/x64

 

Uwaga
Możliwa jest również instalacja z wykorzystaniem serwera MS SQL Express. Należy pamiętać o ograniczeniach związanych z maksymalną wielkością bazy danych (max 10 GB) oraz maksymalną ilością alokowanej pamięci (max 1 GB).

 

Licencje:

      • Konieczny jest zakup licencji na: system operacyjny, serwer baz danych oraz wymaganych licencji CAL dla serwera SQL i systemu operacyjnego.

Zalecana konfiguracja sprzętowa serwera MongoDB

(jeśli Comarch DMS ma aktywną współpracę z modułem Comarch DMS Repozytorium – zob. Comarch DMS – Repozytorium)

      • VCPU – 8 x 2.2 GHz
      • RAM – 32 GB, zalecane 64 GB
      • HDD/SSD – wielkość dysku zależy od ilości przechowywanych załączników. Można przyjąć założenie: 200 kB dla jednej strony załącznika czarno-białego i 500 kB dla jednej strony załącznika kolorowego.
      • Kontroler z obsługą RAID
      • NIC – Interfejs sieciowy 1000 Mb/s

 

Wymagane oprogramowanie

(jeśli Comarch DMS ma aktywną współpracę z modułem Comarch DMS Repozytorium – zob. Comarch DMS – Repozytorium)

 

Uwaga
Repozytorium należy zainstalować na tej samej witrynie, na której znajduje się moduł Workflow (np. Default Web Site).

 

System operacyjny:

      • Ubuntu 20.04 LTS
      • Windows Server 2016 Standard/Datacenter Edition
      • Windows Server 2019 Standard/Datacenter Edition
      • Windows Server 2022 Standard/Datacenter Edition

 

Uwaga
Możliwa jest instalacja także na innych systemach operacyjnych. Więcej informacji można znaleźć tutaj: Install MongoDB Community Edition — MongoDB Manual

 

Baza danych:

MongoDB Community version

Licencje:

Konieczny jest zakup licencji na: system operacyjny, licencji CAL systemu operacyjnego w przypadku
systemu Windows.

 

Rozwiązanie dedykowane pod jeden serwer MongoDB, zalecana ilość dokumentów to 6 mln.

 

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

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

      • CPU – średnio 300 MHz
      • RAM – max. 600 MB
      • HDD – 0,1 MB
      • Licencje – Licencja dostępu terminalowego dla każdego użytkownika (cal)

Konfiguracja sprzętowa dla stacji roboczej

Wymagany sprzęt – zalecenia minimalne:

      • CPU – Procesory z rodziny Intel /AMD 1 GHz lub szybszy
      • RAM – 4 GB
      • Pamięć masowa – HDD lub SSD
      • NIC – Interfejs sieciowy 100/1000 Mb/s (w zależności od całości infrastruktury)
      • Ekran – 1024×768

Wymagane oprogramowanie dla stacji roboczej

System operacyjny:

      • Windows 10
      • Windows 11

.Net Framework:

      • 4.7.2 lub wyższy (zalecany 4.8)

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.

    • Optymalnymi ilościami, które nie powinny być przekraczane to ok. 100 kontrolek na karcie obiegu i 10 dodatkowych kolumn na liście dokumentów.
    • Optymalna liczba dokumentów wprowadzanych do systemu to ok. 400 000 dokumentów rocznie w ramach jednego typu obiegu.



Sprawdzanie numeru wersji komponentów Comarch DMS

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.

 

Komunikat podczas uruchamiania aplikacji web dotyczący braku zgodności wersji komponentów aplikacji




Aplikacja Comarch DMS desktop na maszynie wirtualnej

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 kanałów wirtualnych 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:

Ustawienia skanowania

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.

 

Rozpoczynasz pracę z Comarch DMS i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch DMS i chcesz dowiedzieć się więcej?

Sprawdź Szkolenia Comarch DMS!




Instalacja – informacje ogólne

Do instalacji aplikacji Comarch DMS wymagane jest posiadanie dodatku Microsoft .Net Framework w wersji 4.7.2 lub wyższej.

 

Uwaga
Dla Comarch DMS nie zaleca się korzystania z serwerów proxy.

 

Uwaga
Do poprawnej współpracy z systemami Comarch ERP XL i Comarch ERP Optima wymagane jest aby wpis w zmiennych środowiskowych PATH dotyczący systemu Comarch ERP XL znalazł się przed wpisem dotyczącym Comarch ERP Optima.

 

Uwaga
Do generowania dokumentów za pomocą kontrolki Dokument ERP XL oraz kompresji załączników zapisywanych do bazy systemu Comarch ERP XL, system Comarch ERP XL musi być zainstalowany na serwerze IIS, na którym działa aplikacja.

 

Wskazówka
Chcesz dowiedzieć się, jak zainstalować Comarch DMS we współpracy z Comarch ERP XL? Sprawdź Szkolenia Comarch DMS !

 

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

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

lub

  1.  Katalog z instalatorem aplikacji serwerowej, WEB i desktop oraz (od wersji 2024.2.0) modułu Repozytorium – Comarch DMS {numer wersji} instalator Comarch DMS

 

Uwaga
Instalator aplikacji desktop nie jest dostępny w wersji 2022.0.2

 

Podstawowym elementem systemu Comarch DMS jest aplikacja serwerowa. Dlatego w pierwszej kolejności procesu instalacji należy zainstalować aplikację serwerową, później aplikację WEB, a następnie skonfigurować aplikację stacjonarną.

Od wersji 2024.2.0 umożliwiono:

  • Instalację serwera MongoDB z poziomu instalatora Comarch DMS;
  • Instalację aplikacji Comarch DMS Repozytorium za pomocą instalatora Comarch DMS;
  • Aktualizację aplikacji Comarch DMS Repozytorium z poziomu instalatora Comarch DMS.

Zalecamy przeprowadzenie instalacji aplikacji serwerowej, WEB oraz instalacji aplikacji desktop i Comarch DMS Repozytorium przy użyciu instalatora znajdującego się w katalogu Comarch DMS {numer wersji} instalator Comarch DMS. Istnieje również możliwość instalacji ręcznej.

 

Ogólny schemat infrastruktury aplikacji Comarch DMS

 

Uwaga

Aby możliwa była poprawna współpraca Comarch DMS z Comarch ERP XL w wersji 2023.2.0 i późniejszych (praca z „Historią związanych”), konieczne jest otwarcie do edycji następujących plików znajdujących się w katalogu z plikami Comarch ERP XL:

  • CDNKSI.exe.config;
  • CDNSPR.exe.config;
  • CDNZAM.exe.config

i wprowadzenie w każdym z nich w ramach <assemblyBinding> następującego przekierowania:

<dependentAssembly>

<assemblyIdentity name="Newtonsoft.Json" publicKeyToken="30ad4fe6b2a6aeed" culture="neutral" />

<bindingRedirect oldVersion="0.0.0.0-13.0.0.0" newVersion="13.0.0.0" />

</dependentAssembly>

 

Widok pliku CDNKSI.exe.config z dodanym przekierowaniem (przykład)

 

Widok pliku CDNSPR.exe.config z dodanym przekierowaniem (przykład)

 

Widok pliku CDNZAM.exe.config z dodanym przekierowaniem (przykład)




Instalacja Microsoft SQL Server Express za pomocą instalatora Comarch DMS

Jeżeli użytkownik nie ma zainstalowanego Microsoft SQL, wtedy od wersji 2023.0.0 może dokonać instalacji darmowego Microsoft SQL Server Express za pomocą instalatora Comarch DMS.

Aby uruchomić instalator Comarch DMS, w pobranym pakiecie instalacyjnym należy wejść do katalogu Comarch DMS 2024.0.0 instalator Comarch DMS i uruchomić Instalator Comarch DMS.exe

Wybór języka instalacji

Po uruchomieniu instalatora zostaje wyświetlone okno początkowe, w ramach którego dostępne jest pole „Język instalatora”, w którym należy dokonać wyboru języka, w jakim ma zostać przeprowadzona instalacja aplikacji. Dostępne są następujące języki:

  • Polski
  • Angielski
  • Niemiecki
  • Francuski

Okno początkowe instalatora aplikacji Comarch DMS – wybór języka instalacji

 

Po wyborze języka instalacji należy nacisnąć przycisk  [Dalej], aby przejść do kolejnego kroku instalacji. Jeżeli operator naciśnie przycisk  [Anuluj] albo spróbuje zamknąć okno za pomocą znaku x, wówczas zostanie wyświetlony następujący komunikat:

 

Komunikat, który zostanie wyświetlony po naciśnięciu przycisku „Anuluj” lub przy próbie zamknięcia okna instalatora

 

Jeśli użytkownik wybierze przycisk:

  • Tak – instalator zostanie zamknięty
  • Nie – użytkownik pozostanie w tym samym oknie, a komunikat będzie zamknięty

 

Okno przygotowania komponentów

W kolejnym kroku instalatora zostaje wyświetlone okno, informujące o tym, że instalator przygotowuje potrzebne komponenty. Przejście do następnego okna nastąpi automatycznie.

W następnym kroku instalatora wyświetlone zostaje okno powitalne instalatora.

Okno przygotowania komponentów

W następnym kroku instalatora wyświetlone zostaje okno powitalne instalatora.

 

Okno powitalne instalatora

Ekran powitalny instalatora Comarch DMS

Jeżeli użytkownik chce kontynuować instalację, wówczas powinien nacisnąć przycisk  [Dalej], aby przejść do kolejnego kroku instalacji. Jeżeli operator naciśnie przycisk  [Anuluj] albo spróbuje zamknąć okno za pomocą znaku x, wówczas zostanie wyświetlony komunikat analogiczny do przedstawionego powyżej.

 

Wybór aplikacji

Następnie w ramach okna Wybór aplikacji należy zaznaczyć opcję Microsoft SQL Server Express i kliknąć przycisk [Dalej].

 

Wybór opcji „Microsoft SQL Server Express”

 

Wtedy następuje przejście do instalatora, w ramach którego nastąpi zainstalowanie najnowszej wersji Microsoft SQL Server Express – zostaje otwarte okno „Serwer bazodanowy SQL”

 

Serwer bazodanowy SQL

W ramach okna „Serwer bazodanowy SQL” użytkownik może wybrać sposób logowania do serwera SQL:

  • Logowanie domenowe – w takim przypadku użytkownik nie dokonuje żadnych zmian, tylko klika przycisk [Instaluj], aby przejść do następnego kroku instalacji

 

Okno „Serwer bazodanowy SQL”, jeśli wybrano logowanie domenowe – użytkownik nie wprowadza zmian, jedynie klika „Instaluj”

 

    • Za pomocą własnego hasła – w takim wypadku użytkownik będzie logował się do serwera SQL, używając własnego hasła, które zostanie nadane dla konta administratora o nazwie „sa” – w tym celu konieczne jest zaznaczenie dostępnego w ramach okna checkboxa Zabezpiecz własnym hasłem (domyślnie checkbox jest odznaczony). Po zaznaczeniu checkboxa poniżej pojawiają się pola:
      • Hasło – należy tu wpisać hasło, za pomocą którego użytkownik będzie się logował na serwerze SQL. Hasło musi spełniać przynajmniej 3 z następujących zasad, a mianowicie zawierać:
        • Małe litery
        • Wielkie litery
        • Cyfry
        • Znaki specjalne
      • Powtórz hasło – w tym polu konieczne jest ponowne wpisanie frazy, za pomocą której uzupełniono pole „Hasło”

Po wpisaniu hasła w obydwóch polach należy nacisnąć przycisk [Instaluj], aby przejść do następnego kroku instalacji. Przycisk jest nieaktywny do czasu poprawnego uzupełnienia pól.

 

Okno „Serwer bazodanowy SQL”, jeśli wybrano logowanie za pomocą własnego hasła – użytkownik zaznacza checkbox „Zabezpiecz własnym haslem”, uzupełnia hasło w dostępnych polach i klika „Instaluj”

 

Wskazówka
Jeśli wybrano logowanie za pomocą własnego hasła, to aby zalogować się do Microsoft QL Server Express konieczny będzie wybór opcji „SQL Server Authentication” i wpisanie sa w polu „Login” oraz określonego podczas instalacji hasła w polu „Hasło”.

 

Przykładowe logowanie do serwera SQL

 

 

Instalowanie

Po wyborze sposobu logowania do serwera SQL i kliknięciu przycisku [Instaluj] następuje  instalacja Microsoft SQL Server Express, wyświetlane jest także okno instalacji serwera.

 

 

Koniec pracy instalatora

Kiedy instalacja Microsoft SQL Server Express dobiegnie końca, wówczas nastąpi przejście do okna „Koniec pracy instalatora”, zaś okno instalacji serwera zamknie się automatycznie. Aby wyjść z okna, należy wybrać przycisk „Zakończ”.

 

Okno „Koniec pracy instalatora”

 

Następnie należy zainstalować aplikacje: serwerową (dawną web) i  WEB (nową web) Comarch DMS jak opisano w artykule:




Instalacja aplikacji serwerowej, WEB i Comarch DMS Repozytorium za pomocą instalatora


Instalacja – etapy początkowe

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

W wersji 2023.0.0 wprowadzono nowe instalatory aplikacji web dla:

  • Comarch DMS Standalone
  • Comarch DMS we współpracy z Comarch ERP XL
  • Comarch DMS we współpracy z Comarch ERP Optima

 

Od wersji 2023.0 istnieje również możliwość instalacji serwera bazodanowego Microsoft SQL Server Express z poziomu instalatora aplikacji web Comarch DMS (zob.Instalacja Microsoft SQL Server Express za pomocą instalatora Comarch DMS). Z poziomu instalatora aplikacji web można także przejść bezpośrednio do instalatora aplikacji desktop Comarch DMS.

 

Uwaga
Instalacje wersji WWW nie są zalecane na stacjach roboczych. Instalacja powinna być przeprowadzona na dedykowanym serwerze.

 

Aby uruchomić instalator Comarch DMS, w pobranym pakiecie instalacyjnym należy wejść do katalogu Comarch DMS [wersja] instalator Comarch DMS i uruchomić Instalator Comarch DMS.exe

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

  • Instalacja koniecznych komponentów serwera IIS
  • Konfiguracja puli na której będzie pracowała aplikacji Comarch DMS
  • Instalacja i konfiguracja aplikacji Comarch DMS
  • Aktualizacja aplikacji serwerowej i webowej Comarch DMS
  • Instalacja serwera MongoDB (od wersji Comarch DMS 2024.2.0)
  • Instalacja i aktualizacja aplikacji Comarch DMS Repozytorium (od wersji Comarch DMS 2024.2.0)

 

Wybór języka instalacji

Po uruchomieniu instalatora zostaje wyświetlone okno początkowe, w ramach którego dostępne jest pole „Język instalatora”, w którym należy dokonać wyboru języka, w jakim ma zostać przeprowadzona instalacja aplikacji. Dostępne są następujące języki:

  • Polski
  • Angielski
  • Niemiecki
  • Francuski

 

Okno początkowe instalatora aplikacji web Comarch DMS – wybór języka instalacji

 

Po wyborze języka instalacji należy nacisnąć przycisk [Dalej], aby przejść do kolejnego kroku instalacji, okna instalacji wymaganych dodatków. Jeżeli operator naciśnie przycisk [Anuluj] albo spróbuje zamknąć okno za pomocą znaku x, wówczas zostanie wyświetlony następujący komunikat:

 

Komunikat, który zostanie wyświetlony po naciśnięciu przycisku „Anuluj” lub przy próbie zamknięcia okna instalatora

 

Jeśli użytkownik wybierze przycisk:

  • Tak – instalator zostanie zamknięty
  • Nie – użytkownik pozostanie w tym samym oknie, a komunikat będzie zamknięty

 

Od wersji 2024.0.1 po przejściu do okna instalacji wymaganych dodatków wyświetlany jest komunikat, który informuje o braku możliwości instalacji Comarch DMS w systemach wcześniejszych niż:

  • Windows Vista x64;
  • Windows Server 2008 x64;
  • Windows 7 x64
  • Windows Server 2008 R2 x64
  • Windows Server 2012 x64.

Po kliknięciu w przycisk [OK] instalator zostaje zamknięty.

 

Komunikat informujący o braku możliwości instalacji Comarch DMS

 

Okno przygotowania komponentów

W kolejnym kroku instalatora zostaje wyświetlone okno, informujące o tym, że instalator przygotowuje potrzebne komponenty. Przejście do następnego okna nastąpi automatycznie.

W następnym kroku instalatora wyświetlone zostaje okno powitalne instalatora.

Okno przygotowania komponentów

 

Okno powitalne instalatora

Ekran powitalny instalatora web Comarch DMS

 

Jeżeli użytkownik chce kontynuować instalację, wówczas powinien nacisnąć przycisk [Dalej], aby przejść do kolejnego kroku instalacji. Jeżeli operator naciśnie przycisk [Anuluj] albo spróbuje zamknąć okno za pomocą znaku x, wówczas zostanie wyświetlony komunikat analogiczny do przedstawionego powyżej.

 

Wybór aplikacji

Po przejściu do okna Wybór aplikacji należy wybrać opcję Instalacja aplikacji Comarch DMS oraz Comarch DMS Repozytorium.

 

Uwaga
Jeżeli użytkownik nie ma zainstalowanego serwera SQL, wówczas przed przystąpieniem do instalacji aplikacji web powinien wybrać opcję Instalacja Microsoft SQL Server Express i kliknąć [Dalej]. Dalsze kroki opisano w artykule Instalacja Microsoft SQL Server Express za pomocą instalatora Comarch DMS.

Jeżeli użytkownik nie ma zainstalowanego serwera MongoDB, a chce korzystać z modułu Comarch DMS Repozytorium, wówczas powinien wybrać opcję Instalacja serwera MongoDB i kliknąć [Dalej]. Dalsze kroki opisano w rozdziale Instalacja serwera Mongo DB za pomocą instalatora Comarch DMS .

Wybór instalacji aplikacji web Comarch DMS za pomocą instalatora

 

Po kliknięciu przycisku [Dalej] użytkownik przechodzi do okna „Wybór aplikacji cd.”.

 

Wybór aplikacji cd.

W ramach okna „Wybór aplikacji cd.” operator może wybrać jedną z trzech opcji:

      • Instalacja aplikacji Comarch DMS (zob. poniżej: Instalacja aplikacji Comarch DMS – aby instalować jedynie Comarch DMS;
      • Instalacja aplikacji Comarch DMS oraz Comarch DMS Repozytorium (zob. poniżej: Instalacja aplikacji Comarch DMS oraz Comarch DMS Repozytorium) – aby instalować zarówno Comarch DMS, jak i Comarch DMS Repozytorium;
      • Instalacja Comarch DMS Repozytorium – aby instalować jedynie Comarch DMS Repozytorium.

Okno „Wybór aplikacji cd.”

 

Instalacja aplikacji Comarch DMS

Jeśli w oknie „Wybór aplikacji cd.” operator zaznaczył opcję „Instalacja aplikacji Comarch DMS”, a następnie [Dalej], wówczas następuje przejście do okna „Tryb pracy”.

 

Tryb pracy

W ramach okna Tryb pracy należy zaznaczyć opcję Współpraca z Comarch ERP XL; ta opcja umożliwia zainstalowanie Comarch DMS, w którym będzie możliwa praca w powiązaniu z Comarch ERP XL.

Po wyborze opcji należy kliknąć [Dalej], aby przejść do kolejnego kroku instalacji.

 

Okno „Tryb pracy” – wybór opcji współpracy z Comarch ERP XL

 

Warunki korzystania z oprogramowania

W ramach okna Warunki korzystania z oprogramowania należy zapoznać się z warunkami korzystania z oprogramowania Comarch DMS, zaznaczyć checkbox „Akceptuję warunki instalacji” i nacisnąć [Dalej], aby przejść do kolejnego etapu – przycisk nie jest aktywny, jeśli nie została zaznaczona zgoda na warunki instalacji.

 

Okno „Warunki korzystania z oprogramowania”

 

Internetowe usługi informacyjne (IIS)

W kolejnym oknie Internetowe usługi informacyjne (IIS) następuje weryfikacja, czy na danym komputerze dostępny jest serwer IIS. Jeżeli:

Serwer IIS nie jest dostępny - wyświetlana jest informacja „ Serwer IIS nie jest dostępny na tym komputerze” i nie jest możliwe przejście do kolejnego etapu instalacji.

W takim wypadku użytkownik może:

  • Nacisnąć przycisk [Zainstaluj IIS] – nastąpi wówczas instalacja IIS. Podczas instalacji wyświetlany jest komunikat „ Trwa instalacja serwera IIS”. Po zakończonej instalacji przycisk „Zainstaluj IIS” zostaje wyszarzony i wyświetlany jest napis „Serwer IIS został poprawnie zainstalowany”.
  • Pozostawić otwarte okno instalatora Comarch DMS, zainstalować ręcznie IIS, a potem kliknąć [Odśwież]
  • Zamknąć instalator za pomocą przycisku [Anuluj] lub znaku x, wykonać ręczną instalację IIS i ponownie przejść przez kolejne kroki instalatora do okna „Internetowe usługi informacyjne (IIS)”

 

Po zastosowaniu jednego z powyższych sposobów możliwe będzie przejście do kolejnego kroku instalacji aplikacji web Comarch DMS za pomocą przycisku [Dalej]

Serwer IIS jest dostępny – wyświetlana jest informacja „ Serwer IIS został poprawnie zainstalowany” i należy przejść do kolejnego kroku, klikając przycisk [Dalej].

 

Okno „Internetowe usługi informacyjne”, jeśli na danym komputerze dostępny jest serwer IIS

 

Wymagane dodatki

Po kliknięciu przycisku [Dalej], następuje przejście do następnego okna, w ramach którego następuje instalacja dodatków wymaganych dla poprawnego działania Comarch DMS.

W ramach pola dostępnego w prawej części okna dostępne są następujące kolumny:

  • Name – zawiera nazwę danego dodatku
  •  Required – zawiera numer wymaganej wersji danego dodatku
  • Found – zawiera numer wersji danego dodatku zainstalowanej już na komputerze
  • Action – zawiera nieaktywny przycisk Pomiń – jeśli na komputerze jest już odpowiednia wersja i dany dodatek nie wymaga instalacji, wówczas jego instalacja zostanie automatycznie pominięta

Okno „Wymagane dodatki”

Aby zainstalować wymagane dodatki i przejść do następnego okna należy nacisnąć przycisk [Dalej].

 

Wybór puli aplikacji

Na kolejnym kroku, w oknie Pula aplikacji należy określić, na jakiej puli aplikacji ma pracować aplikacja Comarch DMS – w tym celu należy:

  • Wybrać pulę aplikacji z listy znajdującej się po prawej stronie okna, klikając na nią

 

lub

  • Dodać nową pulę aplikacji –wpisać nazwę puli, która ma zostać utworzona, w polu „„Nazwa nowej puli aplikacji”, a następnie nacisnąć przycisk [Dodaj pulę]. Wybór puli zostaje automatycznie ustawiony na nowoutworzonej puli . Dodana w ten sposób pula spełnia wymagania konieczne do instalacji aplikacji DMS.

 

Dodawanie puli „NowaPula”

 

Okno „Pula aplikacji”, w którym wybrano pulę „Comarch DMS”

 

Kiedy operator wybrał pulę aplikacji z listy albo dodał nową pulę i ją zaznaczył, wówczas następuje sprawdzenie, czy pula spełnia konieczne wymagania. Jeśli pod listą pul aplikacji zostanie wyświetlony komunikat:

  • Wybrana pula spełnia wymagania instalowanej aplikacji – można przejść do dalszego kroku instalacji Comarch DMS
  • Wybrana pula nie spełnia wymagań instalowanej aplikacji – przed kontynuacją instalacji Comarch DMS należy wybrać inną pulę spełniającą wymagania lub dodać nową
  • Wybrana pula jest zatrzymana. Przed uruchomieniem aplikacji należy uruchomić pulę w Menedżerze IIS. – przed kontynuacją instalacji Comarch DMS należy uruchomić pulę aplikacji
  • Pula o tej nazwie już istnieje. – przed kontynuacją instalacji Comarch DMS należy wybrać inną pulę spełniającą wymagania lub dodać nową o innej nazwie

 

Po wyborze puli aplikacji spełniającej wymagania należy przejść do następnego kroku instalacji, klikając przycisk [Dalej].

 

Kreowanie aplikacji serwerowej

W tym oknie następuje konfiguracja aplikacji serwerowej (webowej starszego typu). W ramach okna Kreowanie aplikacji serwerowej użytkownik:

  • w polu „Wybierz lub utwórz witrynę web” – z listy dostępnych witryn wybiera witrynę, w której ma zostać utworzona aplikacja;
  • w polu „Port” – wpisuje numer portu, który przypisany jest do danej witryny;
  • w polu „Wprowadź nazwę aplikacji serwerowej” – wpisuje nadaną przez siebie nazwę aplikacji, np. DMSapi

 

Uwaga
Nazwa aplikacji nie może zawierać następujących znaków specjalnych:

  • \
  • ?
  •  ;
  • :
  • @
  • (spacja)
  •  =
  •  +
  • $
  •  „
  •  |
  •  ”
  • <
  •  >
  • *

Jeżeli użytkownik wpisze nazwę zawierającą jeden lub więcej z powyższych znaków, wówczas nowa aplikacja nie zostanie utworzona, a w dolnej części okna pojawi się informacja o zakazanych znakach specjalnych.
W takim wypadku użytkownik powinien zmodyfikować nazwę wpisaną w polu „Nazwa aplikacji” tak, aby nie zawierała już znaków specjalnych, a później ponownie nacisnąć [Utwórz aplikację].

 

 

Następnie należy kliknąć przycisk [Utwórz aplikację], aby nowa aplikacja została utworzona. Podczas tworzenia aplikacji w dolnej części okna widoczna jest informacja „Trwa kreowanie aplikacji”. Jeżeli utworzenie aplikacji przebiegło pomyślnie, wówczas wyświetlana jest informacja „Aplikacja została utworzona pomyślnie”. Przycisk [Utwórz aplikację] nie jest aktywny do czasu wybrania witryny i wpisania nazwy aplikacji przez użytkownika.

Okno „Kreowanie aplikacji serwerowej” po tym, jak aplikacja została utworzona

Jeżeli podczas tworzenia aplikacji nastąpił błąd, wyświetlona zostanie informacja „Nie udało się utworzyć aplikacji”. W takim przypadku użytkownik powinien zmienić witrynę w polu „Nazwa witryny” i ponownie kliknąć   [Utwórz aplikację] albo opuścić instalator, a następnie ponownie przeprowadzić instalację.

Operator ma także opcję dodania nowej witryny, na której utworzy aplikację serwerową. W tym celu powinien:

  • W polu „Wybierz lub utwórz witrynę web” wpisać nazwę witryny, która ma zostać utworzona;

W polu „Port” wpisać numer portu, który ma zostać przypisany do nowoutworzonej witryny

Okno „Kreowanie aplikacji serwerowej” podczas dodawania nowej witryny

Następnie operator powinien nacisnąć przycisk [Utwórz witrynę]. Jeśli tworzenie witryny zakończyło się powodzeniem, wówczas w dolnej części okna wyświetlany jest napis Witryna została utworzona na serwerze IIS.

 

Okno „Kreowanie aplikacji serwerowej” po pomyślnym dodaniu nowej witryny

Jeśli operator wpisze w polu Wybierz lub utwórz witrynę web nazwę witryny, która już istnieje, i kliknie [Utwórz witrynę], wówczas witryna nie zostanie utworzona, a w dolnej części okna widoczna będzie informacja Witryna o tej nazwie już istnieje. W takim przypadku należy wprowadzić inną, nieistniejącą do tej pory nazwę witryny i ponownie kliknąć [Utwórz witrynę].

 

Okno „Kreowanie aplikacji serwerowej”, gdy próbowano utworzyć nową witrynę o takiej samej nazwie jak już istniejąca

 

Analogicznie, jeżeli operator wpisze w polu Port numer portu, który jest już wykorzystywany, i kliknie [Utwórz witrynę], wówczas witryna nie zostanie utworzona, a w dolnej części okna widoczna będzie informacja Port jest już użyty przez inną witrynę. W takim przypadku należy wprowadzić inny, nieużywany do tej pory numer portu i ponownie kliknąć [Utwórz witrynę].

 

Okno „Kreowanie aplikacji serwerowej”, gdy próbowano utworzyć nową witrynę na porcie, który jest już wykorzystywany

Aby przejść do kolejnego kroku instalacji należy wybrać przycisk [Dalej]. Przycisk nie jest aktywny dopóki aplikacja nie została utworzona.

 

Kreowanie aplikacji WEB

W tym oknie następuje konfiguracja aplikacji webowej z nowym interfejsem. W ramach okna Kreowanie aplikacji WEB użytkownik:

  • w polu „Wybierz lub utwórz witrynę web” – z listy dostępnych witryn wybiera witrynę, w której ma zostać utworzona aplikacja;
  • w polu „Port” – wpisuje numer portu, który przypisany jest do danej witryny;
  • w polu „Wprowadź nazwę aplikacji WEB” – wpisuje nadaną przez siebie nazwę aplikacji, np. DMSweb.

 

Uwaga
Nazwa aplikacji nie może zawierać następujących znaków specjalnych:

  • \
  • ?
  •  ;
  • :
  • @
  • (spacja)
  •  =
  •  +
  • $
  •  „
  •  |
  •  ”
  • <
  •  >
  • *

Jeżeli użytkownik wpisze nazwę zawierającą jeden lub więcej z powyższych znaków, wówczas nowa aplikacja nie zostanie utworzona, a w dolnej części okna pojawi się informacja o zakazanych znakach specjalnych.
W takim wypadku użytkownik powinien zmodyfikować nazwę wpisaną w polu „Nazwa aplikacji” tak, aby nie zawierała już znaków specjalnych, a później ponownie nacisnąć [Utwórz aplikację].

 

Informacja o znakach zakazanych w oknie „Kreowanie aplikacji WEB”

Następnie należy kliknąć przycisk [Utwórz aplikację], aby nowa aplikacja została utworzona. Podczas tworzenia aplikacji w dolnej części okna widoczna jest informacja „Trwa kreowanie aplikacji”. Jeżeli utworzenie aplikacji przebiegło pomyślnie, wówczas wyświetlana jest informacja „Aplikacja została utworzona pomyślnie”.

Przycisk [Utwórz aplikację] nie jest aktywny do czasu wybrania witryny i wpisania nazwy aplikacji przez użytkownika.

 

Okno „Kreowanie aplikacji WEB” po tym, jak aplikacja została utworzona

Jeżeli podczas tworzenia aplikacji nastąpił błąd, wyświetlona zostanie informacja „Nie udało się utworzyć aplikacji”. W takim przypadku użytkownik powinien zmienić witrynę w polu „Wybierz lub utwórz witrynę web” i ponownie kliknąć [Utwórz aplikację] albo opuścić instalator, a następnie ponownie przeprowadzić instalację.

Operator ma także opcję dodania nowej witryny, na której utworzy aplikację WEB. W tym celu powinien:

  • W polu „Wybierz lub utwórz witrynę web” wpisać nazwę witryny, która ma zostać utworzona;
  • W polu „Port” wpisać numer portu, który ma zostać przypisany do nowoutworzonej witryny

 

Okno „Kreowanie aplikacji WEB” podczas dodawania nowej witryny

 

Następnie operator powinien nacisnąć przycisk [Utwórz witrynę]. Jeśli tworzenie witryny zakończyło się powodzeniem, wówczas w dolnej części okna wyświetlany jest napis Witryna została utworzona na serwerze IIS.

 

Okno „Kreowanie aplikacji WEB” po pomyślnym dodaniu nowej witryny

Jeśli operator wpisze w polu Wybierz lub utwórz witrynę web nazwę witryny, która już istnieje, i kliknie [Utwórz witrynę], wówczas witryna nie zostanie utworzona, a w dolnej części okna widoczna będzie informacja Witryna o tej nazwie już istnieje. W takim przypadku należy wprowadzić inną, nieistniejącą do tej pory nazwę witryny i ponownie kliknąć [Utwórz witrynę].

 

Okno „Kreowanie aplikacji WEB”, gdy próbowano utworzyć nową witrynę o takiej samej nazwie jak już istniejąca

 

Analogicznie, jeżeli operator wpisze w polu Port numer portu, który jest już wykorzystywany, i kliknie [Utwórz witrynę], wówczas witryna nie zostanie utworzona, a w dolnej części okna widoczna będzie informacja Port jest już użyty przez inną witrynę. W takim przypadku należy wprowadzić inny, nieużywany do tej pory numer portu i ponownie kliknąć [Utwórz witrynę].

 

Okno „Kreowanie aplikacji WEB”, gdy próbowano utworzyć nową witrynę na porcie, który jest już wykorzystywany

Aby przejść do kolejnego kroku instalacji należy wybrać przycisk [Dalej]. Przycisk nie jest aktywny dopóki aplikacja nie została utworzona.

Opcje instalacji

W następnym oknie „ Opcje instalacji” w ramach pola „Domyślny język instalowanej aplikacji” wybierany jest język, w którym wyświetlana będzie domyślnie aplikacja Comarch DMS.

 

Okno „Opcje instalacji” w przypadku instalacji Comarch DMS we współpracy z systemem Comarch ERP XL

 

Dostępne są również cztery parametry:

    • Utwórz osobną bazę danych dla Comarch DMS – domyślnie zaznaczony parametr; wyświetlany w przypadku instalacji Comarch DMS we współpracy z systemami Comarch ERP. Jeżeli parametr zostanie odznaczony, wówczas system Comarch DMS będzie korzystał z bazy Comarch ERP XL
    • Opcja zmiany języka na ekranie logowania do aplikacji – jeżeli parametr zostanie zaznaczony, wówczas na ekranie logowania dostępny będzie link [aplikacja desktop] lub [aplikacja serwerowa – dawna web], po kliknięciu w który możliwy jest wybór z listy jednego z czterech języków aplikacji: polskiego, angielskiego, niemieckiego lub francuskiego.
    • Wymagaj przestrzegania polityki mocnych haseł – domyślnie zaznaczony parametr; sprawia, że hasła ustawiane w aplikacji muszą spełniać określone warunki:
        • Składać się z min. 12 znaków
        • Zawierać cyfry
        • Zawierać małe i wielkie litery;
        • Zawierać znaki specjalne.
  • Wersja Premium – opcja domyślnie zaznaczona; funkcjonalność modelowania procesów za pomocą kodu C#[/su_list]
  •  

    Uwaga
    Od wersji 2023.0 w ramach instalatora nie jest już dostępne opcja:

    • Włącz funkcjonalność opisu analitycznego – opcja wyświetlana w poprzedniej wersji instalatora podczas instalacji Comarch DMS z Comarch ERP XL; aktualnie funkcjonalność opisu analitycznego jest domyślnie włączona

     

    Po ustawieniu parametrów należy kliknąć na przycisk [Dalej], aby kontynuować instalację – jeżeli w ramach okna „Opcje instalacji” :

    • zaznaczono parametr „Utwórz osobną bazę danych dla Comarch DMS” – kolejnym krokiem instalacji jest przejście do okna „Baza danych Comarch DMS”
    • odznaczono parametr „Utwórz osobną bazę danych dla Comarch DMS” – wówczas następuje przejście bezpośrednio do okna „Baza danych Comarch ERP XL”.

     

    Baza danych Comarch DMS

    Poniżej przedstawiono kolejne kroki instalacji po kliknięciu przycisku [Dalej] w oknie „Opcje instalacji” , jeśli zaznaczono parametr „Utwórz osobną bazę danych dla Comarch DMS”

    Po przejściu do okna „Baza danych Comarch DMS” należy poprawnie uzupełnić pole „Nazwa serwera”, a następnie wybrać typ logowania:

    • Logowanie zintegrowane

     

    lub

     

    • Logowanie SQL – jeśli wybrano tę opcję, należy podać:
        • W polu „Nazwa użytkownika” – nazwę użytkownika logującego się do serwera SQL – np. sa
        • W polu „Hasło” – hasło użytkownika logującego się do serwera SQL

     

    Okno „Baza danych Comarch DMS” przed uzupełnieniem danych

     

    Następnie należy nacisnąć przycisk [Połącz], aby połączyć się z serwerem SQL. Jeżeli połączenie zostało nawiązane, w dolnej części okna pojawi się napis „Nawiązano połączenie z serwerem SQL”.

     

    Okno „Baza danych Comarch DMS” po uzupełnieniu pola „Nazwa serwera”, wyborze typu logowania i naciśnięciu „Połącz”

     

    Jeśli nawiązano połączenie z serwerem, użytkownik powinien kliknąć przycisk [Zmień hasło].

    Zostaje wówczas wyświetlone okno, w którym należy uzupełnić hasło dla użytkownika ODUser, który dodawany jest do serwera SQL podczas pierwszej instalacji Comarch DMS. Hasło musi być silne, to znaczy:

    • Składać się z min. 12 znaków
    • Zawierać cyfry
    • Zawierać małe i wielkie litery;
    • Zawierać znaki specjalne.

     

    Uwaga
    Hasło nie może również zawierać następujących znaków :

    • ;


     

    Jeżeli wpisano hasło, które nie spełnia któregoś z tych trzech wymagań, wówczas po kliknięciu przycisku [Zapisz] hasło nie zostaje zapisane i wyświetlany jest komunikat:

    • Jeśli hasło jest za krótkie

     

     

        • Brakuje warunku/warunków wymaganych dla silnego hasła (np. brak znaku specjalnego, brak wielkiej litery)

     

     

    Należy zmienić hasło, tak, aby spełniało wszystkie warunki.

    Jeśli natomiast hasło wpisane w polu „Powtórz hasło” różni się od hasła wpisanego w polu „Hasło”, wtedy po kliknięciu przycisku [Zapisz] hasło nie zostaje zapisane i wyświetlany jest komunikat:

     

    Komunikat wyświetlany, jeśli hasła nie są zgodne

     

    Należy uzupełnić pole „Powtórz hasło” tak, aby zgadzało się z polem „Hasło”.

     

    Okno zmiany hasła dla użytkownika ODUser

     

    Kiedy pola zostały poprawnie uzupełnione, a użytkownik nacisnął przycisk [Zapisz], okno zmiany hasła dla ODUsera zostaje zamknięte, a hasło użytkownika ODUser zostaje zmienione.

    Hasło zostanie również wpisane do wszystkich „connection string” znajdujących się w 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 Serwera, 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.

     

    Uwaga
    Operator ODUser jest wspólnym operatorem dla wszystkich instalacji Comarch DMS realizowanych w ramach jednego serwera MS SQL.

     

    Następnie użytkownik powinien nacisnąć przycisk [Dodaj bazę]. Wtedy zostanie otwarte okno, w ramach którego należy wprowadzić nazwę nowej bazy danych Comarch DMS, a następnie kliknąć [Zapisz]. Jeżeli użytkownik nie chce jednak dodać nowej bazy, wtedy powinien nacisnąć przycisk [Anuluj] albo znak X.

     

    Okno dodawania nowej bazy Comarch DMS

     

    Po naciśnięciu przycisku [Zapisz] baza Comarch DMS zostaje dodana i w ramach instalatora wyświetla się informacja „Baza danych DMS została utworzona”.

     

    Uwaga
    Jeśli użytkownik instaluje Comarch DMS po raz pierwszy, ma tylko możliwość dodania nowej bazy dla DMS – nie może dokonać wyboru z listy istniejących baz, jak w poprzednim instalatorze.

     

    Uwaga
    Od wersji 2024.0.0 instalator szyfruje connection strings w pliku Web.config w katalogu aplikacji serwerowej (dawnej web).

     

    Dodawanie nowej bazy

     

    Gdy baza danych została dodana, wówczas należy kliknąć przycisk [Uruchom skrypty] w celu przygotowania bazy Comarch DMS do pracy. Kiedy wykonywanie skryptów zakończyło się sukcesem, wyświetlona zostaje informacja „Skrypty SQL zostały wykonane pomyślnie”, a użytkownik może nacisnąć przycisk   [Dalej], aby przejść do kolejnego kroku instalacji – do okna „Baza danych Comarch ERP XL” (zob. poniżej rozdział Baza danych Comarch ERP XL).

     

    Okno „Baza danych Comarch DMS” po pomyślnym wykonaniu skryptów

     

    Baza danych Comarch ERP XL

    W ramach okna „Baza danych Comarch ERP XL” należy poprawnie uzupełnić pole „Nazwa serwera”, a następnie wybrać typ logowania:

    • Logowanie zintegrowane

     

    lub

     

    • Logowanie SQL – jeśli wybrano tę opcję, należy podać:
        • W polu „Nazwa użytkownika” – nazwę użytkownika logującego się do serwera SQL – np. sa
        • W polu „Hasło” – hasło użytkownika logującego się do serwera SQL

     

    Okno „Baza danych Comarch ERP XL” przed uzupełnieniem danych

     

    Następnie należy nacisnąć przycisk [Połącz], aby połączyć się z serwerem SQL. Jeżeli połączenie zostało nawiązane, w dolnej części okna pojawi się napis „Nawiązano połączenie z serwerem SQL”.

    Jeśli:

    • Baza firmowa Comarch ERP XL i wcześniej połączona z aplikacją baza są na tym samym serwerze – wówczas po nawiązaniu połączenia z serwerem należy przejść do wyboru bazy w polu „Lista baz danych”

     

    Okno „Baza danych Comarch ERP XL” po nawiązaniu połączenia z serwerem i wyborze bazy firmowej – jeśli baza Comarch ERP XL i wcześniej połączona z aplikacją baza są na tym samym serwerze

     

    • Baza Comarch ERP XL znajduje się na innym serwerze lub w oknie „Opcje instalacji” nie zaznaczono opcji „Niezależna baza Comarch DMS” – wtedy po nawiązaniu połączenia z serwerem konieczne jest kliknięcie w przycisk [Zmień hasło]

    Po wyborze przycisku [Zmień hasło] zostaje wyświetlone okno, w którym należy uzupełnić hasło dla użytkownika ODUser, który dodawany jest do serwera SQL podczas pierwszej instalacji Comarch DMS. Hasło musi być silne, to znaczy:

    • Składać się z min. 12 znaków
    • Zawierać cyfry
    • Zawierać małe i wielkie litery;
    • Zawierać znaki specjalne.

     

    Uwaga
    Hasło nie może również zawierać następujących znaków :

    • ;


     

    Jeżeli wpisano hasło, które nie spełnia któregoś z tych trzech wymagań, wówczas po kliknięciu przycisku [Zapisz] hasło nie zostaje zapisane i wyświetlany jest komunikat:

        • Jeśli hasło jest za krótkie

     

     

        • Brakuje warunku/warunków wymaganych dla silnego hasła (np. brak znaku specjalnego, brak wielkiej litery)

     

     

    Należy zmienić hasło, tak, aby spełniało wszystkie warunki.

    Jeśli natomiast hasło wpisane w polu „Powtórz hasło” różni się od hasła wpisanego w polu „Hasło”, wtedy po kliknięciu przycisku [Zapisz] hasło nie zostaje zapisane i wyświetlany jest komunikat:

     

    Komunikat wyświetlany, jeśli hasła nie są zgodne

     

    Należy uzupełnić pole „Powtórz hasło” tak, aby zgadzało się z polem „Hasło”.

     

    Okno zmiany hasła dla użytkownika ODUser

     

    Kiedy pola zostały poprawnie uzupełnione, a użytkownik nacisnął przycisk [Zapisz], okno zmiany hasła dla ODUsera zostaje zamknięte, a hasło użytkownika ODUser zostaje zmienione. Następnie należy przejść do wyboru bazy w polu „Lista baz danych”

    W ramach pola „Lista baz danych” użytkownik powinien wybrać jedną z dostępnych baz Comarch ERP XL, a następnie kliknąć przycisk [Uruchom skrypty] w celu przystosowania bazy Comarch ERP XL do pracy z systemem Comarch DMS.

     

    Uwaga
    Dodanie nowej bazy firmowej Comarch ERP XL nie jest możliwe z poziomu instalatora Comarch DMS.

     

    Kiedy wykonywanie skryptów zakończyło się sukcesem, wyświetlona zostaje informacja „Skrypty SQL zostały wykonane pomyślnie”, a użytkownik może nacisnąć przycisk [Dalej] i przejść do okna „Klucze licencji”.

     

    Okno instalatora po pomyślnym wykonaniu skryptów na bazie Comarch ERP XL

     

    Klucze licencji

    W ramach okna „Klucze licencji” należy:

    • w polu „Serwer klucza licencji Comarch DMS” wpisać klucz licencji Comarch DMS zgodnie ze wzorem nazwa_serwera_klucza::numer_klucza
    • W polu „Serwer klucza licencji Comarch ERP XL” wpisać klucz licencji Comarch ERP XL zgodnie ze wzorem nazwa_serwera_klucza::numer_klucza

     

    Okno „Klucze licencji”

     

    Uwaga
    W ramach instalatora nie następuje weryfikacja klucza – jeśli wprowadzono niepoprawny klucz licencji, wystąpi błąd przy próbie logowania do aplikacji web Comarch DMS.

     

    Instalacja aplikacji web Comarch DMS we współpracy z Comarch ERP XL

    Po uzupełnieniu kluczy licencji i kliknięciu [Instaluj] następuje przejście do okna instalacji aplikacji web Comarch DMS.

     

    Okno „Instalacja” , gdy trwa instalacja Comarch DMS

     

    Koniec pracy instalatora

    Po zakończeniu instalacji następuje przejście do końcowego okna instalacji aplikacji web Comarch DMS. Gdy użytkownik kliknie przycisk [Zakończ], instalator zostanie zamknięty, natomiast zostanie otwarta przeglądarka na ekranie logowania do nowej aplikacji WEB Comarch DMS, zgodnie z nazwą aplikacji, którą podano w instalatorze.

     

    Okno końcowe instalatora Comarch DMS

     

    Wskazówka
    Jeśli podczas uruchomiania aplikacji serwerowej (dawna web) pojawia się komunikat: „add name=”strConnct providerName=”System.Data.SqlClient” – sprawdź tutaj

    Jeśli podczas próby uruchomienia aplikacji serwerowej (dawna web) pojawia się komunikat ”Błąd http 500.19 – Internal Server Error’’ – sprawdź tutaj

     

    Instalacja aplikacji Comarch DMS oraz Comarch DMS Repozytorium

    Jeśli w oknie „Wybór aplikacji cd.” operator zaznaczył opcję „Instalacja aplikacji Comarch DMS”, a następnie [Dalej], wówczas następuje przejście do okna „Tryb pracy”.

     

    Tryb pracy

    Tryb pracy

    W ramach okna Tryb pracy należy zaznaczyć opcję Współpraca z Comarch ERP XL; ta opcja umożliwia zainstalowanie Comarch DMS, w którym będzie możliwa praca w powiązaniu z Comarch ERP XL.

    Po wyborze opcji należy kliknąć [Dalej], aby przejść do kolejnego kroku instalacji.

     

    Okno „Tryb pracy” – wybór opcji współpracy z Comarch ERP XL

     

    Warunki korzystania z oprogramowania

    W ramach okna Warunki korzystania z oprogramowania należy zapoznać się z warunkami korzystania z oprogramowania Comarch DMS, zaznaczyć checkbox „Akceptuję warunki instalacji” i nacisnąć [Dalej], aby przejść do kolejnego etapu – przycisk nie jest aktywny, jeśli nie została zaznaczona zgoda na warunki instalacji.

     

    Okno „Warunki korzystania z oprogramowania”

     

    Internetowe usługi informacyjne (IIS)

    W kolejnym oknie Internetowe usługi informacyjne (IIS) następuje weryfikacja, czy na danym komputerze dostępny jest serwer IIS. Jeżeli:

    Serwer IIS nie jest dostępny – wyświetlana jest informacja „ Serwer IIS nie jest dostępny na tym komputerze” i nie jest możliwe przejście do kolejnego etapu instalacji.

    W takim wypadku użytkownik może:

    • Nacisnąć przycisk [Zainstaluj IIS] – nastąpi wówczas instalacja IIS. Podczas instalacji wyświetlany jest komunikat „ Trwa instalacja serwera IIS”. Po zakończonej instalacji przycisk „Zainstaluj IIS” zostaje wyszarzony i wyświetlany jest napis „Serwer IIS został poprawnie zainstalowany”.
    • Pozostawić otwarte okno instalatora Comarch DMS, zainstalować ręcznie IIS, a potem kliknąć [Odśwież]
    • Zamknąć instalator za pomocą przycisku [Anuluj] lub znaku x, wykonać ręczną instalację IIS i ponownie przejść przez kolejne kroki instalatora do okna „Internetowe usługi informacyjne (IIS)”

     

    Po zastosowaniu jednego z powyższych sposobów możliwe będzie przejście do kolejnego kroku instalacji aplikacji web Comarch DMS za pomocą przycisku [Dalej]

    Serwer IIS jest dostępny – wyświetlana jest informacja „ Serwer IIS został poprawnie zainstalowany” i należy przejść do kolejnego kroku, klikając przycisk [Dalej].

     

    Okno „Internetowe usługi informacyjne”, jeśli na danym komputerze dostępny jest serwer IIS

     

    Wymagane dodatki

    Po kliknięciu przycisku [Dalej], następuje przejście do następnego okna, w ramach którego następuje instalacja dodatków wymaganych dla poprawnego działania Comarch DMS.

    W ramach pola dostępnego w prawej części okna dostępne są następujące kolumny:

    • Name – zawiera nazwę danego dodatku
    •  Required – zawiera numer wymaganej wersji danego dodatku
    • Found – zawiera numer wersji danego dodatku zainstalowanej już na komputerze
    • Action – zawiera nieaktywny przycisk Pomiń – jeśli na komputerze jest już odpowiednia wersja i dany dodatek nie wymaga instalacji, wówczas jego instalacja zostanie automatycznie pominięta

    Okno „Wymagane dodatki”

    Aby zainstalować wymagane dodatki i przejść do następnego okna należy nacisnąć przycisk [Dalej].

     

    Wybór puli aplikacji

    Na kolejnym kroku, w oknie Pula aplikacji należy określić, na jakiej puli aplikacji ma pracować aplikacja Comarch DMS – w tym celu należy:

    • Wybrać pulę aplikacji z listy znajdującej się po prawej stronie okna, klikając na nią

     

    lub

    • Dodać nową pulę aplikacji –wpisać nazwę puli, która ma zostać utworzona, w polu „„Nazwa nowej puli aplikacji”, a następnie nacisnąć przycisk [Dodaj pulę]. Wybór puli zostaje automatycznie ustawiony na nowoutworzonej puli . Dodana w ten sposób pula spełnia wymagania konieczne do instalacji aplikacji DMS.

     

    Dodawanie puli „NowaPula”

     

    Okno „Pula aplikacji”, w którym wybrano pulę „Comarch DMS”

     

    Kiedy operator wybrał pulę aplikacji z listy albo dodał nową pulę i ją zaznaczył, wówczas następuje sprawdzenie, czy pula spełnia konieczne wymagania. Jeśli pod listą pul aplikacji zostanie wyświetlony komunikat:

    • Wybrana pula spełnia wymagania instalowanej aplikacji – można przejść do dalszego kroku instalacji Comarch DMS
    • Wybrana pula nie spełnia wymagań instalowanej aplikacji – przed kontynuacją instalacji Comarch DMS należy wybrać inną pulę spełniającą wymagania lub dodać nową
    • Wybrana pula jest zatrzymana. Przed uruchomieniem aplikacji należy uruchomić pulę w Menedżerze IIS. – przed kontynuacją instalacji Comarch DMS należy uruchomić pulę aplikacji
    • Pula o tej nazwie już istnieje. – przed kontynuacją instalacji Comarch DMS należy wybrać inną pulę spełniającą wymagania lub dodać nową o innej nazwie

     

    Po wyborze puli aplikacji spełniającej wymagania należy przejść do następnego kroku instalacji, klikając przycisk [Dalej].

     

    Kreowanie aplikacji serwerowej

    W tym oknie następuje konfiguracja aplikacji serwerowej (webowej starszego typu). W ramach okna Kreowanie aplikacji serwerowej użytkownik:

    • w polu „Wybierz lub utwórz witrynę web” – z listy dostępnych witryn wybiera witrynę, w której ma zostać utworzona aplikacja;
    • w polu „Port” – wpisuje numer portu, który przypisany jest do danej witryny;
    • w polu „Wprowadź nazwę aplikacji serwerowej” – wpisuje nadaną przez siebie nazwę aplikacji, np. DMSapi

     

    Uwaga
    Nazwa aplikacji nie może zawierać następujących znaków specjalnych:

    • \
    • ?
    •  ;
    • :
    • @
    • (spacja)
    •  =
    •  +
    • $
    •  „
    •  |
    •  ”
    • <
    •  >
    • *

    Jeżeli użytkownik wpisze nazwę zawierającą jeden lub więcej z powyższych znaków, wówczas nowa aplikacja nie zostanie utworzona, a w dolnej części okna pojawi się informacja o zakazanych znakach specjalnych.
    W takim wypadku użytkownik powinien zmodyfikować nazwę wpisaną w polu „Nazwa aplikacji” tak, aby nie zawierała już znaków specjalnych, a później ponownie nacisnąć [Utwórz aplikację].

     

     

    Następnie należy kliknąć przycisk [Utwórz aplikację], aby nowa aplikacja została utworzona. Podczas tworzenia aplikacji w dolnej części okna widoczna jest informacja „Trwa kreowanie aplikacji”. Jeżeli utworzenie aplikacji przebiegło pomyślnie, wówczas wyświetlana jest informacja „Aplikacja została utworzona pomyślnie”. Przycisk [Utwórz aplikację] nie jest aktywny do czasu wybrania witryny i wpisania nazwy aplikacji przez użytkownika.

    Okno „Kreowanie aplikacji serwerowej” po tym, jak aplikacja została utworzona

    Jeżeli podczas tworzenia aplikacji nastąpił błąd, wyświetlona zostanie informacja „Nie udało się utworzyć aplikacji”. W takim przypadku użytkownik powinien zmienić witrynę w polu „Nazwa witryny” i ponownie kliknąć   [Utwórz aplikację] albo opuścić instalator, a następnie ponownie przeprowadzić instalację.

    Operator ma także opcję dodania nowej witryny, na której utworzy aplikację serwerową. W tym celu powinien:

    • W polu „Wybierz lub utwórz witrynę web” wpisać nazwę witryny, która ma zostać utworzona;

    W polu „Port” wpisać numer portu, który ma zostać przypisany do nowoutworzonej witryny

    Okno „Kreowanie aplikacji serwerowej” podczas dodawania nowej witryny

    Następnie operator powinien nacisnąć przycisk [Utwórz witrynę]. Jeśli tworzenie witryny zakończyło się powodzeniem, wówczas w dolnej części okna wyświetlany jest napis Witryna została utworzona na serwerze IIS.

     

    Okno „Kreowanie aplikacji serwerowej” po pomyślnym dodaniu nowej witryny

    Jeśli operator wpisze w polu Wybierz lub utwórz witrynę web nazwę witryny, która już istnieje, i kliknie [Utwórz witrynę], wówczas witryna nie zostanie utworzona, a w dolnej części okna widoczna będzie informacja Witryna o tej nazwie już istnieje. W takim przypadku należy wprowadzić inną, nieistniejącą do tej pory nazwę witryny i ponownie kliknąć [Utwórz witrynę].

     

    Okno „Kreowanie aplikacji serwerowej”, gdy próbowano utworzyć nową witrynę o takiej samej nazwie jak już istniejąca

     

    Analogicznie, jeżeli operator wpisze w polu Port numer portu, który jest już wykorzystywany, i kliknie [Utwórz witrynę], wówczas witryna nie zostanie utworzona, a w dolnej części okna widoczna będzie informacja Port jest już użyty przez inną witrynę. W takim przypadku należy wprowadzić inny, nieużywany do tej pory numer portu i ponownie kliknąć [Utwórz witrynę].

     

    Okno „Kreowanie aplikacji serwerowej”, gdy próbowano utworzyć nową witrynę na porcie, który jest już wykorzystywany

    Aby przejść do kolejnego kroku instalacji należy wybrać przycisk [Dalej]. Przycisk nie jest aktywny dopóki aplikacja nie została utworzona.

     

    Kreowanie aplikacji WEB

    W tym oknie następuje konfiguracja aplikacji webowej z nowym interfejsem. W ramach okna Kreowanie aplikacji WEB użytkownik:

    • w polu „Wybierz lub utwórz witrynę web” – z listy dostępnych witryn wybiera witrynę, w której ma zostać utworzona aplikacja;
    • w polu „Port” – wpisuje numer portu, który przypisany jest do danej witryny;
    • w polu „Wprowadź nazwę aplikacji WEB” – wpisuje nadaną przez siebie nazwę aplikacji, np. DMSweb.

     

    Uwaga
    Nazwa aplikacji nie może zawierać następujących znaków specjalnych:

    • \
    • ?
    •  ;
    • :
    • @
    • (spacja)
    •  =
    •  +
    • $
    •  „
    •  |
    •  ”
    • <
    •  >
    • *

    Jeżeli użytkownik wpisze nazwę zawierającą jeden lub więcej z powyższych znaków, wówczas nowa aplikacja nie zostanie utworzona, a w dolnej części okna pojawi się informacja o zakazanych znakach specjalnych.
    W takim wypadku użytkownik powinien zmodyfikować nazwę wpisaną w polu „Nazwa aplikacji” tak, aby nie zawierała już znaków specjalnych, a później ponownie nacisnąć [Utwórz aplikację].

     

    Informacja o znakach zakazanych w oknie „Kreowanie aplikacji WEB”

    Następnie należy kliknąć przycisk [Utwórz aplikację], aby nowa aplikacja została utworzona. Podczas tworzenia aplikacji w dolnej części okna widoczna jest informacja „Trwa kreowanie aplikacji”. Jeżeli utworzenie aplikacji przebiegło pomyślnie, wówczas wyświetlana jest informacja „Aplikacja została utworzona pomyślnie”.

    Przycisk [Utwórz aplikację] nie jest aktywny do czasu wybrania witryny i wpisania nazwy aplikacji przez użytkownika.

     

    Okno „Kreowanie aplikacji WEB” po tym, jak aplikacja została utworzona

    Jeżeli podczas tworzenia aplikacji nastąpił błąd, wyświetlona zostanie informacja „Nie udało się utworzyć aplikacji”. W takim przypadku użytkownik powinien zmienić witrynę w polu „Wybierz lub utwórz witrynę web” i ponownie kliknąć [Utwórz aplikację] albo opuścić instalator, a następnie ponownie przeprowadzić instalację.

    Operator ma także opcję dodania nowej witryny, na której utworzy aplikację WEB. W tym celu powinien:

    • W polu „Wybierz lub utwórz witrynę web” wpisać nazwę witryny, która ma zostać utworzona;
    • W polu „Port” wpisać numer portu, który ma zostać przypisany do nowoutworzonej witryny

     

    Okno „Kreowanie aplikacji WEB” podczas dodawania nowej witryny

     

    Następnie operator powinien nacisnąć przycisk [Utwórz witrynę]. Jeśli tworzenie witryny zakończyło się powodzeniem, wówczas w dolnej części okna wyświetlany jest napis Witryna została utworzona na serwerze IIS.

     

    Okno „Kreowanie aplikacji WEB” po pomyślnym dodaniu nowej witryny

    Jeśli operator wpisze w polu Wybierz lub utwórz witrynę web nazwę witryny, która już istnieje, i kliknie [Utwórz witrynę], wówczas witryna nie zostanie utworzona, a w dolnej części okna widoczna będzie informacja Witryna o tej nazwie już istnieje. W takim przypadku należy wprowadzić inną, nieistniejącą do tej pory nazwę witryny i ponownie kliknąć [Utwórz witrynę].

     

    Okno „Kreowanie aplikacji WEB”, gdy próbowano utworzyć nową witrynę o takiej samej nazwie jak już istniejąca

     

    Analogicznie, jeżeli operator wpisze w polu Port numer portu, który jest już wykorzystywany, i kliknie [Utwórz witrynę], wówczas witryna nie zostanie utworzona, a w dolnej części okna widoczna będzie informacja Port jest już użyty przez inną witrynę. W takim przypadku należy wprowadzić inny, nieużywany do tej pory numer portu i ponownie kliknąć [Utwórz witrynę].

     

    Okno „Kreowanie aplikacji WEB”, gdy próbowano utworzyć nową witrynę na porcie, który jest już wykorzystywany

    Aby przejść do kolejnego kroku instalacji należy wybrać przycisk [Dalej]. Przycisk nie jest aktywny dopóki aplikacja nie została utworzona.

    Opcje instalacji

    W następnym oknie „ Opcje instalacji” w ramach pola „Domyślny język instalowanej aplikacji” wybierany jest język, w którym wyświetlana będzie domyślnie aplikacja Comarch DMS.

     

    Okno „Opcje instalacji” w przypadku instalacji Comarch DMS we współpracy z systemem Comarch ERP XL

     

    Dostępne są również cztery parametry:

      • Utwórz osobną bazę danych dla Comarch DMS – domyślnie zaznaczony parametr; wyświetlany w przypadku instalacji Comarch DMS we współpracy z systemami Comarch ERP. Jeżeli parametr zostanie odznaczony, wówczas system Comarch DMS będzie korzystał z bazy Comarch ERP XL
      • Opcja zmiany języka na ekranie logowania do aplikacji – jeżeli parametr zostanie zaznaczony, wówczas na ekranie logowania dostępny będzie link [aplikacja desktop] lub [aplikacja serwerowa – dawna web], po kliknięciu w który możliwy jest wybór z listy jednego z czterech języków aplikacji: polskiego, angielskiego, niemieckiego lub francuskiego.
      • Wymagaj przestrzegania polityki mocnych haseł – domyślnie zaznaczony parametr; sprawia, że hasła ustawiane w aplikacji muszą spełniać określone warunki:
          • Składać się z min. 12 znaków
          • Zawierać cyfry
          • Zawierać małe i wielkie litery;
          • Zawierać znaki specjalne.
  • Wersja Premium – opcja domyślnie zaznaczona; funkcjonalność modelowania procesów za pomocą kodu C#[/su_list]
  •  

    Uwaga
    Od wersji 2023.0 w ramach instalatora nie jest już dostępne opcja:

    • Włącz funkcjonalność opisu analitycznego – opcja wyświetlana w poprzedniej wersji instalatora podczas instalacji Comarch DMS z Comarch ERP XL; aktualnie funkcjonalność opisu analitycznego jest domyślnie włączona

     

    Po ustawieniu parametrów należy kliknąć na przycisk [Dalej], aby kontynuować instalację – jeżeli w ramach okna „Opcje instalacji” :

    • zaznaczono parametr „Utwórz osobną bazę danych dla Comarch DMS” – kolejnym krokiem instalacji jest przejście do okna „Baza danych Comarch DMS”
    • odznaczono parametr „Utwórz osobną bazę danych dla Comarch DMS” – wówczas następuje przejście bezpośrednio do okna „Baza danych Comarch ERP XL”.

     

    Baza danych Comarch DMS

    Poniżej przedstawiono kolejne kroki instalacji po kliknięciu przycisku [Dalej] w oknie „Opcje instalacji” , jeśli zaznaczono parametr „Utwórz osobną bazę danych dla Comarch DMS”

    Po przejściu do okna „Baza danych Comarch DMS” należy poprawnie uzupełnić pole „Nazwa serwera”, a następnie wybrać typ logowania:

    • Logowanie zintegrowane

     

    lub

     

    • Logowanie SQL – jeśli wybrano tę opcję, należy podać:
        • W polu „Nazwa użytkownika” – nazwę użytkownika logującego się do serwera SQL – np. sa
        • W polu „Hasło” – hasło użytkownika logującego się do serwera SQL

     

    Okno „Baza danych Comarch DMS” przed uzupełnieniem danych

     

    Następnie należy nacisnąć przycisk [Połącz], aby połączyć się z serwerem SQL. Jeżeli połączenie zostało nawiązane, w dolnej części okna pojawi się napis „Nawiązano połączenie z serwerem SQL”.

     

    Okno „Baza danych Comarch DMS” po uzupełnieniu pola „Nazwa serwera”, wyborze typu logowania i naciśnięciu „Połącz”

     

    Jeśli nawiązano połączenie z serwerem, użytkownik powinien kliknąć przycisk [Zmień hasło].

    Zostaje wówczas wyświetlone okno, w którym należy uzupełnić hasło dla użytkownika ODUser, który dodawany jest do serwera SQL podczas pierwszej instalacji Comarch DMS. Hasło musi być silne, to znaczy:

    • Składać się z min. 12 znaków
    • Zawierać cyfry
    • Zawierać małe i wielkie litery;
    • Zawierać znaki specjalne.

     

    Uwaga
    Hasło nie może również zawierać następujących znaków :

    • ;


     

    Jeżeli wpisano hasło, które nie spełnia któregoś z tych trzech wymagań, wówczas po kliknięciu przycisku [Zapisz] hasło nie zostaje zapisane i wyświetlany jest komunikat:

    • Jeśli hasło jest za krótkie

     

     

        • Brakuje warunku/warunków wymaganych dla silnego hasła (np. brak znaku specjalnego, brak wielkiej litery)

     

     

    Należy zmienić hasło, tak, aby spełniało wszystkie warunki.

    Jeśli natomiast hasło wpisane w polu „Powtórz hasło” różni się od hasła wpisanego w polu „Hasło”, wtedy po kliknięciu przycisku [Zapisz] hasło nie zostaje zapisane i wyświetlany jest komunikat:

     

    Komunikat wyświetlany, jeśli hasła nie są zgodne

     

    Należy uzupełnić pole „Powtórz hasło” tak, aby zgadzało się z polem „Hasło”.

     

    Okno zmiany hasła dla użytkownika ODUser

     

    Kiedy pola zostały poprawnie uzupełnione, a użytkownik nacisnął przycisk [Zapisz], okno zmiany hasła dla ODUsera zostaje zamknięte, a hasło użytkownika ODUser zostaje zmienione.

    Hasło zostanie również wpisane do wszystkich „connection string” znajdujących się w 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 Serwera, 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.

     

    Uwaga
    Operator ODUser jest wspólnym operatorem dla wszystkich instalacji Comarch DMS realizowanych w ramach jednego serwera MS SQL.

     

    Następnie użytkownik powinien nacisnąć przycisk [Dodaj bazę]. Wtedy zostanie otwarte okno, w ramach którego należy wprowadzić nazwę nowej bazy danych Comarch DMS, a następnie kliknąć [Zapisz]. Jeżeli użytkownik nie chce jednak dodać nowej bazy, wtedy powinien nacisnąć przycisk [Anuluj] albo znak X.

     

    Okno dodawania nowej bazy Comarch DMS

     

    Po naciśnięciu przycisku [Zapisz] baza Comarch DMS zostaje dodana i w ramach instalatora wyświetla się informacja „Baza danych DMS została utworzona”.

     

    Uwaga
    Jeśli użytkownik instaluje Comarch DMS po raz pierwszy, ma tylko możliwość dodania nowej bazy dla DMS – nie może dokonać wyboru z listy istniejących baz, jak w poprzednim instalatorze.

     

    Uwaga
    Od wersji 2024.0.0 instalator szyfruje connection strings w pliku Web.config w katalogu aplikacji serwerowej (dawnej web).

     

    Dodawanie nowej bazy

     

    Gdy baza danych została dodana, wówczas należy kliknąć przycisk [Uruchom skrypty] w celu przygotowania bazy Comarch DMS do pracy. Kiedy wykonywanie skryptów zakończyło się sukcesem, wyświetlona zostaje informacja „Skrypty SQL zostały wykonane pomyślnie”, a użytkownik może nacisnąć przycisk   [Dalej], aby przejść do kolejnego kroku instalacji – do okna „Baza danych Comarch ERP XL” (zob. poniżej rozdział Baza danych Comarch ERP XL).

     

    Okno „Baza danych Comarch DMS” po pomyślnym wykonaniu skryptów

     

    Baza danych Comarch ERP XL

    W ramach okna „Baza danych Comarch ERP XL” należy poprawnie uzupełnić pole „Nazwa serwera”, a następnie wybrać typ logowania:

    • Logowanie zintegrowane

     

    lub

     

    • Logowanie SQL – jeśli wybrano tę opcję, należy podać:
        • W polu „Nazwa użytkownika” – nazwę użytkownika logującego się do serwera SQL – np. sa
        • W polu „Hasło” – hasło użytkownika logującego się do serwera SQL

     

    Okno „Baza danych Comarch ERP XL” przed uzupełnieniem danych

     

    Następnie należy nacisnąć przycisk [Połącz], aby połączyć się z serwerem SQL. Jeżeli połączenie zostało nawiązane, w dolnej części okna pojawi się napis „Nawiązano połączenie z serwerem SQL”.

    Jeśli:

    • Baza firmowa Comarch ERP XL i wcześniej połączona z aplikacją baza są na tym samym serwerze – wówczas po nawiązaniu połączenia z serwerem należy przejść do wyboru bazy w polu „Lista baz danych”

     

    Okno „Baza danych Comarch ERP XL” po nawiązaniu połączenia z serwerem i wyborze bazy firmowej – jeśli baza Comarch ERP XL i wcześniej połączona z aplikacją baza są na tym samym serwerze

     

    • Baza Comarch ERP XL znajduje się na innym serwerze lub w oknie „Opcje instalacji” nie zaznaczono opcji „Niezależna baza Comarch DMS” – wtedy po nawiązaniu połączenia z serwerem konieczne jest kliknięcie w przycisk [Zmień hasło]

    Po wyborze przycisku [Zmień hasło] zostaje wyświetlone okno, w którym należy uzupełnić hasło dla użytkownika ODUser, który dodawany jest do serwera SQL podczas pierwszej instalacji Comarch DMS. Hasło musi być silne, to znaczy:

    • Składać się z min. 12 znaków
    • Zawierać cyfry
    • Zawierać małe i wielkie litery;
    • Zawierać znaki specjalne.

     

    Uwaga
    Hasło nie może również zawierać następujących znaków :

    • ;


     

    Jeżeli wpisano hasło, które nie spełnia któregoś z tych trzech wymagań, wówczas po kliknięciu przycisku [Zapisz] hasło nie zostaje zapisane i wyświetlany jest komunikat:

        • Jeśli hasło jest za krótkie

     

     

        • Brakuje warunku/warunków wymaganych dla silnego hasła (np. brak znaku specjalnego, brak wielkiej litery)

     

     

    Należy zmienić hasło, tak, aby spełniało wszystkie warunki.

    Jeśli natomiast hasło wpisane w polu „Powtórz hasło” różni się od hasła wpisanego w polu „Hasło”, wtedy po kliknięciu przycisku [Zapisz] hasło nie zostaje zapisane i wyświetlany jest komunikat:

     

    Komunikat wyświetlany, jeśli hasła nie są zgodne

     

    Należy uzupełnić pole „Powtórz hasło” tak, aby zgadzało się z polem „Hasło”.

     

    Okno zmiany hasła dla użytkownika ODUser

     

    Kiedy pola zostały poprawnie uzupełnione, a użytkownik nacisnął przycisk [Zapisz], okno zmiany hasła dla ODUsera zostaje zamknięte, a hasło użytkownika ODUser zostaje zmienione. Następnie należy przejść do wyboru bazy w polu „Lista baz danych”

    W ramach pola „Lista baz danych” użytkownik powinien wybrać jedną z dostępnych baz Comarch ERP XL, a następnie kliknąć przycisk [Uruchom skrypty] w celu przystosowania bazy Comarch ERP XL do pracy z systemem Comarch DMS.

     

    Uwaga
    Dodanie nowej bazy firmowej Comarch ERP XL nie jest możliwe z poziomu instalatora Comarch DMS.

     

    Kiedy wykonywanie skryptów zakończyło się sukcesem, wyświetlona zostaje informacja „Skrypty SQL zostały wykonane pomyślnie”, a użytkownik może nacisnąć przycisk [Dalej] i przejść do okna „Pula aplikacji Comarch DMS Repozytorium”.

     

    Okno instalatora po pomyślnym wykonaniu skryptów na bazie Comarch ERP XL

     

    Pula aplikacji Comarch DMS Repozytorium

    Okno „Pula aplikacji Comarch DMS Repozytorium” przed dodaniem/wyborem puli aplikacji

    W ramach okna „Pula aplikacji Comarch DMS Repozytorium” należy określić, na jakiej puli aplikacji ma pracować aplikacja Comarch DMS Repozytorium– w tym celu należy:

        • Wybrać pulę aplikacji z listy znajdującej się po prawej stronie okna, klikając na nią

    lub

        • Dodać nową pulę aplikacji –wpisać nazwę puli, która ma zostać utworzona, w polu „„Nazwa nowej puli aplikacji”, a następnie nacisnąć przycisk [Dodaj pulę]. Wybór puli zostaje automatycznie ustawiony na nowoutworzonej puli . Dodana w ten sposób pula spełnia wymagania konieczne do instalacji aplikacji Comarch DMS Repozytorium.

     

    Dodawanie puli „Repozytorium”

     

    Okno „Pula aplikacji”, w którym wybrano pulę „Comarch DMS”

     

    Po wyborze puli aplikacji spełniającej wymagania należy przejść do następnego kroku instalacji , klikając przycisk [Dalej].

     

    Kreowanie aplikacji Repozytorium

    Następnie w dodanym w wersji 2024.2.0 oknie Kreowanie aplikacji Repozytorium następuje konfiguracja aplikacji dla modułu Comarch DMS Repozytorium.

     

    Uwaga

    W wersji 2024.2.2 w Comarch DMS Repozytorium wprowadzono szyfrowanie connection stringów znajdujących się w pliku appsettings.json w folderze z plikami Comarch DMS Repozytorium.

     

    Plik appsettings.json z zaszyfrowanymi connection strings

     

    W ramach okna Kreowanie aplikacji Repozytorium użytkownik:

        • w polu „Wybierz lub utwórz witrynę web” – z listy dostępnych witryn wybiera witrynę, w której ma zostać utworzona aplikacja Comarch DMS Repozytorium;

    Uwaga
    Zalecane jest, aby aplikacja Comarch DMS Repozytorium została zainstalowana na tej samej witrynie, na której znajduje się moduł Workflow (np. Default Web Site).

        • w polu „Port” – wpisuje numer portu, który przypisany jest do danej witryny;
        • w polu „Wprowadź nazwę aplikacji Repozytorium” – wpisuje nadaną przez siebie nazwę aplikacji, np. DMSRepozytorium

     

    Uwaga

    Nazwa aplikacji nie może zawierać następujących znaków specjalnych:

        • \
        • ?
        • ;
        • :
        • @
        • (spacja)
        • =
        • +
        • $
        • |
        • <
        • >
        • *

    Jeżeli użytkownik wpisze nazwę zawierającą jeden lub więcej z powyższych znaków, wówczas nowa aplikacja nie zostanie utworzona, a w dolnej części okna pojawi się informacja o zakazanych znakach specjalnych.

    W takim wypadku użytkownik powinien zmodyfikować nazwę wpisaną w polu „Nazwa aplikacji” tak, aby nie zawierała już znaków specjalnych, a później ponownie nacisnąć [Utwórz aplikację].

    Informacja o znakach zakazanych w oknie „Kreowanie aplikacji Repozytorium”

    Następnie należy kliknąć przycisk [Utwórz aplikację], aby nowa aplikacja została utworzona. Podczas tworzenia aplikacji w dolnej części okna widoczna jest informacja „Trwa kreowanie aplikacji”. Jeżeli utworzenie aplikacji przebiegło pomyślnie, wówczas wyświetlana jest informacja „Aplikacja została utworzona pomyślnie”. Przycisk [Utwórz aplikację] nie jest aktywny do czasu wybrania witryny i wpisania nazwy aplikacji przez użytkownika.

    Okno „Kreoanie aplikacji Repozytorium” po tym, jak aplikacja została utworzona

     

    Operator ma również opcję dodania nowej witryny, na której utworzy aplikację Comarch DMS Repozytorium, jednakże zaleca się, aby aplikację Comarch DMS Repozytorium zainstalować na tej samej witrynie, na której zainstalowano moduł Workflow Comarch DMS.

    Aby jednak utworzyć nową witrynę operator powinien:

        • W polu „Wybierz lub utwórz witrynę web” wpisać nazwę witryny, która ma zostać utworzona;
        • W polu „Port” wpisać numer portu, który ma zostać przypisany do nowoutworzonej witryny

     

    Okno „Kreowanie aplikacji Repozytorium” podczas dodawania nowej witryny

     

    Następnie operator powinien nacisnąć przycisk [Utwórz witrynę]. Jeśli tworzenie witryny zakończyło się powodzeniem, wówczas w dolnej części okna wyświetlany jest napis Witryna została utworzona na serwerze IIS.

    Okno „Kreowanie aplikacji Repozytorium” po pomyślnym dodaniu nowej witryny

     

    Aby przejść do kolejnego kroku instalacji należy wybrać przycisk [Dalej]. Przycisk nie jest aktywny, dopóki aplikacja nie została utworzona.

     

    Baza danych Comarch DMS Repozytorium

    Następnie w ramach okna „Baza danych Comarch DMS Repozytorium” operator powinien uzupełnić:

        • W ramach pola „Nazwa serwera” – nazwę serwera, na którym znajduje się serwer MongoDB;

    Uwaga
    Istnieje możliwość wprowadzenia w ramach pola „Nazwa serwera” IP serwera MongoDB.

        • W sekcji „Logowanie do serwera MongoDB”:
          • W ramach pola „Login” – login administratora MongoDB
          • W ramach pola „Hasło” – hasło administratora MongoDB

    Następnie należy sprawdzić poprawność wprowadzonych danych, klikając w przycisk [Połącz].

    Jeśli próba nawiązania połączenia zakończyła się powodzeniem, w dolnej części okna wyświetlony zostaje napis „Nawiązano połączenie z serwerem MongoDB”.

    Uwaga
    Dane uwierzytelniające operatora są niezbędne do przeprowadzenia procesu instalacji i są wykorzystywane wyłącznie podczas pracy instalatora.

    Okno „Baza danych Comarch DMS Repozytorium” przed uzupełnieniem pól

     

    Okno „Baza danych Comarch DMS Repozytorium” po uzupełnieniu pól i kliknięciu w przycisk „Połącz”

     

    Następnie operator powinien wybrać bazę w ramach pola „Lista baz danych” (jeśli wcześniej przygotowano bazę przeznaczoną dla Comarch DMS Repozytorium) albo nacisnąć przycisk [Dodaj bazę], aby utworzyć nową bazę danych dla aplikacji Comarch DMS Repozytorium.

    Jeżeli operator kliknął w przycisk [Dodaj bazę], wówczas zostaje otwarte okno w ramach którego należy wprowadzić nazwę nowej bazy danych Comarch DMS Repozytorium, a następnie kliknąć [Zapisz]. Jeżeli użytkownik nie chce jednak dodać nowej bazy, wtedy powinien nacisnąć przycisk [Anuluj] albo znak X.

    Okno dodawania nowej bazy Comarch DMS Repozytorium

     

    Po naciśnięciu przycisku [Zapisz] baza Comarch DMS Repozytorium zostaje dodana i w ramach instalatora wyświetla się informacja „ Baza danych została utworzona”.

    Okno „Baza danych Comarch DMS Repozytorium” po dodaniu nowej bazy

     

    Następnie operator powinien nacisnąć przycisk [Zmień hasło].

    W otwartym oknie w polu „Hasło” należy ustawić hasło dla użytkownika MongoUser serwera MongoDB, za którego pośrednictwem będzie odbywać się komunikacja aplikacji Comarch DMS Repozytorium z bazą danych. Hasło należy następnie wpisać ponownie w polu „Powtórz hasło”, a później kliknąć przycisk „Zapisz”.

    Okno zmiany hasła dla użytkownika MongoUser

     

    Hasło powinno spełniać następujące warunki:

        • Składać się z min. 12 znaków;
        • Zawierać cyfry;
        • Zawierać małe i wielkie litery;
        • Zawierać znaki specjalne.

     

    Uwaga

    Login ani hasło nie mogą zawierać następujących znaków:

    • :
    • /
    • ?
    • #
    • [
    • ]
    • @
    • !

     

    Jeżeli wpisano hasło, które nie spełnia któregoś z tych czterech wymagań, wówczas po kliknięciu przycisku [Zapisz] hasło nie zostaje zapisane i wyświetlany jest komunikat:

        • Jeśli hasło jest za krótkie

        • Brakuje warunku/warunków wymaganych dla silnego hasła (brak znaku specjalnego, brak wielkiej litery)

     

    Należy zmienić hasło, tak, aby spełniało wszystkie warunki.

    Jeśli natomiast hasło wpisane w polu „Powtórz hasło” różni się od hasła wpisanego w polu „Hasło”, wtedy po kliknięciu przycisku [Zapisz] hasło nie zostaje zapisane i wyświetlany jest komunikat:

     

    Komunikat wyświetlany, jeśli hasła nie są zgodne

     

    Należy uzupełnić pole „Powtórz hasło” tak, aby zgadzało się z polem „Hasło”.

    Kiedy pola zostały poprawnie uzupełnione, a użytkownik nacisnął przycisk [Zapisz], okno zmiany hasła dla MongoUsera zostaje zamknięte, a hasło użytkownika MongoUser zostaje zmienione. Następnie operator powinien kliknąć [Dalej].

    Okno „Baza danych Comarch DMS Repozytorium” po zmianie hasła dla użytkownika MongoUser

     

    Klucze licencji

    Po kliknięciu w przycisk [Dalej] następuje przejście do okna „Klucze licencji”. Operator powinien uzupełnić:

        • W ramach pola „Serwer klucza licencji Comarch DMS” – klucz licencji dla Comarch DMS
        • W ramach pola „Serwer klucza licencji Comarch ERP XL” – klucz licencji dla Comarch ERP XL
        • W ramach pola „Adres e-mail administratora” – adres email, który będzie widoczny w Comarch DMS w komunikatach, w których wymagany jest kontakt z administratorem

     

    Okno „Klucze licencji” przed wprowadzeniem zmian (w przypadku instalacji Comarch DMS we współpracy z Comarch ERP XL)

     

    Instalacja

    Po uzupełnieniu pól operator powinien kliknąć [Instaluj]. Następuje wówczas przejście do kolejnego okna „Instalacja”.

    Okno „Instalacja”

     

    Koniec pracy instalatora

    Po zakończeniu instalacji następuje przejście do końcowego okna instalacji aplikacji. Gdy użytkownik kliknie przycisk [Zakończ], instalator zostanie zamknięty, natomiast zostanie otwarta przeglądarka na ekranie logowania do nowej aplikacji WEB Comarch DMS, zgodnie z nazwą aplikacji, którą podano w instalatorze.

    Dalsze kroki dotyczące konfiguracji Comarch DMS Repozytorium należy wykonać w ramach aplikacji desktop Comarch DMS, a następnie w zakładce [Repozytorium] w aplikacji web Comarch DMS.

    Okno „Koniec pracy instalatora”

     

    Wskazówka
    Jeśli podczas uruchomiania aplikacji serwerowej (dawna web) pojawia się komunikat: „add name=”strConnct providerName=”System.Data.SqlClient” – sprawdź tutaj

    Jeśli podczas próby uruchomienia aplikacji serwerowej (dawna web) pojawia się komunikat ”Błąd http 500.19 – Internal Server Error’’ – sprawdź tutaj

    Rozpoczynasz pracę z Comarch DMS i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch DMS i chcesz dowiedzieć się więcej?

    Sprawdź Szkolenia Comarch DMS!




    Instalacja początkowa Comarch DMS i instalacja aplikacji serwerowej (dawnej web) w trybie ręcznym

    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:

    • Konsola zarzadzania usługami IIS
    • Narzędzia i skrypty zarządzania usługami IIS
    • Usługa zarządzania usługami IIS
    • ASP
    • Filtry ISAPI
    • Błędy HTTP
    • Dokument domyślny
    • Przeglądanie katalogów
    • Zawartość statyczna
    • Filtrowanie żądań
    • ASP .NET
    • Rozszerzalność architektury .NET

    W pobranym pliku instalacyjnym należy wejść do katalogu Comarch DMS {wersja} i  przekopiować zawartość katalogów DMS Workflow API i DMS Web do dwóch oddzielnych nowoutworzonych folderów na dysku C:\inetpub\wwwroot.

    Nazwy folderów będą zarazem nazwami aplikacji webowych uruchamianych poprzez przeglądarkę, tzn:

    • aplikacji serwerowej – dawnej aplikacji webowej – w tym przypadku jest to DMSApi;
    • aplikacji web – nowej aplikacji webowej – w tym przypadku jest to DMSWeb

    Uwaga

    Lokalnemu użytkownikowi IUSR należy nadać uprawnienie do katalogów DMSApi i DMSWeb.

     

    Nadawanie uprawnień do katalogu DMSApi lokalnemu użytkownikowi IUSR

    Nadawanie uprawnień do katalogu DMSWeb lokalnemu użytkownikowi IUSR

     

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

    Okno Menadżer internetowych usług informatycznych (IIS)

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

    Okno Ograniczenia ISAPI i CGI

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

    Wybór puli dla 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”.

    Okno „Dodawanie puli aplikacji”

    Dla wybranej puli należy skonfigurować ustawienia zaawansowane.

    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 tak, jak poniżej.

    Ustawienia zaawansowane – wzór

    Następnie należy skonwertować katalogi DMSApi (katalog, do którego skopiowano pliki z folderu DMS Workflow Api z pakietu instalacyjnego)  i DMSWeb (katalog, do którego skopiowano pliki z folderu DMS Web z pakietu instalacyjnego) na aplikacje i przypisać do nich utworzoną pulę.

    Konwertowanie katalogu DMSApi na aplikację

     

    Konwertowanie katalogu DMSWeb na aplikację

     

    Uwaga
    Zalecana jest instalacja Comarch DMS jako aplikacji w witrynie (np. w witrynie Default Web Site) , a nie jako odrębne witryny.

     

    Okno dodawania aplikacji DMSApi

    Okno dodawania aplikacji DMSWeb

    Przygotowanie baz danych

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

    Aplikacja może pracować na dwóch odrębnych bazach danych (baza Comarch DMS i baza ERP XL) lub na jednej wspólnej bazie (baza ERP XL). Poniżej został przedstawiony przykład instalacji z wykorzystaniem dwóch baz.

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

    Pojawi się okno, w którym należy podać nazwę bazy danych.

    Tworzenie bazy w Microsoft SQL Serwer Management Studio

    Konfiguracja pliku web.config

    Uwaga
    Comarch DMS może pracować w trybie jednofirmowym lub wielofirmowym. Niektóre ustawienia pliku Web.config w trybie wielofirmowym są nieużywane i nie ma potrzeby ich definiowania. Tryb pracy (jedno/wielofirmowy) ustawiany jest w kluczu <add key=”MultiCompany” value=”” />.

    W pliku konfiguracyjnym Web.config znajdującym się w katalogu C:\inetpub\wwwroot\{nazwa aplikacji serwerowej} 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.

    Uwaga
    Od wersji 2024.0.0 instalator szyfruje connection strings w pliku Web.config w katalogu aplikacji serwerowej (dawnej web).

    Ustawienia kluczy używane w obu trybach:

    • <add key=”Version” value=”5048495746514648″ /> – parametr określający numer wersji Comarch DMS.
    • <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 DMS” /> – 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ć po 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.

     

    Rejestracja użytkownika w DMS z poziomu aplikacji web, gdy parametr „TaxPayerIdRequired” value=”false” />, „PersonalDataProcessingConsentRequired” value=”true” /> i parametr „WorkingConditionsAcceptanceRequired” value=”true”

    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=”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=”ACDFolderPathsDestination” value=”Registry” /> – parametr dostępny od wersji 2023.1.0; umożliwia wybór miejsca zapisu ścieżek punktów ACD. Klucz może przyjmować wartości:
            • Registry – wartość domyślna, oznaczająca, że ścieżki punktów ACD będą zapisywane w rejestrze (jak dotychczas)  .
            • Database– wartość oznaczająca, że ścieżki punktów ACD będą zapisywane w bazie danych w tabeli do.DF_ConfAPFolderPaths

    Uwaga
    Jeśli użytkownik pierwszy raz zmienia wartość klucza na „Database”, wówczas przy pierwszym ładowaniu widoku punktów ACD wszystkie dane z rejestru zapisują się do bazy.  Natomiast przy zmianie wartości z „Database” na „Registry” dane z bazy nie są automatycznie przepisywane do rejestru.

    • <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=”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 = „MailSendingInterval” value=”1” /> – parametr, w którym operator określa, jak często baza danych będzie sprawdzać, czy są nowe maile (w minutach)
    • <add key = „DeleteMailsAfterSending” value=”False” /> – od wersji 2022.0.3 parametr, w którym operator określa, czy wiadomości email po wysłaniu powinny być usuwane czy zachowywane w tabelach. Klucz może przyjmować wartości:
            • „False” – wartość oznaczająca, że zarówno maile, jak I załączniki zostaną zarchiwizowane w tabelach po wysłaniu
            • „True” – wartość oznaczająca, że zarówno maile, jak i załączniki zostaną usunięte po wysłaniu
    • <add key=„NotAllowedFileExtensionsDM” value=”” /> – parametr, w ramach którego można wpisać rozszerzenia plików, które mają być zabronione przy dodawaniu nowych dokumentów do Managera Dokumentów. Domyślnie wartość klucza jest pusta – jeśli nie zostanie uzupełniona przez administratora, możliwe będzie dodawanie plików z każdym rodzajem rozszerzenia.
    • <!– <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.

     

    • <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=”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=”Comarch2FAUri” value=”https://ws.erp.comarch.pl/services/” /> – adres usługi 2FA z Comarch ERP Optima.
    • add key=”KSeFWorkMode” value=”Demo” /> – klucz wprowadzony w wersji 2024.0.1; umozliwia określenie, czy Firma testuje funkcjonalność wysyłania faktur do KSeF, czy korzysta z niej produkcyjnie. Klucz może przybierać jedną z następujących wartości:
    1.Demo – wartość domyślna; w przypadku wprowadzenia takiej wartości praca z systemem KSeF odbywa się w trybie Demo;
    2.Production – w przypadku wprowadzenia takiej wartości praca z systemem KSeF odbywa się w trybie Produkcyjnym, czyli wersji produkcyjnej systemu;
    3.Test – w przypadku wprowadzenia takiej wartości praca z systemem KSeF odbywa się w trybie testowym.
    W kwestii różnic pomiędzy powyższymi trybami zob. Przełączanie trybu pracy z KSeF
    • <add key=„EDorAuthApiUrl” value=”https://ow.edoreczenia.gov.pl/auth/realms/EDOR” /> – klucz dodany w wersji 2024.1.0 związany z integracją z usługą e-Doręczenia; w kluczu znajduje się adres potrzebny do uzyskania tokenu dostępowego do API Search Engine i User Agent;
    • <add key=„EDorUserAgentApiUrl” value=”https://uaapi-ow.poczta-polska.pl/api/v2″ /> – klucz dodany w wersji 2024.1.0 związany z integracją z usługą e-Doręczenia; w ramach klucza określony jest endpoint dla API Search Engine;
    • <add key=„EDorSearchApiUrl” value=”https://ow.edoreczenia.gov.pl/api/se/v2″ /> – klucz dodany w wersji 2024.1.0 związany z integracją z usługą e-Doręczenia; w ramach klucza określony jest endpoint dla API User Agent;
    • <add key=„EDorMaxMessageSize” value=”15″ /> – klucz dodany w wersji 2024.1.0 związany z integracją z usługą e-Doręczenia; w ramach klucza określony jest maksymalny dopuszczalny rozmiar załączników, które są przesyłane w ramach usługi E-Doręczenia. Aktualnie wartość ta wynosi 15 MB. Klucz nieaktywny w pierwszej wersji funkcjonalności;
    • <add key=„ChatERPUrl” value=”https://chat.aiml.comarch.com/api/v2″ /> – klucz dodany w wersji 2024.3.0; w ramach klucza znajduje się adres URL usługi Chat ERP;
    • <add key=„ChatERPApiKeyEncrypted” value=”zaszyfrowany klucz API”/> – klucz dodany w wersji 2024.3.0; w ramach klucza znajduje się zaszyfrowany klucz API – jest to stała wartość, której nie należy edytować;
    • <!– <add key=”ERPSQLServer1” value=”.” /> –> – klucz wymagany przy współpracy z Comarch ERP XL w trybie chmurowym (należy odkomentować). Należy zdefiniować serwer dla bazy ERP XL.
    • <!– <add key=”ERPSQLServer2” value=”.” /> –> – jeżeli ERP XL w trybie chmurowym pracuje na więcej niż jednym serwerze, należy odkomentować i uzupełnić.
    • <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=”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=”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=„WebClientUrl” value=”http://<ip serwera>/DocumentWorkflow.Web” /> – wprowadzony w wersji 2024.0.0; klucz, w którym (w przypadku korzystania z funkcjonalności Comarch DMS Repozytorium) należy wprowadzić adres aplikacji nowego klienta web,
      np. http://localhost/ DocumentWorkflow.Web (w wersjach starszych niż 2024.0.0 w tym miejscu znajduje się klucz <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).
    • <add key=”PerformanceAnalysisTimeRange” value=”1000,5000″ /> – klucz dostępny od wersji 2024.0.0; umożliwia zmianę zakresów czasowych  informacji prezentowanych na zakładce „Analiza wydajności” w sekcji „Statystyki”
    • <add key=”MaxLoginAttempts” value=”5″/> – klucz dostępny od wersji 2024.1.1; w ramach tego klucza należy podać, jaka ma być maksymalna liczba prób logowania dla operatora zanim nastąpi zablokowanie logowania – domyślna wartość to 5 (zob. Blokowanie logowania po kilku nieudanych próbach)
    • <add key=”LoginBlockTime” value=”60″/> – klucz dostępny od wersji 2024.1.1; w ramach tego klucza należy podać, po jakim czasie (liczonym w sekundach) operator będzie mógł podjąć kolejną próbę logowania, po tym, jak logowanie zostało zablokowane – domyślna wartość to 60 (zob. Blokowanie logowania po kilku nieudanych próbach)

     

    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=”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=”ERPSQLServer1” value=”.” /> –> – klucz wymagany przy współpracy z Comarch ERP XL w trybie chmurowym (należy odkomentować). Należy zdefiniować serwer dla bazy ERP XL.
    • <!– <add key=”ERPSQLServer2” value=”.” /> –> – jeżeli ERP XL w trybie chmurowym pracuje na więcej niż jednym serwerze, należy odkomentować i uzupełnić.

     

    Uruchamianie skryptów

    Następnie należy uruchomić skrypty na bazie Comarch DMS oraz na bazie Comarch ERP XL.

    Uruchamianie skryptów na bazie Comarch DMS

    W katalogu DMS Workflow Api znajduje się plik Install.bat, który służy do instalacji skryptów na bazie Comarch DMS.

    Lokalizacja pliku:

    katalog z plikami instalacyjnymi \ Comarch DMS {wersja} \ DMS Workflow Api \ Sql \ Install.bat

    Aby uruchomić skrypty, należy postępować w jeden z następujących sposobów:

     

    Przyklad

    Sposób 1

    Należy uruchomić wiersz polecenia, wpisując cmd w wyszukiwarce w menu „Start” i wybierając opcję „Uruchom jako administrator”.

    Otwieranie wiersza polecenia

     

    Następnie należy wpisać cd, nacisnąć spację i podać ścieżkę do lokalizacji pliku Install.bat – np. C:\inetpub\wwwroot\DMSApi\Sql – a następnie nacisnąć Enter.

    Później należy uruchomić plik z linii poleceń wpisując:

    Install.bat <nazwa_serwera> <nazwa_bazy_Comarch_DMS>

    a następnie klikając Enter – wówczas zostaną uruchomione skrypty.

     

    Przykładowy wiersz polecenia do instalacji skryptów na bazie Comarch DMS

     

    Po wykonaniu skryptów należy zamknąć okno Wiersza polecenia.

     

    Przyklad

    Sposób 2

    W katalogu DMSApi\Sql należy odnaleźć plik Install.bat i otworzyć go do edycji.

     

    Wybór pliku „Install.bat” do edycji

     

    Następnie w ramach okna edytora należy uzupełnić dane w następujący sposób:

    set SERVER=nazwa_serwera

    SHIFT

    set DATABASE=nazwa_bazy_Comarch_DMS

    a następnie zapisać zmiany i zamknąć okno.

     

    Plik „Install.bat” po uzupełnieniu danych i zapisaniu pliku

     

    Uwaga

    W wersji 2024.0.2 w pliku Install.bat został dodany dodatkowy argument ODUSERPASSWORD, w którym należy uzupełnić hasło dla ODUsera w przypadku instalacji ręcznej aplikacji Comarch DMS, jeśli aplikacja Comarch DMS jest instalowana po raz pierwszy i użytkownik ODUser nie istnieje w MSSQL.

    Hasło dla użytkownika ODUser musi być zgodne z polityką haseł.
    Należy używać silnego hasła, które spełnia wszystkie poniższe warunki:

    • składa się z minimum 12 znaków;
    • zawiera znaki alfabetyczne;
    • zawiera znaki specjalne ze zbioru !@#$%^*()

     

    Parametr ODUSERPASSWORD w pliku Install.bat – przykład

     

    Później należy kliknąć prawym przyciskiem myszki na plik Install.bat i wybrać opcję „Uruchom jako administrator”. Wówczas, po wyrażeniu zgody na dokonanie zmian przez Windows Command Processor, zostaną uruchomione skrypty. Po wykonaniu skryptów okno zostanie automatycznie zamknięte.

     

    Wybór opcji „Uruchom jako administrator”

     

    Uruchamianie skryptów na bazie Comarch ERP XL

    Analogiczny scenariusz należy wykonać dla katalogu Workflow Api \ SqlXL w tej samej lokalizacji, z tą różnicą, że zamiast nazwy bazy danych Comarch DMS należy podać nazwę bazy Comarch ERP XL, a zamiast Install.bat – InstallXL.bat.

    Lokalizacja pliku:

    katalog z plikami instalacyjnymi \ Comarch DMS {wersja} \ DMS Workflow Api \ SqlXL \ InstallXL.bat

    Aby uruchomić skrypty, należy postępować w jeden z następujących sposobów:

    Sposób 1

    Należy uruchomić wiersz polecenia, wpisując cmd w wyszukiwarce w menu „Start” i wybierając opcję „Uruchom jako administrator”.

     

    Otwieranie wiersza polecenia

     

    Następnie należy wpisać cd, nacisnąć spację i podać ścieżkę do lokalizacji pliku InstallXL.bat – np. C:\inetpub\wwwroot\DMSApi\SqlXL – a następnie nacisnąć Enter.

    Później należy uruchomić plik z linii poleceń wpisując:

    InstallXL.bat <nazwa_serwera> <nazwa_bazy_Comarch_ERP_XL>

    a następnie klikając Enter – wówczas zostaną uruchomione skrypty na bazie Comarch ERP XL.

     

    Przykładowy wiersz polecenia do instalacji skryptów na bazie Comarch ERP XL

     

    Po wykonaniu skryptów należy zamknąć okno Wiersza polecenia.

     

    Sposób 2

    W katalogu DMS Workflow Api\SqlXL należy odnaleźć plik InstallXL.bat i otworzyć go do edycji.

     

    Wybór pliku „InstallXL.bat” do edycji

     

    Następnie w ramach okna edytora należy uzupełnić dane w następujący sposób:

    set SERVER=nazwa_serwera

    SHIFT

    set DATABASE=nazwa_bazy _Comarch_ERP_XL

    a następnie zapisać zmiany i zamknąć okno.

     

    Plik „InstallXL.bat” po uzupełnieniu danych i zapisaniu pliku

     

    Uwaga

    W wersji 2024.0.2 w pliku InstallXL.bat został dodany dodatkowy argument ODUSERPASSWORD, w którym należy uzupełnić hasło dla ODUsera w przypadku instalacji ręcznej aplikacji Comarch DMS, jeśli aplikacja Comarch DMS jest instalowana po raz pierwszy i użytkownik ODUser nie istnieje w MSSQL.

    Hasło dla użytkownika ODUser musi być zgodne z polityką haseł.
    Należy używać silnego hasła, które spełnia wszystkie poniższe warunki:

    • składa się z minimum 12 znaków;
    • zawiera znaki alfabetyczne;
    • zawiera znaki specjalne ze zbioru !@#$%^*()

     

    Parametr ODUSERPASSWORD w pliku InstallXL.bat – przykład

     

    Później należy kliknąć prawym przyciskiem myszki na plik InstallXL.bat i wybrać opcję „Uruchom jako administrator”. Wówczas, po wyrażeniu zgody na dokonanie zmian przez Windows Command Processor, zostaną uruchomione skrypty. Po wykonaniu skryptów okno zostanie automatycznie zamknięte.

     

    Wybór opcji „Uruchom jako administrator”

     

    Uwaga
    Skrypty na bazie Comarch DMS oraz bazie Comarch ERP XL mogą być uruchamiane wielokrotnie.

     

    Reindeksacja bazy

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

                • Zreindeksowanie tabel schematu DO,
                • Odbudowę statystyk,
                • Rekompilacje procedur i funkcji schematu DO.

    Aby reindeksować bazę, należy uruchomić wiersz polecenia, wpisując cmd w wyszukiwarce w menu „Start” i wybierając opcję „Uruchom jako administrator”.

     

    Otwieranie wiersza polecenia

    Następnie należy wpisać cd, nacisnąć spację i podać ścieżkę do lokalizacji pliku reindex.bat – np. C:\inetpub\wwwroot\dms202311\Sql – a następnie nacisnąć Enter.

    Póżniej należy uruchomić plik z linii poleceń wpisując:

    reindex.bat <nazwa_serwera> <nazwa_bazy_Comarch_DMS>

     

    a następnie klikając Enter – wówczas zostanie uruchomiona reindeksacja bazy Comarch DMS.

    Po wykonaniu reindeksacji należy kliknąć dowolny przycisk, a później zamknąć okno Wiersza polecenia.

     

    Przykładowy wiersz polecenia do reindeksacji bazy Comarch DMS

     

    Wskazówka
    Zalecana jest reindeksacja bazy przy aktualizacji aplikacji Comarch DMS.

     

    Weryfikacja poprawności konfiguracji aplikacji serwerowej

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

    Okno logowania do aplikacji serwerowej

    Wskazówka
    Jeśli podczas uruchomiania aplikacji serwerowej (dawna web) pojawia się komunikat: „add name=”strConnct providerName=”System.Data.SqlClient” – sprawdź tutaj

    Jeśli podczas próby uruchomienia aplikacji serwerowej (dawna web) pojawia się komunikat ”Błąd http 500.19 – Internal Server Error’’ – sprawdź tutaj

     

    W celu konfiguracji aplikacji WEB należy przejść do artykułu Ręczna konfiguracja aplikacji WEB (nowej aplikacji web)

     

    Rozpoczynasz pracę z Comarch DMS i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch DMS i chcesz dowiedzieć się więcej?

    Sprawdź Szkolenia Comarch DMS!




    Ręczna konfiguracja aplikacji WEB (nowej aplikacji web)

    Po wykonaniu początkowych kroków instalacji Comarch DMS oraz po instalacji aplikacji serwerowej (zob. artykuł Instalacja początkowa Comarch DMS i instalacja aplikacji serwerowej (dawnej web) w trybie ręcznym dla: Comarch DMS Standalone , Comarch DMS we współpracy z Comarch ERP XL, Comarch DMS we współpracy z Comarch ERP Optima, Comarch DMS we współpracy z Comarch ERP Enterprise) należy przystąpić do konfiguracji aplikacji WEB

    Uwaga

    Dla poprawnego działania aplikacji WEB należy zainstalować następujące dodatki do serwera IIS:

    Po pobraniu i instalacji Application Request Routing należy kolejno:

    1. w ramach Menedżera Internetowych usług Internetowych  kliknąć na ikonę „Application Request Routing Cache”

    2. w ramach paneluAkcje” po prawej stronie ekranu nacisnąć link „Otwórz funkcje”.

     

    Wybór ikony „Application Request Routing Cache”  i przycisku „Otwórz funkcje”

     

    3.  zaznaczyć parametr „Enable proxy” w ramach zakładki „Application Request Routing” i potwierdzić zmianę przyciskiem „Zastosuj”.

     

    Włączanie proxy w ustawieniach „Application Request Routing” na serwerze IIS

     

    Aby skonfigurować aplikację kliencką (WEB), administrator powinien:

    1. W ramach katalogu zawierającego aplikację web (nową aplikację webową) otworzyć do edycji plik index.html i uzupełnić nazwę aplikacji web (nowej aplikacji webowej) w ramach klucza „base href”, przykładowo:

    <base href=”/DMSWeb/”>

    a następnie zapisać wprowadzone zmiany;

     

    Uzupełnianie klucza base href w pliku index.html

     

    2. W ramach katalogu zawierającego aplikację web (nową aplikację webową) otworzyć do edycji plik web.config i uzupełnić:

      • W ramach „WorkflowApi” zamiast [applicationHost] nazwę serwera, na którym znajduje się aplikacja serwerowa (starsza aplikacja web) i zamiast DocumentWorkflow.Apinazwę aplikacji serwerowej (starszej aplikacji web)
      • W ramach „WorkflowDashboards” (dodane w wersji 2024.1.1) zamiast [applicationHost] nazwę serwera, na którym znajduje się aplikacja serwerowa (starsza aplikacja web) i zamiast DocumentWorkflow.Apinazwę aplikacji serwerowej (starszej aplikacji web)
      • W ramach „WorkflowWebsockets” zamiast [applicationHost] nazwę serwera, na którym znajduje się aplikacja serwerowa (starsza aplikacja web) i zamiast DocumentWorkflow.Apinazwę aplikacji serwerowej (starszej aplikacji web)

    a następnie zapisać wprowadzone zmiany.

     

    Przyklad

    <rule name=”WorkflowApi” stopProcessing=”true”>
    <match url=”^api/(.*)” />
    <action type=”Rewrite” url=”http://localhost/DMSApi/api/v3/{R:1}”
    logRewrittenUrl=”true” />
    </rule>
    <rule name=”WorkflowDashboards” stopProcessing=”true”>
    <match url=”^dashboards/(.*)” />
    <action type=”Rewrite”
    url=”http://localhost/DMSApi/reports/{R:1}”
    logRewrittenUrl=”true” />
    </rule>
    <rule name=”WorkflowWebsockets” stopProcessing=”true”>
    <match url=”^hubs/(.*)” />
    <action type=”Rewrite” url=”http://localhost/DMSApi/signalr/{R:1}”
    logRewrittenUrl=”true” />
    </rule>

     

    Uzupełnianie pliku web.config w aplikacji web Comarch DMS

     

    Rozpoczynasz pracę z Comarch DMS i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch DMS i chcesz dowiedzieć się więcej?

    Sprawdź Szkolenia Comarch DMS!