Plik Web.config

Uwaga
Comarch DMS może pracować w trybie jednofirmowym lub wielofirmowym. Niektóre ustawienia pliku Web.config w trybie wielofirmowym są nieużywane i nie ma potrzeby ich definiowania. Tryb pracy (jedno/wielofirmowy) ustawiany jest w kluczu <add key=”MultiCompany” value=”” />.

W pliku konfiguracyjnym Web.config znajdującym się w katalogu C:\inetpub\wwwroot\{nazwa aplikacji serwerowej} (katalogu, do którego przekopiowano zawartość katalogu DMS Workflow Api z pakietu instalacyjnego) dostępne są następujące klucze:

Definicje connection stringów używane w obu trybach:

  • W kluczu „strConnectDMS” należy wprowadzić connection string do bazy danych Comarch DMS.

Definicje connection stringów używane w trybie jednofirmowym:

  • W kluczu „strConnectERPComp” należy wprowadzić connection string do bazy Comarch ERP XL lub bazy firmowej Comarch ERP Optima / Comarch ERP Altum. Klucz jest wymagany do poprawnego działania integracji. Wprowadzenie klucza nie jest wymagane, jeżeli Comarch DMS pracuje w trybie wielospółkowym.
  • W kluczu „strConnectERPConf1” należy wprowadzić connection string do bazy konfiguracyjnej Comarch ERP Optima lub Comarch ERP Altum. Klucz ten jest wymagany po poprawnego działania integracji Comarch DMS z Comarch ERP Optima lub Comarch ERP Altum. Klucz jest również wymagany w trybie chmurowym Comarch ERP Optima. Wprowadzenie klucza nie jest konieczne w przypadku pracy Comarch DMS w trybie wielofirmowym.

 

Uwaga

Od wersji 2024.0.2 możliwe jest wskazanie identyfikatora connection stringa, aby określić  connection string, na podstawie którego będzie następowało połączenie do bazy danych. Jeżeli:

  • <add key=”MultiCompany” value=”false” /> – wówczas connection stringi strConnectERPComp i strConnectERPConf1 są przechowywane w pliku Web.config
  • <add key=”MultiCompany” value=”true” /> – wówczas connection stringi są przechowywane  w pliku Web.config i w tabeli do.DF_ConfCMDictionary – w tym przypadku connection stringi do baz: konfiguracyjnej i firmowej są zapisywane pod jednym ID połączenia, zastosowano zatem nastepujące identyfikatory:
    • nazwa_spółki_Comp – pobiera connection string zapisany w kolumnie CMD_ConnectionStringERP / CMD_ConnectionStringERPEncrypted
    • nazwa_spółki_Conf – pobiera connection string zapisany w kolumnie CMD_ConnectionStringERPConf / CMD_ConnectionStringERPConfEncrypted

 

gdzie nazwa_spółki – wartość wprowadzona w polu „Nazwa spólki” / „Nazwa spółki (baza)” na zakładce  „Połączenia z ERP” na zakładce [Ustawienia]

 

Wartość wprowadzona w polu „Nazwa spółki (baza)”, która wchodzi w skład identyfikatorów connection stringów

 

Przykład wykorzystania identyfikatorów connection stringów dla bazy Comarch ERP Optima w ramach kontrolki typu Własna akcja

 

Identyfikatory connection stringów są wykorzystywane w kodzie C#:

    • dla MS SQL:
      • connection = new DmsSqlConnection(Globals.Common.ConnectionStrings.strConnectDMS)
      • DmsSqlCommand command = new DmsSqlCommand(connection, sqlQuery)
    • dla PostgreSQL:
      • connection = new DmsNpgsqlConnection(„pgStrConnectDMS”)
      • DmsNpgsqlCommand command = new DmsNpgsqlCommand(connection, sqlQuery)

 

Definicje connection stringów używane w trybie wielofirmowym:

      • • Klucze „strConnectERPConf2”, „strConnectERPConf3” itd. mogą być używane w trybie chmurowym Comarch ERP Optima. Poprzez wprowadzenie connection stringów możliwe jest dodanie kilku baz konfiguracyjnych, które dostępne będą w Comarch DMS w oknie definiowanie połączeń spółki z bazą ERP.

Uwaga
Od wersji 2024.0.0 instalator szyfruje connection strings w pliku Web.config w katalogu aplikacji serwerowej (dawnej web).

Ustawienia kluczy używane w obu trybach:

      • <add key=”Version” value=”5048495746514648″ /> – parametr określający numer wersji Comarch DMS.
      • <add key=”WorkMode” value=”XL” /> – określenie współpracy Comarch DMS z systemami ERP,
              • dla Comarch ERP Optima – wartość = „Optima”,
              • dla Comarch ERP XL – wartość = „XL”,
              • dla Comarch ERP Altum – wartość = „Altum”,
              • bez współpracy z systemem EPR – wartość = „Standalone”.
      • <add key=”MultiCompany” value=”false” /> – ustawienie trybu pracy jednofirmowy (false) i wielofirmowy (true).
      • <add key=”MaximumNumberOfControlCardColumns” value=”10″ /> – definicja maksymalnej liczby kolumn karty obiegu, która będzie dostępna w konfiguracji typu obiegu.
      • <add key=”PremiumFunctionality” value=”true” /> – klucz odpowiada za dostęp do funkcjonalności modelowania procesów w Comarch DMS za pomocą kodu w języku C#. Wartość „true” – funkcjonalność dostępna, wartość „false” – funkcjonalność niedostępna.
      • <add key=”LicenceKeyServerDMS” value=”nazwa serwera klucza DMS” /> – należy wpisać nazwę serwera licencji dla aplikacji Comarch DMS.
      • <add key=”ShowChangeLanguage” value=”true” /> – wartość „true” włącza możliwość wyboru języka pracy aplikacji Comarch DMS w oknie logowania. Wartość „false” wyłącza tą możliwość.
      • <add key=”UseStrongPassword” value=”false” /> – wartość „true” wymusza stosowanie polityki mocnych haseł przez operatorów Comarch DMS (min 8 znaków, wielka litera, znak specjalny).
      • <add key=”ExternalRegistrationEnabled” value=”false” /> – wartość „true” klucza umożliwia rejestrowanie użytkowników z poziomu aplikacji web i aktywuje funkcje wpisywane do tabeli do.DF_ConfOSEmployeesQueue – tabeli z danymi rejestracji użytkowników. Okno rejestracji można wyświetlić po dodaniu do adresu aplikacji członu „/ExternalRegistration”, np. http://localhost/DMS/ExternalRegistration. Wartość klucza = „false” oznacza, że rejestracja użytkowników w aplikacji web jest niemożliwa.
              • <add key=”TaxPayerIdRequired” value=”false” /> – klucz określa, czy użytkownik będzie musiał podać NIP podczas rejestracji. Wartość „true” oznacza konieczność podania NIP, wartość „false” oznacza brak konieczności.
              • <add key=”PersonalDataProcessingConsentRequired” value=”false” /> – klucz określa, czy w oknie rejestracji będzie wyświetlany parametr „Akceptuję regulamin oraz zapoznałem się z informacją o przetwarzaniu danych osobowych”. Wartość „true” spowoduje, że parametr będzie wyświetlany, a jego zaznaczenie będzie wymagane do rejestracji konta. Tekst regulaminu i informacji o przetwarzaniu danych osobowych należy wprowadzić odpowiednio do plików Rules_pl.txt i gdpr_pl.txt znajdujących się w folderze TextResources. Wartość „false” powoduje, że parametr nie jest wyświetlany i jego zaznaczenie nie jest wymagane do rejestracji.
              • <add key=”WorkingConditionsAcceptanceRequired” value=”false” /> – klucz określa, czy w oknie rejestracji będzie wyświetlany parametr „Akceptuję warunki pracy”. Wartość „true” powoduje, że parametr będzie wyświetlany, a jego zaznaczenie będzie wymagane do rejestracji konta. Treść informacji o warunkach pracy należy wprowadzić do pliku workingConditions_pl.txt w folderze TextResources. Wartość „false” powoduje, że parametr nie jest wyświetlany i jego zaznaczenie nie jest wymagane do rejestracji.

 

Rejestracja użytkownika w DMS z poziomu aplikacji web, gdy parametr „TaxPayerIdRequired” value=”false” />, „PersonalDataProcessingConsentRequired” value=”true” /> i parametr „WorkingConditionsAcceptanceRequired” value=”true”

Uwaga
Do właściwego działania rejestracji użytkownika z poziomu aplikacji web konieczne jest poprawne wypełnienie przez administratora pól sekcji Ustawienia konta pocztowego w ramach zakładki Ustawienia w aplikacji desktopowej

      • <add key=”DocumentListDateRange” value=”150″ /> – możliwość zdefiniowania filtra zawężającego wyszukiwanie dokumentów, dla których przekazanie do kolejnego etapu odbyło się określoną ilość dni temu. Wartość klucza odpowiada liczbie dni. Niezależnie od ustawienia, operator może usunąć lub zmienić zdefiniowany filtr. Ustawienie wartość = 0 wyłącza domyślny filtr.
      • <add key=”ERPXLCloud” value=”false” /> – wartość „true” umożliwia współpracę Comarch DMS z Comarch ERP XL w trybie chmurowym.
      • <add key=”OptimaCloudMode” value=”false” /> – wartość „true” umożliwia współpracę Comarch DMS z Comarch ERP Optima w trybie chmurowym.
      • <add key=”ACDFolderPathsDestination” value=”Registry” /> – parametr dostępny od wersji 2023.1.0; umożliwia wybór miejsca zapisu ścieżek punktów ACD. Klucz może przyjmować wartości:
              • Registry – wartość domyślna, oznaczająca, że ścieżki punktów ACD będą zapisywane w rejestrze (jak dotychczas)  .
              • Database– wartość oznaczająca, że ścieżki punktów ACD będą zapisywane w bazie danych w tabeli do.DF_ConfAPFolderPaths

Uwaga
Jeśli użytkownik pierwszy raz zmienia wartość klucza na „Database”, wówczas przy pierwszym ładowaniu widoku punktów ACD wszystkie dane z rejestru zapisują się do bazy.  Natomiast przy zmianie wartości z „Database” na „Registry” dane z bazy nie są automatycznie przepisywane do rejestru.

      • <add key=”AskAboutDocumentSave” value=”True” /> – parametr odpowiedzialny za wyświetlanie komunikatów z pytaniem „Czy zapisać zmiany?” na szczegółach dokumentów Comarch DMS. W przypadku ustawienia value=”True”, komunikaty będą wyświetlane w aplikacji, w przypadku value=”False” komunikaty nie będą wyświetlane w aplikacji.

Uwaga
Gdy wartość klucza „AskAboutDocumentSave” zostanie ustawiona na „False”, w ustawieniach typu obiegu nie będzie możliwe włączenie funkcjonalności automatycznego zapisu po zainicjowaniu dokumentu.

      • <add key=”CombinationCompanies” value=”false”/> – klucz odpowiada za możliwość ustawienia różnych spółek dla kontrolek na definicji obiegu. Wyłączona możliwość ustawienia różnych spółek dla wszystkich kontrolek: value = „false”, włączona: value = „true”.
      • <add key=”DocumentCounterMinutesInterval” value=”1″/> – parametr odpowiedzialny za wyświetlanie liczby dokumentów utworzonych w ramach danego typu obiegu, liczba dokumentów prezentowana jest w nawiasie obok każdego typu obiegu na drzewie typów obiegów. Domyślnie funkcjonalność jest włączona z wartością 1, czyli odświeżenie danych o liczbie dokumentów w ramach danego typu/grupy typów obiegu odbywa się co 1 minutę. Klucz może przyjmować wartości:
            • „-1” – wartość oznaczająca, że funkcjonalność jest wyłączona, na drzewie typów obiegów nie są prezentowane wartości z liczbą dokumentów.
            • „0” – wartość oznaczająca, że funkcjonalność jest włączona i sumowanie liczby dokumentów odbywa się przy każdym wejściu na listę dokumentów
            • „<liczba całkowita>” – wartość oznaczająca, że funkcjonalność jest włączona, wpisana liczba określa wyrażony w minutach czas, po którym nastąpi automatyczne odświeżenie danych.
      • <add key = „MailSendingInterval” value=”1” /> – parametr, w którym operator określa, jak często baza danych będzie sprawdzać, czy są nowe maile (w minutach)
      • <add key = „DeleteMailsAfterSending” value=”False” /> – od wersji 2022.0.3 parametr, w którym operator określa, czy wiadomości email po wysłaniu powinny być usuwane czy zachowywane w tabelach. Klucz może przyjmować wartości:
              • „False” – wartość oznaczająca, że zarówno maile, jak I załączniki zostaną zarchiwizowane w tabelach po wysłaniu
              • „True” – wartość oznaczająca, że zarówno maile, jak i załączniki zostaną usunięte po wysłaniu
      • <add key=„NotAllowedFileExtensionsDM” value=”” /> – parametr, w ramach którego można wpisać rozszerzenia plików, które mają być zabronione przy dodawaniu nowych dokumentów do Managera Dokumentów. Domyślnie wartość klucza jest pusta – jeśli nie zostanie uzupełniona przez administratora, możliwe będzie dodawanie plików z każdym rodzajem rozszerzenia.
      • <!– <add key=”XLAPIOpeHaslo” value=”haslo” / />–> – musi pozostać zakomentowane. Parametr aktywny jeżeli ustawiono <add key=”WorkMode” value=”XL” />. Umożliwia pracę na wspólnym haśle podczas generowania dokumentów.

 

Uwaga
Odkomentowanie klucza o nazwie”XLAPIOpeHaslo” spowoduje zamianę wszystkich haseł operatorów Comarch ERP XL na hasło ustawione w kluczu.

 

      • <add key=”DestinationAttachmentsWorkflow” value=”DO” /> – parametr umożliwia wybór bazy, w której przechowywane będą załączniki dodane do dokumentów:
                • baza DMS – value = „DO”,
                • baza ERP XL – value = „XL”,
                • usługa IBARD – value = „IBARD”.
      • <add key=”DestinationAttachmentsRepository” value=”DO” /> – parametr umożliwia wybór bazy, w której przechowywane będą pliki dodane do Managera dokumentów lub usługi Comarch DMS Repozytorium:
                • baza DMS – value = „DO”,
                • usługa IBARD – value = „IBARD”.
      • <add key=”OCRComarchUri” value=”https://ocr.erp.comarch.pl/v1.0/api/” /> – 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=”Comarch2FAUri” value=”https://ws.erp.comarch.pl/services/” /> – adres usługi 2FA z Comarch ERP Optima.
      • add key=”KSeFWorkMode” value=”Demo” /> – klucz wprowadzony w wersji 2024.0.1; umozliwia określenie, czy Firma testuje funkcjonalność wysyłania faktur do KSeF, czy korzysta z niej produkcyjnie. Klucz może przybierać jedną z następujących wartości:

1.Demo – wartość domyślna; w przypadku wprowadzenia takiej wartości praca z systemem KSeF odbywa się w trybie Demo;

2.Production – w przypadku wprowadzenia takiej wartości praca z systemem KSeF odbywa się w trybie Produkcyjnym, czyli wersji produkcyjnej systemu;

3.Test – w przypadku wprowadzenia takiej wartości praca z systemem KSeF odbywa się w trybie testowym.

W kwestii różnic pomiędzy powyższymi trybami zob. Przełączanie trybu pracy z KSeF

      • <add key=„EDorAuthApiUrl” value=”https://ow.edoreczenia.gov.pl/auth/realms/EDOR” /> – klucz dodany w wersji 2024.1.0 związany z integracją z usługą e-Doręczenia; w kluczu znajduje się adres potrzebny do uzyskania tokenu dostępowego do API Search Engine i User Agent;
      • <add key=„EDorUserAgentApiUrl” value=”https://uaapi-ow.poczta-polska.pl/api/v2″ /> – klucz dodany w wersji 2024.1.0 związany z integracją z usługą e-Doręczenia; w ramach klucza określony jest endpoint dla API Search Engine;
      • <add key=„EDorSearchApiUrl” value=”https://ow.edoreczenia.gov.pl/api/se/v2″ /> – klucz dodany w wersji 2024.1.0 związany z integracją z usługą e-Doręczenia; w ramach klucza określony jest endpoint dla API User Agent;
      • <add key=„EDorMaxMessageSize” value=”15″ /> – klucz dodany w wersji 2024.1.0 związany z integracją z usługą e-Doręczenia; w ramach klucza określony jest maksymalny dopuszczalny rozmiar załączników, które są przesyłane w ramach usługi E-Doręczenia. Aktualnie wartość ta wynosi 15 MB. Klucz nieaktywny w pierwszej wersji funkcjonalności;
      • <!– <add key=„ERPSQLServer1” value=”.” – klucz wymagany przy współpracy z Comarch ERP XL w trybie chmurowym (należy odkomentować). Należy zdefiniować serwer dla bazy ERP XL.
      • <!– <add key=”ERPSQLServer2” value=”.” /> –> – jeżeli ERP XL w trybie chmurowym pracuje na więcej niż jednym serwerze, należy odkomentować i uzupełnić.
      • <add key=”DMUsersIdAllowedToReorderDirectiories” value=”” /> – wartość klucza określa, którzy operatorzy są uprawnieni do zarządzania układem katalogów na drzewie w Managerze dokumentów. Domyślnie wartość klucza jest pusta, oznacza to, że wszyscy operatorzy mogą zarządzać kolejnością katalogów na drzewie. Jeżeli w kluczu zostaną wskazane identyfikatory operatorów DMS (DCD_ID), będzie to oznaczać, że jedynie wskazani operatorzy posiadają uprawnienie do reorganizacji struktury katalogów. Identyfikatory operatorów powinny być rozdzielane przecinkiem.
      • <add key=”CompanyNameSearchModeEnabled” value=”false” /> – klucz działa w trybie wielospółkowym, wartość „true” powoduje możliwość zawężania listy wyświetlanych spółek po wpisaniu frazy w okno wyszukiwania. Jeżeli wartość = „false”, spółkę należy znaleźć i wybrać z rozwijanej listy.
      • <add key=”UseRepository” value=”false” /> – parametr określający, czy do przechowywania dokumentów będzie używany moduł Manager dokumentów (wartość „false”), czy funkcjonalność Comarch DMS Repozytorium (wartość „true”).
      • <add key=”RepositoryUrl” value=”” /> – w przypadku korzystania z funkcjonalności Comarch DMS Repozytorium, należy wprowadzić adres URL aplikacji DocumentManager.WebApi,
        np. 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 aplikacji nowego klienta web,
        np. http://localhost/ DocumentWorkflow.Web (w wersjach starszych niż 2024.0.0 w tym miejscu znajduje się klucz <add key=”RepositoryClientUrl” value=”” /> – w przypadku korzystania z funkcjonalności Comarch DMS Repozytorium, należy wprowadzić adres URL aplikacji DocumentManager.WebClient,http://localhost/DocumentManager.WebClient).
      • <add key=”PerformanceAnalysisTimeRange” value=”1000,5000″ /> – klucz dostępny od wersji 2024.0.0; umożliwia zmianę zakresów czasowych  informacji prezentowanych na zakładce „Analiza wydajności” w sekcji „Statystyki”
      • <add key=”MaxLoginAttempts” value=”5″/> – klucz dostępny od wersji 2024.1.1; w ramach tego klucza należy podać, jaka ma być maksymalna liczba prób logowania dla operatora zanim nastąpi zablokowanie logowania – domyślna wartość to 5 (zob. Blokowanie logowania po kilku nieudanych próbach)
      • <add key=”LoginBlockTime” value=”60″/> – klucz dostępny od wersji 2024.1.1; w ramach tego klucza należy podać, po jakim czasie (liczonym w sekundach) operator będzie mógł podjąć kolejną próbę logowania, po tym, jak logowanie zostało zablokowane – domyślna wartość to 60 (zob. Blokowanie logowania po kilku nieudanych próbach)

 

Ustawienia kluczy używane w trybie jednofirmowym:

      • <add key=”CompanyName” value=”<nazwa firmy>” /> – można zdefiniować nazwę firmy, która zostanie wyświetlona w aplikacji przed loginem zalogowanego operatora.
      • <add key=”LicenceKeyServerERP” value=”<nazwa serwera klucza ERP>” /> – należy wpisać nazwę serwera licencji dla Comarch ERP XL / Comarch ERP Optima / Comarch ERP Altum.
      • <add key=”EnableAnaliticDescription” value=”false” /> – parametr aktywny jeżeli ustawiono <add key=”WorkMode” value=”XL” />. Umożliwia dekretację kosztów i generowanie dokumentów.
      • <add key=”AnalitycalDescriptionWorkMode” value=”1″ /> – parametr określa tryb pobierania wymiarów opisu analitycznego. Klucz przyjmuje następujące wartości:
                      • 1 – bezpośrednie pobieranie wymiarów z bazy Comarch ERP XL,
                      • 2 – tryb z buforowaniem i doczytywaniem wymiarów do nowej daty utworzenia dokumentów (tryb, w którym dotychczas były pobierane wymiary opisu analitycznego),
                      • 3 – tryb z buforowaniem, ale bez doczytywania wymiarów (warunek: w Comarch ERP XL wymiary nie posiadają zakresów czasowych).
      • <add key=”CdnApiVersion” value=”20201″ /> – nr wersji systemu ERP XL, z którym współpracuje Comarch DMS.
      • <add key=”UrlERP” value=”UrlERP” /> – klucz należy uzupełnić przy konfigurowaniu współpracy Comarch DMS z Comarch ERP Enterprise (CEE). Należy wprowadzić adres URL do systemu CEE. np. „https://nazwa_aplikacji.cisag.com”. Nie ma konieczności uzupełniania klucza w przypadku pracy w trybie wielospółkowym.
      • <add key=”CertificateNameERP” value=”CertificateNameERP” /> – należy uzupełnić klucz certyfikatu dla CEE. Nie ma konieczności uzupełniania klucza w przypadku pracy w trybie wielospółkowym.
      • <add key=”RestServiceERP” value=”RestServiceERP” /> –  w kluczu należy umieścić adres serwisu rest systemu Comarch ERP Enterprise.
      • <add key=”DatabaseERP” value=”DatabaseERP” /> – należy wprowadzić nazwę bazy CEE. Nie ma konieczności uzupełniania klucza w przypadku pracy w trybie wielospółkowym.
      • <add key=”OrganizationERPId” value=”OrganizationERP” /> – należy wprowadzić unikalny identyfikator (w formie GUID) domyślnej organizacji w CEE. Nie ma konieczności uzupełniania klucza w przypadku pracy w trybie wielospółkowym.
      • <add key=”OrganizationERPName” value=”DefaultOrganizationIdentifier” /> – należy wprowadzić nazwę organizacji nadaną w systemie Comarch ERP Enterprise.
      • <!– <add key=”ERPSQLServer1” value=”.” /> –> – klucz wymagany przy współpracy z Comarch ERP XL w trybie chmurowym (należy odkomentować). Należy zdefiniować serwer dla bazy ERP XL.
      • <!– <add key=”ERPSQLServer2” value=”.” /> –> – jeżeli ERP XL w trybie chmurowym pracuje na więcej niż jednym serwerze, należy odkomentować i uzupełnić.



Rejestracja nowych użytkowników w aplikacji serwerowej (dawna web)

Od wersji 2020.2.1 dostępna jest możliwość rejestracji nowych użytkowników Comarch DMS z poziomu aplikacji serwerowej (dawna web). Do potencjalnego użytkownika zostaje wysłany mail zawierający link do formularza rejestracyjnego, w ramach którego potencjalny użytkownik :

  • podaje dane konieczne do założenia konta
  • potwierdza zapoznanie się z regulaminem, informacją o ochronie danych osobowych i warunkami pracy w aplikacji

 

Uwaga
Formularz rejestracyjny wymaga konfiguracji przez administratora systemu Comarch DMS.

 

Konfiguracja

Rejestracja nowych użytkowników z poziomu aplikacji serwerowej (dawna web) zostaje włączona, jeśli w pliku web.config wartość klucza <add key=”ExternalRegistrationEnabled” value=”false” /> zostanie zmieniona na true:

<add key=”ExternalRegistrationEnabled” value=”true” />  (zob. Instalacja aplikacji serwerowej (dawnej web) w trybie ręcznym).  Następnie należy określić następujące parametry:

  • <add key=”TaxPayerIdRequired” value=”false” /> – klucz określa, czy użytkownik będzie musiał podać NIP podczas rejestracji. Wartość „true” oznacza konieczność podania NIP, wartość „false” oznacza brak konieczności.

 

Widok formularza rejestracji po ustawieniu wartości true w ramach klucza „TaxPayerIdRequired”

 

  • <add key=”PersonalDataProcessingConsentRequired” value=”false” /> – klucz określa, czy w oknie rejestracji będzie wyświetlany parametr „Akceptuję regulamin oraz zapoznałem się z informacją o przetwarzaniu danych osobowych”. Wartość „true” spowoduje, że parametr będzie wyświetlany, a jego zaznaczenie będzie wymagane do rejestracji konta. Tekst regulaminu i informacji o przetwarzaniu danych osobowych należy wprowadzić odpowiednio do plików Rules_pl.txt i Gdpr_pl.txt znajdujących się w folderze TextResources. Wartość „false” powoduje, że parametr nie jest wyświetlany i jego zaznaczenie nie jest wymagane do rejestracji.

 

Widok formularza rejestracji po ustawieniu wartości true w ramach klucza ”PersonalDataProcessingConsentRequired”

 

  • <add key=”WorkingConditionsAcceptanceRequired” value=”false” /> – klucz określa, czy w oknie rejestracji będzie wyświetlany parametr „Akceptuję warunki pracy”. Wartość „true” powoduje, że parametr będzie wyświetlany, a jego zaznaczenie będzie wymagane do rejestracji konta. Treść informacji o warunkach pracy należy wprowadzić do pliku WorkingConditions_pl.txt w folderze TextResources. Wartość „false” powoduje, że parametr nie jest wyświetlany i jego zaznaczenie nie jest wymagane do rejestracji.

 

Widok formularza rejestracji po ustawieniu wartości true w ramach klucza ”WorkingConditionsAcceptanceRequired”

 

Wskazówka
W plikach można użyć znaczników HTML, aby sformatować treść prezentowaną na stronie

 

Przebieg rejestracji

Uwaga
Do właściwego działania rejestracji użytkownika z poziomu aplikacji web konieczne jest poprawne wypełnienie przez administratora pól sekcji Ustawienia konta pocztowego w ramach zakładki Ustawienia  w aplikacji desktopowej

Potencjalny użytkownik wyświetla w przeglądarce stronę, która znajduje się pod adresem: http://localhost/DocumentWorkflow.Web/ExternalRegistration- adres składa się z adresu aplikacji serwerowej (dawna web), do którego dokładany jest człon „/ExternalRegistration”, np. http://localhost/Standalone/ExternalRegistration

 

Widok formularza rejestracji po ustawieniu wartości true w ramach kluczy: „TaxPayerIdRequired”, ”PersonalDataProcessingConsentRequired”, ”WorkingConditionsAcceptanceRequired” (wymagane jest uzupełnienie wszystkich parametrów)

 

Widok formularza rejestracji po ustawieniu wartości false w ramach kluczy: „TaxPayerIdRequired”, ”PersonalDataProcessingConsentRequired”, ”WorkingConditionsAcceptanceRequired” (nie jest wymagane uzupełnienie NIP, a dodatkowe parametry są wyłączone)

 

Potencjalny użytkownik powinien uzupełnić wymagane pola formularza, a następnie kliknąć przycisk [Zarejestruj się].

 

Przykładowe uzupełnienie formularza rejestracji nowego użytkownika

 

Po wyborze przycisku [Zarejestruj się] wyświetlone zostaje okno informujące o konieczności aktywacji konta, aby dokończyć proces rejestracji, a na adres email podany w formularzu wysyłana jest wiadomość zawierająca link aktywacyjny do konta. Jeżeli wiadomość nie dotarła na skrzynkę mailową, można ponowić próbę, klikając wyślij link ponownie w ramach okna przeglądarki.

 

Okno wyświetlane po wyborze przycisku „Zarejestruj się”

 

Wiadomość email z linkiem aktywacyjnym, wysłana na adres podany w formularzu rejestracyjnym

 

Po wyborze przycisku [Aktywuj konto] wyświetlane jest okno z informacją o zakończeniu rejestracji sukcesem i z przyciskiem [Zaloguj się do Comarch DMS], po wyborze którego następuje przejście do okna logowania do aplikacji serwerowej (dawna web) Comarch DMS.

 

Okno wyświetlane po kliknięciu przycisku „Aktywuj konto”

 

Okno logowania do aplikacji serwerowej (dawna web), dostępne po wyborze przycisku „Zaloguj się do Comarch DMS”

 

Dodany w ten sposób pracownik jest widoczny wraz z  loginem, imieniem, nazwiskiem i adresem mailowym, które uzupełniono w formularzu rejestracji,  w ramach zakładki [Struktura organizacyjna] w aplikacji Comarch DMS desktop.

 

Przykładowy pracownik dodany z poziomu aplikacji web




Zmiany w instalatorze Comarch DMS w wersji 2024.2.0

Umożliwienie instalacji serwera Mongo DB oraz instalacji i aktualizacji aplikacji Comarch DMS Repozytorium z poziomu instalatora Comarch

W wersji 2024.2.0 umożliwiono:

      • Instalację serwera MongoDB z poziomu instalatora Comarch DMS;
      • Instalację aplikacji Comarch DMS Repozytorium za pomocą instalatora Comarch DMS;
      • Aktualizację aplikacji Comarch DMS Repozytorium z poziomu instalatora Comarch DMS.

 

Zmiany w oknie „Wybór aplikacji”

W ramach okna „Wybór aplikacji” zaszły następujące zmiany:

Zmianie uległy również komentarze dostępne po lewej stronie okna.

 

Uwaga
Instalację aplikacji Comarch DMS oraz Comarch DMS Repozytorium należy przeprowadzić na serwerze (komputerze), na którym zainstalowano serwis IIS (Internet Information Services).

 

Okno „Wybór aplikacji” w instalatorze Comarch DMS

 

Dodanie okna „Wybór aplikacji cd.”

W wersji 2024.2.0 dodano okno „Wybór aplikacji cd.”. Okno wyświetlane jest w przypadku, jeśli w oknie „Wybór aplikacji” operator zaznaczył opcję „Instalacja aplikacji Comarch DMS oraz Comarch DMS Repozytorium”, a następnie nacisnął [Dalej].

W ramach okna „Wybór aplikacji cd.” operator może wybrać jedną z trzech opcji:

Okno „Wybór aplikacji cd.”

 

Instalacja serwera Mongo DB

Aby zainstalować serwer Mongo DB, należy przejść do katalogu <wybrana lokalizacja/Comarch DMS 2024.2.0\Comarch DMS 2024.2.0 instalator Comarch DMS i uruchomić plik Instalator Comarch DMS.exe na komputerze, na którym ma zostać zainstalowany serwer MongoDB a/albo MongoDB Compass i gdzie zostanie utworzona nowa baza MongoDB.

Po przejściu kolejnych kroków instalacji analogicznie jak w poprzedniej wersji operator powinien wybrać dodaną w wersji 2024.2.0 opcję „Instalacja serwera MongoDB” w ramach okna „Wybór aplikacji”, a następnie kliknąć [Dalej].

 

Zaznaczanie opcji „Instalacja serwera MongoDB” w ramach okna „Wybór aplikacji” w instalatorze Comarch DMS

Po naciśnięciu [Dalej] następuje przejście do okna „Serwer MongoDB”. Jeśli na danym komputerze jest już zainstalowany serwer Mongo DB, wówczas wyświetlony zostanie następujący komunikat blokujący ponowną instalację serwera MongoDB:

 

Zaznaczanie opcji „Instalacja serwera MongoDB” w ramach okna „Wybór aplikacji” w instalatorze Comarch DMS

Po wyborze przycisku „OK” komunikat zostanie zamknięty, a operator będzie mógł wybrać inny komponent do instalacji/aktualizacji w oknie „Wybór aplikacji”

Jeżeli na danym komputerze nie jest zainstalowany serwer MongoDB, wówczas nastąpi przejście do okna „Serwer MongoDB”. W ramach okna znajdują się następujące pola:

      • Zainstaluj MongoDB Compass – domyślnie zaznaczony parametr – jeśli parametr pozostanie zaznaczony, wówczas MongoDB Compass zostanie zainstalowany na tej samej maszynie, na której zainstalowana będzie baza;
      • Ścieżka instalacyjna – ścieżka instalacyjna serwera – domyślnie C:\Program Files\ – operator może kliknąć w przycisk [Przeglądaj] znajdujący się obok tego pola i wybrać preferowaną lokalizację;
      • Adres IP serwera IIS – w ramach tego pola należy wprowadzić adres IP serwera IIS, a następnie kliknąć przycisk [Połącz], aby sprawdzić, czy wprowadzono poprawny adres – jeśli adres jest poprawny, zostanie wyświetlony napis „Nawiązano połączenie z serwerem IIS”;
      • Login – w ramach tego pola należy wprowadzić login dla użytkownika, który ma posiadać uprawnienia administratora na serwerze MongoDB (jak użytkownik „admin” w instrukcji ręcznej konfiguracji MongoDB);
      • Hasło – w ramach tego pola należy wprowadzić hasło dla użytkownika, który ma posiadać uprawnienia administratora na serwerze MongoDB (jak hasło użytkownika „admin” w instrukcji ręcznej konfiguracji MongoDB) – Hasło powinno spełniać następujące warunki:
        • Składać się z min. 12 znaków;
        • Zawierać cyfry;
        • Zawierać małe i wielkie litery;
        • Zawierać znaki specjalne;
      • Powtórz hasło – pole, w którym należy ponownie wpisać hasło wprowadzone w polu „Hasło”

Okno „Serwer MongoDB” po sprawdzeniu połączenia i uzupełnieniu pól

Kiedy operator wpisał poprawny adres IP serwera IIS, login oraz hasło, wówczas przycisk [Instaluj] staje się aktywny.

Po kliknięciu w przycisk [Instaluj] następuje przejście do okna „Instalacja” i odbywa się instalacja serwera MongoDB, wyświetlane jest także osobne okno instalacji serwera.

 

Okno „Instalacja”

 

Okno instalacji serwera

 

Gdy instalacja serwera MongoDB została zakończona, wówczas następuje przejście do okna „Koniec pracy instalatora”, a okno instalacji serwera zostanie automatycznie zamknięte. Aby zamknąć okno instalatora DMS, należy nacisnąć [Zakończ].

W dalszej kolejności należy zainstalować aplikacje: serwerową, WEB (jeśli nie zostały zainstalowane wcześniej) oraz Repozytorium.

 

Uwaga
Logi będą zapisywane w podanej ścieżce instalacyjnej w oknie Serwer MongoDB z dopiskiem „\log” – przykładowo: C:\Program Files\MongoDB\Server\5.0\log.

 

Okno „Koniec pracy instalatora”

 

Instalacja aplikacji Comarch DMS

Jeśli operator chce zainstalować aplikację Comarch DMS (bez Comarch DMS Repozytorium) – wówczas powinien zaznaczyć opcję „ Instalacja aplikacji Comarch DMS”.

W takim przypadku kolejne kroki instalacji pozostają bez zmian w stosunku do poprzedniego instalatora Comarch DMS, z wyjątkiem zmiany warunków do silnego hasła oraz komunikatów w oknie Baza danych Comarch DMS, Baza danych Comarch ERP XL, Konfiguracyjna baza danych Comarch ERP Optima, Firmowa baza danych Comarch ERP Optima (zob. Zmiany warunków do silnego hasła oraz komunikatów dotyczących błędnego hasła w instalatorze Comarch DMS).

 

Instalacja aplikacji Comarch DMS oraz Comarch DMS Repozytorium

Jeśli operator chce zainstalować zarówno aplikację Comarch DMS, jak i aplikację Comarch DMS Repozytorium – w takim przypadku powinien zaznaczyć opcję „Instalacja aplikacji Comarch DMS oraz Comarch DMS Repozytorium”.

Zaznaczanie opcji „Instalacja aplikacji Comarch DMS oraz Comarch DMS Repozytorium” w ramach okna „Wybór aplikacji cd.” w instalatorze Comarch DMS

 

W takim przypadku kolejne kroki instalacji aż do okna Baza danych Comarch DMS (tryb pracy Comarch DMS Standalone)/ Baza danych Comarch ERP XL (tryb pracy Współpraca z Comarch ERP XL)/Firmowa baza danych Comarch ERP Optima (tryb pracy Współpraca z Comarch ERP Optima) pozostają bez zmian w stosunku do poprzedniego instalatora Comarch DMS, z wyjątkiem zmiany warunków do silnego hasła oraz komunikatów w oknie Baza danych Comarch DMS, Baza danych Comarch ERP XL, Konfiguracyjna baza danych Comarch ERP Optima, Firmowa baza danych Comarch ERP Optima (zob. Zmiany warunków do silnego hasła oraz komunikatów dotyczących błędnego hasła w instalatorze Comarch DMS).

Po kliknięciu przycisku [Dalej] w ramach okna Baza danych Comarch DMS (tryb pracy Comarch DMS Standalone)/ Baza danych Comarch ERP XL (tryb pracy Współpraca z Comarch ERP XL)/ Firmowa baza danych Comarch ERP Optima (tryb pracy Współpraca z Comarch ERP Optima) następuje przejście do dodanego w wersji 2024.2.0 okna „Pula aplikacji dla Comarch DMS Repozytorium”

Okno „Pula aplikacji Comarch DMS Repozytorium” przed dodaniem/wyborem puli aplikacji

W ramach okna „Pula aplikacji Comarch DMS Repozytorium” należy określić, na jakiej puli aplikacji ma pracować aplikacja Comarch DMS Repozytorium– w tym celu należy:

      • Wybrać pulę aplikacji z listy znajdującej się po prawej stronie okna, klikając na nią

lub

      • Dodać nową pulę aplikacji –wpisać nazwę puli, która ma zostać utworzona, w polu „„Nazwa nowej puli aplikacji”, a następnie nacisnąć przycisk   [Dodaj pulę]. Wybór puli zostaje automatycznie ustawiony na nowoutworzonej puli . Dodana w ten sposób pula spełnia wymagania konieczne do instalacji aplikacji Comarch DMS Repozytorium.

 

Dodawanie puli „Repozytorium”

 

Okno „Pula aplikacji”, w którym wybrano pulę „Comarch DMS”

 

Po wyborze puli aplikacji spełniającej wymagania należy przejść do następnego kroku instalacji , klikając przycisk   [Dalej].

Następnie w dodanym w wersji 2024.2.0 oknie Kreowanie aplikacji Repozytorium następuje konfiguracja aplikacji dla modułu Comarch DMS Repozytorium. W ramach okna Kreowanie aplikacji Repozytorium użytkownik:

      • w polu „Wybierz lub utwórz witrynę web” – z listy dostępnych witryn wybiera witrynę, w której ma zostać utworzona aplikacja Comarch DMS Repozytorium;

Uwaga
Zalecane jest, aby aplikacja Comarch DMS Repozytorium została zainstalowana na tej samej witrynie, na której znajduje się moduł Workflow (np. Default Web Site).

      • w polu „Port” – wpisuje numer portu, który przypisany jest do danej witryny;
      • w polu „Wprowadź nazwę aplikacji Repozytorium” – wpisuje nadaną przez siebie nazwę aplikacji, np. DMSRepozytorium

 

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

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 „Kreoanie aplikacji Repozytorium” po tym, jak aplikacja została utworzona

 

Operator ma również opcję dodania nowej witryny, na której utworzy aplikację Comarch DMS Repozytorium, jednakże zaleca się, aby aplikację Comarch DMS Repozytorium zainstalować na tej samej witrynie, na której zainstalowano moduł Workflow Comarch DMS.

Aby jednak utworzyć nową witrynę operator 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 Repozytorium” 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 Repozytorium” po pomyślnym dodaniu nowej witryny

 

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

Następnie w ramach okna „Baza danych Comarch DMS Repozytorium” operator powinien uzupełnić:

      • W ramach pola „Nazwa serwera” – nazwę serwera, na którym znajduje się serwer MongoDB;

Uwaga
Istnieje możliwość wprowadzenia w ramach pola „Nazwa serwera” IP serwera MongoDB.

      • W sekcji „Logowanie do serwera MongoDB”:
        • W ramach pola „Login” – login administratora MongoDB
        • W ramach pola „Hasło” – hasło administratora MongoDB

Następnie należy sprawdzić poprawność wprowadzonych danych, klikając w przycisk [Połącz].

Jeśli próba nawiązania połączenia zakończyła się powodzeniem, w dolnej części okna wyświetlony zostaje napis „Nawiązano połączenie z serwerem MongoDB”.

Uwaga
Dane uwierzytelniające operatora są niezbędne do przeprowadzenia procesu instalacji i są wykorzystywane wyłącznie podczas pracy instalatora.

Okno „Baza danych Comarch DMS Repozytorium” przed uzupełnieniem pól

 

Okno „Baza danych Comarch DMS Repozytorium” po uzupełnieniu pól i kliknięciu w przycisk „Połącz”

 

Następnie operator powinien wybrać bazę w ramach pola „Lista baz danych” (jeśli wcześniej przygotowano bazę przeznaczoną dla Comarch DMS Repozytorium) albo nacisnąć przycisk [Dodaj bazę], aby utworzyć nową bazę danych dla aplikacji Comarch DMS Repozytorium.

Jeżeli operator kliknął w przycisk [Dodaj bazę], wówczas zostaje otwarte okno w ramach którego należy wprowadzić nazwę nowej bazy danych Comarch DMS Repozytorium, a następnie kliknąć  [Zapisz]. Jeżeli użytkownik nie chce jednak dodać nowej bazy, wtedy powinien nacisnąć przycisk   [Anuluj] albo znak X.

Okno dodawania nowej bazy Comarch DMS Repozytorium

 

Po naciśnięciu przycisku   [Zapisz] baza Comarch DMS Repozytorium zostaje dodana i w ramach instalatora wyświetla się informacja „ Baza danych została utworzona”.

Okno „Baza danych Comarch DMS Repozytorium” po dodaniu nowej bazy

 

Następnie operator powinien nacisnąć przycisk [Zmień hasło].

W otwartym oknie w polu „Hasło” należy ustawić hasło dla użytkownika MongoUser serwera MongoDB, za którego pośrednictwem będzie odbywać się komunikacja aplikacji Comarch DMS Repozytorium z bazą danych. Hasło należy następnie wpisać ponownie w polu „Powtórz hasło”, a później kliknąć przycisk „Zapisz”.

Okno zmiany hasła dla użytkownika MongoUser

 

Hasło powinno spełniać następujące warunki:

      • Składać się z min. 12 znaków;
      • Zawierać cyfry;
      • Zawierać małe i wielkie litery;
      • Zawierać znaki specjalne.

Jeżeli wpisano hasło, które nie spełnia któregoś z tych trzech wymagań, wówczas po kliknięciu przycisku   [Zapisz] hasło nie zostaje zapisane i wyświetlany jest komunikat:

      • Jeśli hasło jest za krótkie

      • Brakuje warunku/warunków wymaganych dla silnego hasła (brak znaku specjalnego, brak wielkiej litery)

 

Należy zmienić hasło, tak, aby spełniało wszystkie warunki.

Jeśli natomiast hasło wpisane w polu „Powtórz hasło” różni się od hasła wpisanego w polu „Hasło”, wtedy po kliknięciu przycisku [Zapisz] hasło nie zostaje zapisane i wyświetlany jest komunikat:

 

Komunikat wyświetlany, jeśli hasła nie są zgodne

 

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 MongoUsera zostaje zamknięte, a hasło użytkownika MongoUser zostaje zmienione. Następnie operator powinien kliknąć  [Dalej].

Okno „Baza danych Comarch DMS Repozytorium” po zmianie hasła dla użytkownika MongoUser

 

Po kliknięciu w przycisk  [Dalej] następuje przejście do okna „Klucze licencji”. Operator powinien uzupełnić:

      • W ramach pola „Serwer klucza licencji Comarch DMS” – klucz licencji dla Comarch DMS
      • W ramach pola „Serwer klucza licencji Comarch ERP XL”/ „Serwer klucza licencji Comarch ERP Optima” – w przypadku współpracy Comarch DMS z systemem ERP, odpowiednio: z Comarch ERP XL lub Comarch ERP Optima
      • W ramach pola „Adres e-mail administratora” – adres email, który będzie widoczny w Comarch DMS w komunikatach, w których wymagany jest kontakt z administratorem

Okno „Klucze licencji” przed wprowadzeniem zmian (w przypadku instalacji Comarch DMS Standalone)

 

Po uzupełnieniu pól operator powinien kliknąć [Instaluj]. Następuje wówczas przejście do kolejnego okna „Instalacja”.

Okno „Instalacja”

 

Po zakończeniu instalacji następuje przejście do końcowego okna instalacji aplikacji. Gdy 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.

Dalsze kroki dotyczące konfiguracji Comarch DMS Repozytorium należy wykonać w ramach aplikacji desktop Comarch DMS, a następnie w zakładce [Repozytorium] w aplikacji web Comarch DMS.

Okno „Koniec pracy instalatora”

 

Instalacja Comarch DMS Repozytorium

Jeżeli operator chce zainstalować tylko aplikację Comarch DMS Repozytorium do wybranej aplikacji Comarch DMS – wówczas powinien zaznaczyć opcję „Instalacja Comarch DMS Repozytorium” i nacisnąć [Dalej].

Uwaga
Konieczne jest, aby wersja zainstalowanych aplikacji Comarch DMS była zgodna z wersją instalowanego modułu Comarch DMS Repozytorium.

Zaznaczanie opcji „Instalacja Comarch DMS Repozytorium” w ramach okna „Wybór aplikacji” w instalatorze Comarch DMS

 

Po kliknięciu przycisku [Dalej] następuje przejście do okna Warunki korzystania z oprogramowania, gdzie należy zapoznać się z warunkami korzystania z oprogramowania Comarch DMS, zaznaczyć checkbox „Akceptuję warunki instalacji” i nacisnąć   [Dalej], aby przejść do kolejnego etapu – przycisk nie jest aktywny, jeśli nie została zaznaczona zgoda na warunki instalacji.

Okno „Warunki korzystania z oprogramowania

 

Po przejściu przez kolejne okna – „Internetowe usługi informacyjne (IIS)”, a następnie „Wymagane dodatki” – analogiczne do okien w dotychczasowym instalatorze – w ramach okna „Pula aplikacji Comarch DMS Repozytorium” należy określić, na jakiej puli aplikacji ma pracować aplikacja Comarch DMS Repozytorium– w tym celu należy:

      • Wybrać pulę aplikacji z listy znajdującej się po prawej stronie okna, klikając na nią

lub

      • Dodać nową pulę aplikacji –wpisać nazwę puli, która ma zostać utworzona, w polu „„Nazwa nowej puli aplikacji”, a następnie nacisnąć przycisk   [Dodaj pulę]. Wybór puli zostaje automatycznie ustawiony na nowoutworzonej puli . Dodana w ten sposób pula spełnia wymagania konieczne do instalacji aplikacji Comarch DMS Repozytorium.

Okno „Pula aplikacji Comarch DMS Repozytorium” przed dodaniem/wyborem puli aplikacji

 

Dodawanie puli „Repozytorium”

 

Okno „Pula aplikacji”, w którym wybrano pulę „Comarch DMS”

 

Po wyborze puli aplikacji spełniającej wymagania należy przejść do następnego kroku instalacji , klikając przycisk   [Dalej].

Następnie w dodanym w oknie Kreowanie aplikacji Repozytorium następuje konfiguracja aplikacji dla modułu Comarch DMS Repozytorium. W ramach okna Kreowanie aplikacji Repozytorium użytkownik:

      • w polu „Wybierz lub utwórz witrynę web” – z listy dostępnych witryn wybiera witrynę, w której ma zostać utworzona aplikacja Comarch DMS Repozytorium;

Uwaga
Zalecane jest, aby aplikacja Comarch DMS Repozytorium została zainstalowana na tej samej witrynie, na której znajduje się moduł Workflow (np. Default Web Site).

      • w polu „Port” – wpisuje numer portu, który przypisany jest do danej witryny;
      • w polu „Wprowadź nazwę aplikacji Repozytorium” – wpisuje nadaną przez siebie nazwę aplikacji, np. DMSRepozytorium

 

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

 

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 Repozytorium” 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 „Nazwa witryny” i ponownie kliknąć    [Utwórz aplikację].

Operator ma również opcję dodania nowej witryny, na której utworzy aplikację Comarch DMS Repozytorium, jednakże zaleca się, aby aplikację Comarch DMS Repozytorium zainstalować na tej samej witrynie, na której zainstalowano moduł Workflow Comarch DMS.

Aby jednak utworzyć nową witrynę operator 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 Repozytorium” 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 Repozytorium” po pomyślnym dodaniu nowej witryny

 

Po kliknięciu  [Dalej] następuje przejście do okna „Witryny i aplikacje Comarch DMS”. W ramach okna operator powinien:

      • W pierwszym polu „Wybierz witrynę web” wybrać z listy witrynę, w której utworzono aplikację serwerową, z którą będzie współpracowała aplikacja Comarch DMS Repozytorium;
      • W polu „Wybierz aplikację serwerową” wybrać z listy aplikację serwerową, z którą będzie współpracowała aplikacja Comarch DMS Repozytorium;
      • W drugim polu „Wybierz witrynę web” wybrać z listy witrynę, w której utworzono aplikację WEB, z którą będzie współpracowała aplikacja Comarch DMS Repozytorium;
      • W polu „Wybierz aplikację WEB” wybrać z listy aplikację WEB, z którą będzie współpracowała aplikacja Comarch DMS Repozytorium.

 

Okno „Witryny i aplikacje Comarch DMS” po uzupełnieniu pól

 

Kiedy operator wskazał witryny i aplikacje, a następnie kliknął przycisk  [Dalej], wówczas następuje weryfikacja zgodności wersji wybranych aplikacji Comarch DMS z wersją modułu Comarch DMS Repozytorium, która jest instalowana.

Jeżeli weryfikacja wykaże, że wersje nie są zgodne, wówczas zostanie wyświetlony następujący komunikat:

Komunikat wyświetlany, gdy wersje aplikacji Comarch DMS i Comarch DMS Repozytorium nie są zgodne

 

Gdy operator kliknie przycisk [OK], instalator zostanie zamknięty.

Jeśli weryfikacja zgodności wersji wybranych aplikacji Comarch DMS z wersją modułu Comarch DMS Repozytorium zakończyła się powodzeniem, wówczas po kliknięciu przycisku  [Dalej] następuje przejście do okna „Baza danych Comarch DMS Repozytorium”.

W oknie „Baza danych Comarch DMS Repozytorium” operator powinien uzupełnić:

      • W ramach pola „Nazwa serwera” – nazwę serwera, na którym znajduje się serwer MongoDB;

Uwaga
Istnieje możliwość wprowadzenia w ramach pola „Nazwa serwera” IP serwera MongoDB.

      • W sekcji „Logowanie do serwera MongoDB”:
        • W ramach pola „Login” – login administratora MongoDB
        • W ramach pola „Hasło” – hasło administratora MongoDB

Następnie należy sprawdzić poprawność wprowadzonych danych, klikając w przycisk [Połącz].

Jeśli próba nawiązania połączenia zakończyła się powodzeniem, w dolnej części okna wyświetlony zostaje napis „Nawiązano połączenie z serwerem MongoDB”.

Uwaga
Dane uwierzytelniające operatora są niezbędne do przeprowadzenia procesu instalacji i są wykorzystywane wyłącznie podczas pracy instalatora.

Okno „Baza danych Comarch DMS Repozytorium” przed uzupełnieniem pól

 

Okno „Baza danych Comarch DMS Repozytorium” po uzupełnieniu pól i kliknięciu w przycisk „Połącz”

 

Następnie operator powinien wybrać bazę w ramach pola „Lista baz danych” (jeśli wcześniej przygotowano bazę przeznaczoną dla Comarch DMS Repozytorium) albo nacisnąć przycisk [Dodaj bazę], aby utworzyć nową bazę danych dla aplikacji Comarch DMS Repozytorium.

Jeżeli operator kliknął w przycisk [Dodaj bazę], wówczas zostaje otwarte okno w ramach którego należy wprowadzić nazwę nowej bazy danych Comarch DMS Repozytorium, a następnie kliknąć  [Zapisz].

Jeżeli użytkownik nie chce jednak dodać nowej bazy, wtedy powinien nacisnąć przycisk   [Anuluj] albo znak X.

Okno dodawania nowej bazy Comarch DMS Repozytorium

 

Po naciśnięciu przycisku   [Zapisz] baza Comarch DMS Repozytorium zostaje dodana i w ramach instalatora wyświetla się informacja „ Baza danych została utworzona”.

Okno „Baza danych Comarch DMS Repozytorium” po dodaniu nowej bazy

 

Następnie operator powinien nacisnąć przycisk [Zmień hasło].

W otwartym oknie w polu „Hasło” należy ustawić hasło dla użytkownika MongoUser serwera MongoDB, za którego pośrednictwem będzie odbywać się komunikacja aplikacji Comarch DMS Repozytorium z bazą danych.

Hasło należy następnie wpisać ponownie w polu „Powtórz hasło”, a później kliknąć przycisk „Zapisz”.

Okno zmiany hasła dla użytkownika MongoUser

 

Hasło powinno spełniać następujące warunki:

      • Składać się z min. 12 znaków;
      • Zawierać cyfry;
      • Zawierać małe i wielkie litery;
      • Zawierać znaki specjalne.

Kiedy pola zostały poprawnie uzupełnione, a użytkownik nacisnął przycisk   [Zapisz], okno zmiany hasła dla MongoUsera zostaje zamknięte, a hasło użytkownika MongoUser zostaje zmienione. Następnie operator powinien kliknąć  [Dalej].

Okno „Baza danych Comarch DMS Repozytorium” po zmianie hasła dla użytkownika MongoUser

 

Po kliknięciu w przycisk  [Dalej] następuje przejście do okna „Klucze licencji”. Operator powinien uzupełnić:

      • W ramach pola „Serwer klucza licencji Comarch DMS” – klucz licencji dla Comarch DMS
      • W ramach pola „Serwer klucza licencji Comarch ERP XL”/ „Serwer klucza licencji Comarch ERP Optima” – w przypadku współpracy Comarch DMS z systemem ERP, odpowiednio: z Comarch ERP XL lub Comarch ERP Optima
      • W ramach pola „Adres e-mail administratora” – adres email, który będzie widoczny w Comarch DMS w komunikatach, w których wymagany jest kontakt z administratorem

Okno „Klucze licencji” przed wprowadzeniem zmian (w przypadku instalacji Comarch DMS Standalone)

 

Po uzupełnieniu pól operator powinien kliknąć [Instaluj]. Następuje wówczas przejście do kolejnego okna „Instalacja”.

Okno „Instalacja”

 

Po zakończeniu instalacji następuje przejście do końcowego okna instalacji aplikacji. Gdy 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ą wybrano w instalatorze.

Dalsze kroki dotyczące konfiguracji Comarch DMS Repozytorium należy wykonać w ramach aplikacji desktop Comarch DMS, a następnie w zakładce [Repozytorium] w aplikacji web Comarch DMS.

Okno „Koniec pracy instalatora”

 

Aktualizacja aplikacji Comarch DMS i Comarch DMS Repozytorium

Aby zaktualizować aplikacje Comarch DMS i Comarch DMS Repozytorium, należy przejść do katalogu <wybrana lokalizacja/Comarch DMS 2024.2.0\Comarch DMS 2024.2.0 instalator Comarch DMS i uruchomić plik Instalator Comarch DMS.exe na komputerze, na którym zainstalowano aplikacje Comarch DMS i Comarch DMS Repozytorium, które mają zostać zaktualizowane.

Po przejściu kolejnych kroków instalacji analogicznie jak w poprzedniej wersji instalatora operator powinien wybrać opcję „Aktualizacja aplikacji Comarch DMS oraz Comarch DMS Repozytorium” w ramach okna „Wybór aplikacji”, a następnie kliknąć [Dalej].

Zaznaczanie opcji „Aktualizacja aplikacji Comarch DMS oraz Comarch DMS Repozytorium” w ramach okna „Wybór aplikacji” w instalatorze Comarch DMS

 

W takim przypadku kolejne kroki instalacji aż do okna Baza danych Comarch DMS (tryb pracy Comarch DMS Standalone)/ Baza danych Comarch ERP XL (tryb pracy Współpraca z Comarch ERP XL)/Firmowa baza danych Comarch ERP Optima (tryb pracy Współpraca z Comarch ERP Optima) pozostają bez zmian w stosunku do poprzedniego instalatora Comarch DMS, z wyjątkiem zmiany warunków do silnego hasła oraz komunikatów w oknie Baza danych Comarch DMS, Baza danych Comarch ERP XL, Konfiguracyjna baza danych Comarch ERP Optima, Firmowa baza danych Comarch ERP Optima (zob.Zmiany warunków do silnego hasła oraz komunikatów dotyczących błędnego hasła w instalatorze Comarch DMS).

Po kliknięciu przycisku [Dalej] w ramach okna Baza danych Comarch DMS (tryb pracy Comarch DMS Standalone)/ Baza danych Comarch ERP XL (tryb pracy Współpraca z Comarch ERP XL)/ Firmowa baza danych Comarch ERP Optima (tryb pracy Współpraca z Comarch ERP Optima) następuje przejście do dodanego w wersji 2024.2.0 okna „Aktualizacja aplikacji Repozytorium”

Uwaga
Przejście do okna „Aktualizacja aplikacji Repozytorium” nastąpi w przypadku, jeśli w folderze z aktualizowaną aplikacją serwerową w pliku Web.config klucz „UseRepository” ma wartość „true”

W ramach okna „Aktualizacja aplikacji Repozytorium” znajdują się następujące pola:

      • Wybierz witrynę web – w ramach tego pola operator powinien wybrać witrynę, na której znajduje się aplikacja Repozytorium do zaktualizowania (domyślnie wyświetlana jest witryna Default Web Site);
      • Port – pole numeru portu, wyszarzone i nieedytowalne;
      • Wybierz aplikację Repozytorium – w ramach tego pola operator powinien wybrać aplikację Repozytorium do zaktualizowania.

Następnie należy kliknąć [Dalej], aby przejść do kolejnego okna.

Okno „Aktualizacja aplikacji Repozytorium” przed wypełnieniem pól

 

Okno „Aktualizacja aplikacji Repozytorium” po wypełnieniu pól

 

Następnie w ramach okna „Baza danych Comarch DMS Repozytorium” operator powinien uzupełnić:

      • W ramach pola „Nazwa serwera” – nazwę serwera, na którym znajduje się serwer MongoDB;
      • W sekcji „Logowanie do serwera MongoDB”:
        • W ramach pola „Login” – login administratora MongoDB
        • W ramach pola „Hasło” – hasło administratora MongoDB

Następnie należy sprawdzić poprawność wprowadzonych danych, klikając w przycisk [Połącz].

Jeśli próba nawiązania połączenia zakończyła się powodzeniem, w dolnej części okna wyświetlony zostaje napis „Nawiązano połączenie z serwerem MongoDB”.

Okno „Baza danych Comarch DMS Repozytorium” przed uzupełnieniem pól

 

Okno „Baza danych Comarch DMS Repozytorium” po uzupełnieniu pól i kliknięciu w przycisk „Połącz”

 

Jeśli nawiązano połączenie z serwerem MongoDB, wówczas w ramach pola „Lista baz danych” wybrana jest baza Comarch DMS Repozytorium odpowiednia dla danej aplikacji.

Nastepnie, opcjonalnie, operator może zmienić hasło dla użytkownika MongoUser, klikając przycisk [Zmień hasło].

W otwartym oknie w polu „Hasło” należy ustawić hasło dla użytkownika MongoUser, dodanego do serwera MongoDB podczas pierwszej instalacji danej aplikacji Comarch DMs Repozytorium. Hasło należy następnie wpisać ponownie w polu „Powtórz hasło”, a później kliknąć przycisk „Zapisz”.

Okno zmiany hasła dla użytkownika MongoUser

 

Hasło powinno spełniać następujące warunki:

      • Składać się z min. 12 znaków;
      • Zawierać cyfry;
      • Zawierać małe i wielkie litery;
      • Zawierać znaki specjalne.

Kiedy pola zostały poprawnie uzupełnione, a użytkownik nacisnął przycisk   [Zapisz], okno zmiany hasła dla MongoUsera zostaje zamknięte, a hasło użytkownika MongoUser zostaje zmienione. Następnie operator powinien kliknąć  [Dalej].

Okno „Baza danych Comarch DMS Repozytorium” po zmianie hasła dla użytkownika MongoUser

 

Po kliknięciu w przycisk  [Dalej] następuje przejście do okna „Klucze licencji”. W ramach okna dostępne są następujące pola:

      • Serwer klucza licencji Comarch DMS” – klucz licencji dla Comarch DMS – automatycznie uzupełniony, ale dostępny do edycji
      • Serwer klucza licencji Comarch ERP XL”/ „Serwer klucza licencji Comarch ERP Optima” – w przypadku współpracy Comarch DMS z systemem ERP, odpowiednio: z Comarch ERP XL lub Comarch ERP Optima – automatycznie uzupełniony, ale dostępny do edycji
      • Adres e-mail administratora – adres email, który będzie widoczny w Comarch DMS w komunikatach, w których wymagany jest kontakt z administratorem – automatycznie uzupełniony, ale dostępny do edycji

Okno „Klucze licencji” (w przypadku instalacji Comarch DMS Standalone)

 

Po uzupełnieniu pól operator powinien kliknąć [Instaluj]. Następuje wówczas przejście do kolejnego okna „Aktualizowanie”.

Okno „Aktualizowanie”

 

Po zakończeniu instalacji następuje przejście do końcowego okna instalacji aplikacji. Gdy użytkownik kliknie przycisk   [Zakończ], instalator zostanie zamknięty, natomiast zostanie otwarta przeglądarka na ekranie logowania do nowej aplikacji WEB Comarch DMS, zgodnie z nazwą aplikacji, którą podano w instalatorze.

Okno „Koniec pracy instalatora”

 

Zmiany warunków do silnego hasła oraz komunikatów dotyczących błędnego hasła w instalatorze Comarch DMS

W wersji 2024.2.0 w instalatorze Comarch DMS uległy zmianie warunki do silnego hasła oraz komunikaty dotyczące błędnego hasła w ramach następujących okien:

      • Baza danych Comarch DMS
      • Baza danych Comarch ERP XL
      • Konfiguracyjna baza danych Comarch ERP Optima
      • Firmowa baza danych Comarch ERP Optima

Podobnie jak w przypadku wcześniejszych instalatorów, po kliknięciu przycisku [Zmień hasło] w otwartym oknie w polu „Hasło” należy ustawić hasło dla użytkownika ODUser, dodanego do serwera SQL podczas pierwszej instalacji Comarch DMS. Hasło należy następnie wpisać ponownie w polu „Powtórz hasło”, a później kliknąć przycisk „Zapisz”.

Od wersji 2024.2.0 hasło powinno spełniać następujące warunki:

      • Składać się z min. 12 znaków;
      • Zawierać cyfry;
      • Zawierać małe i wielkie litery;
      • Zawierać znaki specjalne.

Uwaga
Hasło nie może również zawierać następujących znaków: ; ’ „

Jeżeli wpisano hasło, które nie spełnia któregoś z tych trzech wymagań lub nie jest jednakowe w polach „Hasło” i „Powtórz hasło”, wówczas po kliknięciu przycisku   [Zapisz] hasło nie zostaje zapisane, a zamiast dotychczasowych komunikatów odpowiednie informacje są wyświetlane w dolnej części okna:

      • Jeśli hasło jest za krótkie

      • Jeśli brakuje warunku/warunków wymaganych dla silnego hasła (brak znaku specjalnego, brak wielkiej litery)

      • Jeżeli hasło wpisane w polu „Powtórz hasło” różni się od hasła wpisanego w polu „Hasło”




Instalacja aplikacji Comarch DMS w wersji web za pomocą instalatora

„Instalacja aplikacji Comarch DMS w wersji web za pomocą instalatora”

 

Film instruktażowy w wersji z lektorem, w którym przedstawiono, jak:

 

    •  za pomocą instalatora zainstalować samą aplikację w wersji webowej
    •  ale także niezbędnej do jej instalacji komponenty
    •  wybrać opcję aktualizacji aplikacji webowej
    •  skonfigurować prawidłowo wymagane przez instalator elementy aplikacji
    •  zalogować sie po raz pierwszy do aplikacji w wersji webowej aplikacji Comarch DMS

 

Zapraszamy do zapoznania się ze wszystkimi filmami Comarch DMS

 




Instalacja aplikacji Comarch DMS w wersji stacjonarnej za pomocą instalatora

„Instalacja aplikacji Comarch DMS w wersji stacjonarnej za pomocą instalatora”

 

Film instruktażowy w wersji z lektorem, w którym przedstawiono, jak:

 

    •  za pomocą instalatora zainstalować  aplikację w wersji desktop
    •  przygotować pliki i foldery dedykowane do instalacji
    •  zalogować sie po raz pierwszy do aplikacji w wersji desktop aplikacji Comarch DMS
    •  znaleźc istotne informacje do dalszej pracy z aplikacją zaraz po zalogowaniu do wersji desktop

 

Zapraszamy do zapoznania się ze wszystkimi filmami Comarch DMS