Ręczna konfiguracja aplikacji WEB (nowej aplikacji web)

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

Uwaga

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

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

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

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

 

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

 

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

 

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

 

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

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

<base href=”/DMSWeb/”>

a następnie zapisać wprowadzone zmiany;

 

Uzupełnianie klucza base href w pliku index.html

 

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

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

a następnie zapisać wprowadzone zmiany.

 

Przyklad

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

 

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

 

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

Sprawdź Szkolenia Comarch DMS!




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
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=”ExtendedPdfViewerZoomToPageLevel” value=”false”/> – klucz, który pozwala na dopasowanie rozmiaru załącznika do rozmiaru okna podglądu jedynie w przypadku podglądu za pomocą DevExpress);
  • <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 i aktualizacja aplikacji WEB za pomocą instalatora

Nowy instalator aplikacji web Comarch DMS umożliwia również aktualizację aplikacji serwerowej i aktualizację aplikacji WEB Comarch DMS.

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

 

Następnie aby zaktualizować aplikację web Comarch DMS, należy w ramach okna „Wybór aplikacji” wybrać opcję „Aktualizacja aplikacji Comarch DMS Web” i kliknąć [Dalej].

 

Wybór opcji aktualizacji aplikacji Comarch DMS Web

 

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

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:

  • jeżeli użytkownik utworzył już wcześniej aplikację WEB, wówczas przechodzi do okna „Aktualizacja aplikacji WEB”
  • jeżeli użytkownik nie utworzył jeszcze aplikacji WEB, 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

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ę co najmniej z 8 znaków

Zawierać wielką literę

Zawierać znak specjalny

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

 

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. Opcjonalnie, użytkownik może zmienić hasło dla istniejącej bazy po kliknięciu przycisku [Zmień hasło].

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

  • Składa się z min. 9 znaków
  • Zawiera wielkie litery i male litery
  • Zawiera znak specjalny

 

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

 

Okno zmiany hasła dla użytkownika ODUser

 

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

Po wyborze bazy i (opcjonalnie) zmianie hasła dla istniejącej bazy użytkownik 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.

 

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

Jeśli nawiązano połączenie 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

 

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

 

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

Jeśli nawiązano połączenie 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 firmowej

 

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 „Klucze licencji”.

 

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

 

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 plikuWeb.config. W razie potrzeby użytkownik może wpisać ręcznie inne klucze licencji Comarch DMS zgodnie ze wzorem nazwa_serwera_klucza::numer_klucza. Następnie należy kliknąć na przycisk [Instaluj] , aby przejść do kolejnego kroku.

 

Okno „Klucze licencji” ze wzorcem zapisu kluczy licencji

 

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




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

 

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

 




Comarch DMS Lite

W wersji 2023.0.0 wprowadzono nowy tryb działania systemu Comarch DMS – Comarch DMS Lite.

Comarch DMS Light funkcjonuje analogicznie do dotychczasowego Comarch DMS, ale występują w nim pewne ograniczenia.

Różnice występujące w Comarch DMS Lite:

  • Możliwe jest utworzenie maksymalnie 2 obiegów dokumentów
  • Dodawanie oraz importowanie dokumentów jest zablokowane, jeżeli na liście obiegów dokumentów znajdują się już 2 obiegi
  • Możliwe jest utworzenie maksymalnie 50 kontrolek w ramach każdego z obiegów dokumentów
  • Dodawanie kontrolek jest zablokowane w ramach danego obiegu dokumentów, jeżeli dodano ich już 50 do tego obiegu

 

Nie jest możliwe zalogowanie się do Comarch DMS Lite, jeśli:

  • Liczba obiegów dokumentów w systemie jest większa od dwóch

 

i/albo

 

  • Na którymś z obiegów lub na obydwóch obiegach dokumentów dodano więcej niż po 50 kontrolek

 

  • Comarch DMS Lite domyślnie współpracuje z Comarch ERP Optima, dlatego w systemie dostępne są kontrolki elektroniczne, które korzystają z formatek Comarch ERP Optima
  • Za pracę systemu Comarch DMS w trybie Lite odpowiada wartość „Lite”, którą należy wprowadzić w kluczu WorkMode w pliku Web.config
  • Dostępny jest instalator do wersji Comarch DMS Lite, umożliwiający również instalację Microsoft SQL Express Server
  • Aby korzystać z wersji Comarch DMS Lite, należy posiadać nową licencję

 

Uwaga
W trybie pracy Comarch DMS Lite nie jest dostępna praca z modułem Repozytorium.

W wersji 2023.0.1 dodano komunikaty informujące o braku możliwości pracy z modułem Repozytorium, jeśli Comarch DMS pracuje w trybie Lite.

Jeśli użytkownik w ramach pliku Web.config uzupełnił klucze WorkMode i UseRepository w następujący sposób:

<add key=”WorkMode” value=”Lite” />

<add key=”UseRepository” value=”true” />

wówczas po wejściu do zakładki [Repozytorium] w aplikacji desktop zostanie wyświetlony komunikat Aktualnie pracujesz w Comarch DMS w trybie Lite, w którym uruchomienie modułu Repozytorium jest niemożliwe.

 

Komunikat wyświetlany przy próbie  wejścia do zakładki [Repozytorium] w aplikacji desktop

 

Obiegi dokumentów w Comarch DMS Lite

W ramach licencji Comarch DMS można posiadać i korzystać tylko z 2 obiegów dokumentów. Kiedy na liście typów obiegów dodano już dwa obiegi dokumentów, wówczas możliwość dodawania oraz importowania nowych obiegów jest zablokowana.

Jeśli w ramach zakładki [Definicje obiegów dokumentów] operator, który ma już dodane 2 obiegi dokumentów, wykona jedną z następujących czynności:

  • Kliknie na przycisk [Dodaj]
  • Naciśnie przycisk , a następnie wybierze opcję „Nowy typ obiegu” lub „Obiekt typu Repozytorium dokumentów”
  • Kliknie na ikonę [Importuj]

 

Nowy obieg nie zostanie dodany, natomiast zostanie wyświetlony następujący komunikat, informujący o tym, że dodanie kolejnego typu obiegu nie jest możliwe:

 

Komunikat wyświetlany przy próbie dodania trzeciego typu obiegu w ramach Comarch DMS Lite

 

Okno komunikatu można zamknąć, klikając w przycisk „OK” lub x.

 

Uwaga
Dodanie nowego typu obiegu stanie się możliwe, jeśli zostanie usunięty przynajmniej jeden z dotychczasowych obiegów.

 

Widok zakładki „Definicje obiegów dokumentów” z maksymalną dostępną liczbą typów obiegów w trybie Comarch DMS Lite

 

Kontrolki w Comarch DMS Lite

 

W ramach każdego z dwóch dostępnych typów obiegu możliwe jest dodanie tylko po 50 kontrolek.

 

Uwaga
Kontrolki, które znajdują się w różnych zakladkach i sekcjach w ramach danego typu obiegu również podlegają sumowaniu – takich kontrolek może być łącznie maksymalnie 50. Po osiągnięciu liczby 50 kontrolek w danym typie obiegu mozliwe jest dodanie nowej zakładki lub sekcji, ale nie można w nich dodać nowych kontrolek.

 

Możliwość dodawania nowych kontrolek ulega zablokowaniu, jeżeli na danym obiegu osiągnięto już liczbę 50 dodanych kontrolek.

W takim przypadku po wykonaniu jednej z następujących czynności w ramach panelu „Kontrolki” w danym typie obiegu, a mianowicie:

  • Po kliknięciu na ikonę [Dodaj], wyborze typu kontrolki, wpisaniu jej nazwy i kliknięciu
  • Po naciśnięciu przycisku , następnie opcji „Dodaj kontrolkę”, a potem wyborze typu kontrolki, wpisaniu jej nazwy i kliknięciu

 

nowa kontrolka nie zostaje dodana, natomiast wyświetlany jest następujący komunikat, informujący o baku możliwości dodania nowej kontrolki:

 

Komunikat wyświetlany przy próbie dodania pięćdziesiątej pierwszej kontrolki w ramach Comarch DMS Lite

 

Plik Web.config dla Comarch DMS Lite

Aby pracować w Comarch DMS Lite, należy w kluczu WorkMode w pliku Web.config wpisać wartość „Lite”.

 

Plik Web.config, w którym w kluczu WorkMode wpisano wartość „Lite”

 

Jeśli:

  • Wartość w kluczu WorkMode jest inna niż „Lite”, zaś w kluczu LicenceKeyServerDMS wpisano numer licencji do wersji Comarch DMS Lite – wówczas użytkownik nie może się zalogować, a w oknie logowania wyświetlony zostaje komunikat „Wystąpił błąd przy pobieraniu klucza licencji”
  • Wartość w kluczu WorkMode to „Lite”, zaś w kluczu LicenceKeyServerDMS wpisano numer licencji do standardowej wersji Comarch DMS – wówczas użytkownik może się zalogować i pracować w wersji Lite, może też przełączyć wersję w pliku Web.config na wersję standardową Comarch DMS

 

Ekran logowania do aplikacji desktop, jeżeli wprowadzono niewłaściwy klucz licencji

 

Ekran logowania do aplikacji serwerowej (dawna web), jeżeli wprowadzono niewłaściwy klucz licencji

 

Zmiana trybu pracy ze standardowego Comarch DMS do Comarch DMS Lite

Jeśli użytkownik wykupił licencję Comarch DMS Lite, ale pracował przedtem w wersji standardowej Comarch DMS oraz:

  • Posiadał w wersji standardowej Comarch DMS więcej niż 2 obiegi – wówczas nie może się zalogować w ramach licencji Comarch DMS Lite do poprzednio użytkowanego systemu, a przy próbie logowania wyświetlany jest następujący komunikat:

 

Komunikat wyświetlany przy próbie logowania do Comarch DMS Lite, jeśli użytkownik miał przedtem w standardowym Comarch DMS więcej niż 2 obiegi dokumentów

 

  • Miał więcej niż 50 kontrolek na każdym z obiegów – wówczas nie może się zalogować w ramach licencji Comarch DMS Lite do poprzednio użytkowanego systemu, a przy próbie logowania wyświetlany jest następujący komunikat:

 

Komunikat wyświetlany przy próbie logowania do Comarch DMS Lite, jeśli użytkownik miał przedtem w standardowym Comarch DMS więcej niż 50 kontrolek

 

W takich przypadkach aby móc pracować na licencji Comarch DMS Lite, należy wybrać jeden z poniższych sposobów postępowania:

  • Usunąć nadmiar obiegów i kontrolek, tak aby pozostały tylko dwa obiegi po max. 50 kontrolek każdy przed wygaśnięciem licencji standardowej Comarch DMS
  • Eksportować wszystkie obiegi dokumentów zanim wygaśnie licencja standardowa, a następnie importować wybrane obiegi do nowego systemu, pracującego na licencji Lite
  • Skonfigurować system od nowa na licencji Lite

 

Instalacja Comarch DMS Lite

W oknie „Tryb pracy” w instalatorze  Comarch DMS we współpracy z Comarch ERP Optima dodano checkbox „Comarch DMS Lite”, który domyślnie jest odznaczony – wówczas Comarch DMS będzie pracował w trybie standardowym. Jeżeli natomiast operator podczas instalacji zaznaczy checkbox – wówczas Comarch DMS będzie pracował w trybie Lite.

Wybór opcji „Comarch DMS Lite” w oknie „Tryb pracy” w instalatorze

Po przejściu kolejnych kroków instalacji (zob. Instalacja aplikacji serwerowej i WEB za pomocą instalatora) należy w ramach okna „Pula aplikacji” dodać nową pulę lub wybrać już istniejącą z listy.

Pula aplikacji w przypadku instalacji Comarch DMS Lite jest personifikowana, a zatem w ramach pól „Login” i „Hasło”, które znajdują się poniżej listy, należy wpisać login i hasło użytkownika domenowego, w którego kontekście ma pracować pula aplikacji (podanie loginu oraz hasła użytkownika jest związane z koniecznością zmiany tożsamości puli z ApplicationPoolIdentity na konto niestandardowe).

Przycisk „Dalej” jest nieaktywny aż do czasu uzupełnienie pól „Login” i „Hasło”

Uwaga
W przypadku instalacji Comarch DMS w pozostałych trybach ( w tym we współpracy z Comarch DMS Optima bez trybu Lite) pula aplikacji jest konfigurowana z tożsamością konta wbudowanego ApplicationPoolIdentity

 

Okno „Pula aplikacji”, jeśli instalowany jest Comarch DMS Lite

Po kliknięciu przycisku „Dalej” ma miejsce walidacja poprawności danych konta użytkownika.

Jeśli wprowadzony login albo hasło są nieprawidłowe, wówczas przejście do kolejnego etapu instalacji zostaje zablokowane aż do czasu wpisania poprawnych danych i wyświetlony zostaje  komunikat „Login lub hasło nie są prawidłowe. Zweryfikuj poprawność wprowadzonych danych”:

Okno „Pula aplikacji”, jeśli dane wprowadzone w polach „Login” i „Hasło” są błędne

Jeżeli wprowadzone dane są prawidłowe, wówczas po kliknięciu przycisku „Dalej” nastąpi przejście do okna „Kreowanie aplikacji”.

Kreowanie aplikacji serwerowej

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

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

 

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

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

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

Informacja o znakach zakazanych w oknie „Kreowanie aplikacji serwerowej”

 

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

Okno „Kreowanie aplikacji serwerowej”

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

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

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

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

 

Okno „Kreowanie aplikacji serwerowej” podczas dodawania nowej witryny

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

 

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

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

 

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

 

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

 

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

 

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

Kreowanie aplikacji WEB

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

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

 

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

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

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

 

Informacja o znakach zakazanych w oknie „Kreowanie aplikacji WEB”

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

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

 

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

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

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

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

 

Okno „Kreowanie aplikacji WEB” podczas dodawania nowej witryny

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

 

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

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

 

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

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

 

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

 

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

 

Opcje instalacji

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

Okno „Opcje instalacji” w przypadku instalacji Comarch DMS w trybie Lite

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

  • Utwórz osobną bazę danych dla Comarch DMS – domyślnie zaznaczony parametr; wyświetlany w przypadku instalacji Comarch DMS we współpracy z systemami Comarch ERP. Jeżeli parametr zostanie odznaczony, wówczas system Comarch DMS będzie korzystał z bazy firmowej systemu Comarch ERP Optima
  • Opcja zmiany języka na ekranie logowania do aplikacji – jeżeli parametr zostanie zaznaczony, wówczas na ekranie logowania dostępny będzie link [aplikacja desktop] lub [aplikacja serwerowa], 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ę co najmniej z 8 znaków
      • Zawierać wielkie i małe litery
      • Zawierać znak specjalny
  • Wersja Premium – opcja domyślnie zaznaczona i wyszarzona (nie do edycji); funkcjonalność modelowania procesów za pomocą kodu C#

Po ustawieniu parametrów należy kliknąć na przycisk [Dalej], aby kontynuować instalację – kolejne kroki instalacji przebiegają tak, jak przedstawiono w artykule Instalacja aplikacji serwerowej i WEB za pomocą instalatora

 

W przypadku instalacji ręcznej aplikacji serwerowej i WEB przebiega ona analogicznie do instalacji Comarch DMS we współpracy z Comarch ERP Optima (zob. Instalacja aplikacji serwerowej (dawnej web) w trybie ręcznym oraz Ręczna konfiguracja aplikacji WEB (nowej aplikacji web)).