Wymagania sprzętowe, oprogramowanie i licencje serwerowe
Zalecane przeglądarki
Do pracy z modułem zalecane są przeglądarki:
Microsoft Edge;
Google Chrome;
Mozilla Firefox;
Opera.
Porty, które powinny zostać otwarte dla Comarch DMS
Na serwerze MSSQL należy odblokować domyślny port 1433, aby móc nawiązać komunikację z serwerem IIS i ewentualnie innymi serwerami, w przypadku instalacji na wielu różnych maszynach
Na maszynie, na której zainstalowano Comarch ERP Menadżer Kluczy należy otworzyć port SSL 443, aby umożliwić komunikację z serwerami Comarch
Można włączyć komunikację na porcie 5150, połączenie to wspiera komunikację Comarch ERP Menadżer Kluczy z serwerem IIS
Dodatkowo:
W SQL Management Studio należy włączyć „Authentification mixed mode”, a także upewnić się, że został utworzony użytkownik „SA”
Zalecana konfiguracja sprzętowa serwera IIS
Wymagany sprzęt – zalecenia minimalne:
VCPU – 2 x 2.2 GHz
RAM – 8 GB
HDD/SSD – 120 GB
Kontroler z obsługą RAID
Konfiguracja RAID – RAID1
NIC – Interfejs sieciowy 100/1000 Mb/s (w zależności od całości infrastruktury)
Zapewnienie możliwości rozbudowy:
Możliwość rozbudowy do 4 CPU
Możliwość rozszerzenia pamięci RAM powyżej 8 GB
Wymagane oprogramowanie serwera IIS
System operacyjny (jedna z poniższych możliwości):
Windows Server 2016
Windows Server 2019
Windows Server 2022
Dodatkowe wymagania:
IIS w wersji 7.x lub nowszej
.Net Framework 4.7.2 lub wyższa (zalecana 4.8)
Wymagane licencje na oprogramowanie dla serwera IIS
Licencja na system operacyjny
Jeden z dostępnych rodzajów licencji:
BOX
OEM
MOLP
Licencje klienckie (dostępowe) do serwera SQL
Liczba wymaganych licencji dostępowych powinna odpowiadać ilości użytkowników lub urządzeń posiadających dostęp do serwera IIS (logujących się do Comarch DMS). W związku z tym, w niektórych przypadkach bardziej korzystnym rozwiązaniem może okazać się zakup licencji „per Core”.
Wymagane licencje:
CAL SQL Server 2014/2016/2017/2019/2022 lub
CAL SQL Server 2014/2016/2017/2019/2022 Runtime i
CAL Windows Server 2016/2019/2022 lub licencja External Connector (dotyczy użytkowników zewnętrznych)
Ograniczenia i uwagi
Nie można łączyć licencji na serwer z licencjami CAL w sytuacji, kiedy są one dedykowane dla różnych wersji językowych.
Zalecana konfiguracja sprzętowa serwera SQL
Zalecaną konfiguracją współpracy Comarch DMS z serwerem MS SQL jest użycie serwera MS SQL przygotowanego dla ERP XL. W przypadku konfiguracji „Standalone” lub konfiguracji z wykorzystaniem dwóch serwerów MS SQL, zalecane wymagania sprzętowe zostały przedstawione poniżej.
Wymagany sprzęt – zalecenia minimalne:
VCPU – 8 x 2.2 GHz
RAM – 16 GB, zalecane 31 GB
HDD/SSD – 200 GB (dla 100 tys. dokumentów DMS bez załączników należy zarezerwować 3 GB + rozmiar na załączniki przy założeniu: 200 kb dla jednej strony załącznika czarno-białego, 500 kb dla jednej strony załącznika kolorowego)
Kontroler z obsługą RAID
NIC – Interfejs sieciowy 100/1000 Mb/s (w zależności od całości infrastruktury)
Wymagane oprogramowanie SQL
System operacyjny:
Windows Server 2016 Standard/Datacenter Edition
Windows Server 2019 Standard/Datacenter Edition
Windows Server 2022 Standard/Datacenter Edition
Baza danych:
MS SQL 2014 Server Standard/Enterprise Edition x86/x64
MS SQL 2016 Server Standard/Enterprise Edition x86/x64
MS SQL 2017 Server Standard/Enterprise Edition x86/x64
MS SQL 2019 Server Standard/Enterprise Edition x86/x64
MS SQL 2022 Server Standard/Enterprise Edition x86/x64
Uwaga
Możliwa jest również instalacja z wykorzystaniem serwera MS SQL Express. Należy pamiętać o ograniczeniach związanych z maksymalną wielkością bazy danych (max 10 GB) oraz maksymalną ilością alokowanej pamięci (max 1 GB).
Licencje:
Konieczny jest zakup licencji na: system operacyjny, serwer baz danych oraz wymaganych licencji CAL dla serwera SQL i systemu operacyjnego.
Zalecana konfiguracja sprzętowa serwera MongoDB
(jeśli Comarch DMS ma aktywną współpracę z modułem Comarch DMS Repozytorium – zob. Comarch DMS – Repozytorium)
VCPU – 8 x 2.2 GHz
RAM – 32 GB, zalecane 64 GB
HDD/SSD – wielkość dysku zależy od ilości przechowywanych załączników. Można przyjąć założenie: 200 kB dla jednej strony załącznika czarno-białego i 500 kB dla jednej strony załącznika kolorowego.
Kontroler z obsługą RAID
NIC – Interfejs sieciowy 1000 Mb/s
Wymagane oprogramowanie
(jeśli Comarch DMS ma aktywną współpracę z modułem Comarch DMS Repozytorium – zob. Comarch DMS – Repozytorium)
Uwaga
Repozytorium należy zainstalować na tej samej witrynie, na której znajduje się moduł Workflow (np. Default Web Site).
Konieczny jest zakup licencji na: system operacyjny, licencji CAL systemu operacyjnego w przypadku
systemu Windows.
Rozwiązanie dedykowane pod jeden serwer MongoDB, zalecana ilość dokumentów to 6 mln.
Obciążenie serwera uruchomioną aplikacją DMS w sesji terminalowej.
Obciążenie na jedną sesje terminalową z uruchomioną aplikacją Comarch DMS:
CPU – średnio 300 MHz
RAM – max. 600 MB
HDD – 0,1 MB
Licencje – Licencja dostępu terminalowego dla każdego użytkownika (cal)
Konfiguracja sprzętowa dla stacji roboczej
Wymagany sprzęt – zalecenia minimalne:
CPU – Procesory z rodziny Intel /AMD 1 GHz lub szybszy
RAM – 4 GB
Pamięć masowa – HDD lub SSD
NIC – Interfejs sieciowy 100/1000 Mb/s (w zależności od całości infrastruktury)
Ekran – 1024×768
Wymagane oprogramowanie dla stacji roboczej
System operacyjny:
Windows 10
Windows 11
.Net Framework:
4.7.2 lub wyższy (zalecany 4.8)
Wydajność systemu Comarch DMS
Wydajność Comarch DMS zależy w znacznym stopniu od złożoności realizowanych procesów, tj. od liczby kontrolek zdefiniowanych na karcie obiegu, wykorzystania mechanizmów inicjowania wartości kontrolek skryptami SQL i C# oraz od liczby kolumn zdefiniowanych na liście dokumentów.
Optymalnymi ilościami, które nie powinny być przekraczane to ok. 100 kontrolek na karcie obiegu i 10 dodatkowych kolumn na liście dokumentów.
Optymalna liczba dokumentów wprowadzanych do systemu to ok. 400 000 dokumentów rocznie w ramach jednego typu obiegu.
Repozytorium – informacje ogólne
Celem modułu Repozytorium jest przechowywanie dokumentów w formie plików w ramach kreowanej przez administratorów i (częściowo) edytorów struktury folderów.
Dostęp danego pracownika do danego folderu lub pliku zależy od tego, czy zostały mu do niego przyznane uprawnienia. W ramach modułu Repozytorium widoczne są dla użytkownika tylko te foldery i pliki, do których przyznał mu dostęp użytkownik o uprawnieniach administratora (Repozytorium lub lokalnego).
Rozpoczynasz pracę z Comarch DMS Repozytorium i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch DMS Repozytorium i chcesz dowiedzieć się więcej?
W bieżącej wersji wymagane jest, żeby użytkownik, który korzysta z modułu Repozytorium, posiadał licencję umożliwiającą pracę z tym modułem.
Weryfikacja licencji na moduł Repozytoriumbędzie następowała za każdym razem, kiedy wykorzystywane będą dane Repozytorium.
Jeżeli użytkownik będzie próbował korzystać z funkcjonalności modułu Repozytorium, choć nie posiada licencji na korzystanie z tego modułu, wyświetlony zostanie komunikat informujący o zaistniałym problemie.
Bez licencji na pracę z modułem Repozytorium nie jest możliwe:
otworzenie okna Repozytorium
dodanie w ramach Comarch DMS załącznika do dokumentu, którego załączniki są zapisywane w Repozytorium
zapis w ramach Comarch DMS dokumentu, którego załączniki są zapisywane w Repozytorium
Rozpoczynasz pracę z Comarch DMS Repozytorium i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch DMS i chcesz dowiedzieć się więcej?
Moduł Repozytorium jest dostępny zarówno dla Comarch DMS Standalone, jak i dla wszystkich form współpracy: z Comarch ERP XL, Comarch ERP Optima, Comarch ERP Altum i Comarch ERP Enterprise (CEE).
Uwaga
Moduł Repozytorium nie funkcjonuje w przeglądarce Internet Explorer. Do pracy z modułem zalecane są przeglądarki:
Microsoft Edge
Google Chrome
Mozilla Firefox
Opera
Uwaga
Od wersji 2023.1.0 aby możliwa była poprawna współpraca z modułem Repozytorium należy kolejno:
1.zainstalować dodatek Application Request Routing, dostępny pod następującym adresem:
2. w ramach Menedżera Internetowych usług Internetowych kliknąć na ikonę „Application Request Routing Cache”
3.w ramach panelu „Akcje” po prawej stronie ekranunacisnąć link „Otwórz funkcje”.
4.zaznaczyć parametr „Enable proxy” w ramach zakładki „Application Request Routing” i potwierdzić zmianę przyciskiem „Zastosuj”.
Uwaga
W wersji 2023.0.0 zaktualizowano .net core do .net6.
Z tego powodu wymagana jest aktualizacja w środowisku Windows pakietu IIS Hosting Bundle do wersji 6.0 albo wyższej– aktualizację można pobrać ze strony https://dotnet.microsoft.com/en-us/download/dotnet/6.0
Obsługa bazy danych MongoDB nie ulega zmianie. Zalecane jest korzystanie z wersji 4.4 – 5.0
Uwaga
Nastąpiły zmiany w lokalizacji ustawień modułu Comarch DMS Repozytorium: definicjach atrybutów i typów dokumentów – przeniesiono je do wersji web aplikacji.
System Comarch DMS składa się z modułów:
Comarch DMS Workflow (Obieg Dokumentów)
Comarch DMS Repozytorium
Aby umożliwić działanie modułu Workflow i modułu Repozytorium, niezbędne jest zainstalowanie trzech odrębnych aplikacji na serwerze IIS, z których dwie służą potrzebom modułu Comarch DMS Workflow (Obieg Dokumentów) i jedna tworzy moduł Comarch DMS Repozytorium.
Instalacja serwera MongoDB w systemie Windows
Uwaga
Minimalna obsługiwana wersja serwera MongoDB to wersja 4.2.
W celu pobrania instalatora serwera MongoDB należy wejść na stronę https://www.mongodb.com/, następnie wybrać zakładkę „Products”, później „Community Edition”, następnie „MongoDB Community Server”, nacisnąć zielony przycisk„Select package”, wybrać wersję MongoDB w polu „Version”, a następnienacisnąć zielony przycisk „Download”(bezpośredni link do „MongoDB Community Server”: MongoDB Community Download | MongoDB).
Proces instalacji przedstawiony poniżej to skrócona wersja instalacji – przy założeniu, że na tej samej maszynie, gdzie Mongo DB jest uruchamiany, zainstalowana jest też baza.
1.Po pobraniu pliku instalacyjnego należy go otworzyć. Wówczas na ekranie pojawia się okno instalatora Mongo DB, gdzie powinno się kliknąć „Next”.
2. Następnie należy wyrazić zgodę na umowę licencyjną, zaznaczając checkbox i kliknąć „Next”.
3. Kolejnym krokiem jest wybór typu instalacji – należy wybrać opcję „Complete”.
4. Następnie należy w oknie konfiguracji usługi wybrać checkbox „Run service as Network Service user”.
5. W kolejnym oknie instalacyjnym zaznacza się parametr „Install Mongo DB Compass”.
Mongo DB Compass to aplikacja, która służy do przeglądania bazy danych, analogicznie do SSMS dla SQL Server. Po wyborze przycisku „Next” następuje przejście do kolejnego okna.
6. Następnie należy kliknąć „Install”.
7. Na zakończenie instalacji należy kliknąć przycisk „Finish”.
Po ukończeniu instalacji konieczne jest upewnienie się, czy usługa MongoDB jest uruchomiona. Można to sprawdzić wchodząc do Menedżera zadań systemu Windows, wybierając zakładkę Usługi i znajdując pozycję Mongo DB, dla której w polu „Stan” powinno wyświetlać się „Uruchomiony”.
Dodawanie administratora MongoDB i bazy danych dla Comarch DMS Repozytorium za pomocą MongoDB Compass
Po instalacji na MongoDB należy uruchomić MongoDB Compass. Jeśli Mongo DB zostało zainstalowane lokalnie, wówczas nie ma konieczności uzupełniania connection stringa – wystarczy nacisnąć „Connect”, aby zalogować się do serwera.
Kiedy zalogowano się do serwera Mongo DB, wówczas:
1. należy utworzyć użytkownika o uprawnieniach administratora na serwerze– w poniższym przykładzie taki użytkownik to admin, zaś jego hasło to Passwd1234. Posiada najwyższy poziom uprawnień na serwerze.
Aby utworzyć użytkownika należy:
wpisać instrukcję use admin na konsoli _MONGOSH BETA,
zatwierdzić przyciskiem Enter,
wprowadzić na konsoli _MONGOSH BETA następujące polecenie:
Wielkość liter w nazwach użytkowników jest istotna dla logowania
Wskazówka
Zaleca się zmianę hasła na inne mocne hasło.
Uwaga
Jeżeli w mocnym haśle został użyty znak „@”, wówczas w ConnectionString konieczne jest wpisanie „%40” zamiast „@”. Potrzeba zmiany wynika z tego, że Mongo traktuje znak „@” jako oddzielenie pozycji.
2. Następnie należy utworzyć bazę danych dla Comarch DMS Repozytorium i dodać użytkownika, dla którego będzie następowało łączenie się aplikacji Comarch DMS Repozytorium z bazą danych. W tym celu konieczne jest, aby:
wpisać instrukcję use Repository (Repository to nazwa przykładowej bazy Repozytorium) na konsoli _MONGOSH BETA,
zatwierdzić przyciskiem Enter,
wprowadzić na konsoli _MONGOSH BETA następujące polecenie, aby dodać użytkownika:
Wielkość liter w nazwach użytkowników jest istotna dla logowania
Wskazówka
Zaleca się zmianę hasła na inne mocne hasło.
Uwaga
Jeżeli w mocnym haśle został użyty znak „@”, wówczas w ConnectionString konieczne jest wpisanie „%40” zamiast „@”. Potrzeba zmiany wynika z tego, że Mongo traktuje znak „@” jako oddzielenie pozycji.
Po wykonaniu powyższych czynności Mongo DB Compass może zostać zamknięty.
Wprowadzanie zmian w pliku mongod.cfg
Następnie należy dokonać edycji pliku konfiguracyjnegomongod.cfg.
Plik znajduje się w lokalizacji:
<install directory>\bin\mongod.cfg
domyślnie lokalizacja to: C:\Program Files\MongoDB\Server\<wersja>\bin\mongod.cfg
Zmiany, których należy dokonać w pliku mongod.cfg:
1. w sekcji #network interfaces:
port: 27017 – port domyślny
bindIp: 127.0.0.1 – domyślnie jest w tym miejscu ustawiony localhost – tu powinien być umieszczony adres IP klienta, który komunikuje się z serwerem bazodanowym (dla Comarch DMS Repozytorium: z serwerem IIS). Jeżeli zamiast bindIp zostanie wpisane bindIpAll: true, wówczas można będzie połączyć się z serwerem z każdego komputera.
2. w sekcji #security:
Uwaga
Należy usunąć znak # przedsecurity
Uwaga
Należy dodać dwie spacje i wpisaćauthorization: enabled
Uwaga
Bez dwóch spacji przed authorization: enabled serwer nie będzie mógł zostać uruchomiony.
Dzięki tej zmianie możliwe będzie logowanie do bazy MongoDB przy użyciu loginu i hasła.
Następnie należy zapisać plik i uruchomić ponownie serwer MongoDB w Menedżerze zadań Windows, klikając na niego prawym przyciskiem myszy i naciskając „Uruchom ponownie”.
Uwaga
Podczas ponownego łączenia do MongoDB Compass konieczne będzie wpisanie connection stringa według poniższego wzoru:
Kiedy zainstalowano serwer, kolejnym krokiem jest wprowadzenie zmian w pliku konfiguracyjnymmongod.conf, dostępnym w lokalizacji: /etc/mongod.conf. Polecenie, które uruchamia plik mongod.conf do edycji, to:
sudo gedit/etc/mongod.conf
Zmiany, których należy dokonać w pliku mongod.conf:
1. w sekcji #network interfaces:
port: 27017 – port domyślny
bindIp: 127.0.0.1 – domyślnie jest w tym miejscu ustawiony localhost – tu powinien być umieszczony adres IP klienta, który komunikuje się z serwerem bazodanowym (dla Comarch DMS Repozytorium: z serwerem IIS). Jeżeli zamiast bindIp zostanie wpisane bindIpAll: true, wówczas można będzie połączyć się z serwerem z każdego komputera.
2. w sekcji #security:
Uwaga
Należy usunąć znak# przedsecurity
Uwaga
Należy dodać dwie spacje i wpisaćauthorization: enabled
Uwaga
Bez dwóch spacji przed authorization: enabled serwer nie będzie mógł zostać uruchomiony.
Dzięki tej zmianie możliwe będzie logowanie do bazy MongoDB przy użyciu loginu i hasła.
Po zapisaniu wprowadzonych zmian należy ponownie uruchomić serwer MongoDB, przykładowo używając poniższej komendy:
sudo systemctl restart mongod
Dodawanie administratora MongoDB i bazy danych dla Comarch DMS Repozytorium z poziomu terminala w Ubuntu
Następnie należy zalogować się do MongoDB z poziomu terminala w Ubuntu, a później utworzyć bazę danych i dodać operatora, dla którego nastąpi łączenie się Comarch DMS Repozytorium z bazą danych.
Aby utworzyć bazę, powinna zostać wpisana komenda: use Repository.
W dalszej kolejności należy utworzyć użytkownika, zaczynając od wpisania komendy use admin.
Później konieczne jest wprowadzenie polecenia, które utworzy użytkownika o uprawnieniach administratora na serwerze – w poniższym przykładzie taki użytkownik to admin, zaś jego hasło to Passwd1234. Posiada najwyższy poziom uprawnień na serwerze:
Wielkość liter w nazwach użytkowników jest istotna dla logowania.
Wskazówka
Zaleca się zmianę hasła na inne mocne hasło.
Uwaga
Jeżeli w mocnym haśle został użyty znak „@”, wówczas w ConnectionString konieczne jest wpisanie „%40” zamiast „@”. Potrzeba zmiany wynika z tego, że Mongo traktuje znak „@” jako oddzielenie pozycji.
Następnie należy dodać użytkownika, dla którego będzie następowało łączenie się aplikacji Comarch DMS Repozytorium z bazą danych. W tym celu konieczne jest wprowadzenie następującego polecenia:
Tworzenie i odtwarzanie backupów bazy danych MongoDB
Backupy baz danych Mongo DB mogą być tworzone i odtwarzane za pomocą narzędzi mongodump oraz mongorestore, które należą do MongoDB Database Tools. Można je pobrać ze strony producenta:
Zanim rozpocznie się konfigurację aplikacji Comarch DMS na serwerze IIS, konieczne jest zainstalowanie dwóch komponentów, niezbędnych do poprawnego działania aplikacji:
Jeżeli aktualizację przeprowadzono w trybie ręcznym, konieczne jest zaktualizowanie aplikacji Comarch DMS: serwerowej, web i desktop, a w ustawieniach puli aplikacji zmiana wartości parametruWłącz aplikacje 32-bitowenaFalse. Tych czynności nie trzeba wykonywać, jeśli do aktualizacji został użyty instalator.
Przenoszenie katalogu DMS Repository Api
Jeżeli na serwerze nie jest zainstalowany Comarch DMS, konieczna jest instalacja aplikacji Comarch DMS serwerowej, WEB i desktop według instrukcji znajdującej się na stroniehttps://pomoc.comarch.pl/dms/ po wejściu do kategorii wybranej współpracy, w rozdziale Instalacja i konfiguracja.
Następnie należy z pakietu instalacyjnego z lokalizacji Comarch DMS {wersja} \ Comarch DMS {wersja} skopiować zawartość katalogu DMS Repository Api do folderu w lokalizacjiC:\inetpub\wwwroot, np. do katalogu DocumentManager.WebApi.
Uwaga
Od wersji 2024.0.0 w pakiecie instalacyjnym nie znajduje się już folder DocumentManager.WebClient, a zamiast folderu DocumentManager.WebApi dostępny jest folder DMS Repository Api.
Dodawanie nowej puli aplikacji dla Comarch DMS Repozytorium
Comarch DMS Repozytorium jest modułem Comarch DMS, jednak musi zostać zainstalowany jako osobna aplikacja na serwerze IIS i wymaga osobnej puli aplikacji.
Uwaga
Z powodu różnych właściwości nie można wykorzystać tej samej puli aplikacji dla aplikacji DMS i Repozytorium.
Uwaga
Repozytorium należy zainstalować na tej samej witrynie, na której znajduje się moduł Workflow (np. Default Web Site)
Dla puli aplikacji dedykowanej modułowi Comarch DMS Repozytorium konieczne jest określenie wersji środowiska .NET CLR jako ’Bez kodu zarządzanego’.
Dla puli aplikacji dedykowanej modułowi Comarch DMS Workflow (Obieg Dokumentów) konieczne jest określenie wersji środowiska .NET CLR jako.NET CLR v4.0.
Następnie należy nacisnąć opcję „Ustawienia zaawansowane„, dostępną do wyboru po kliknięciu na „Pule aplikacji„, a następnie naciśnięciu nazwy odpowiedniej puli prawym przyciskiem myszy. Można też, alternatywnie, kliknąć nazwę puli i wybrać opcję z paska „Akcje” po prawej stronie ekranu.
W ramach „Ustawień zaawansowanych” konieczne jest ustawienie parametru ’Włącz aplikacje 32-bitowe’ na False.
Konwertowanie katalogu DocumentManager.WebApi na aplikację
1. W kolejnym kroku należy w ramach Menedżera IIS nacisnąć prawym przyciskiem myszy folderDocumentManager.WebApi i wybrać opcję „Konwertuj na aplikację„.
2. Następnie otworzy się okno „Dodawanie aplikacji„, w którym należy nacisnąć opcję „Wybierz„, wybrać pulę aplikacji dedykowaną Comarch DMS Repozytorium – w poniższym przykładzie jest to pula „DMS_repository” – i nacisnąć „Ok„.
W ramach Comarch DMS można korzystać z Managera dokumentów lub z modułu Repozytorium, nie jest jednak możliwe jednoczesne korzystanie z obydwóch opcji.
Domyślnie włączony jest Manager dokumentów, dlatego aby włączyć obsługę modułu Comarch DMS Repozytorium, w kluczu Web.config, dostępnym w folderze z aplikacją serwerową (dawną web) Comarch DMS należy uzupełnić 3 następujące klucze:
<add key=”UseRepository” value=”true” /> – umożliwiający włączenie Repozytorium poprzez wpisanie wartości „true” (jeżeli pozostanie „false”, włączony będzie Manager dokumentów)
<add key=”RepositoryUrl” value=”http://<ip serwera>/DocumentManager.WebApi” /> – w tym kluczu konieczne jest wprowadzenie adresu URL aplikacji Repozytorium, przykładowo:
http://localhost/DocumentManager.WebApi
<add key=”WebClientUrl” value=”http://<ip serwera>/DocumentWorkflow.Web” /> – wprowadzony w wersji 2024.0.0; klucz, w którym (w przypadku korzystania z funkcjonalności Comarch DMS Repozytorium) należy wprowadzić adres nowej aplikacji WEB, przykładowo:
Od wersji 2024.0.0 moduł Repozytorium nie jest dostępny z poziomu aplikacji serwerowej Comarch DMS (dawnej aplikacji web).
Wskazówka
Adres URL aplikacji DocumentManager.WebApi można sprawdzić, klikając w daną aplikację w Menedżerze internetowych usług informacyjnych (IIS) i naciskając opcję „Przeglądaj *:80 (http)” w panelu ” Zarządzaj aplikacją” po prawej stronie ekranu.
Adres strony widoczny w otwartym oknie przeglądarki to adres danej aplikacji.
Wprowadzanie zmian w appsettings.json, pliku konfiguracyjnym serwera
Uwaga
Przed przejściem do kolejnych kroków konfiguracji zaleca się zatrzymanie utworzonej witryny sieci web albo całego serwera IIS.
Następnie konieczne jest wejście do katalogu z aplikacją Repozytorium (np. DocumentManager.WebApi), dostępnym domyślnie w lokalizacji C:\inetpub\wwwroot\ , a następnie edycja znajdującego się tam pliku konfiguracyjnego appsettings.json , w którym należy uzupełnić poniższe informacje:
Wskazówka
Wielkość znaków w parametrach nie ma znaczenia.
1. „IdentityMongoDatabaseSettings” – connection string do bazy Comarch DMS Repozytorium, która zawiera konta użytkowników.
Przyklad
Connection string powinien składać się z takich części:
W tym parametrze powinien zostać wprowadzony adres aplikacji serwerowej modułu Workflow – taki, jak został wprowadzony w dms.exe.config – pliku konfiguracyjnym aplikacji desktop
4. ”StorageSettings” – ustawienia bazy, która przechowuje pliki
„Type” – właściwość, która określa domyślne miejsce przechowywania plików dodawanych do Comarch DMS Repozytorium. Może przyjmować wartości:
„IBard” – wtedy pliki dodawane do Repozytorium będą przechowywane w usłudze Comarch IBARD
„Mongo” – wtedy pliki dodawane do Repozytorium będą przechowywane w bazie MongoDB
”IBARDStorageSettings” – parametr uzupełniany, jeśli wybrano bazę IBARD, baza danych, która przechowuje dane wymagane dla IBARD
„ConnectionString” – connection string do bazy z konfiguracją współpracy z IBARD – znajduje się tu ta sama informacja, która w wersji poprzedniej była w IBARDMongoDatabase Settings
Uwaga
Jeśli wszystkie pliki Comarch DMS Repozytorium mają być przechowywane tylko w usłudze IBARD – wówczas należy usunąć pozycje „MongoStorageSettings”, „ConnectionString”, „ChunkSizeBytes”.
Uwaga
W przypadku przechowywania plików z Repozytorium w usłudze IBARD po uzupełnieniu „Connection String” w „IBARDStorageSettings” konieczne jest zalogowanie do usługi IBARD w sekcji „Przechowywanie plików” w zakładce „Ustawienia” w aplikacji desktop Comarch DMS, klikając przycisk „Autoryzacja„.
Przyklad
Przykład uzupełnienia pliku appsettings.json, jeśli wszystkie pliki mają być przechowywane w usłudze Comarch IBARD:
”MongoStorageSettings” – parametr uzupełniany, jeśli wybrano bazę MongoDB, baza danych, która przechowuje pliki binarne.
W tym parametrze należy uzupełnić „ConnectionString” do bazy, która będzie służyć do przechowywania plików dodawanych do Comarch DMS Repozytorium.
Drugi klucz, ”ChunkSizeBytes”, dotyczy tylko plików przechowywanych w bazie MongoDB, definiuje maksymalny rozmiar pojedynczej części pliku (w bajtach), który jest dodawany do bazy.
Uwaga
Jeżeli przesyłany plik okaże się być większego rozmiaru niż określono w ”ChunkSizeBytes”, plik ulegnie podziałowi na tyle części, ile razy ”ChunkSizeBytes” mieści się w rozmiarze tego pliku, z ewentualnym jednym dodatkowym plikiem (jeśli z podziału zostanie reszta).
Uwaga
Jeśli wszystkie pliki Comarch DMS Repozytorium mają być przechowywane tylko w usłudze Mongo – wówczas należy usunąć pozycje „IbardStorageSettings” i jego „ConnectionString”.
Przyklad
Przykład uzupełnienia pliku appsettings.json, jeśli wszystkie pliki mają być przechowywane w bazie MongoDB:
Możliwa jest również sytuacja, w której podczas pracy z Comarch DMS Repozytorium zostało zmienione miejsce przechowywania plików z usługi IBARD na bazę MongoDB – wtedy możliwe jest korzystanie z plików przechowywanych zarówno w IBARD, jak i w MongoDB. Warunkiem jest uzupełnienie „Connection String” w kluczu „IBARDStorageSettings” (tak, żeby następowało połączenie z bazą, która przechowuje konfigurację współpracy z IBARD) oraz „Connection String” w kluczu „MongoStorageSettings” (tak, żeby następowało połączenie z bazą, która przechowuje pliki). Przy takim uzupełnieniu connection stringów domyślnie pliki, które zostaną dodane do Comarch DMS Repozytorium, będą zapisane zgodnie z lokalizacją, którą określono w parametrze Type w sekcji Storage Settings.
Przyklad
Przykład uzupełnienia pliku appsettings.json, jeśli pliki mają być zapisywane w bazie MongoDB, ale możliwa również będzie praca z plikami, które są przechowywane w usłudze IBARD:
Powyższe ustawienia są niezbędne do właściwej konfiguracji pliku. Poniższe ustawienia natomiast można zmienić opcjonalnie:
„JWTSettings” – ustawienia JSON Web Tokens, autoryzacja użytkowników wewnątrz Comarch DMS Repozytorium. Zawiera następujące parametry:
„Key” – klucz szyfrujący,
„Issuer”:”CorelIdentity”,
„Audience”: „CorelIdentityUser”,
„DurationInMinutes”: 60 – czas, po jakim token autoryzujący wygaśnie; podany w minutach
„Serilog” – framework logujący działanie aplikacji. Zawiera następujące parametry:
„MinimumLevel” – określa poziom szczegółowości loga
„Default”: „Information” – definiuje domyślny poziom
„Override” – określa szczegółowe ustawienia logów dla paczek Microsoft oraz System, zapisywanie informacji na poziomie warning i wyżej, czyli error, fatal error.
„Enrich”: [ „FromLogContext”, „WithMachineName”, „WithProcessId”, „WithThreadId” ] – określa schemat wpisów do dziennika logów. Zawiera następujące parametry:
„WriteTo” – definicja logów „Name”: „Console” – logi do konsoli „Name”: „File” – logi do pliku w formacie txt
„path”: „C:\\temp\\repository.txt” – lokalizacja w której będzie zapisywany log
„outputTemplate”: „{Timestamp:G} {Message}{NewLine:1}{Exception:1}” – format logów „Name”: „File” – logi do pliku w formacie json
„path”: „C:\\temp\\repository.json” – lokalizacja w której będzie zapisywany log
„formatter”: „Serilog.Formatting.Json.JsonFormatter, Serilog”
Uwaga
Kiedy dane zostały wprowadzone, konieczne jest zapisanie pliku appsettings.json, a następnie uruchomienie zatrzymanej wcześniej witryny albo całego serwera IIS. Następnie należy uruchomić Comarch DMS aplikację desktopową.
Włączenie protokołu WebSocket
Od wersji 2022.0.1 konieczne jest włączenie protokołu WebSocket. W tym celu należy wykonać następujące kroki:
1. w ramach pola wyszukiwania przy przycisku „Start” wpisać frazę „Włącz lub wyłącz funkcje systemu Windows” i kliknąć „Otwórz”
2. Następnie w oknie, które zostało otwarte, należy rozwinąć zawartość folderu „Internetowe usługi informacyjne”, później „Usługi WWW”, potem „Funkcje tworzenia aplikacji”, zaznaczyć checkbox przy folderze „Protokół WebSocket” i kliknąć przycisk .
Zostanie wówczas otwarte okno Funkcje systemu Windows, w ramach którego system dokona zapisu wprowadzonych zmian.
Gdy zmiany zostaną zapisane, informacja o tym zostanie wyświetlona w ramach okna. Należy wówczas zamknąć okno, klikając na przycisk .
3. Następnie należy otworzyć Menadżer Internetowych Usług Internetowych (IIS) i w środkowej części okna, w sekcjiZarządzaniekliknąć na ikonęEdytor konfiguracji, a następnie wybrać opcjęOtwórz funkcję, znajdującą się po prawej stronie, w górnej części panelu Akcje.
4. Po wyborze opcji Otwórz funkcję w środkowej części Menedżera zostanie wyświetlony Edytor konfiguracji.
W poluSekcjanależywyszukać na rozwijalnej liście sekcjęsystem.webServer/webSocket, a następnie wybrać dla polaenabledwartośćTrue. Następnie aby zapisać zmiany, wybierz opcjęZastosuj dostępną w ramach panelu Akcje po prawej stronie Menedżera.
5. Później należy ponownie uruchomić IIS, wybierając opcjęUruchom ponowniena panelu Akcje w ramach Menedżera IIS.
Rozpoczynasz pracę z Comarch DMS Repozytorium i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch DMS Repozytorium i chcesz dowiedzieć się więcej?
2. W ramach katalogu zawierającego aplikację web (nową aplikację webową) otworzyć do edycji plik web.config i uzupełnić:
W ramach „RepositoryApi” zamiast [applicationHost]nazwę serwera, na którym znajduje się aplikacja Repozytorium i zamiast DocumentManager.WebApi – nazwę aplikacji Repozytorium
W ramach „RepositoryWebsockets”zamiast [applicationHost]nazwę serwera, na którym znajduje się aplikacja Repozytorium i zamiast DocumentManager.WebApi – nazwę aplikacji Repozytorium
Rozpoczynasz pracę z Comarch DMS Repozytorium i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch DMS i chcesz dowiedzieć się więcej?
Instalacja drugiej aplikacji Comarch DMS Repozytorium dla innej aplikacji Comarch DMS
Dla aplikacji Comarch DMS od wersji 2023.1.0 możliwe jest skonfigurowanie drugiej aplikacji Comarch DMS Repozytorium dla drugiej aplikacji Comarch DMS.
Przykład:
Użytkownik zainstalował dwie aplikacje Comarch DMS w następujący sposób:
Pliki pierwszej aplikacji serwerowej (stary web) Comarch DMS zostały przeniesione do folderu DocumentWorkflow.Web.1 (lokalizacja: C:\inetpub\wwwroot\DocumentWorkflow.Web.1), a pliki pierwszej aplikacji klienckiej (nowy web) do folderu NewWorkflow.1 (lokalizacja: C:\inetpub\wwwroot\NewWorkflow.1);
Pliki drugiej aplikacji serwerowej (stary web) Comarch DMS zostały przeniesione do folderu DocumentWorkflow.Web.2 (lokalizacja: C:\inetpub\wwwroot\DocumentWorkflow.Web.2), a pliki pierwszej aplikacji klienckiej (nowy web) do folderu NewWorkflow.2 (lokalizacja: C:\inetpub\wwwroot\NewWorkflow.2)
Użytkownik zainstalował również dwie aplikacje Comarch DMS Repozytorium w następujący sposób:
Pliki pierwszej aplikacji Comarch DMS Repozytorium – zwanej dalej Repozytorium 1– zostały przeniesione do folderu Repository.1(lokalizacja: C:\inetpub\wwwroot\Repository.1)
Pliki drugiej aplikacji Comarch DMS Repozytorium – zwanej dalej Repozytorium 2 – zostały przeniesione do folderu Repository.2(lokalizacja: C:\inetpub\wwwroot\Repository.2)
Użytkownik utworzył również w MongoDB 2 bazy dla Comarch DMS Repozytorium:
Repository – dla pierwszej aplikacji Comarch DMS Repozytorium – Repozytorium 1; z użytkownikiem MongoUser1 i hasłem Passwd1234
Repository2 – dla drugiej aplikacji Comarch DMS Repozytorium – Repozytorium 2; z użytkownikiem MongoUser2 i hasłem Passwd5678
Użytkownik chciałby, aby:
Pierwsza aplikacja Comarch DMS współpracowała z aplikacją Repozytorium 1
oraz
Druga aplikacja Comarch DMS współpracowała z aplikacją Repozytorium 2
W tym celu należy wykonać następujące kroki:
Konfiguracja aplikacji DocumentWorkflow.Web.1, NewWorkflow.1 i aplikacji Repozytorium 1
1. W pliku web.config w folderze DocumentWorkflow.Web.1 należy uzupełnić klucze dotyczące konfiguracji pracy z Repozytorium 1 w następujący sposób:
2. Następnie należy dodać pulę aplikacji dms_repository dla aplikacji Repozytorium 1.
Dla puli aplikacji dedykowanej modułowi Comarch DMS Repozytorium konieczne jest określenie wersji środowiska .NET CLR jako ’Bez kodu zarządzanego’.
3. Następnie należy w ramach Menedżera IIS nacisnąć prawym przyciskiem myszy folder Repository.1 i wybrać opcję „Konwertuj na aplikację„.
Następnie otwiera się okno „Dodawanie aplikacji”, w którym należy nacisnąć opcję „Wybierz”, wybrać pulę aplikacji dedykowaną Comarch DMS Repozytorium – w tym przypadku jest to pula „dms_repository” – i nacisnąć „Ok”.
4. Następnie należy wejść do katalogu Repository.1 i otworzyć do edycji plik konfiguracyjny appsettings.json, gdzie konieczne jest uzupełnienie wszystkich connection string w następujący sposób:
2. Następnie należy dodać pulę aplikacji dms_repository2 dla aplikacji Repozytorium 2.
Dla puli aplikacji dedykowanej modułowi Comarch DMS Repozytorium konieczne jest określenie wersji środowiska .NET CLR jako ’Bez kodu zarządzanego’.
3. Następnie należy w ramach Menedżera IIS nacisnąć prawym przyciskiem myszy folder Repository.2 i wybrać opcję „Konwertuj na aplikację„.
Następnie otworzy się okno „Dodawanie aplikacji”, w którym należy nacisnąć opcję „Wybierz”, wybrać pulę aplikacji dedykowaną Comarch DMS Repozytorium – w tym przypadku jest to pula „dms_repository2” – i nacisnąć „Ok”.
4. Następnie należy wejść do katalogu Repository.2 i otworzyć do edycji plik konfiguracyjny appsettings.json, gdzie konieczne jest uzupełnienie wszystkich connection string w następujący sposób:
Korzystanie z dwóch aplikacji Comarch DMS Repozytorium
Po odpowiednim skonfigurowaniu dwóch aplikacji Comarch DMS Repozytorium (zob. punkty Konfiguracja aplikacji DocumentWorkflow.Web.1 i aplikacji Repozytorium 1 i Konfiguracja aplikacji DocumentWorkflow.Web.2 i aplikacji Repozytorium 2) oraz po włączeniu protokołu WebSocket (zob. Repozytorium – instalacja dla administratora), a także po wykonaniu początkowej konfiguracji (zob. Repozytorium – konfiguracja początkowa dla administratora) można korzystać z odrębnego modułu Repozytorium w każdej z dwóch aplikacji Comarch DMS.
Rozpoczynasz pracę z Comarch DMS Repozytorium i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch DMS i chcesz dowiedzieć się więcej?
Przed rozpoczęciem aktualizacji bazy MongoDB konieczne jest, aby wykonać backup bazy.
Backupy baz danych Mongo DB mogą być tworzone i odtwarzane za pomocą narzędzimongodumporazmongorestore, które należą do MongoDB Database Tools.
Backup bazy danych MongoDB w systemie Windows
1. Aby pobrać narzędzia, należy wejść na stronę producenta: https://www.mongodb.com/try/download/database-tools, wybrać właściwą platformę w polu „Platform” i format „msi” w polu „Package”, a następnie nacisnąć przycisk „Download”.
2. Następnie należy otworzyć pobrany plik. Zostanie wówczas otwarte okno początkowe instalatora MongoDB Database Tools, gdzie należy kliknąć na „Next”.
3. W następnym kroku należy wyrazić zgodę na umowę licencyjną, zaznaczając checkbox, a następnie wybrać „Next”.
4. Następnie otwarte zostaje okno, w którym można wybrać lokalizację, gdzie zostaną zainstalowane narzędzia MongoDB.
Domyślna lokalizacja to C:\Program Files\MongoDB\Tools\100\bin.
Po wyborze lokalizacji użytkownik powinien kliknąć „Next”.
5. W kolejnym oknie należy wybrać przycisk „Install”. Wówczas następuje instalacja MongoDB Database Tools.
6. Następnie należy uruchomić wiersz polecenia, wpisująccmd w wyszukiwarce w menu „Start” i wybierając opcję „Uruchom jako administrator”.
7. Następnie należy wpisaćcd, nacisnąć spację i podać ścieżkę do lokalizacji narzędzi MongoDB – w poniższym przykładzie znajdują się one w lokalizacji C:\Program Files\MongoDB\Tools\100\bin.
8. Następnie należy nacisnąć Enter i wprowadzić następującą frazę:
10. W kolejnym kroku konieczne jest wprowadzenie hasła do Repozytorium dla użytkownika MongoUser – w poniższym przykladzie jest to hasło Passwd1234, analogicznie do przykładu przedstawionego w instrukcji instalacji Repozytorium.
Uwaga
Hasło nie jest widoczne na ekranie.
11. Po naciśnięciu przycisku Enter następuje tworzenie kopii zapasowej bazy Repozytorium.
12.Backup bazy Repozytorium jest zapisywany w folderze „dump” w lokalizacji, w której znajdują się narzędzia MongoDB – w poniższym przykładzie jest to lokalizacja C:\Program Files\MongoDB\Tools\100\bin\dump.
Backup bazy danych MongoDB w systemie Linux, dystrybucja Ubuntu
Backup bazy danych MongoDB na Ubuntu należy przeprowadzić zgodnie z instrukcją producenta dostępną pod adresem mongodump — MongoDB Database Tools.
Rozpoczynasz pracę z Comarch DMS Repozytorium i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch DMS Repozytorium i chcesz dowiedzieć się więcej?
Przywracanie bazy danych Mongo DB w systemie Windows
Po wcześniejszym pobraniu MongoDB Database Tools oraz wykonaniu kopii zapasowej bazy Repozytorium za pomocą narzędziamongodump (zob. Backup bazy danych MongoDB) możliwe jest przywrócenie bazy danych za pomocą narzędzia mongorestore. W tym celu:
1. należy uruchomić wiersz polecenia, wpisująccmd w wyszukiwarce w menu „Start” i wybierając opcję „Uruchom jako administrator”.
2. Następnie należy wpisaćcd, nacisnąć spację i podać ścieżkę do lokalizacji narzędzi MongoDB– w poniższym przykładzie znajdują się one w lokalizacji C:\Program Files\MongoDB\Tools\100\bin.
3. Następnie należy nacisnąć Enter i wprowadzić następującą frazę:
dump/Repository – lokalizacja folderu, w którym zapisano kopię zapasową bazy Repozytorium
4. Następnie należy nacisnąć Enter.
5. W kolejnym kroku konieczne jest wprowadzenie hasła do Repozytorium dla użytkownika MongoUser – w poniższym przykladzie jest to hasło Passwd1234, analogicznie do przykładu przedstawionego w instrukcji instalacji Repozytorium i w instrukcji tworzenia kopii zapasowej bazy Repozytorium.
Uwaga
Hasło nie jest widoczne na ekranie.
6.Po naciśnięciu przycisku Enter następuje przywrócenie kopii zapasowej bazy Repozytorium.
Przywracanie bazy danych Mongo DB w systemie Linux, dystrybucja Ubuntu
Przywrócenie bazy danych MongoDB na Ubuntu należy przeprowadzić zgodnie z instrukcją producenta dostępną pod adresem: mongorestore — MongoDB Database Tools.
Rozpoczynasz pracę z Comarch DMS Repozytorium i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch DMS Repozytorium i chcesz dowiedzieć się więcej?
W wersji 2022.0.3 wprowadzono automatyczną aktualizację baz danych modułu Comarch DMS Repozytorium. Aktualizacja bazy danych umożliwia dokonanie konwersji struktury bazy MongoDB do nowej wersji (zob. Aktualizacja bazy danych MongoDB).
Jeśli użytkownik korzystał przedtem z Comarch DMS i z Comarch DMS Repozytorium, powinien dokonać aktualizacji.
Najpierw konieczna jest aktualizacja aplikacji serwerowej, WEB i desktop Comarch DMS, którą można przeprowadzić ręcznie albo za pomocą instalatora. Kiedy aplikacje zostały zaktualizowane, wówczas można przystąpić do aktualizacji modułu Repozytorium.
Przebieg aktualizacji:
1. W pobranym pakiecie instalacyjnym należy otworzyć folderComarch DMS {wersja}, a następnie ComarchDMS {wersja}, w którym znajduje się folder DMS Repository Api
Uwaga
Od wersji 2024.0.0 w pakiecie instalacyjnym nie znajduje się już folder DocumentManager.WebClient, a zamiast folderu DocumentManager.WebApi dostępny jest folder DMS Repository Api.
2. następnie konieczne jest usunięcie i podmienienie dotychczasowej zawartości folderuDocumentManager.WebApi (lub folderu o innej nazwie, do którego w wersji 2024.0.0 lub późniejszej skopiowano zawartość folderu DMS Repository Api), znajdującego się domyślnie w lokalizacji C:\inetpub\wwwroot, na odpowiadającą mu zawartość folderuDMS Repository Api z pakietu instalacyjnego, poprzez jej skopiowanie i wklejenie
Uwaga
Wszystkie pliki w folderze DocumentManager.WebApipowinny zostać usunięte i podmienione plikami z folderu z nowej wersji, z wyjątkiem plikuappsettings.json, który znajduje się w folderze DocumentManager.WebApi. Jest to plik, który zawiera konfigurację połączenia z Comarch DMS i z bazą MongoDB – jeśli zostanie podmieniony, trzeba uzupełnić od nowa plik (zob. Wprowadzanie zmian w appsettings.json, pliku konfiguracyjnym serwera).
W ramach katalogu zawierającego aplikację web (nową aplikację webową) otworzyć do edycji plik web.config i uzupełnić:
W ramach „RepositoryApi” zamiast [applicationHost]nazwę serwera, na którym znajduje się aplikacja Repozytorium i zamiast DocumentManager.WebApi – nazwę aplikacji Repozytorium
W ramach „RepositoryWebsockets”zamiast [applicationHost]nazwę serwera, na którym znajduje się aplikacja Repozytorium i zamiast DocumentManager.WebApi – nazwę aplikacji Repozytorium
4. następnie należy zrestartować serwer IIS w Menedżerze internetowych usług informacyjnych (IIS) , klikając przycisk „Uruchom ponownie” po prawej stronie ekranu
5. w dalszej kolejności konieczne jest wyczyszczenie danych przeglądarki, na której użytkownik korzysta z modułu Repozytorium, w tym plików cookie oraz innych danych witryn
Tak przygotowane Repozytorium jest zaktualizowane i gotowe do pracy.
Rozpoczynasz pracę z Comarch DMS Repozytorium i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch DMS Repozytorium i chcesz dowiedzieć się więcej?
Przed rozpoczęciem aktualizacji bazy MongoDB konieczne jest, aby wykonać backup bazy – zob. Backup bazy danych MongoDB.
W wersji 2022.0.3 wprowadzono automatyczną aktualizację baz danych modułu Comarch DMS Repozytorium. Aktualizacja bazy danych umożliwia dokonanie konwersji struktury bazy MongoDB do nowej wersji.
Aktualizacja bazy następuje automatycznie po pierwszym uruchomieniu Repozytorium, po tym, jak podniesiono system do nowej wersji.
Aktualizacja umożliwia konwersję struktury bazy MongoDB do nowej wersji. Podczas aktualizacji rozpoznawana jest wersja bazy, która jest aktualizowana – jeśli występują różnice w strukturze bazy poprzedniej wersji, wówczas aktualizacja bazy uruchamiana jest automatycznie, jeżeli natomiast struktura bazy pomiędzy danymi wersjami nie uległa zmianie – nie zachodzi aktualizacja.
Jeśli wersja podnoszona jest o kilka wersji niższa niż aktualna, wówczas aktualizacja bazy danych następuje etapami, kolejno do każdej wersji, aż do aktualnej. Możliwe jest podniesienie z danej wersji do wersji 2022.0.2 i wyżej.
Aktualizacja bazy danych znajduje się w osobnej bibliotece DLL.
Wskazówka
Błędy, które powstają w czasie aktualizacji bazy, są zapisywane do tego samego pliku z logami, co błędy aplikacji.
Ekran aktualizacji jest wyświetlany użytkownikom na każdym poziomie uprawnień oraz użytkownikom, którzy nie posiadają uprawnień do modułu Repozytorium – a zatem każdy operator Comarch DMS może rozpocząć aktualizację bazy modułu Repozytorium.
Dla dokumentów zarchiwizowanych, będących jednocześnie w okresie retencji, w miejsce kryterium okresu przechowywania zostaje automatycznie wprowadzona data dodania dokumentu.
Dla dokumentów aktywnych, których dotyczy reguła retencji, jako kryterium okresu przechowywania nie zostaje wprowadzona automatycznie żadna data – operator ustawia datę przy próbie zarchiwizowania dokumentu.
Dla dokumentów, które są unieważnione, w miejscu powodu unieważnienia znajduje się znak –.
Aktualizacja bazy danych MongoDB – przebieg
Po wykonaniu backupu (zob. Backup bazy danych MongoDB) można przejść do aktualizacji bazy danych Repozytorium.
Uwaga
W celu wykonania backupu bazy danych MongoDB należy skontaktować się z administratorem modułu Repozytorium, jeśli użytkownik nie ma takich uprawnień.
Przy pierwszym uruchomieniu po aktualizacji aplikacji (zobacz Aktualizacja Comarch DMS Repozytorium) na ekranie pojawia się okno początkowe aktualizacji. Dostępny jest na nim checkbox „Potwierdzam wykonanie backupu bazy MongoDB” wraz z informacją, że potwierdzenie wykonania kopii zapasowej bazy jest konieczne do rozpoczęcia aktualizacji.
Aby rozpocząć aktualizację należy zaznaczyć checkbox i kliknąć przycisk[Aktualizuj bazę].
Po wyborze przycisku [Aktualizuj bazę] rozpoczyna się aktualizacja bazy Repozytorium, a na ekranie widoczna jest informacja o trwającej aktualizacji, wyświetlany jest także obecny etap aktualizacji i szacowany czas jej zakończenia.
Uwaga
Aktualizacja bazy jest kontynuowana nawet, jeśli po jej rozpoczęciu przeglądarka została zamknięta.
Jeżeli podczas aktualizacji wystąpią błędy, które spowodują, że jej poprawne przeprowadzenie nie będzie możliwe, jak np. w przypadku przerwania połączenia do serwera repozytorium Repository.exe lub problemów związanych z serwerem bazy MongoDB, wówczas wyświetlony zostanie następujący komunikat:
Informacje techniczne dotyczące powodów niepowodzenia aktualizacji, wyników aktualizacji bazy i ewentualnych błędów (np. odnoszące się do aktualizacji bazy z wersji 2022.0.2 do wersji 2022.0.3 lub do błędów wynikających ze struktury bazy), są zapisywane w logach.
Uzupełnianie danych krytycznych dla systemu
Jeśli Repozytorium jest podnoszone z wersji, w której nie były jeszcze stosowane identyfikatory dokumentów i brak prefixów w typach dokumentów (zob. „Ustawienia” w Repozytorium – zakładka „Zarządzanie aplikacją” dla administratora), wówczas po zakończonej aktualizacji w Repozytorium zostaje wyświetlone okno, w ramach którego administrator systemu musi uzupełnić brakujące prefixy. Następnie zmiany należy zapisać, aby możliwe było rozpoczęcie pracy z Repozytorium.
Uwaga
Jeżeli w wersji 2021.2.0 w ramach prefixów wprowadzono znaki szczególne i diakrytyczne, wówczas nie zachodzi potrzeba zmiany tych prefiksów po aktualizacji bazy.
Okno Uzupełnij konfigurację aplikacjizostaje automatycznie wyświetlone tuż po zakończeniu aktualizacji lub, jeśli aktualizacja miała miejsce w tle, przy zamkniętej przeglądarce – po pierwszym otwarciu interfejsu Repozytorium po aktualizacji. W oknie wyświetlone są w kolejności alfabetycznej wszystkie typy dokumentów, jakie dotychczas utworzono. Nie jest możliwe zamknięcie okna ani zapisanie zmian, jeśli wszystkie wymagane pola z prefiksami nie zostały odpowiednio uzupełnione. Po przesunięciu kursora na ikonkę wyświetlana jest informacja dotycząca zasad wprowadzania prefiksów, analogiczna do informacji dostępnej przy definiowaniu typu dokumentu w ustawieniach Repozytorium.
Kiedy wszystkie pola zostały poprawnie wypełnione, operator może zapisać zmiany za pomocą przycisku [Zapisz]. Po zapisaniu zmian okno zostaje zamknięte i można przystąpić do pracy z Repozytorium.
Jeżeli użytkownik wpisze w ramach pola Prefixtaki prefix, który:
Już istnieje w Repozytorium– pole zostaje podświetlone na czerwono, a pod nim zostaje wyświetlony komunikat Taki prefix już istnieje
Jest krótszy niż 2 albo dłuższy niż 5 znaków – pole zostaje podświetlone na czerwono
Zawiera znaki diakrytyczne i specjalne – pole zostaje podświetlone na czerwono, a pod nim zostaje wyświetlony komunikat Prefix zawiera niedozwolone znaki
Kiedy administrator systemu uzupełni prefixy typów dokumentów i zapisze okno konfiguracji, wówczas nastąpi automatyczne nadanie dokumentom identyfikatorów.
Numeracja takich identyfikatorów po prefiksie zależy od daty dodania dokumentu do Repozytorium.
Przyklad
W ramach Repozytorium w wersji 2021.1.0 utworzono typ dokumentu Faktura, a następnie dodano do niego 4 dokumenty tego typu. Kiedy wersja została podniesiona i przeprowadzono aktualizację bazy, administrator podczas konfiguracji przy pierwszym logowaniu przypisał do tego typu prefix FZ. W takim przypadku numeracja dokumentów, które już należą do tego typu, przedstawia się w następujący sposób:
Data dodania dokumentu
Identyfikator nadany automatycznie
11.02.2021
FZ/1
20.04.2021
FZ/2
05.05.2021
FZ/3
06.12.2021
FZ/4
Kiedy aktualizacja bazy Repozytorium zostanie zakończona, a administrator uzupełni brakujące prefiksy (jeśli była taka potrzeba), wówczas możliwe będzie przystąpienie do pracy z Repozytorium. Zakończenie aktualizacji sukcesem zostaje potwierdzone wyświetleniem informującego o tym komunikatu.
Uwaga
Informacja o zakończeniu aktualizacji nie zostanie wyświetlona, jeśli podczas aktualizacji użytkownik nie był zalogowany – dla takiego użytkownika dostępny jest od razu widok Repozytorium gotowego do rozpoczęcia pracy .
Uwaga
Jeżeli użytkownik uruchomi Repozytorium podczas przeprowadzania aktualizacji, wówczas zostanie wyświetlona informacja o trwającej aktualizacji i o braku możliwości pracy z Repozytorium do czasu jej zakończenia.
Uwaga
Każdy operator, który znajdował się w bazie MongoDB przed aktualizacją, jest nadal dostępny w zaktualizowanej bazie Nie jest zatem konieczne ponowne nadawanie uprawnień operatorom i mogą oni przystąpić do pracy z Repozytorium od razu po zaktualizowaniu bazy oraz uzupełnieniu brakujących prefiksów.
Rozpoczynasz pracę z Comarch DMS Repozytorium i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch DMS Repozytorium i chcesz dowiedzieć się więcej?