• pierwszą instalację
• ponowną instalację

Systemowe paski przewijania –  odpowiada kluczowi <add key=”SystemScrollbars” value=”false” /> w pliku DMS.exe.config – decyduje o tym, czy w aplikacji desktop wyświetlane są paski przewijania o domyślnym systemowym wyglądzie (zaznaczony checkbox) czy ostylowane przez Comarch DMS (odznaczony checkbox”);

Liczba dokumentów prezentowanych na jednej stronie – odpowiada kluczowi <add key=”DocumentListRowsCount” value=”50″ /> w pliku DMS.exe.config –  określa ilość dokumentów widoczną na jednej stronie wyników wyszukiwania w aplikacji desktop (domyślnie 50);

Podgląd załączników PDF w zewnętrznym programie – odpowiada kluczowi  <add key=”IntegratedPdfViewer” value=”true” /> w pliku DMS.exe.config  – jeżeli zaznaczono checkbox, wówczas możliwy jest podgląd załączników w formacie *.pdf bezpośrednio w aplikacji Comarch DMS, w prawym panelu karty obiegu

W podglądzie PDF wyświetlaj pełną stronę załącznika – odpowiada kluczowi <add key=”ExtendedPdfViewerZoomToPageLevel” value=”false”/> w pliku DMS.exe.config – pozwala na dopasowanie rozmiaru załącznika do rozmiaru okna podglądu jedynie w przypadku podglądu za pomocą DevExpress);

Włącz kanały wirtualne dla plików – odpowiada kluczowi <add key=”VirtualChannelToLocalMachineFiles” value=”false” /> w pliku DMS.exe.config – jest odpowiedzialne za możliwość załączania plików z lokalnego komputera do aplikacji Comarch DMS, która jest uruchomiona na wirtualnej maszynie.

• Kiedy checkbox jest zaznaczony, dodawanie załączników z katalogów umieszczonych na maszynie wirtualnej nie jest możliwe, wywoływane są wyłącznie okna z komputera lokalnego, na którym uruchomiono połączenie terminalowe.
• >Można załączać pliki zarówno z lokalnego komputera jak i maszyny wirtualnej, jeśli w opcjach podłączania pulpitu zdalnego udostępniono dyski komputera lokalnego. W takiej konfiguracji należy odznaczyć checkbox.

Włącz kanały wirtualne dla skanerów – odpowiada kluczowi <add key=”VirtualChannelToLocalMachineScanner” value=”false” /> w pliku DMS.exe.config  –odpowiedzialne za możliwość załączenia w aplikacji Comarch DMS uruchomionej na wirtualnej maszynie skanu dokumentu bezpośrednio ze skanera podłączonego do lokalnego komputera użytkownika.

Wyświetlaj okna Comarch ERP Optima w trybie – odpowiada kluczowi <add key=”OptimaWindowsMode” value=”0″ /> – odpowiada za to, czy okna Comarch ERP Optima będą uruchamiane w trybie SDI czy MDI.Domyślnie została ustawiona wartość SDI.

Następnie można przejść do zakładki „Ustawienia zaawansowane cz. 2”. W ramach tej zakładki operator może dokonać zmiany kolejnych  domyślnych ustawień, dostępnych w pliku DMS.exe.config w katalogu z plikami aplikacji stacjonarnej.

W ramach zakładki dostępne są następujące ustawienia:

Wyświetlaj przebieg procesu na standardowym wydruku karty obiegu – odpowiada kluczowi <add key=”ShowTheProcessFlowOnThePrintout” value=”true” /> w pliku DMS.exe.config – określa, czy przebieg (etapy) ma być pokazywany na standardowych wydrukach;

Komponent do rozpoznawania kodów kreskowych – odpowiada kluczowi <add key=”ScanMode” value=”Aspose” /> w pliku DMS.exe.config – w ramach tego klucza możliwa jest zmiana komponentu do rozpoznawania kodów kreskowych; Można wybrać wartość

• Aspose – komponent, który od wersji 2020.0.0 jest domyślnym komponentem służącym do rozpoznawania kodów kreskowych.
• Internal – poprzedni komponent.

Limit czasu dla przetwarzania dokumentu w usłudze Comarch OCR – odpowiada kluczowi <add key=”OCRComarchTimeout” value=”15″ /> w plku DMS.exe.config – wartość to wyrażony w minutach czas, po którym przetwarzanie pliku zostanie przerwane i wyświetlony zostanie błąd (!), a program przejdzie do przetwarzania następnego dokumentu w kolejce.

Liczba maili pobieranych jednorazowo ze skrzynki – odpowiada kluczowi <add key=”MailsMaximumNumber” value=”15″ /> w pliku DMS.exe.config – umożliwia zmianę liczbę maili pobieranych jednorazowo ze skrzynki pocztowej. Domyślnie wartość klucza ustawiona jest na 15 –  oznacza to, że jednorazowe odświeżenie listy maili przy pomocy przycisku pobierze i wyświetli na liście kolejne 15 wiadomości. W przypadku, kiedy w kluczu zostanie ustawiona wartość 0, wówczas będą pobierane wszystkie wiadomości e-mail.

Komponent obsługujący pocztę przychodzącą – odpowiada kluczowi <add key=”UseAlternativeMailClient” value=”true” /> w pliku DMs.exe.config –  określa, czy do odbierania maili w punktach ACD użytkownicy korzystają z MailKit czy (wcześniejszego) MailSystem.NET (ActiveUp));

Utrzymanie sesji XL API – odpowiada kluczowi add key=”XLAPIHoldSession” value=”False” /> w pliku DMS.exe.config – służy do utrzymywania sesji podczas pracy z XLApi.Jeśli:

• zaznaczono checkbox– podczas pracy z formatkami XL przez XLApi, sesja tworzy się w czasie pierwszego podniesienia formatki i nie jest zamykana po zamknięciu formatki – jest używana do czasu zamknięcia aplikacji.
• nie zaznaczono checkboxa– sesja jest zamykana po zamknięciu formatki

• <add key=”ServerUri” value=”http://localhost/dms202301″ /> – klucz, w którym należy wprowadzić adres URL, za pomocą którego uruchamiana jest aplikacja serwerowa (dawna web);
• <add key=”ExtendedPdfViewerZoomToPageLevel” value=”false”/> – klucz, który pozwala na dopasowanie rozmiaru załącznika do rozmiaru okna podglądu jedynie w przypadku podglądu za pomocą DevExpress);
• <add key=”IntegratedPdfViewer” value=”true” /> – jeżeli w ramach klucza zostanie wprowadzona wartość „true”, wówczas możliwy jest podgląd załączników w formacie *.pdf bezpośrednio w aplikacji Comarch DMS, w prawym panelu karty obiegu;
• <add key=”SystemScrollbars” value=”false” /> – klucz decyduje o tym, czy w  aplikacji desktop wyświetlane są paski przewijania o domyślnym systemowym wyglądzie („true”) czy ostylowane przez Comarch DMS („false”);
• <add key=”DocumentListRowsCount” value=”50″ /> – klucz określa ilość dokumentów widoczną na jednej stronie wyników wyszukiwania w aplikacji desktop;
• <add key=”ShowTheProcessFlowOnThePrintout” value=”true” /> – klucz określa, czy  przebieg (etapy) ma być pokazywany na standardowych wydrukach;
• <add key=”OptimaWindowsMode” value=”0″ /> – klucz odpowiada za to, czy okna Comarch ERP Optima będą uruchamiane w trybie SDI czy MDI. Parametr może przyjmować wartości 0 (tryb SDI) i 1 (tryb MDI). Domyślnie została ustawiona wartość 0
• <add key=”ScanMode” value=”Aspose” /> – w ramach tego klucza możliwa jest zmiana komponentu do rozpoznawania kodów kreskowych; klucz  może przyjąć wartości:
  • Aspose – komponent, który od wersji 2020.0.0 jest domyślnym komponentem służącym do rozpoznawania kodów kreskowych.
  • Internal – poprzedni komponent.

• <!– <add key=”ScanRectangle” value=”0,0,450,90″/> –> w ramach tego klucza można określić obszar (prostokąt) na skanie, w którym szukany jest kod kreskowy. Poszczególne parametry to:
  • (0) – współrzędna x lewego górnego wierzchołka prostokąta
  • (0) – współrzędna y lewego górnego wierzchołka prostokąta
  • (450) – szerokość prostokąta
  • (90) – wysokość prostokąta
• <!– <add key=”AsposeScanFormats” value=”EAN13″/> – klucz, w którym możliwe jest określenie typu rozpoznawanych kodów kreskowych dla komponentu Aspose. Domyślnie klucz jest zakomentowany – oznacza to, że komponent sam rozpozna typ skanowanego kodu kreskowego.
• <!– <add key=”ScanFormats” value=”CODE_39″/> – klucz określa aktywne formaty kodów kreskowych dla poprzedniego komponentu Internal,
• <add key=”UseAlternativeMailClient” value=”true” /> – klucz określa, czy do odbierania maili w punktach ACD  użytkownicy korzystają z MailKit („true”) czy (wcześniejszego) MailSystem.NET (ActiveUp) („false”);
• <add key=”MailsMaximumNumber” value=”15″ /> – klucz, który umożliwia zmianę liczbę maili pobieranych jednorazowo ze skrzynki pocztowej. Domyślnie wartość klucza ustawiona jest na 15 –  oznacza to, że jednorazowe odświeżenie listy maili przy pomocy przycisku pobierze i wyświetli na liście kolejne 15 wiadomości. W przypadku, kiedy w kluczu zostanie ustawiona wartość 0, wówczas będą pobierane wszystkie wiadomości e-mail.
• <add key=”VirtualChannelToLocalMachineFiles” value=”false” /> – klucz jest odpowiedzialny za możliwość załączania plików z lokalnego komputera do aplikacji Comarch DMS, która jest uruchomiona na wirtualnej maszynie.
  • Kiedy kanał wirtualny VirtualChannelToLocalMachineFiles jest włączony („True”), dodawanie załączników z katalogów umieszczonych na maszynie wirtualnej nie jest możliwe, wywoływane są wyłącznie okna z komputera lokalnego, na którym uruchomiono połączenie terminalowe.
  • Można załączać pliki zarówno z lokalnego komputera jak i maszyny wirtualnej, jeśli w opcjach podłączania pulpitu zdalnego udostępniono dyski komputera lokalnego. W takiej konfiguracji należy wartość klucza VirtualChannelToLocalMachineFiles ustawić na „False”.
• <add key=”VirtualChannelToLocalMachineScanner” value=”false” /> – klucz jest odpowiedzialny za możliwość załączenia w aplikacji Comarch DMS uruchomionej na wirtualnej maszynie skanu dokumentu bezpośrednio ze skanera podłączonego do lokalnego komputera użytkownika.
• <add key=”OCRComarchUri” value=”https://cr.erp.comarch.pl/api/v1/” /> – adres serwera usługi Comarch OCR, na który wysyłane są pliki do rozpoznania w Comarch OCR
• <add key=”OCRComarchTimeout” value=”15″ /> – wartość to wyrażony w minutach czas, po którym przetwarzanie pliku zostanie przerwane i wyświetlony zostanie błąd (!), a program przejdzie do przetwarzania następnego dokumentu w kolejce.
• <add key=”OCRFilesExtensionFilter” value=”” /> – klucz dodany w wersji 2024; w ramach klucza możliwe jest wprowadzenie takich rozszerzeń dokumentów, które mają być przetwarzane przez OCR. Poszczególne rodzaje rozszerzeń należy rozdzielić średnikami. Domyślnie filtr nie ma podanej wartości – w takim przypadku filtr jest nieaktywny;
• add key=”XLAPIHoldSession” value=”False” /> – klucz służy do utrzymywania sesji podczas pracy z XLApi. Klucz przyjmuje wartości:
  • „true” – podczas pracy z formatkami XL przez XLApi, sesja tworzy się w czasie pierwszego podniesienia formatki i nie jest zamykana po zamknięciu formatki – jest używana do czasu zamknięcia aplikacji.
  • „false” – sesja jest zamykana po zamknięciu formatki
• <add key=”RPAFolderPath” value=”C:\dms202310″ /> – klucz dostępny od wersji 2023.1.0; należy wpisać poprawną wartość, aby skrypt wprowadzony w ramach zakładki „Konfiguracja automatycznego trybu pracy” został poprawnie skompilowany. Jako wartość klucza należy wpisać ścieżkę do folderu z aplikacją desktop Comarch DMS, np. C:\dms202310. (zob. Zakładka „Edytor skryptów”);
• <add key=”ACDExePath” value=”” /> – klucz dostępny od wersji 2023.1.0; w ramach tego klucza należy wprowadzić ścieżkę do pliku .exe, który ma zostać uruchomiony w punkcie ACD, np. <add key=”ACDExePath” value=”C:\Windows\System32\calc.exe” /> (zob. Uruchamianie pliku exe w punkcie ACD);
• <add key=”ACDGenMaxDOP” value=”1″ /> – klucz dostępny od wersji 2024.0.0; w ramach tego klucza użytkownik może zwiększyć szybkość generowania dokumentów w punktach ACD; domyślna wartość tego parametru wynosi 1 – aby zwiększyć tempo generowania dokumentów należy wpisać cyfry większe niż 1; zaleca się, aby nie przekraczać wartości 4.
• <add key=”Version” value=”5048505146494648″ /> – zakodowany numer wersji Comarch DMS – nie należy edytować.

• Dla bazy konfiguracyjnej Comarch ERP Altum:

katalog z plikami instalacyjnymi \ Comarch DMS {wersja} \ DMS Workflow Api  \ SqlAltum \ InstallAltumConf.bat

• Dla każdej z baz firmowych Comarch ERP Altum (osobno):

• Zreindeksowanie tabel schematu DO,
• Odbudowę statystyk,
• Rekompilacje procedur i funkcji schematu DO.

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

• W kluczu „strConnectDMS” należy wprowadzić connection string do bazy danych Comarch DMS.
• W kluczu „strConnectERPComp” należy wprowadzić connection string do firmowej bazy danych Comarch ERP Altum.
• W kluczu „strConnectERPConf1” należy wprowadzić connection string do konfiguracyjnej bazy Comarch ERP Altum.
• <add key=”WorkMode” value=”ALTUM” /> określenie współpracy Comarch DMS z Comarch ERP Altum – należy wpisać wartość „ALTUM”.
• <add key=”MultiCompany” value=”false” /> ustawienie trybu pracy – jednofirmowy („false”), w przypadku zmiany trybu na wielofirmowy należy zmienić wartość na „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” /> włącza możliwość wyboru języka pracy aplikacji Comarch DMS na oknie logowania. Wartość „false” wyłącza funkcjonalność.
• <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 serwerowej (dawna web) i aktywuje funkcje wpisywane do tabeli do.DF_ConfOSEmployeesQueue – tabeli z danymi rejestracji użytkowników. Okno rejestracji można wyświetlić do dodaniu do adresu aplikacji członu „/ExternalRegistration”, np. http://localhost/DMS/ExternalRegistration. Wartość klucza = „false” oznacza, że rejestracja użytkowników w aplikacji serwerowej (dawna 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.

Uwaga

Do właściwego działania rejestracji użytkownika z poziomu aplikacji serwerowej (dawna 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ą w kluczu ilość dni temu. 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.

• <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=”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=”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 dostępny, jeżeli ustawiono <add key=”WorkMode” value=”XL” />. Umożliwia pracę na wspólnym haśle podczas generowania dokumentów.

• <add key=”CompanyName” value=”nazwa firmy” /> można zdefiniować nazwę firmy, która zostanie wyświetlona w aplikacjach przed loginem zalogowanego operatora.
• <add key=”LicenceKeyServerERP” value=”nazwa serwera klucza ERP” /> należy wpisać nazwę serwera licencji dla 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=”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=”KSeFWorkMode” value=”Demo” /> – klucz wprowadzony w wersji 2024.0.1; umożliwia 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=”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=”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=”201761″ /> parametr aktywny jeżeli ustawiono tryb pracy ‘XL’ lub ‘Optima’. Nr wersji systemu ERP z którym współpracuje Comarch DMS.

• System ERP – wskazanie typu systemu, z którym konfigurowana jest współpraca, w tym przypadku Altum.
• Baza konfiguracyjna – należy wskazać serwer, bazę danych oraz hasło dla użytkownika ODUser.

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

• 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]

 

 

 

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)

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

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

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

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

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

• • • <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=”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ć.

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

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