Baza wiedzy LINKSPOT › Comarch BPM - Repozytorium

Repozytorium – ręczna instalacja dla administratora

Comarch BPM - Repozytorium · Opublikowano 2025-09-18

Spis treści artykułu

Moduł Repozytorium jest dostępny zarówno dla Comarch BPM (dawniej 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:

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:

https://www.iis.net/downloads/microsoft/application-request-routing

  1. w ramach Menedżera Internetowych usług Internetowych kliknąć na ikonę „Application Request Routing Cache”
  2. w ramach panelu „Akcje” po prawej stronie ekranu nacisnąć link „Otwórz funkcje”.

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

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

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

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 BPM (dawniej DMS) Repozytorium: definicjach atrybutów  i typów dokumentów – przeniesiono je do wersji web aplikacji.

System Comarch BPM (dawniej DMS) składa się z modułów:

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 BPM (dawniej DMS) Workflow (Obieg Dokumentów) i jedna tworzy moduł Comarch BPM (dawniej 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ępnie nacisnąć 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.

Z pełnym procesem instalacji środowiska MongoDB można zapoznać się w instrukcji producenta pod adresem Install MongoDB Community Edition on Windows — MongoDB Manual.

  1. Po pobraniu pliku instalacyjnego należy go otworzyć. Wówczas na ekranie pojawia się okno instalatora Mongo DB, gdzie powinno się kliknąć „Next”.

Okno początkowe instalatora MongoDB

  1. Następnie należy wyrazić zgodę na umowę licencyjną, zaznaczając checkbox i kliknąć „Next”.

Okno umowy licencyjnej MongoDB

  1. Kolejnym krokiem jest wybór typu instalacji – należy wybrać opcję „Complete”.

Okno Mongo DB – wybór typu instalacji

  1. Następnie należy w oknie konfiguracji usługi wybrać checkbox „Run service as Network Service user”.

Wybór konfiguracji usługi w MongoDB

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

Okno instalacji MongoDB Compass

  1. Następnie należy kliknąć „Install”.

Okno do rozpoczęcia instalacji MongoDB

  1. Na zakończenie instalacji należy kliknąć przycisk „Finish”.

Okno końcowe instalacji Mongo DB

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

Menedżer zadań systemu Windows – widoczny podświetlony rekord MongoDB

Dodawanie administratora MongoDB i bazy danych dla Comarch BPM (dawniej 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.

Okno logowania do serwera Mongo DB

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:

db.createUser(
{
user:"admin",
pwd:"Passwd1234",
roles:[{role:"root",db:"admin"}] }
)

Uwaga

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.

Dodawanie administratora o nazwie admin w MongoDB

  1. Następnie należy utworzyć bazę danych dla Comarch BPM (dawniej DMS) Repozytorium i dodać użytkownika, dla którego będzie następowało łączenie się aplikacji Comarch BPM (dawniej DMS) Repozytorium z bazą danych. W tym celu konieczne jest, aby:
db.createUser(
{
user:"MongoUser",
pwd:"Passwd1234",
roles:[{role:"readWrite",db:"Repository"}] }
)

Uwaga

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.

Tworzenie bazy danych dla Comarch BPM (dawniej DMS) Repozytorium

Dodawanie użytkownika, dla którego aplikacja Comarch BPM (dawniej DMS) Repozytorium łączy się z bazą danych

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 konfiguracyjnego mongod.cfg.

Plik znajduje się w lokalizacji:

\bin\mongod.cfg

domyślnie lokalizacja to: C:\Program Files\MongoDB\Server\\bin\mongod.cfg

Przykładowa lokalizacja pliku mongod.cfg

Zmiany, których należy dokonać w pliku mongod.cfg:

  1. w sekcji #network interfaces:
  1. w sekcji #security:

Należy usunąć znak # przed security

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.

Zmiany w pliku mongod.cfg

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

Ponowne uruchamianie MongoDB w Menedżerze zadań Windows po edycji pliku mongod.cfg

Uwaga

Podczas ponownego łączenia do MongoDB Compass konieczne będzie wpisanie connection stringa według poniższego wzoru:

mongodb://:@:/?authSource=

Przykładowo dla administratora:

mongodb://admin:Passwd1234@localhost/?authSource=admin

Przykładowo dla użytkownika MongoUser:

mongodb://MongoUser:Passwd1234@localhost/Repository?authSource=Repository

Instalacja serwera MongoDB w systemie Linux, dystrybucja Ubuntu

Uwaga

Minimalna obsługiwana wersja serwera MongoDB to wersja 4.2.

Instalacja serwera MongoDB na Ubuntu powinna zostać przeprowadzona według instrukcji producenta, do której można przejść za pomocą następującego linku: Install MongoDB Community Edition on Ubuntu — MongoDB Manual.

Wprowadzanie zmian w pliku mongod.conf

Kiedy zainstalowano serwer, kolejnym krokiem jest wprowadzenie zmian w pliku konfiguracyjnym mongod.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:
  1. w sekcji #security:

Należy usunąć znak # przed security

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 BPM (dawniej DMS) Repozytorium z poziomu terminala w Ubuntu

Następnie należy zalogować się do MongoDB z poziomu terminala w Ubuntu,  a później create a database and add the operator for which the Comarch DMS Repository will be connected to the database.

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:

db.createUser(
{
user:"admin",
pwd:"Passwd1234",
roles:[{role:"root",db:"admin"}]
}
)

Uwaga

Wielkość liter w nazwach użytkowników jest istotna dla logowania.

Wskazówka

Zaleca się zmianę hasła na inne mocne hasło.

Login ani hasło nie mogą zawierać następujących znaków:

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

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

[/alert]

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 BPM (dawniej DMS) Repozytorium z bazą danych. W tym celu konieczne jest wprowadzenie następującego polecenia:

db.createUser(
{
user:"MongoUser",
pwd:"Passwd1234",
roles:[{role:"readWrite",db:"Repository"}]
}
)

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:

Download MongoDB Command Line Database Tools | MongoDB

Z dokumentacją dotyczącą narzędzi do tworzenia i odtwarzania baz MongoDB można się zapoznać na stronie producenta: The MongoDB Database Tools Documentation — MongoDB Database Tools.

Konfiguracja aplikacji na serwerze IIS

Instalacja komponentów

Zanim rozpocznie się konfigurację aplikacji Comarch BPM (dawniej DMS) na serwerze IIS, konieczne jest zainstalowanie dwóch komponentów, niezbędnych do poprawnego działania aplikacji:

Uwaga

Jeżeli aktualizację przeprowadzono w trybie ręcznym, konieczne jest zaktualizowanie aplikacji Comarch BPM (dawniej DMS): serwerowej, web i desktop, a w ustawieniach puli aplikacji zmiana wartości parametru Włącz aplikacje 32-bitowena False. Tych czynności nie trzeba wykonywać, jeśli do aktualizacji został użyty instalator.

Ustawienia zawansowane puli aplikacji dla modułu Workflow (Obieg dokumentów) (aplikacji serwerowej) – z odpowiednim ustawieniem parametru „Włącz aplikacje 32-bitowe”

Przenoszenie katalogu BPM (dawniej DMS) Repository Api

Jeżeli na serwerze nie jest zainstalowany Comarch BPM (dawniej DMS), konieczna jest instalacja aplikacji Comarch DMS serwerowej, WEB  i desktop według instrukcji znajdującej się na stronie https://pomoc.comarch.pl/bpm/ po wejściu do kategorii wybranej współpracy, w rozdziale Instalacja i konfiguracja.

Następnie należy z pakietu instalacyjnego z lokalizacji Comarch BPM (dawniej DMS) {wersja} \ Comarch BPM (dawniej DMS) {wersja} skopiować zawartość katalogu BPM Repository Api do folderu w lokalizacji C:\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 BPM Repository Api (wcześniej DMS Repository Api).

Lokalizacja folderu BPM Repository Api w pakiecie instalacyjnym Comarch BPM 2025.2.0

Lokalizacja folderu DocumentManager.WebApi, do którego przeniesiono zawartość folderu BPM Repository Api

Dodawanie nowej puli aplikacji dla Comarch BPM (dawniej DMS) Repozytorium

Comarch BPM (dawniej DMS) Repozytorium jest modułem Comarch BPM (dawniej 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)

Dodawanie nowej puli aplikacji w IIS

Dla puli aplikacji dedykowanej modułowi Comarch BPM (dawniej DMS) Repozytorium konieczne jest określenie wersji środowiska .NET CLR jako ’Bez kodu zarządzanego’.

Dodawanie puli aplikacji „BPM_repository” dla modułu Repozytorium, z wersją środowiska .Net CLR zaznaczoną jako „Bez kodu zarządzanego”

Ustawienia zaawansowane puli BPM_repository

Dla pul aplikacji dedykowanych modułowi Comarch BPM (dawniej 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.

Dodawanie puli „BPM_workflow” dla Comarch BPM (dawniej DMS) Workflow (Obieg Dokumentów) (aplikacji serwerowej)

Ustawienia zawansowane puli aplikacji dla modułu Workflow (Obieg dokumentów) (aplikacji serwerowej) – z odpowiednim ustawieniem parametru „Włącz aplikacje 32-bitowe”

Dodawanie puli aplikacji dedykowanej modułowi Obieg dokumentów (aplikacji web)

Rys 68. Ustawienia zaawansowane dla puli aplikacji dedykowanej modułowi Obieg dokumentów (aplikacji web)

Konwertowanie katalogu DocumentManager.WebApi na aplikację

  1. W kolejnym kroku należy  w ramach Menedżera IIS nacisnąć prawym przyciskiem myszy folder DocumentManager.WebApi i wybrać opcję „Konwertuj na aplikację„.

Konwertowanie folderu DocumentManager.WebApi na aplikację w oknie Menedżera internetowych usług informacyjnych (IIS)

  1. Następnie otworzy się okno „Dodawanie aplikacji„, w którym należy nacisnąć opcję „Wybierz„, wybrać pulę aplikacji dedykowaną Comarch BPM (dawniej DMS) Repozytorium – w poniższym przykładzie jest to pula „BPM_repository” –  i nacisnąć „Ok„.

Okno dodawania aplikacji dla aplikacji modułu Comarch BPM Repozytorium

Wybór puli aplikacji dla aplikacji Repozytorium

Konfiguracja pliku web.config aplikacji Comarch BPM (dawniej DMS)

W ramach Comarch BPM (dawniej 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 BPM (dawniej DMS) Repozytorium, w kluczu Web.config, dostępnym w folderze z aplikacją serwerową (dawną web) Comarch BPM (dawniej DMS) należy uzupełnić 3 następujące klucze:

http://localhost/DocumentManager.WebApi

http://localhost/ DocumentWorkflow.Web

Wprowadzone zmiany należy zapisać.

Uwaga

Od wersji 2024.0.0 dostęp do modułu Repozytorium jest możliwy z poziomu aplikacji WEB (nowej aplikacji web) – w kwestii konfiguracji zob. Konfiguracja aplikacji WEB (nowej aplikacji web) do współpracy z modułem Repozytorium).

Od wersji 2024.0.0 moduł Repozytorium nie jest dostępny z poziomu aplikacji serwerowej Comarch BPM (dawniej 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.

Sprawdzanie adresu URL aplikacji DocumentManager.WebApi

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 BPM (dawniej DMS) Repozytorium, która zawiera konta użytkowników.

Przyklad

Connection string powinien składać się z takich części:

„mongodb://:@:/?authSource=”

gdzie:

:  – nazwa i hasło użytkownika MongoDB, który został dodany do bazy Comarch DMS Repozytorium

@: – ip i port serwera, na którym znajduje się baza Mongo DB

/ – nazwa utworzonej bazy repozytorium

?authSource= –  ponownie nazwa utworzonej bazy repozytorium

Przykład:

„mongodb://MongoUser:Passwd1234@localhost:27017/Repository?authSource=Repository”

  1. „ApplicationMongoDatabaseSettings” – connection string do bazy Comarch BPM (dawniej DMS) Repozytorium, która zawiera dane aplikacji.

Przykładowo:

„mongodb://MongoUser:Passwd1234@localhost:27017/Repository?authSource=Repository”

  1. „DocumentWorkflowSettings” – adres serwera BPM (dawniej DMS).

Przykładowo:

„http://localhost/Standalone”

Wskazówka

W tym parametrze powinien zostać wprowadzony adres aplikacji serwerowej modułu Workflow – taki, jak został wprowadzony w bpm.exe.config (dawnym dms.exe.config) – pliku konfiguracyjnym aplikacji desktop

Przykład uzupełnienia connection strings dla „IdentityMongoDatabaseSettings” i „ApplicationMongoDatabaseSettings” oraz „ServerUrl” dla „DocumentWorkflowSettings”

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 BPM (dawniej DMS)  Repozytorium. Może przyjmować wartości:

Przykładowe uzupełnienie „Type” w „Storage settings” , jeśli pliki z Repozytorium przechowywane będą w usłudze Comarch Ibard

Przykładowe uzupełnienie „Type” w „Storage settings” , jeśli pliki z Repozytorium przechowywane będą 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 BPM (dawniej 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 BPM (dawniej DMS), klikając przycisk „Autoryzacja„.

Okno logowania do usługi IBARD w aplikacji desktopowej Comarch BPM (dawniej DMS)

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 BPM (dawniej 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 BPM (dawniej 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 BPM (dawniej 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 BPM (dawniej 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:

5.  „AllowedOrigins” – adres witryny Comarch BPM (dawniej DMS) Repozytorium, przykładowo http://[/su_list]

Przykładowe uzupełnienie „AllowedOrigins”

Powyższe ustawienia są niezbędne do właściwej konfiguracji pliku. Poniższe ustawienia natomiast można zmienić opcjonalnie:

„Key” – klucz szyfrujący,

„Issuer”:”CorelIdentity”,

„Audience”: „CorelIdentityUser”,

„DurationInMinutes”: 60 – czas, po jakim token autoryzujący wygaśnie; podany w minutach

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

„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

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 BPM (dawniej DMS) aplikację desktopową.

Wskazówka

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

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”

Wyszukiwanie frazy „Włącz lub wyłącz funkcje systemu Windows”

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

Zaznaczanie checkboxa przy „Protokół Web Socket”

Zostanie wówczas otwarte okno Funkcje systemu Windows, w ramach którego system dokona zapisu wprowadzonych zmian.

Zapisywanie wprowadzonych zmian w systemie

Gdy zmiany zostaną zapisane, informacja o tym zostanie wyświetlona w ramach okna. Należy wówczas zamknąć okno, klikając na przycisk .

Okno „Funkcje systemu Windows”, gdy zmiany zostały zapisane

  1. Następnie należy otworzyć Menadżer Internetowych Usług Internetowych (IIS) i w środkowej części okna, w sekcji Zarządzanie kliknąć 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.

Wybór opcji „Otwórz funkcję”

  1. Po wyborze opcji Otwórz funkcję w środkowej części Menedżera zostanie wyświetlony Edytor konfiguracji.

W polu Sekcja należy wyszukać na rozwijalnej liście sekcję system.webServer/webSocket, a następnie wybrać dla pola enabled wartość True. Następnie aby zapisać zmiany, wybierz opcję Zastosuj dostępną w ramach panelu Akcje po prawej stronie Menedżera.

Wybór wartości „True” dla pola „enabled”

Zatwierdzenie wprowadzonych zmian za pomocą opcji „Zastosuj”

  1. Później należy ponownie uruchomić IIS, wybierając opcję Uruchom ponownie na panelu Akcje w ramach Menedżera IIS.

Dalsza konfiguracja Comarch BPM (dawniej DMS) Repozytorium zostala opisana w artykulłach:  Konfiguracja aplikacji WEB (nowej aplikacji web) do współpracy z modułem Repozytorium oraz Repozytorium – konfiguracja początkowa dla administratora

Wskazówka

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

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

Sprawdź Szkolenia Comarch BPM Repozytorium!

Powrót do początku artykułu

＋ Mam problem z tym tematem Otwórz w portalu bazy wiedzy »