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 zarządzania 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 katalogu DMSApi.

Nadawanie uprawnień do katalogu DMSApi 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”.

Opis: C:\Users\Konrad.Nowak\Pictures\INTSLACJA OD\insta1.png
Okno Menadżer internetowych usług informatycznych (IIS)

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

Opis: C:\Users\Konrad.Nowak\Pictures\INTSLACJA OD\insta2.png
Okno Ograniczenia ISAPI i CGI

W kolejnym kroku należy dodać/wybrać pule aplikacji, na których będą uruchamiane aplikacje Comarch DMS. Nowe pule aplikacji dodajemy klikając prawym przyciskiem myszy na kategorię „Pule aplikacji”.

Uwaga
Od wersji 2025.0.0 dla aplikacji serwerowej i dla aplikacji WEB wymagane jest skonfigurowanie osobnych pul aplikacji

Opis: C:\Users\Konrad.Nowak\Pictures\INTSLACJA OD\inst1.png
Wybór puli dla aplikacji

Pojawi się okno dodawania puli aplikacji. Należy wpisać w nim nazwę puli dla aplikacji serwerowej, np. „DMSapi” i wybrać wersję .NetFramework 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 aplikacji serwerowej

 

Następnie w kolejnym oknie dodawania puli należy wpisać nazwę puli dla aplikacji WEB, np. „DMSweb” 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 aplikacji WEB

 

Dla wybranych pul należy skonfigurować ustawienia zaawansowane.

Ustawienia zaawansowane

Pojawi się okno, w którym w przypadku każdej puli należy ustawić opcję „Włącz aplikacje 32-bitowe” jako False, natomiast jako „Tożsamość” należy ustawić „ApplicationPoolIdentity”, a następnie sprawdzić czy pozostałe parametry zostały ustawione 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ę (lub, od wersji 2025.0.0, utworzone pule).

 

Konwertowanie katalogu DMSApi na aplikację

 

Konwertowanie katalogu DMSWeb na aplikację

 

Uwaga
Konieczne jest, aby aplikacje: serwerowa i web znajdowały się na tej samej witrynie.

 

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

 

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 bazy dla Comarch ERP Optima.

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

Aby stworzyć 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.

Uwaga

Od wersji 2024.0.2 możliwe jest wskazanie identyfikatora connection stringa, aby określić  connection string, na podstawie którego będzie następowało połączenie do bazy danych. Jeżeli:

  • <add key=”MultiCompany” value=”false” /> – wówczas connection stringi strConnectERPComp i strConnectERPConf1 są przechowywane w pliku Web.config
  • <add key=”MultiCompany” value=”true” /> – wówczas connection stringi są przechowywane  w pliku Web.config i w tabeli do.DF_ConfCMDictionary – w tym przypadku connection stringi do baz: konfiguracyjnej i firmowej są zapisywane pod jednym ID połączenia, zastosowano zatem nastepujące identyfikatory:
    • nazwa_spółki_Comp – pobiera connection string zapisany w kolumnie CMD_ConnectionStringERP / CMD_ConnectionStringERPEncrypted
    • nazwa_spółki_Conf – pobiera connection string zapisany w kolumnie CMD_ConnectionStringERPConf / CMD_ConnectionStringERPConfEncrypted

 

gdzie nazwa_spółki – wartość wprowadzona w polu „Nazwa spólki” / „Nazwa spółki (baza)” na zakładce  „Połączenia z ERP” na zakładce [Ustawienia]

 

Wartość wprowadzona w polu „Nazwa spółki (baza)”, która wchodzi w skład identyfikatorów connection stringów

 

Przykład wykorzystania identyfikatorów connection stringów dla bazy Comarch ERP Optima w ramach kontrolki typu Własna akcja

 

Identyfikatory connection stringów są wykorzystywane w kodzie C#:

    • dla MS SQL:
      • connection = new DmsSqlConnection(Globals.Common.ConnectionStrings.strConnectDMS)
      • DmsSqlCommand command = new DmsSqlCommand(connection, sqlQuery)
    • dla PostgreSQL:
      • connection = new DmsNpgsqlConnection(„pgStrConnectDMS”)
      • DmsNpgsqlCommand command = new DmsNpgsqlCommand(connection, sqlQuery)

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=„DefaultAppMarket” value=”PL” /> – parametr dodany w wersji 2025.0.0; od tego parametru jest zależna nazwa systemu wyświetlana w aplikacjach (zob. Zmiana nazwy systemu w zależności od rynku, na którym będzie sprzedawany ). Parametr może przyjmować następujące wartości:
    • ”PL” – w takim przypadku produkt jest dedykowany na rynek polski – w systemie wyświetlane są nazwy „Comarch DMS” i „Repozytorium”
    • ”Other” – w takim przypadku produkt jest dedykowany na rynki inne niż polski – w systemie wyświetlane są nazwy „Comarch BPM” i „Archive”
  • <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.

Uwaga
W wersji 2024.3.1 klucz ACDFolderPathsDestination został usunięty z pliku web.config –  od tej wersji włącznie ścieżki punktów ACD są zapisywane w bazie danych.

  • <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=”Comarch OCR Uri” /> – 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=”Comarch 2FA Uri” /> – 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;

Uwaga

W przypadku korzystania ze środowiska testowego dla usługi e-Doręczenia należy zmodyfikować wartości kluczy, które dotyczą e-Doręczeń, jak na poniższej ilustracji:

  • <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=”Chat ERP URL” /> – 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)
  • <add key=„LegacyDocumentManagerAccess” value=”false” /> – klucz dostępny od wersji 2025.1.0;umożliwia dostęp do Menadżera dokumentów w aplikacji serwerowej pomimo braku możliwości pracy w aplikacji serwerowej. Klucz może przyjmować wartości:
    • False – wartość domyślna; w takim przypadku Menadżer dokumentów w aplikacji serwerowej nie jest dostępny, a po przejściu do adresu aplikacji serwerowej wyświetlany jest komunikat „Ta wersja aplikacji Comarch DMS Web nie jest już dostępna” (zob. Dodanie komunikatu informującego o tym, że dawna wersja aplikacji web jest niedostępna );
    • True – jeśli w ramach klucza wprowadzono taką wartość, wówczas Menadżer dokumentów w aplikacji serwerowej jest dostępny, a po przejściu do adresu aplikacji serwerowej operator może się zalogować – zostanie wówczas otwarte okno, w ramach którego dostępna jest jedynie zakładka „Manager dokumentów”
  • <add key="UseNewModeOfDocumentPermissions" value="false" /> - klucz dodany do pliku Web.config w wersji 2024.3.0 (od wersji 2024.2.0 możliwe jest samodzielne dopisanie go w ramach plliku); domyślna wartość to "false" - wówczas aplikacja korzysta ze starego mechanizmu uprawnień do dokumentów; jeżeli operator zmieni wartośc na "true", wówczas zostaje włączony nowy mechanizm uprawnień do dokumentów (zob. Nowy mechanizm uprawnień do dokumentów)

 

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 bazach: konfiguracyjnej  i firmowej Comarch ERP Optima.

Uruchamianie skryptów na bazie Comarch DMS

W katalogu DMS Workflow Api\Sql 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>

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 DMS Workflow Api\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 bazach konfiguracyjnej i firmowej Comarch ERP Optima

Analogiczny scenariusz należy wykonać dla katalogu DMS Workflow Api\ SqlOptima w tej samej lokalizacji.

Lokalizacja plików:

  • Dla bazy konfiguracyjnej Comarch ERP Optima:

 

katalog z plikami instalacyjnymi \ Comarch DMS {wersja} \ DMS Workflow Api \ SqlOptima \ InstallOptimaConf.bat

 

  • Dla każdej z baz firmowych Comarch ERP Optima (osobno):

 

katalog z plikami instalacyjnymi \ Comarch DMS {wersja} \ DMS Workflow Api \ SqlOptima \ InstallOptimaComp.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 InstallOptimaConf.bat - np. C:\inetpub\wwwroot\DMS Web\SqlOptima – a następnie nacisnąć Enter.

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

InstallOptimaConf.bat <nazwa_serwera> <nazwa_bazy_konfiguracyjnej_Comarch_ERP_Optima>

 

a następnie klikając Enter - wówczas zostaną uruchomione skrypty na bazie konfiguracyjnej Comarch ERP Optima.

 

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

 

Po wykonaniu skryptów w ramach tego samego okna należy wpisać następującą linię polecenia:

InstallOptimaComp.bat <nazwa_serwera> <nazwa_bazy_firmowej_Comarch_ERP_Optima>

 

a następnie kliknąć Enter - wówczas zostaną uruchomione skrypty na danej bazie firmowej Comarch ERP Optima.

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

 

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

 

Przyklad

Sposób 2

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

 

Wybór pliku „InstallOptimaConf.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_konfiguracyjnej_Comarch_ERP_Optima

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

 

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

 

Uwaga

W wersji 2024.0.2 w pliku InstallOptimaConf.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 InstallOptimaConf.bat – przykład

 

Później należy kliknąć prawym przyciskiem myszki na plik InstallOptimaConf.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”

 

Następnie w tym samym katalogu DMS Workflow Api\SqlOptima należy odnaleźć plik InstallOptimaComp.bat i otworzyć go do edycji.

 

Wybór pliku „InstallOptimaComp.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_firmowej_Comarch_ERP_Optima

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

 

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

 

 

Uwaga

W wersji 2024.0.2 w pliku InstallOptimaComp.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 InstallOptimaComp.bat – przykład

 

Później należy kliknąć prawym przyciskiem myszki na plik InstallOptimaComp.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”

 

Reindeksacja bazy

W katalogu DMS Workflow Api \ 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

 

Od wersji 2025.1.0 wsparcie dla starej wersji aplikacji web zostało zakończone – z tego powodu w przypadku, jeśli użytkownik próbuje uruchomić adres aplikacji serwerowej (dawnej web) w przeglądarce, wówczas zostanie wyświetlone okno z informacją Ta wersja aplikacji Comarch DMS Web nie jest już dostępna. Aby korzystać z aplikacji Comarch DMS Web oraz wszystkich jej funkcji, pobierz najnowszą wersję. Klikając w poniższy przycisk, zostaniesz przekierowany do strony nowej aplikacji Web.

Uwaga
Komunikat nie jest wyświetlany jeśli w pliku Web.config w folderze z plikami aplikacji serwerowej <add key="LegacyDocumentManagerAccess" value="true" /> (zob. Dodanie klucza "LegacyDocumentManagerAccess" – umożliwienie dostępu do Menadżera dokumentów z aplikacji serwerowej) .

 

Okno „Ta wersja aplikacji Comarch DMS Web nie jest już dostępna”

 

Po kliknięciu w przycisk [Nowa aplikacja] operator zostaje przeniesiony na odpowiednią stronę nowej aplikacji Web.

Komunikat zostaje wyświetlony w języku używanym aktualnie przez przeglądarkę; jeśli dany język nie jest obsługiwany, wówczas komunikat wyświetla się w języku angielskim.

 

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)




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

 

Jeśli aplikacja ma współpracować z Comarch DMS Repozytorium, wówczas należy również uzupełnić:

    • W ramach „RepositoryApi” zamiast [applicationHost] nazwę serwera, na którym znajduje się aplikacja Repozytorium i zamiast DocumentManager.WebApi – nazwę aplikacji Repozytorium
    • W ramach „RepositoryWebsockets” zamiast [applicationHost] nazwę serwera, na którym znajduje się aplikacja Repozytorium i zamiast DocumentManager.WebApinazwę aplikacji Repozytorium

a następnie zapisać wprowadzone zmiany.

 

Przyklad

<rule name=”RepositoryApi” stopProcessing=”true”>
<match url=”^api/repository/(.*)” />
<action type=”Rewrite” url=”http://localhost/repozytorium/api/{R:1}”
logRewrittenUrl=”true” />
</rule>
<rule name=”RepositoryWebsockets” stopProcessing=”true”>
<match url=”^hubs/repository/(.*)” />
<action type=”Rewrite” url=”http://localhost/repozytorium/hubs/{R:1}”
logRewrittenUrl=”true” />
</rule>

 

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!




Weryfikacja poprawności konfiguracji aplikacji web (nowej aplikacji web)

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

 

Okno do logowania w aplikacji web Comarch DMS




Instalacja aplikacji stacjonarnej za pomocą instalatora

Od wersji Comarch DMS 2022.0 istnieje możliwość instalacji aplikacji stacjonarnej za pomocą instalatora.

 

Uwaga
Podczas instalacji za pomocą Instalatora (Instalator Comarch DMS.exe) potrzebny jest dostęp do Internetu.

 

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

 

Uwaga
Od wersji 2023.0.0 w ramach pakietu instalacyjnego nie jest dostępny instalator aplikacji web dla Comarch DMS we współpracy z Comarch ERP Altum.

 

Uwaga
W wersji 2024.1.0 wprowadzono instalację komponentu WebView 2 podczas instalacji aplikacji desktop. W przypadku ręcznej instalacji aplikacji desktop operator może pobrać komponent pod adresem https://developer.microsoft.com/en-us/microsoft-edge/webview2/?form=MA13LH#download-section

 

Od wersji 2023.0.0 przejście do instalatora Comarch DMS Desktop następuje z poziomu nowego instalatora Comarch DMS (zob. Nowy instalator Comarch DMS Web). W tym celu należy ponownie uruchomić instalator Comarch DMS, przejść początkowe kroki analogicznie do instalacji aplikacji web i w oknie „Wybór aplikacji” wybrać opcję Instalacja aplikacji Comarch DMS Desktop, a następnie przycisk [Dalej].

 

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

 

Okno przygotowania komponentów

 

Ekran powitalny instalatora  Comarch DMS

 

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

 

Po przejściu do kolejnego okna należy nacisnąć przycisk [Instaluj] – wówczas zostanie otwarte okno instalatora aplikacji Comarch DMS Desktop, w którym należy postępować zgodnie z dalszą częścią instrukcji.

 

Okno instalatora Comarch DMS, z którego można przejść do instalacji aplikacji desktop Comarch DMS

 

Instalator aplikacji desktopowej umożliwia:

  • pierwszą instalację
  • ponowną instalację

 

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

 

Okno początkowe instalatora aplikacji desktopowej

 

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

Akceptacja warunków korzystania z oprogramowania Comarch DMS

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

Wybór folderu docelowego do instalacji Comarch DMS

W kolejnym kroku należy wprowadzić adres URL aplikacji serwerowej (starszej aplikacji web) Comarch DMS.

Wprowadzanie adresu URL aplikacji serwerowej

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

Sprawdzanie adresu URL aplikacji serwerowej

Adres URL aplikacji serwerowej w przeglądarce

Następnie konieczne jest sprawdzenie poprawności połączenia za pomocą przycisku „Sprawdź połączenie”. Jeżeli wpisano poprawny adres URL, pod przyciskiem powinna pojawić się informacja „Wprowadzony adres URL jest prawidłowy”.

Wprowadzanie adresu URL aplikacji serwerowej- sprawdzanie poprawności adresu

 

Po wprowadzeniu  adresu URL i jego pozytywnej weryfikacji można przejść do zakładki „Ustawienia zaawansowane cz. 1”. W ramach tej zakładki operator może dokonać zmiany domyślnych ustawień, dostępnych w pliku DMS.exe.config w katalogu z plikami aplikacji stacjonarnej.

Zakładka „Ustawienia zaawansowane cz.1”

W ramach zakładki dostępne są następujące ustawienia:

Systemowe paski przewijania –  odpowiada kluczowi <add key=”SystemScrollbars” value=”false” /> w pliku DMS.exe.config – decyduje o tym, czy w aplikacji desktop wyświetlane są paski przewijania o domyślnym systemowym wyglądzie (zaznaczony checkbox) czy ostylowane przez Comarch DMS (odznaczony checkbox”);

Liczba dokumentów prezentowanych na jednej stronie – odpowiada kluczowi <add key=”DocumentListRowsCount” value=”50″ /> w pliku DMS.exe.config –  określa ilość dokumentów widoczną na jednej stronie wyników wyszukiwania w aplikacji desktop (domyślnie 50);

Podgląd załączników PDF w zewnętrznym programie – odpowiada kluczowi  <add key=”IntegratedPdfViewer” value=”true” /> w pliku DMS.exe.config  – jeżeli zaznaczono checkbox, wówczas możliwy jest podgląd załączników w formacie *.pdf bezpośrednio w aplikacji Comarch DMS, w prawym panelu karty obiegu

W podglądzie PDF wyświetlaj pełną stronę załącznika – odpowiada kluczowi <add key=”ExtendedPdfViewerZoomToPageLevel” value=”false”/> w pliku DMS.exe.config – pozwala na dopasowanie rozmiaru załącznika do rozmiaru okna podglądu jedynie w przypadku podglądu za pomocą DevExpress);

Włącz kanały wirtualne dla plików – odpowiada kluczowi <add key=”VirtualChannelToLocalMachineFiles” value=”false” /> w pliku DMS.exe.config – jest odpowiedzialne za możliwość załączania plików z lokalnego komputera do aplikacji Comarch DMS, która jest uruchomiona na wirtualnej maszynie.

  • Kiedy checkbox jest zaznaczony, dodawanie załączników z katalogów umieszczonych na maszynie wirtualnej nie jest możliwe, wywoływane są wyłącznie okna z komputera lokalnego, na którym uruchomiono połączenie terminalowe.
  • >Można załączać pliki zarówno z lokalnego komputera jak i maszyny wirtualnej, jeśli w opcjach podłączania pulpitu zdalnego udostępniono dyski komputera lokalnego. W takiej konfiguracji należy odznaczyć checkbox.

 

Włącz kanały wirtualne dla skanerów – odpowiada kluczowi <add key=”VirtualChannelToLocalMachineScanner” value=”false” /> w pliku DMS.exe.config  –odpowiedzialne 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.

Wyświetlaj okna Comarch ERP Optima w trybie – odpowiada kluczowi <add key=”OptimaWindowsMode” value=”0″ /> – odpowiada za to, czy okna Comarch ERP Optima będą uruchamiane w trybie SDI czy MDI.Domyślnie została ustawiona wartość SDI.

 

Następnie można przejść do zakładki „Ustawienia zaawansowane cz. 2”. W ramach tej zakładki operator może dokonać zmiany kolejnych  domyślnych ustawień, dostępnych w pliku DMS.exe.config w katalogu z plikami aplikacji stacjonarnej.

 

Zakładka „Ustawienia zaawansowane cz. 2”

W ramach zakładki dostępne są następujące ustawienia:

Wyświetlaj przebieg procesu na standardowym wydruku karty obiegu – odpowiada kluczowi <add key=”ShowTheProcessFlowOnThePrintout” value=”true” /> w pliku DMS.exe.config – określa, czy przebieg (etapy) ma być pokazywany na standardowych wydrukach;

Komponent do rozpoznawania kodów kreskowych – odpowiada kluczowi <add key=”ScanMode” value=”Aspose” /> w pliku DMS.exe.config – w ramach tego klucza możliwa jest zmiana komponentu do rozpoznawania kodów kreskowych; Można wybrać wartość

  • Aspose – komponent, który od wersji 2020.0.0 jest domyślnym komponentem służącym do rozpoznawania kodów kreskowych.
  • Internal – poprzedni komponent.

 

Limit czasu dla przetwarzania dokumentu w usłudze Comarch OCR – odpowiada kluczowi <add key=”OCRComarchTimeout” value=”15″ /> w plku DMS.exe.config – 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.

Liczba maili pobieranych jednorazowo ze skrzynki – odpowiada kluczowi <add key=”MailsMaximumNumber” value=”15″ /> w pliku DMS.exe.config – umożliwia zmianę liczbę maili pobieranych jednorazowo ze skrzynki pocztowej. Domyślnie wartość klucza ustawiona jest na 15 –  oznacza to, że jednorazowe odświeżenie listy maili przy pomocy przycisku pobierze i wyświetli na liście kolejne 15 wiadomości. W przypadku, kiedy w kluczu zostanie ustawiona wartość 0, wówczas będą pobierane wszystkie wiadomości e-mail.

Komponent obsługujący pocztę przychodzącą – odpowiada kluczowi <add key=”UseAlternativeMailClient” value=”true” /> w pliku DMs.exe.config –  określa, czy do odbierania maili w punktach ACD użytkownicy korzystają z MailKit czy (wcześniejszego) MailSystem.NET (ActiveUp));

Utrzymanie sesji XL API – odpowiada kluczowi add key=”XLAPIHoldSession” value=”False” /> w pliku DMS.exe.config – służy do utrzymywania sesji podczas pracy z XLApi.Jeśli:

  • zaznaczono checkbox– podczas pracy z formatkami XL przez XLApi, sesja tworzy się w czasie pierwszego podniesienia formatki i nie jest zamykana po zamknięciu formatki – jest używana do czasu zamknięcia aplikacji.
  • nie zaznaczono checkboxa– sesja jest zamykana po zamknięciu formatki

 

Następnie należy nacisnąć „Dalej”.

 

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

Wybór przycisku „Instaluj”

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

Instalacja aplikacji desktop

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

Zakończenie instalacji aplikacji desktop

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

Uwaga
Instalator umożliwia instalację tylko jednej instancji DMS na komputerze. Jeżeli istnieje potrzeba zainstalowania kolejnych aplikacji DMS desktop, konieczne jest zainstalowanie ich ręcznie.




Instalacja aplikacji stacjonarnej w trybie ręcznym

Uwaga
W wersji 2024.1.0 wprowadzono instalację komponentu WebView 2 podczas instalacji aplikacji desktop. W przypadku ręcznej instalacji aplikacji desktop operator może pobrać komponent pod adresem https://developer.microsoft.com/en-us/microsoft-edge/webview2/?form=MA13LH#download-section

 

Konfiguracja aplikacji stacjonarnej Comarch DMS

Instalację i konfigurację aplikacji stacjonarnej można przeprowadzić ręcznie.

Uruchomienie aplikacji stacjonarnej Comarch DMS

  • Przekopiowanie zawartości katalogu z plikami aplikacji stacjonarnej na dysk lokalny. W pobranym pliku instalacyjnym należy wejść do katalogu Comarch DMS {wersja}, następnie zawartość katalogu DMS Desktop przekopiować do nowo utworzonego folderu na lokalnym dysku. Np. do c:\DMS
  • Ustawienie adresu URL w pliku konfiguracyjnym

Należy otworzyć do edycji plik DMS.exe.config i w kluczu ServerUri wprowadzić adres URL którym uruchamiana jest aplikacja serwerowa (dawna aplikacja web).

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

Plik konfiguracyjnt DMS.exe.config, adres URL, którym uruchamiana jest aplikacja serwerowa (dawna web)

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

 

Konfiguracja współpracy z ERP Optima

  • Ustawienie zmiennej środowiskowej Path – W zmiennych środowiskowych systemu Windows Path należy dodać ścieżkę do katalogu w którym zainstalowana jest ERP Optima. Po dodaniu ścieżki należy zrestartować komputer.
  • Tryb uruchamiania okien Comarch ERP Optima – w pliku DMS.exe.config dodano klucz OptimaWindowsMode, który odpowiada za to, czy okna Comarch ERP Optima będą uruchamiane w trybie SDI czy MDI.
    W kluczu <add key=”OptimaWindowsMode” value=”0″ /> parametr może przyjmować wartości 0 (tryb SDI) i 1 (tryb MDI). Domyślnie ustawiono wartość 0.

Sprawdzenie poprawności konfiguracji aplikacji stacjonarnej (desktop)

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

Okno logowania do aplikacji stacjonarnej

Okno logowania do aplikacji stacjonarnej w trybie wielospółkowym

Uwaga
Po zainstalowaniu aplikacji w trybie ręcznym należy zmienić hasło dla operatora ODUser na serwerze SQL. Następnie w pliku konfiguracyjnym web.config ustawić takie samo hasło we wszystkich sekcjach „connectionstring”.




Plik dms.exe.config

W ramach pliku dms.exe.config, który jest dostępny w katalogu z aplikacją desktop Comarch DMS, znajdują się następujące klucze:

  • <add key=”ServerUri” value=”http://localhost/dms202301″ /> – klucz, w którym należy wprowadzić adres URL, za pomocą którego uruchamiana jest aplikacja serwerowa (dawna web);
  • <add key =”DefaultPdfViewerType” value =”Devexpress”/> – klucz wprowadzony w wersji 2025.0.1 ; pozwala na  wybór rodzaju podglądu załącznika w formacie PDF w ramach szczegółów dokumentu w aplikacji desktop Comarch DMS (zob. Podgląd załącznika. Klucz przyjmuje następujące wartości:
    • "Chromium" –  jeśli klucz przyjmuje tę wartość, a <add key="IntegratedPdfViewer" value="true" /> (wartość domyślna), wówczas podgląd załącznika może być wyświetlany jako:
      • podgląd wbudowany – wówczas podgląd nie ulega zmianie
      • podgląd za pomocą Chromium
      • podgląd za pomocą domyślnej aplikacji zewnętrznej
    • "Devexpress" – wartość domyślna; jeśli klucz przyjmuje tę wartość, a <add key="IntegratedPdfViewer" value="true" />, wówczas podgląd załącznika może być wyświetlany jako:
      • podgląd wbudowany
      • podgląd za pomocą Devexpressa
      • podgląd za pomocą domyślnej aplikacji zewnętrznej
  • <add key=” PdfViewerZoom” value=” FitToWidth”/> – klucz wprowadzony w wersji 2024.2.1 zamiast klucza "ExtendedPdfViewerZoomToPageLevel". Służy do ustawienia domyślnego zooma PDF Viewera dla załączników (jedynie w przypadku podglądu za pomocą DevExpress). Klucz może przyjąć jedną z następujących wartości:
    •  " " - brak wartości; wówczas dokument jest wyświetlany w oryginalnym rozmiarze
    • FitToVisible – wówczas podgląd załącznika zostanie dopasowany do szerokości okna
    • FitToWidth – wartość domyślna; jeśli ta wartość została wprowadzona, wówczas podgląd załącznika zostanie dopasowany do szerokości tej strony dokumentu, która jest najszersza
    • ToPageLevel – wówczas podgląd załącznika zostanie wyświetlony z poziomu całej strony
  • <add key="IntegratedPdfViewer" value="true" /> - jeżeli w ramach klucza zostanie wprowadzona wartość „true”, wówczas możliwy jest podgląd załączników w formacie *.pdf bezpośrednio w aplikacji Comarch DMS, w prawym panelu karty obiegu;
  • <add key="SystemScrollbars" value="false" /> - klucz decyduje o tym, czy w  aplikacji desktop wyświetlane są paski przewijania o domyślnym systemowym wyglądzie ("true") czy ostylowane przez Comarch DMS ("false");
  • <add key="DocumentListRowsCount" value="50" /> - klucz określa ilość dokumentów widoczną na jednej stronie wyników wyszukiwania w aplikacji desktop;
  • <add key="ShowTheProcessFlowOnThePrintout" value="true" /> - klucz określa, czy  przebieg (etapy) ma być pokazywany na standardowych wydrukach;
  • <add key="OptimaWindowsMode" value="0" /> - klucz odpowiada za to, czy okna Comarch ERP Optima będą uruchamiane w trybie SDI czy MDI. Parametr może przyjmować wartości 0 (tryb SDI) i 1 (tryb MDI). Domyślnie została ustawiona wartość 0
  • <add key="ScanMode" value="Aspose" /> - w ramach tego klucza możliwa jest zmiana komponentu do rozpoznawania kodów kreskowych; klucz  może przyjąć wartości:
    • Aspose – komponent, który od wersji 2020.0.0 jest domyślnym komponentem służącym do rozpoznawania kodów kreskowych.
    • Internal – poprzedni komponent.

Uwaga
Aby korzystać z poprzedniego komponentu do rozpoznawania kodów kreskowych konieczne jest wpisanie w wartość klucza ScanMode wartości „Internal”, w pozostałych przypadkach Comarch DMS będzie korzystał z komponentu Aspose.

  • <!-- <add key="ScanRectangle" value="0,0,450,90"/> --> w ramach tego klucza można określić obszar (prostokąt) na skanie, w którym szukany jest kod kreskowy. Poszczególne parametry to:
        • (0) – współrzędna x lewego górnego wierzchołka prostokąta
        • (0) – współrzędna y lewego górnego wierzchołka prostokąta
        • (450) – szerokość prostokąta
        • (90) – wysokość prostokąta
  • <!-- <add key="AsposeScanFormats" value="EAN13"/> - klucz, w którym możliwe jest określenie typu rozpoznawanych kodów kreskowych dla komponentu Aspose. Domyślnie klucz jest zakomentowany - oznacza to, że komponent sam rozpozna typ skanowanego kodu kreskowego.
  • <!-- <add key="ScanFormats" value="CODE_39"/> - klucz określa aktywne formaty kodów kreskowych dla poprzedniego komponentu Internal,
  • <add key="UseAlternativeMailClient" value="true" /> - klucz określa, czy do odbierania maili w punktach ACD  użytkownicy korzystają z MailKit ("true") czy (wcześniejszego) MailSystem.NET (ActiveUp) ("false");
  • <add key="MailsMaximumNumber" value="15" /> - klucz, który umożliwia zmianę liczbę maili pobieranych jednorazowo ze skrzynki pocztowej. Domyślnie wartość klucza ustawiona jest na 15 -  oznacza to, że jednorazowe odświeżenie listy maili przy pomocy przycisku pobierze i wyświetli na liście kolejne 15 wiadomości. W przypadku, kiedy w kluczu zostanie ustawiona wartość 0, wówczas będą pobierane wszystkie wiadomości e-mail.
  • <add key="VirtualChannelToLocalMachineFiles" value="false" /> - klucz jest odpowiedzialny za możliwość załączania plików z lokalnego komputera do aplikacji Comarch DMS, która jest uruchomiona na wirtualnej maszynie.
        • Kiedy kanał wirtualny VirtualChannelToLocalMachineFiles jest włączony ("True"), dodawanie załączników z katalogów umieszczonych na maszynie wirtualnej nie jest możliwe, wywoływane są wyłącznie okna z komputera lokalnego, na którym uruchomiono połączenie terminalowe.
        • Można załączać pliki zarówno z lokalnego komputera jak i maszyny wirtualnej, jeśli w opcjach podłączania pulpitu zdalnego udostępniono dyski komputera lokalnego. W takiej konfiguracji należy wartość klucza VirtualChannelToLocalMachineFiles ustawić na "False".
  • <add key="VirtualChannelToLocalMachineScanner" value="false" /> - klucz jest odpowiedzialny 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.
  • <add key="OCRComarchUri" value="https://cr.erp.comarch.pl/api/v1/" /> - 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="OCRFilesExtensionFilter" value="" /> – klucz dodany w wersji 2024; w ramach klucza możliwe jest wprowadzenie takich rozszerzeń dokumentów, które mają być przetwarzane przez OCR. Poszczególne rodzaje rozszerzeń należy rozdzielić średnikami. Domyślnie filtr nie ma podanej wartości – w takim przypadku filtr jest nieaktywny;
  • add key="XLAPIHoldSession" value="False" /> - klucz służy do utrzymywania sesji podczas pracy z XLApi. Klucz przyjmuje wartości:
        • „true” – podczas pracy z formatkami XL przez XLApi, sesja tworzy się w czasie pierwszego podniesienia formatki i nie jest zamykana po zamknięciu formatki - jest używana do czasu zamknięcia aplikacji.
        • „false” – sesja jest zamykana po zamknięciu formatki
  • <add key="RPAFolderPath" value="C:\dms202310" /> – klucz dostępny od wersji 2023.1.0; należy wpisać poprawną wartość, aby skrypt wprowadzony w ramach zakładki „Konfiguracja automatycznego trybu pracy” został poprawnie skompilowany. Jako wartość klucza należy wpisać ścieżkę do folderu z aplikacją desktop Comarch DMS, np. C:\dms202310. (zob. Zakładka „Edytor skryptów”);
  • <add key="ACDExePath" value="" /> – klucz dostępny od wersji 2023.1.0; w ramach tego klucza należy wprowadzić ścieżkę do pliku .exe, który ma zostać uruchomiony w punkcie ACD, np. <add key="ACDExePath" value="C:\Windows\System32\calc.exe" /> (zob. Uruchamianie pliku exe w punkcie ACD);
  • <add key="ACDGenMaxDOP" value="1" /> – klucz dostępny od wersji 2024.0.0; w ramach tego klucza użytkownik może zwiększyć szybkość generowania dokumentów w punktach ACD; domyślna wartość tego parametru wynosi 1 – aby zwiększyć tempo generowania dokumentów należy wpisać cyfry większe niż 1; zaleca się, aby nie przekraczać wartości 4.
  • <add key="Version" value="5048505146494648" /> - zakodowany numer wersji Comarch DMS - nie należy edytować.




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

Instalator Comarch DMS umożliwia również aktualizację aplikacji serwerowej i aktualizację aplikacji WEB Comarch DMS oraz aktualizację aplikacji Comarch DMS Repozytorium.

Uwaga
Przed rozpoczęciem aktualizacji Comarch DMS Repozytorium konieczne jest, aby wykonać backup bazy MongoDB – zob. Backup bazy danych MongoDB

Uwaga
Podczas aktualizacji za pomocą Instalatora (Instalator Comarch DMS.exe) potrzebny jest dostęp do Internetu.

W ramach okna początkowego dostępne jest pole Język instalatora – w ramach tego pola użytkownik wybiera język, w którym będą wyświetlane kolejne kroki instalatora.

Po wyborze odpowiedniej wartości w polu należy kliknąć [Dalej], aby przejść do kolejnego kroku aktualizacji.

Jeżeli użytkownik chce zrezygnować z aktualizacji, powinien wybrać przycisk [Anuluj] albo spróbować 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

 

Ekran początkowy aktualizacji aplikacji web Comarch DMS

 

W kolejnym oknie instalatora należy wybrać przycisk [Dalej], aby kontynuować aktualizację.

 

Drugie okno aktualizacji Comarch DMS – ekran powitalny

 

Wybór aplikacji

Następnie aby zaktualizować aplikację Comarch DMS, należy w ramach okna „Wybór aplikacji” wybrać opcję „Aktualizacja aplikacji Comarch DMS oraz Comarch DMS Repozytorium” (od wersji 2024.2.0) i kliknąć [Dalej].

Wybór opcji aktualizacji aplikacji Comarch DMS

 

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

 

Aktualizacja aplikacji serwerowej

Uwaga
W przypadku aktualizacji aplikacji Comarch DMS w wersji 2024.3.1 lub niższej za pomocą instalatora wydanego w ramach wersji 2025.0.0 pula aplikacji, na której do tej pory pracowały aplikacje: serwerowa i web Comarch DMS zostanie dedykowana dla aplikacji serwerowej (Api) Comarch DMS.

Następnie zostaje otwarte okno Aktualizacja aplikacji serwerowej. W ramach tego okna dostępne są następujące pola:

  • Wybierz witrynę web – w tym polu użytkownik z listy dostępnych witryn wybiera witrynę, na której znajduje się aplikacja serwerowa (dawna web), która ma zostać zaktualizowana – domyślnie wyświetlana jest witryna Default Web Site;
  • Port – nieedytowalne pole numeru portu, widoczne jako wyszarzone;
  • Wybierz aplikację serwerową – w tym polu użytkownik z listy aplikacji dostępnych na danej witrynie wybiera tę aplikację serwerową (dawna web), która ma zostać zaktualizowana

Od wersji 2023.0.1 możliwa jest aktualizacja aplikacji web Comarch DMS za pomocą instalatora w przypadku, jeśli dotychczasowa instalacja była wykonywana ręcznie i aplikacja web została zainstalowana bezpośrednio w witrynie.

Przykład aplikacji web zainstalowanej bezpośrednio w witrynie

 

W tym celu w ramach okna Aktualizacja aplikacji serwerowej w polu Wybierz aplikację serwerową dostępna jest opcja Aplikacja zainstalowana w witrynie.

 

Wybór aplikacji serwerowej zainstalowanej w witrynie do aktualizacji

 

Jeżeli użytkownik wybrał opcję Aplikacja zainstalowana w witrynie, wówczas aktualizacja plików aplikacji serwerowej (dawnej web) będzie się odbywać w folderze źródłowym witryny sieci web, który został wskazany w ustawieniach zaawansowanych witryny (Ogólne -> Ścieżka fizyczna).

Po wybraniu odpowiednich wartości w polach należy nacisnąć przycisk [Dalej], aby przejść do kolejnego okna.

Jeśli użytkownik wybrał w polu „Nazwa aplikacji” aplikację, która nie jest aplikacją serwerową Comarch DMS, wówczas po kliknięciu przycisku [Dalej] wyświetlony zostaje komunikat „Wybrana aplikacja nie jest aplikacją Comarch DMS. Wybierz odpowiednią aplikację.”.

 

Okno „Aktualizacja aplikacji serwerowej” po wyborze aplikacji do zaktualizowania (gdy aplikacja nie jest zainstalowana w witrynie)

 

Kiedy wybrano aplikację do aktualizacji, wówczas weryfikowany jest plik web.config. Od wersji 2023.0.1 jeśli w kluczu „MultiCompany” value= true, wówczas aktualizacja bazy Comarch DMS zostaje przeprowadzona i zostaje wyświetlony następujący komunikat:

Komunikat wyświetlany podczas aktualizacji aplikacji Comarch DMS, która pracuje w trybie wielofirmowym

 

W przypadku, jeśli użytkownik naciśnie przycisk:

  • Anuluj – praca instalatora zostanie zakończona, zaś aktualizacja – przerwana
  • Ok – zostanie wykonana aktualizacja bazy DMS, a w kluczu MultiCompany zostaje zachowana wartość True

Następnie użytkownik przechodzi do okna „Pula dla aplikacji WEB”.

 

Wybór puli aplikacji webowej

Od wersji 2025.0.0 dla aplikacji serwerowej i dla aplikacji WEB wymagane jest skonfigurowanie osobnych pul aplikacji. Z tego powodu na kolejnym kroku, w oknie Pula dla aplikacji WEB należy określić, na jakiej puli aplikacji ma pracować aplikacja web Comarch DMS – w tym celu należy, podobnie jak w przypadku aplikacji serwerowej:

  • 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 web DMS.

 

Uwaga
Pula aplikacji, na której ma pracować aplikacja WEB Comarch DMS nie może być tą samą pulą, na której ma pracować aplikacja serwerowa Comarch DMS.

 

Okno „Pula dla aplikacji WEB”, w którym dodano i wybrano pulę „dmsweb2025”

 

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;
  • Wybrana pula została wskazana we wcześniejszym kroku instalacji, na tę na której ma pracować aplikacja serwerowa. Aplikacja webowa wymaga wskazania innej puli. – przed kontynuacją instalacji Comarch DMS należy wybrać inna pulę, która spełnia wymagania albo dodać nową pulę;
  • 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].

 

Jeśli:

  • użytkownik utworzył już wcześniej aplikację WEB powiązaną z daną aplikacją serwerową, wówczas przechodzi do okna „Aktualizacja aplikacji WEB”
  • użytkownik nie utworzył jeszcze aplikacji WEB powiązanej z daną aplikacją serwerową, wówczas przechodzi do okna „Kreowanie aplikacji WEB”

 

Aktualizacja aplikacji WEB

Opcja aktualizacji aplikacji WEB za pomocą instalatora jest dostępna od wersji 2024.0.1. W ramach okna „Aktualizacja aplikacji WEB” należy:

  • w polu „Wybierz witrynę web” wybrać witrynę, na której znajduje się aplikacja WEB, która ma zostać zaktualizowana – domyślnie wyświetlana jest witryna Default Web Site;
  • w polu „Wybierz aplikację WEB” wybrać z listy aplikacji dostępnych na danej witrynie tę aplikację WEB (nowy web), która ma zostać zaktualizowana

a następnie kliknąć przycisk [Dalej], aby przejść do okna „Opcje aktualizacji”.

 

Okno „Aktualizacja aplikacji WEB” przed wyborem aplikacji WEB

 

Okno „Aktualizacja aplikacji WEB” po wyborze aplikacji WEB

 

Jeśli użytkownik wybrał w polu „Wybierz aplikację WEB” aplikację, która nie jest aplikacją serwerową Comarch DMS, wówczas po kliknięciu przycisku [Dalej] wyświetlony zostaje komunikat „Wybrana aplikacja nie jest aplikacją Comarch DMS. Wybierz odpowiednią aplikację.”.

 

Okno „Aktualizacja aplikacji WEB” po wyborze do zaktualizowania aplikacji, która nie jest aplikacją WEB

 

Kreowanie aplikacji WEB

Uwaga
Konieczne jest, aby aplikacje: serwerowa i web znajdowały się na tej samej witrynie.

W ramach tego okna dostępne są pola, w ramach których 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 „Wprowadź nazwę aplikacji WEB” 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.

Po wybraniu odpowiednich wartości w polach należy nacisnąć przycisk [Dalej], aby przejść do okna „Opcje aktualizacji”.

Jeśli użytkownik wybrał w polu „Nazwa aplikacji” aplikację, która nie jest nową aplikacją WEB Comarch DMS, wówczas po kliknięciu przycisku [Dalej] wyświetlony zostaje komunikat „Wybrana aplikacja nie jest aplikacją Comarch DMS. Wybierz odpowiednią aplikację.”.

 

Opcje aktualizacji

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

 

Okno „Opcje aktualizacji” w przypadku aktualizacji Comarch DMS we współpracy z Comarch ERP Optima

 

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

  • Opcja zmiany języka na ekranie logowania do Comarch DMS – jeżeli parametr zostanie zaznaczony, wówczas na ekranie logowania dostępny będzie link [aplikacja desktop] lub [aplikacja serwerowa], 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#

 

Uwaga
Domyślnie opcje aktualizacji są zaznaczone tak, jak zaznaczono je podczas poprzedniej instalacji lub aktualizacji.

 

Po ustawieniu parametrów należy kliknąć na przycisk [Dalej], aby kontynuować aktualizację.

 

Baza danych Comarch DMS

Jeśli podczas instalacji utworzono osobną bazę danych dla Comarch DMS, wówczas następuje przejście do okna „Baza danych Comarch DMS”, gdzie 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

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”

 

Jeśli nawiązano połączenie z serwerem, w ramach pola „Lista baz danych” powinna być wybrana baza Comarch DMS, która jest właściwa dla danej aplikacji – domyślnie podpowiada się właściwa baza. W wersji 2025.0.0 dodano następujące elementy:

  • Pole „Użytkownik SQL dla Comarch DMS” – w ramach tego pola operator może wskazać utworzonego wcześniej użytkownika, który aktualnie komunikuje się z bazą danych. Po wyborze użytkownika przycisk [Zmień hasło] staje się aktywny. Zmiana hasła przy aktualizacji nie jest obowiązkowa, jeśli jednak operator kliknie w przycisk [Zmień hasło], wówczas zostanie otwarte okno, w ramach którego może dokonać zmiany hasła dla wybranego użytkownika SQL (zob. Zmiana hasła użytkownika SQL);
  • Przycisk [Dodaj użytkownika] – operator powinien nacisnąć ten przycisk, jeśli nie chce zmieniać hasła istniejącego użytkownika SQL, chce natomiast dodać nowego użytkownika SQL, za pośrednictwem którego aplikacja Comarch DMS komunikuje się z bazą danych (zob. Dodawanie nowego użytkownika SQL).

 

Zmiana hasła użytkownika SQL

Jeśli operator kliknie w przycisk [Zmień hasło], wówczas zostanie otwarte okno, w ramach którego może dokonać zmiany hasła dla wybranego użytkownika SQL. W tym celu należy:

  • W polu „Hasło” wprowadzić nowe hasło dla wybranego użytkownika SQL
  • W polu „Powtórz hasło” wpisać ponownie nowe hasło dla wybranego użytkownika SQL, takie samo, jak w polu „Hasło”

 

Następnie operator powinien kliknąć przycisk [Zapisz].

Hasło powinno być silne – tzn. 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

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

  • ;

 

Okno zmiany hasła dla wybranego użytkownika SQL

 

Jeżeli wpisano hasło, które nie spełnia któregoś z warunków dla silnego hasła, wówczas po kliknięciu przycisku   [Zapisz] hasło nie zostaje zmienione i wyświetlany jest odpowiedni komunikat, analogicznie jak w przypadku dodawania nowego użytkownika SQL.

Po poprawnym uzupełnieniu pól oraz po kliknięciu przycisku  [Zapisz] hasło dla wybranego użytkownika SQL zostaje zmienione, okno zamyka się, a w ramach okna „Baza danych Comarch DMS” wyświetlony zostaje napis „Hasło użytkownika bazy zostało zmienione”.

 

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

 

Uwaga
Jeżeli zmieniono hasło dla wybranego użytkownika SQL, wówczas w ramach danej aktualizacji nie można dodać nowego użytkownika serwera SQL – przycisk „Dodaj użytkownika” jest wyszarzony.

 

Dodawanie nowego użytkownika SQL

Po kliknięciu w przycisk [Dodaj użytkownika] zostaje otwarte okno, w którym należy uzupełnić następujące pola:

  • Login – w tym polu operator powinien wpisać login nowego użytkownika, za pomocą którego aplikacja Comarch DMS będzie komunikować się z bazą danych na serwerze MS SQL Server;
  • Hasło – w tym polu operator powinien wpisać hasło nowego użytkownika, za pomocą którego aplikacja Comarch DMS będzie komunikować się z bazą danych na serwerze MS SQL Server;
  • Powtórz hasło – w ramach tego pola operator powinien powtórnie wprowadzić hasło nowego użytkownika, za pomocą którego aplikacja Comarch DMS będzie komunikować się z bazą danych na serwerze MS SQL Server.

 

Uwaga
Zaleca się, aby login był unikalny dla każdej instalacji Comarch DMS.

 

Hasło powinno być silne – tzn. 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

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

  • ;

 

Jeżeli wpisano hasło, które nie spełnia któregoś z warunków dla silnego hasła, wówczas po kliknięciu przycisku   [Zapisz] hasło nie zostaje zapisane, użytkownik nie zostaje utworzony i wyświetlany jest odpowiedni komunikat, analogicznie jak podczas instalacji aplikacji Comarch DMS.

 

Okno ustawienia loginu i hasła dla nowego użytkownika, za pomocą którego aplikacja Comarch DMS będzie komunikować się z bazą danych na serwerze MS SQL Server

 

W przypadku, gdy operator wprowadził login i hasło użytkownika, którego login był już wykorzystywany dla innej instalacji na tym samym serwerze , a następnie kliknął w przycisk [Zapisz], wówczas w dolnej części zostanie wyświetlony komunikat ostrzegawczy „Wpisany login jest już wykorzystany do komunikacji z bazą danych na tym serwerze. Zalecamy zmianę loginu dla nowej instalacji”. Komunikat nie blokuje następnych kroków instalacji – po ponownym kliknięciu w przycisk [Zapisz] użytkownik z podanym loginem oraz hasłem zostanie utworzony.

 

Uwaga

W ramach aktualizacji operator może albo zmienić hasło, albo dodać nowego użytkownika SQL – nie może wykonać obydwóch tych akcji.

Operator może także nie podejmować żadnej z tych akcji i od razu po przejściu do okna oraz nawiązaniu połączenia z serwerem wybrać bazę w ramach pola „Lista baz danych”, a następnie kliknąć przycisk „Uruchom skrypty”

Jeżeli dodawanie nowego użytkownika SQL zakończy się sukcesem, wówczas pole „Użytkownik SQL dla Comarch DMS” zostanie zablokowane – operator nie będzie mógł zmienić hasła.

 

Okno „Baza danych Comarch DMS” – widok po utworzeniu nowego użytkownika SQL

 

Uruchamianie skryptów

Po wyborze bazy i (opcjonalnie) zmianie hasła dla istniejącego użytkownika SQL lub dodaniu nowego użytkownika SQL operator powinien nacisnąć przycisk [Uruchom skrypty] w celu aktualizacji bazy 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], aby przejść do kolejnego kroku instalacji – do okna  „Konfiguracyjna baza danych Comarch ERP Optima”.

 

Uwaga
Jeśli Comarch DMS pracuje w trybie wielofirmowym (w pliku web.config klucz <add key=”MultiCompany” value=”true” />), wówczas po etapie „Baza danych Comarch DMS” następuje przejście bezpośrednio do okna „Klucze licencji” – na bazach: konfiguracyjnej i firmowej Comarch ERP Optima należy uruchomić skrypty ręcznie, zgodnie z rozdziałem Aktualizacja aplikacji web w trybie ręcznym.

 

Konfiguracyjna baza danych Comarch ERP Optima

W ramach okna „Konfiguracyjna baza danych Comarch ERP Optima” 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 „Konfiguracyjna baza danych Comarch ERP Optima”

 

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

 

Od wersji 2025.0.0 w przypadku jeśli:

  • baza Comarch ERP Optima znajduje się na tym samym serwerze co baza Comarch DMS albo w oknie „Opcje instalacji”  zaznaczono opcję „Utwórz osobną bazę danych dla Comarch DMS”, po połaczeniu z serwerem użytkownik powinien w ramach pola „Lista baz danych” wybrać bazę konfiguracyjną Comarch ERP Optima, która ma zostać zaktualizowana, a później nacisnąć przycisk [Uruchom skrypty] w celu aktualizacji bazy Comarch ERP Optima.

 

Okno „Konfiguracyjna baza danych Comarch ERP Optima” po nawiązaniu połączenia z serwerem i wyborze bazy konfiguracyjnej (gdy baza konfiguracyjna Comarch ERP Optima znajduje się na tym samym serwerze co baza Comarch DMS albo w oknie „Opcje instalacji”  zaznaczono opcję „Utwórz osobną bazę danych dla Comarch DMS”)

 

  • baza Comarch ERP Optima znajduje się na innym serwerze niż baza Comarch DMS albo w oknie „Opcje instalacji” nie zaznaczono opcji „Utwórz osobną bazę danych dla Comarch DMS”, wówczas po połączeniu z serwerem w ramach okna „Konfiguracyjna baza danych Comarch ERP Optima”  dostępne są:
    • Pole „Użytkownik SQL dla Comarch DMS” – w ramach tego pola operator może wskazać utworzonego wcześniej użytkownika, który aktualnie komunikuje się z bazą danych. Po wyborze użytkownika przycisk [Zmień hasło] staje się aktywny. Zmiana hasła przy aktualizacji nie jest obowiązkowa, jeśli jednak operator kliknie w przycisk [Zmień hasło], wówczas zostanie otwarte okno, w ramach którego może dokonać zmiany hasła dla wybranego użytkownika SQL (zob. Zmiana hasła użytkownika SQL);
    • Przycisk [Dodaj użytkownika] – operator powinien nacisnąć ten przycisk, jeśli nie chce zmieniać hasła istniejącego użytkownika SQL, chce natomiast dodać nowego użytkownika SQL, za pośrednictwem którego aplikacja Comarch DMS komunikuje się z bazą danych (zob. Dodawanie nowego użytkownika SQL).

.

Uwaga

W ramach aktualizacji operator może albo zmienić hasło, albo dodać nowego użytkownika SQL – nie może wykonać obydwóch tych akcji.

Operator może także nie podejmować żadnej z tych akcji i od razu po przejściu do okna oraz nawiązaniu połączenia z serwerem wybrać bazę w ramach pola „Lista baz danych”, a następnie kliknąć przycisk „Uruchom skrypty”

Jeżeli dodawanie nowego użytkownika SQL zakończy się sukcesem, wówczas pole „Użytkownik SQL dla Comarch DMS” zostanie zablokowane – operator nie będzie mógł zmienić hasła.

 

Okno „Konfiguracyjna baza danych Comarch ERP Optima” po nawiązaniu połączenia z serwerem i wyborze bazy konfiguracyjnej (gdy baza konfiguracyjna Comarch ERP Optima znajduje się na innym serwerze niż baza Comarch DMS albo w oknie „Opcje instalacji”  nie zaznaczono opcji „Utwórz osobną bazę danych dla Comarch DMS”)

 

Uruchamianie skryptów

Po ewentualnym dokonaniu zmian i wyborze bazy konfiguracyjnej nalezy nacisnąć przycisk [Uruchom skrypty] w celu aktualizacji bazy konfiguracyjnej Comarch ERP Optima.

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 „Firmowa baza danych Comarch ERP Optima”.

 

Okno instalatora po pomyślnym wykonaniu skryptów na bazie konfiguracyjnej Comarch ERP Optima (gdy baza konfiguracyjna Comarch ERP Optima znajduje się na tym samym serwerze co baza Comarch DMS albo w oknie „Opcje instalacji”  zaznaczono opcję „Utwórz osobną bazę danych dla Comarch DMS”)

 

Firmowa baza danych Comarch ERP Optima

W ramach okna „Firmowa baza danych Comarch ERP Optima” 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 „Firmowa baza danych Comarch ERP Optima”

 

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

Od wersji 2025.0.0 w przypadku jeśli:

  • baza firmowa Comarch ERP Optima znajduje się na tym samym serwerze co baza Comarch DMS lub baza konfiguracyjna Comarch ERP Optima, po połaczeniu z serwerem użytkownik powinien w ramach pola „Lista baz danych” wybrać bazę firmową Comarch ERP Optima, która ma zostać zaktualizowana, a później nacisnąć przycisk [Uruchom skrypty] w celu aktualizacji bazy Comarch ERP Optima.

 

Okno „Firmowa baza danych Comarch ERP Optima” po nawiązaniu połączenia z serwerem i wyborze bazy konfiguracyjnej ( gdy baza firmowa Comarch ERP Optima znajduje się na tym samym serwerze co baza Comarch DMS lub baza konfiguracyjna Comarch ERP Optima)

 

  • baza Comarch ERP Optima znajduje się na innym serwerze niż baza Comarch DMS lub baza konfiguracyjna Comarch ERP Optima, wówczas po połączeniu z serwerem w ramach okna Firmowa baza danych Comarch ERP Optima”  dostępne są:
    • Pole „Użytkownik SQL dla Comarch DMS” – w ramach tego pola operator może wskazać utworzonego wcześniej użytkownika, który aktualnie komunikuje się z bazą danych. Po wyborze użytkownika przycisk [Zmień hasło] staje się aktywny. Zmiana hasła przy aktualizacji nie jest obowiązkowa, jeśli jednak operator kliknie w przycisk [Zmień hasło], wówczas zostanie otwarte okno, w ramach którego może dokonać zmiany hasła dla wybranego użytkownika SQL (zob. Zmiana hasła użytkownika SQL);
    • Przycisk [Dodaj użytkownika] – operator powinien nacisnąć ten przycisk, jeśli nie chce zmieniać hasła istniejącego użytkownika SQL, chce natomiast dodać nowego użytkownika SQL, za pośrednictwem którego aplikacja Comarch DMS komunikuje się z bazą danych (zob. Dodawanie nowego użytkownika SQL).

 

Uwaga

W ramach aktualizacji operator może albo zmienić hasło, albo dodać nowego użytkownika SQL – nie może wykonać obydwóch tych akcji.

Operator może także nie podejmować żadnej z tych akcji i od razu po przejściu do okna oraz nawiązaniu połączenia z serwerem wybrać bazę w ramach pola „Lista baz danych”, a następnie kliknąć przycisk „Uruchom skrypty”

Jeżeli dodawanie nowego użytkownika SQL zakończy się sukcesem, wówczas pole „Użytkownik SQL dla Comarch DMS” zostanie zablokowane – operator nie będzie mógł zmienić hasła.

 

Okno „Firmowa baza danych Comarch ERP Optima” po nawiązaniu połączenia z serwerem i wyborze bazy konfiguracyjnej ( gdy baza firmowa Comarch ERP Optima znajduje się na innym serwerze niż baza Comarch DMS lub baza konfiguracyjna Comarch ERP Optima)

Uruchamianie skryptów

Po ewentualnym dokonaniu zmian i wyborze bazy firmowej nalezy nacisnąć przycisk [Uruchom skrypty] w celu aktualizacji bazy firmowej Comarch ERP Optima.

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:

  • Jeżeli w folderze z aktualizowaną aplikacją serwerową w pliku Web.config klucz „UseRepository” ma wartość „false” – aplikacja Comarch DMS nie współpracuje z modułem Comarch DMS – następuje przejście do okna „Klucze licencji”
  • Jeżeli w folderze z aktualizowaną aplikacją serwerową w pliku Web.config klucz „UseRepository” ma wartość „true” – następuje przejście do okna „Aktualizacja aplikacji Repozytorium”

 

Okno instalatora po pomyślnym wykonaniu skryptów na bazie firmowej Comarch ERP Optima (gdy baza firmowa Comarch ERP Optima znajduje się na tym samym serwerze co baza Comarch DMS lub baza konfiguracyjna Comarch ERP Optima)

Aktualizacja aplikacji 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 „Aktualizacja aplikacji Repozytorium” znajdują się następujące pola:

      • Wybierz witrynę web – w ramach tego pola operator powinien wybrać witrynę, na której znajduje się aplikacja Repozytorium do zaktualizowania (domyślnie wyświetlana jest witryna Default Web Site);
      • Port – pole numeru portu, wyszarzone i nieedytowalne;
      • Wybierz aplikację Repozytorium – w ramach tego pola operator powinien wybrać aplikację Repozytorium do zaktualizowania.

Następnie należy kliknąć [Dalej], aby przejść do kolejnego okna.

 

Okno „Aktualizacja aplikacji Repozytorium” przed wypełnieniem pól

 

Okno „Aktualizacja aplikacji Repozytorium” po wypełnieniu pól

 

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

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”

 

W wersji 2025.1.0 w ramach instalatora Comarch DMS dodano następujące komunikaty, które mogą zostać wyświetlone po uzupełnieniu pól „Nazwa serwera”, „Login” i „Hasło”, a następnie po kliknięciu [Połącz] w oknie „Baza danych Comarch DMS Repozytorium”:

  • „Wprowadzono nieprawidłowy adres serwera” – komunikat wyświetlany, jeśli w polu „Nazwa serwera” wprowadzono niewłaściwy adres serwera.

 

Okno „Baza danych Comarch DMS Repozytorium” z komunikatem „Wprowadzono nieprawidłowy adres serwera”

 

  • „Wprowadzono nieprawidłowe dane logowania” – komunikat wyświetlany, jeśli w polu „Login” i/lub „Hasło” wprowadzono niewłaściwe dane

 

Okno „Baza danych Comarch DMS Repozytorium” z komunikatem „Wprowadzono nieprawidłowe dane logowania”

 

Wskazówka
Czy wystąpiły problemy podczas instalacji Comarch DMS Repozytorium? Sięgnij do wskazówek: Comarch DMS Repozytorium – Najczęściej pojawiające się pytania

 

Jeśli nawiązano połączenie z serwerem MongoDB, wówczas w ramach pola „Lista baz danych” powinna być wybrana baza Comarch DMS Repozytorium odpowiednia dla danej aplikacji.

Nastepnie, opcjonalnie, operator może zmienić hasło dla użytkownika MongoUser, klikając przycisk [Zmień hasło].

W otwartym oknie w polu „Hasło” należy ustawić hasło dla użytkownika MongoUser, dodanego do serwera MongoDB podczas pierwszej instalacji danej aplikacji Comarch DMs Repozytorium. 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:

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

Od wersji 2024.2.2 można używać powyższych znaków w ramach loginu i/lub hasła.

Nie należy natomiast używać spacji w loginie ani w haśle.

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

 

Po kliknięciu w przycisk  [Dalej] następuje przejście do okna „Klucze licencji”.

 

Klucze licencji

W ramach okna „Klucze licencji” w polach: „Serwer klucza licencji Comarch DMS” i „Serwer klucza licencji Comarch ERP Optima” zostają automatycznie wpisane klucze licencji, pobrane z pliku Web.config. W razie potrzeby użytkownik może wpisać ręcznie inne klucze licencji Comarch DMS zgodnie ze wzorem nazwa_serwera_klucza::numer_klucza.

Jeżeli operator aktualizuje również moduł Repozytorium, wówczas w ramach okna „Klucze licencji” dostępne jest także pole „Adres e-mail administratora”, w którym znajduje się adres email, który będzie widoczny w Comarch DMS w komunikatach, w których wymagany jest kontakt z administratorem – automatycznie uzupełniony, ale dostępny do edycji.

Następnie należy kliknąć na przycisk [Instaluj] , aby przejść do kolejnego kroku.

 

Okno „Klucze licencji” (jeśli aktualizowany jest tylko Comarch DMS)

 

Okno „Klucze licencji” (jeśli aktualizowany jest Comarch DMS i Comarch DMS Repozytorium)

 

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

 

Po uzupełnieniu klucza licencji i kliknięciu [Instaluj] następuje przejście do kolejnego okna „Aktualizowanie”  i rozpoczyna się aktualizacja aplikacji web Comarch DMS.

Okno „Aktualizowanie”

 

Po dokonaniu aktualizacji wyświetlone zostanie końcowe okno instalatora. Kiedy 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
Czy wystąpiły problemy podczas instalacji Comarch DMS Repozytorium? Sięgnij do wskazówek: Comarch DMS Repozytorium – Najczęściej pojawiające się pytania

 

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!




Aktualizacja aplikacji serwerowej (dawnej web) w trybie ręcznym

Kopiowanie zawartości katalogu DMS Workflow Api

W pobranym pliku instalacyjnym należy wejść do katalogu Comarch DMS {wersja} i przekopiować zawartość katalogu DMS Workflow Api  do folderu, który utworzono podczas poprzedniej instalacji i do którego wówczas przeniesiono zawartość folderu DMS Web (np. C:\inetpub\wwwroot\DMS).

 

Wprowadzanie zmian w pliku Web.config

Następnie w pliku konfiguracyjnym Web.config znajdującym się w katalogu C:\inetpub\wwwroot\{nazwa aplikacji} należy wprowadzić potrzebne informacje, analogicznie jak podczas instalacji Comarch DMS (zob. punkt Konfiguracja pliku web.config w artykule Instalacja aplikacji serwerowej (dawnej web) w trybie ręcznym) i zapisać plik.

 

Uruchamianie skryptów

Następnie należy uruchomić skrypty na bazie Comarch DMS oraz na bazach: konfiguracyjnej  i firmowej Comarch ERP Optima.

Uruchamianie skryptów na bazie Comarch DMS

W katalogu DMS Workflow Api\Sql 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\DMSWeb\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 DMS Workflow Api\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

 

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 bazach konfiguracyjnej i firmowej Comarch ERP Optima

Analogiczny scenariusz należy wykonać dla katalogu DMS Workflow Api \ SqlOptima w tej samej lokalizacji.

Lokalizacja plików:

  • Dla bazy konfiguracyjnej Comarch ERP Optima:

 

katalog z plikami instalacyjnymi \ Comarch DMS {wersja} \ DMS Workflow Api \ SqlOptima \ InstallOptimaConf.bat

 

  • Dla każdej z baz firmowych Comarch ERP Optima (osobno):

 

katalog z plikami instalacyjnymi \ Comarch DMS {wersja} \ DMS Workflow Api \ SqlOptima \ InstallOptimaComp.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 InstallOptimaConf.bat – np. C:\inetpub\wwwroot\DMSWeb\SqlOptima – a następnie nacisnąć Enter.

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

InstallOptimaConf.bat <nazwa_serwera> <nazwa_bazy_konfiguracyjnej_Comarch_ERP_Optima>

 

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

 

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

 

Po wykonaniu skryptów w ramach tego samego okna należy wpisać następującą linię polecenia:

InstallOptimaComp.bat <nazwa_serwera> <nazwa_bazy_firmowej_Comarch_ERP_Optima>

 

a następnie kliknąć Enter – wówczas zostaną uruchomione skrypty na danej bazie firmowej Comarch ERP Optima.

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

 

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

 

Przyklad

Sposób 2

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

 

Wybór pliku „InstallOptimaConf.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_konfiguracyjnej_Comarch_ERP_Optima

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

 

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

 

Później należy kliknąć prawym przyciskiem myszki na plik InstallOptimaConf.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”

 

Następnie w tym samym katalogu DMS Workflow Api \SqlOptima należy odnaleźć plik InstallOptimaComp.bat i otworzyć go do edycji.

 

Wybór pliku „InstallOptimaComp.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_firmowej_Comarch_ERP_Optima

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

 

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

 

Później należy kliknąć prawym przyciskiem myszki na plik InstallOptimaComp.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”

 

Reindeksacja bazy

W katalog DMS Workflow Api \ 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 i zalogowanie się na użytkownika.

 

Okno do logowania w Comarch DMS



Aktualizacja aplikacji WEB Comarch DMS w trybie ręcznym

Wskazówka

Artykuł dotyczy aktualizacji nowej aplikacji WEB.  W kwestii aktualizacji aplikacji serwerowej (dawnej web) zob.:

 

Zmiana puli aplikacji dla aplikacji WEB

Uwaga
W wersji 2025.0.0 należy zmienić pulę aplikacji dla nowej aplikacji WEB Comarch DMS, jeśli znajduje się na tej samej puli, na której jest aplikacja serwerowa (dawna web).

W tym celu operator powinien kolejno:

  • Otworzyć Menedżer Internetowych Usług Informacyjnych (IIS)
  • Jeżeli chce użyć nowej puli: dodać nową pulę, analogicznie jak przy instalacji Comarch DMS, o takich samych właściwościach (zob. przykładowo Konfiguracja Menedżera Internetowych Usług Informatycznych (IIS));
  • Na liście aplikacji dostępnej po lewej stronie okna kliknąć na aplikację WEB, która ma zostać zaktualizowana i w oknie „Akcje” (z prawej strony okna) nacisnąć „Ustawienia zaawansowane…”

 

Widok fragmentu okna Menedżer Internetowych Usług Informacyjnych (IIS) z zaznaczonym linkiem „Ustawienia zaawansowane…”

 

  • W ramach okna „Ustawienia zaawansowane” kliknąć w pole „Pula aplikacji” , a następnie w przycisk z wielokropkiem

 

Okno „Ustawienia zaawansowane” z zaznaczonym przyciskiem

 

  • W oknie „Wybieranie puli aplikacji” wybrać inną pulę aplikacji o odpowiednich właściwościach dla aplikacji Comarch DMS

 

Wybór puli aplikacji dla aplikacji WEB

 

  • nacisnąć przycisk „OK” w ramach okna „Wybieranie puli aplikacji”
  • nacisnąć przycisk „OK” w ramach okna „Ustawienia zaawansowane” – od tej pory dana aplikacja WEB znajduje się na wybranej puli aplikacji

 

Widok okna „Ustawienia zaawansowane” ze zmienioną pulą aplikacji

 

Kopiowanie zawartości katalogu DMS Web

W pobranym pliku instalacyjnym należy wejść do katalogu Comarch DMS {wersja} i przekopiować zawartość katalogu DMS Web do folderu, który utworzono podczas poprzedniej instalacji (od wersji 2024.0.0) i do którego wówczas przeniesiono zawartość folderu DMS Web (np.na dysku C:\inetpub\wwwroot\DMSWeb).

Wprowadzanie zmian w pliku Index.html

Następnie w ramach katalogu zawierającego aplikację web należy otworzyć do edycji plik index.html i uzupełnić nazwę aplikacji web 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

 

Wprowadzanie zmian w pliku web.config

Następnie w ramach katalogu zawierającego aplikację web należy 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.Api – nazwę 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.Api – nazwę 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.Api – nazwę aplikacji serwerowej (starszej aplikacji web)

a następnie zapisać wprowadzone zmiany.

 

Przyklad

Przykład:

<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

 

Weryfikacja poprawności konfiguracji aplikacji web

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

 

Okno do logowania 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!




Aktualizacja aplikacji stacjonarnej w trybie ręcznym

Uwaga
W wersji 2024.1.0 wprowadzono instalację komponentu WebView 2 podczas instalacji aplikacji desktop. W przypadku ręcznej instalacji aplikacji desktop operator może pobrać komponent pod adresem https://developer.microsoft.com/en-us/microsoft-edge/webview2/?form=MA13LH#download-section

 

W pobranym pliku instalacyjnym należy wejść do katalogu Comarch DMS {wersja}, następnie zawartość katalogu DMS Desktop przekopiować do folderu, który utworzono podczas poprzedniej instalacji i do którego wówczas przeniesiono zawartość folderu DMS Desktop (np. do C:\DMS).

Następnie należy otworzyć do edycji plik DMS.exe.config i w kluczu ServerUri wprowadzić adres URL którym uruchamiana jest aplikacja serwerowa (dawna web). Np. <add key=”ServerUri” value=”http://localhost/DMS” />

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

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

 

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

 

Weryfikacja poprawności konfiguracji aplikacji stacjonarnej (desktop)

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

 

Okno logowania do aplikacji stacjonarnej

 

Okno logowania do aplikacji stacjonarnej w trybie wielospółkowym