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:

Application Request Routing – dodatek można pobrać pod następującym adresem: https://www.microsoft.com/en-us/download/details.aspx?id=47333
URL Rewrite – dodatek można pobrać pod następującym adresem: https://www.iis.net/downloads/microsoft/url-rewrite

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 panelu „Akcje” 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:

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

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

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

Sprawdź Szkolenia Comarch DMS!

Powrót do początku artykułu

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

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.

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”

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

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

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

Stacjonarna aplikacja Comarch DMS może zostać skonfigurowana (uruchamiana) na dwa sposoby:

Jako samodzielna aplikacja zintegrowana z ERP XL, ale bez możliwości uruchamiania aplikacji z poziomu środowiska ERP XL.
Aplikacja zintegrowana ze środowiskiem ERP XL, z możliwością uruchomienia aplikacji z poziomu okna startowego ERP XL oraz z poziomu formatek ERP XL (historia związanych).

Konfiguracja aplikacji stacjonarnej bez możliwości uruchomienia z poziomu środowiska ERP XL

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:\ComarchDMS

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 (dawna web)

Konfiguracja aplikacji stacjonarnej z możliwością uruchamiania z poziomu Comarch ERP XL

Konfiguracja Comarch DMS z możliwością uruchomienia z poziomu Comarch ERP XL składa się z kilku kroków:

W pierwszej kolejności należy skonfigurować środowisko Windows na komputerze operatora:
- W głównym katalogu Comarch ERP XL należy utworzyć nowy folder, np. ComarchDMS (c:\ERPXL_2023.1\ComarchDMS).
- W zmiennych środowiskowych systemu Windows PATH należy dodać nową ścieżkę do nowoutworzonego folderu (niezależnie od ścieżki do głównego katalogu ERP XL)
- Zrestartować komputer
  Uwaga
  Należy upewnić się że w zmiennych środowiskowych PATH istnieje tylko jedna ścieżka do folderu ERP XL i jedna do folderu ERP XL\ComarchDMS.
Kolejny krok to konfiguracja aplikacji stacjonarnej Comarch DMS:
- W pobranym pliku instalacyjnym należy wejść do katalogu Comarch DMS {wersja}, zawartość katalogu DMS Desktop przekopiować do nowo utworzonego folderu w katalogu ERP XL Np. do: c:\ERPXL_2023.1\ComarchDMS
- 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” />
- Zapisać plik DMS.exe.config i przekopiować do głównego katalogu ERP XL (w naszym przykładzie do c:\ERPXL_2021.0). Plik DMS.exe.config musi znajdować się w dwóch katalogach:
  - c:\ERPXL_2023.1
  - c:\ERPXL_2023.1\ComarchDMS
- Uruchomić RejestrOD.bat (z katalogu c:\ERPXL_2023.1\ComarchDMS). W zależności od uprawnień operatora systemu Windows można powtórzyć uruchomienie RejestrOD.bat z prawami administratora.
- Jeżeli użytkownik korzysta z wersji ERP XL wcześniejszej niż 2020.0, konieczne jest również uzupełnienie i wykonanie powyższych kroków na pliku ObiegDokumentow.exe.config.
Ostatnim krokiem jest zmiana trybu pracy w środowisku ERP XL:
- Włączenie w środowisku ERP XL trybu współpracy z Comarch DMS – z poziomu Microsoft SQL Management Studio na bazie ERP XL należy wykonać poniższe zapytanie:

update cdn.konfig set kon_wartosc=1 where kon_numer=7200

Uwaga

Uprawnienie „Obieg dokumentów” ustawiane na właściwościach operatora na zakładce „Parametry” w module Administrator Comarch ERP XL odnosi się do “starej” wersji Obiegu Dokumentów. W przypadku współpracy z Comarch DMS uprawnienie to należy wyłączyć wszystkim operatorom.

Sprawdzenie poprawności konfiguracji aplikacji stacjonarnej (desktop)

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

Sprawdzenie poprawności integracji z Comarch ERP XL

Poprawność integracji z Comarch ERP XL można zweryfikować uruchamiając Obieg dokumentów z poziomu menu Start systemu Comarch ERP XL. Po kliknięciu na przycisk Obieg dokumentów zostanie uruchomiony aktualnie skonfigurowany Comarch DMS.

Integracja z Comarch ERP XL umożliwia wiązanie dokumentów ERP XL z dokumentami Comarch DMS wykorzystując do tego formatkę „Historia związanych”. Ponadto umożliwia też generowanie dokumentów za pomocą kontrolki Dokument ERP XL oraz działanie kontrolek elektronicznych.

C:\Users\anna.sudnik\Desktop\Bez-nazwy-1.png — Wiązanie dokumentu ERP XL z dokumentami Comarch DMS

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.

 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

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

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#

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

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

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 aktualizacji – do okna „Baza danych Comarch ERP XL”.

Baza danych Comarch ERP XL

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

Logowanie zintegrowane

lub

Logowanie SQL – jeśli wybrano tę opcję, należy podać:

W polu „Nazwa użytkownika” – nazwę użytkownika logującego się do serwera SQL – np. sa

W polu „Hasło” – hasło użytkownika logującego się do serwera SQL

Od wersji 2025.0.0 w przypadku jeśli:

baza Comarch ERP XL znajduje się na tym samym serwerze 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 XL, która ma zostać zaktualizowana, a później nacisnąć przycisk [Uruchom skrypty] w celu aktualizacji bazy Comarch ERP XL.

Okno „Baza danych Comarch ERP XL” po nawiązaniu połączenia z serwerem i wyborze bazy danych (gdy baza Comarch ERP XL 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 XL 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 „Baza danych Comarch ERP XL” 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.

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 ERP XL” po nawiązaniu połączenia z serwerem i wyborze bazy Comarch ERP XL (gdy baza Comarch ERP XL 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

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 Comarch ERP XL (gdy baza Comarch ERP XL 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”)

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”

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

:
/
?
#
[
]
@
!

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 XL” 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 [Dalej], 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 klucza – 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 i rozpoczyna się aktualizacja aplikacji web Comarch DMS.

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.

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!

Powrót do początku artykułu

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\DMSWeb).

Wprowadzanie zmian w pliku Web.config

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

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

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.

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 bazie Comarch ERP XL

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

Lokalizacja pliku:

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

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

Sposób 1

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

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

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

InstallXL.bat <nazwa_serwera> <nazwa_bazy_Comarch_ERP_XL>

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

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

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

Sposób 2

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

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

set SERVER=nazwa_serwera

SHIFT

set DATABASE=nazwa_bazy _Comarch_ERP_XL

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

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

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

Uwaga

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

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

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.

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

dla Comarch Standalone i Comarch DMS we współpracy z Comarch ERP Enterprise : Aktualizacja aplikacji serwerowej (dawnej web) w trybie ręcznym,
dla Comarch DMS we współpracy z Comarch ERP XL: Aktualizacja aplikacji serwerowej (dawnej web) w trybie ręcznym ,
dla Comarch DMS we współpracy z Comarch ERP Optima: Aktualizacja aplikacji serwerowej (dawnej web) w trybie ręcznym ,
dla Comarch DMS we współpracy z Comarch ERP Altum: Aktualizacja aplikacji serwerowej (dawnej web) w trybie ręcznym

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

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:

a następnie zapisać wprowadzone zmiany.

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:

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

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!

Powrót do początku artykułu

Aktualizacja aplikacji stacjonarnej w trybie ręcznym

Uwaga

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

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 w trybie wielospółkowym

Wieloinstalacyjność

W aplikacji Comarch DMS została oprogramowana funkcjonalność obsługi wyboru adresu URL wielu instalacji obiegu w wersji stacjonarnej oraz przez API, z którego korzysta Comarch ERP XL.
Funkcjonalność umożliwia:

Zalogowanie się do wielu instalacji Comarch DMS poprzez jedną aplikację desktop. Wybór instalacji odbywa się poprzez wskazanie nazwy instalacji na formatce logowania.
Powiązanie nazwy zmapowanej bazy danych Comarch ERP XL z instalacją Comarch DMS. Dzięki czemu istnieje możliwość podniesienia formatek aplikacji Comarch DMS wskazanej instalacji z poziomu formatki Comarch ERP XL „Historia związanych”.

Konfiguracja wieloinstalacyjności

W tabeli do.DF_ConfCMSettings, która znajduje się w bazie Comarch DMS należy zdefiniować następujące informacje w kolumnach:

CMS_Name – nazwa instalacji (pojawia się jako lista wyboru w oknie logowania),
CMS_URL – adres URL instalacji Comarch DMS (aplikacji serwerowej),
CMS_ERPDBMap – nazwa zmapowanej bazy Comarch ERP XL.

Uwaga

W przypadku wieloinstalacyjności możliwość przejścia do Comarch DMS Repozytorium z poziomu aplikacji desktop może mieć tylko Instalacja 1 (ta, której URL jest zdefiniowany w pliku DMS.exe.config)

Uwaga

W trybie wielofirmowym nie jest możliwe korzystanie z modelu wieloinstalacyjnego.

Przyklad

CMS_Name CMS_URL CMS_ERPDBMap

Instalacja 1 http://www.firma.com/inst1api Nazwa zmapowana 1

Instalacja 2 http://www.firma.com/inst2api Nazwa zmapowana 2

Instalacja 3 http://www.firma.com/inst3api Nazwa zmapowana 3

CMS_Name	CMS_URL	CMS_ERPDBMap
Instalacja 1	http://www.firma.com/inst1api	Nazwa zmapowana 1
Instalacja 2	http://www.firma.com/inst2api	Nazwa zmapowana 2
Instalacja 3	http://www.firma.com/inst3api	Nazwa zmapowana 3

Przykładowe uzupełnienie tabeli do.DF_ConfCMSettings

Uwaga

Wszystkie instalacje powinny pracować na tej samej wersji aplikacji Comarch DMS.

Konfiguracje wieloinstalacyjności należy przeprowadzić na bazie Comarch DMS, która jest domyślną instalacją. Instalacja domyślna to ta, której URL jest zdefiniowany w pliku DMS.exe.config. Dla wersji systemu wcześniejszych niż 2020.2.1 jest to plik ObiegDokumentów.exe.config.