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 ekranunacisnąć link „Otwórz funkcje”.
3.zaznaczyć parametr „Enable proxy” w ramach zakładki „Application Request Routing” i potwierdzić zmianę przyciskiem „Zastosuj”.
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;
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)
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?
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).
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.
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].
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.
Instalator aplikacji desktopowej umożliwia:
pierwszą instalację
ponowną instalację
Po uruchomieniu instalatora zostaje wyświetlone okno początkowe, gdzie należy nacisnąć przycisk „Dalej”
W kolejnym kroku zostaje wyświetlone okno zawierające warunki korzystania z oprogramowania Comarch DMS. Aby przejść do kolejnego kroku instalacji, należy zaznaczyć parametr ” Akceptuję warunki gwarancji i korzystania z oprogramowania Comarch DMS” i nacisnąć przycisk „Dalej”.
W następnym kroku wymagany jest wybór folderu docelowego, w którym zostanie zainstalowana aplikacja stacjonarna. Lokalizację można zmienić, wpisując odpowiednią ścieżkę w polu „Folder:” lub wybierając folder po naciśnięciu przycisku „Przeglądaj”. Po wyborze folderu docelowego należy wybrać „Dalej”.
W kolejnym kroku należy wprowadzić adres URL aplikacji serwerowej (starszej aplikacji web) Comarch DMS.
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.
Następnie konieczne jest sprawdzenie poprawności połączenia za pomocą przycisku „Sprawdź połączenie”. Jeżeli wpisano poprawny adres URL, pod przyciskiem powinna pojawić się informacja „Wprowadzony adres URL jest prawidłowy”.
Po wprowadzeniu adresu URL i jego pozytywnej weryfikacji 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.
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.
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
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.
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:
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
W kolejnym oknie instalatora należy wybrać przycisk [Dalej], aby kontynuować aktualizację.
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].
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
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.
W tym celu w ramach okna Aktualizacja aplikacji serwerowej w polu Wybierz aplikację serwerową dostępna jest opcja Aplikacja zainstalowana w witrynie.
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ę.”.
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:
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”.
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ę.”.
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ę].
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.
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
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.
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ę].
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ę].
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ę 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”.
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”.
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
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.
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”.
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
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.
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”.
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.
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.
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.
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”.
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:
a następnie klikając Enter – wówczas zostaną uruchomione skrypty.
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.
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.
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”.
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:
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.
Przyklad
Sposób 2
W katalogu DMS Workflow Api \SqlOptima należy odnaleźć plik InstallOptimaConf.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_konfiguracyjnej_Comarch_ERP_Optima
a następnie zapisać zmiany i zamknąć okno.
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.
Następnie w tym samym katalogu DMS Workflow Api \SqlOptima należy odnaleźć plik InstallOptimaComp.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_firmowej_Comarch_ERP_Optima
a następnie zapisać zmiany i zamknąć okno.
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.
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”.
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:
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)
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?
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
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
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#