W wersji 2024.3.0 w aplikacji desktop dodano zakładkę [Rezerwacje]. Zakładka jest dostępna dla wszystkich operatorów, choć dostępne na niej opcje zależą od uprawnień operatora – tylko operator o uprawnieniach administratora ma dostęp do zarządzania zasobami, tzn:

Każdy operator może natomiast dodawać rezerwacje i usuwać je.

W ramach zakładki „Rezerwacje” dostępne są następujące elementy:

[Dodaj rezerwację] – przycisk, po kliknięciu w który zostaje otwarte okno dodawania rezerwacji (zob. Dodawanie rezerwacji )

[Usuń rezerwację] – przycisk, po kliknięciu w który rezerwacja zostanie usunięta (zob. Usuwanie rezerwacji)

[Zasoby] – przycisk widoczny i dostępny jedynie dla operatorów o uprawnieniach administratora; po kliknięciu w przycisk zostaje otwarte okno, w ramach którego można zdefiniować grupy zasobów i zasoby (zob. Definiowanie grup zasobów i zasobów)

Kalendarz – dostępny dla każdego operatora, pokazuje bieżący miesiąc kalendarzowy; są na nim widoczne wszystkie rezerwacje dokonane przez danego zalogowanego operatora w dany miesiącu. Istnieje również możliwość przechodzenia pomiędzy miesiącami za pomocą strzałek lub wyboru dnia po kliknięciu w nazwę miesiąca – ikony znajdują się nad kalendarzem.

Backupy baz danych Mongo DB mogą być tworzone i odtwarzane za pomocą narzędzi mongodump oraz mongorestore, które należą do MongoDB Database Tools.

Backup bazy danych MongoDB w systemie Windows

1. Aby pobrać narzędzia, należy wejść na stronę producenta: https://www.mongodb.com/try/download/database-tools, wybrać właściwą platformę w polu „Platform” i format „msi” w polu „Package”, a następnie nacisnąć przycisk „Download”.

2. Następnie należy otworzyć pobrany plik. Zostanie wówczas otwarte okno początkowe instalatora MongoDB Database Tools, gdzie należy kliknąć na „Next”.

3. W następnym kroku należy wyrazić zgodę na umowę licencyjną, zaznaczając checkbox, a następnie wybrać „Next”.

4. Następnie otwarte zostaje okno, w którym można wybrać lokalizację, gdzie zostaną zainstalowane narzędzia MongoDB.

Domyślna lokalizacja to C:\Program Files\MongoDB\Tools\100\bin.

Po wyborze lokalizacji użytkownik powinien kliknąć „Next”.

5. W kolejnym oknie należy wybrać przycisk „Install”. Wówczas następuje instalacja MongoDB Database Tools.

6. Następnie należy uruchomić wiersz polecenia, wpisując cmd w wyszukiwarce w menu „Start” i wybierając opcję „Uruchom jako administrator”.

7. Następnie należy wpisać cd, nacisnąć spację i podać ścieżkę do lokalizacji narzędzi MongoDB – w poniższym przykładzie znajdują się one w lokalizacji C:\Program Files\MongoDB\Tools\100\bin.

8. Następnie należy nacisnąć Enter i wprowadzić następującą frazę:

mongodump --uri="mongodb://MongoUser@localhost/Repository?authSource=Repository"

gdzie:

MongoUser – to nazwa użytkownika, dla którego będzie następuje łączenie się aplikacji Comarch DMS Repozytorium z bazą danych (zob. Repozytorium – instalacja dla administratora)

localhost – nazwa hosta i port

Repository – nazwa bazy Repozytorium

9. Następnie należy nacisnąć Enter.

10. W kolejnym kroku konieczne jest wprowadzenie hasła do Repozytorium dla użytkownika MongoUser – w poniższym przykladzie jest to hasło Passwd1234, analogicznie do przykładu przedstawionego w instrukcji instalacji Repozytorium.

11. Po naciśnięciu przycisku Enter następuje tworzenie kopii zapasowej bazy Repozytorium.

12. Backup bazy Repozytorium jest zapisywany w folderze „dump” w lokalizacji, w której znajdują się narzędzia MongoDB – w poniższym przykładzie jest to lokalizacja C:\Program Files\MongoDB\Tools\100\bin\dump.

Backup bazy danych MongoDB w systemie Linux, dystrybucja Ubuntu

Instalacja MongoDB Database Tools na Ubuntu powinna zostać przeprowadzona według instrukcji producenta, dostępnej pod następującym adresem: Installing the Database Tools on Linux — MongoDB Database Tools.

Backup bazy danych MongoDB na Ubuntu należy przeprowadzić zgodnie z instrukcją producenta dostępną pod adresem mongodump — MongoDB Database Tools.

Uwaga

Należy pamiętać, aby na zakładce „Schemat obiegu” na  etapie, na którym ma się odbyć inicjalizacja, na zakładce „Kontrolki” zaznaczyć parametr „Inicjalizacja SQL/C#”  przy danej kontrolce i  aby zapisać wszystkie wprowadzone zmiany  za pomocą przycisku [Zapisz] .

 Globals.MainFrame.Multiline1.AddRow();

 Globals.MainFrame.Multiline1.AddRows(10);

 Globals.MainFrame.Multiline1.Clear();

 Globals.MainFrame.Int1.Value = Globals.MainFrame.Multiline1.Column;

 Globals.MainFrame.Int2.Value = Globals.MainFrame.Multiline1.Row;

 Globals.MainFrame.Multiline1.RemoveRow(3);

Globals.MainFrame.Int1.Value = Globals.MainFrame.Multiline1.RowCount;

Dostęp do wartości komórek kontrolki „Dane tabelaryczne”

Dostęp do wartości komórki w kontrolce „Dane tabelaryczne” realizowany jest w oparciu o poniższą definicję:

Globals.MainFrame.<identyfikator kontrolki typu Dane tabelaryczne>.Items[index].<Identyfikator danej kolumny>.<właściwość>

Gdzie „index” to numer wiersza liczony od 0 (0 – pierwszy wiersz, 1 – drugi wiersz, …).

 Globals.MainFrame.Multiline1.Items[0].DateTime1.Value = DateTime.Now;

 Globals.MainFrame.Multiline1.Items[0].ERPDocument1.Id = 5024;

 Globals.MainFrame.Multiline1.Items[0].ERPDocument1.IdType = 1521;

 Globals.MainFrame.Multiline1.Items[0].ERPDocument1.IdText = "E97B3CE0-F719-44CD-A473-54A59ABF20D5";

 Globals.MainFrame.Multiline1.Items[0].ERPDocument1.IdTextType = "3EEC4A14-8263-4196-B721-CE7A61C12F45";

 Globals.MainFrame.Multiline1.Items[0].ERPDocument1.Number;

 Globals.MainFrame.Multiline1.Items[0].WorkflowDocuments1.Id = 2;

 Globals.MainFrame.Multiline1.Items[0].WorkflowDocuments1.Number;

 Globals.MainFrame.Multiline1.Items[0].ERPContractor1.Id = 1;

 Globals.MainFrame.Multiline1.Items[0].ERPContractor1.IdText;

 Globals.MainFrame.Multiline1.Items[0].ERPContractor1.Shortcut;

 Globals.MainFrame.Multiline1.Items[0].Int2.Value = 16;

 Globals.MainFrame.Multiline1.Items[0].Real1.Value = (float)124.57;

Globals.MainFrame.Multiline1.Items[0].Decimal1.Value = (decimal)25.36;

 Globals.MainFrame.Multiline1.Items[0].List1.Value = 3;

Globals.MainFrame.Multiline1.Items[0].List1.ValueText = "prz";

 Globals.MainFrame.Multiline1.Items[0].List1.Text;

Globals.MainFrame.Multiline1.Items[0].String3.Text = "Faktura zakupu";

 Globals.MainFrame.Multiline1.Items[0].ERPArticle1.Id = 1;

Globals.MainFrame.Multiline1.Items[0].ERPArticle1.IdText;

 Globals.MainFrame.Multiline1.Items[0].ERPArticle1.Shortcut;

 Globals.MainFrame.Multiline1.Items[0].Bool1.Value = true;

Globals.MainFrame.Multiline1.AddRows(3);
Globals.MainFrame.Multiline1.Items[0].DateTime1.Value = DateTime.Now;
Globals.MainFrame.Multiline1.Items[0].ERPContractor1.Id = 1;
Globals.MainFrame.Multiline1.Items[0].String1.Text = "FZ-2/2024";
Globals.MainFrame.Multiline1.Items[0].ERPDocument1.Id = 5024;
Globals.MainFrame.Multiline1.Items[0].Int1.Value = Globals.MainFrame.Multiline1.Items[0].ERPDocument1.IdType = 1521;
Globals.MainFrame.Multiline1.Items[0].WorkflowDocuments1.Id = 2;
Globals.MainFrame.Multiline1.Items[0].String2.Text = Globals.MainFrame.Multiline1.Items[0].WorkflowDocuments1.Number;
Globals.MainFrame.Multiline1.Items[0].Int2.Value = 16;
Globals.MainFrame.Multiline1.Items[0].Real1.Value = (float)124.57;
Globals.MainFrame.Multiline1.Items[0].Decimal1.Value = (decimal)25.36;
Globals.MainFrame.Multiline1.Items[0].List1.ValueText = "prz";
Globals.MainFrame.Multiline1.Items[0].String3.Text = "Faktura zakupu";
Globals.MainFrame.Multiline1.Items[0].ERPArticle1.Id = 1;
Globals.MainFrame.Multiline1.Items[0].Bool1.Value = true;

Możliwe rozwiązania:

Komunikat w logu związany jest z deklaracją VAT/JPK.

Jeśli dokument jest dodawany do okresu (liczy się data wystawienia/zakupu), za który została już wysłana deklaracja vat/jpk – wówczas pojawia się komunikat jak powyżej – „Document concerns VAT-7 tax return that has already been approved. Administrator blocked the possibility of making changes to such documents.”.

Kiedy ustawi się datę na okres, z którego nie była wysyłana deklaracja vat/jpk, wówczas dokument się generuje.

W ramach zakładki API definiowana jest lista systemów, które współpracują z Comarch DMS przez API.

Jedynie nazwy współpracujących systemów są definiowane na tej zakładce i zapisywane w odrębnej tabeli razem z wygenerowanymi w DMS unikalnymi identyfikatorami zdefiniowanych systemów.

W wersji 2022.0.3 wprowadzone zostały zmiany w ramach sekcji „API” – na liście systemów współpracujących z Comarch DMS przez API znajduje się predefiniowana wartość „Comarch HRM”.

Podczas aktualizacji do wersji 2022.0.3 do tabeli do.DF_Applications zostaje dodany wpis „Comarch HRM” w kolumnie APP_Name. Taka predefiniowana wartość może zostać usunięta z poziomu aplikacji DMS desktop.

Jeżeli nastąpiła aktualizacja bazy z wersji 2022.0.1 albo 2022.0.2  i na liście systemów współpracujących z Comarch DMS przez API były już dodane pozycje, wówczas predefiniowana wartość „ Comarch HRM” zostaje dodana jako kolejna na liście.
Jeżeli pozycja „Comarch HRM” została już dodana, wtedy nie zostaje dodana ponownie po aktualizacji do wersji 2022.0.3.

Aby dodać nazwę tworzonej aplikacji należy:

1. Wybrać przycisk [Dodaj]

2. W nowootwartym oknie wpisać nazwę tworzonej aplikacji i zatwierdzić przyciskiem [Dodaj].

Przycisk jest nieaktywny do czasu wpisania co najmniej dwóch znaków.

Po wyborze przycisku [Dodaj] nazwa, którą wpisano, zostaje wyświetlona na liście systemów. Zarówno predefiniowana, jak i wprowadzone nazwy systemów będą również widoczne na liście dostępnej w polu „System współpracujący” w zakładce „API” na karcie pracownika (zob. Zakładka API na karcie pracownika – integracja Comarch DMS z Comarch HRM).

Jeżeli natomiast użytkownik wybierze przycisk [Anuluj], wówczas nazwa systemu nie zostaje dodana do listy, a okno dodawania nazwy zostanie zamknięte.

Instalacja Comarch DMS

W pierwszym kroku należy zainstalować Comarch BPM (dawniej DMS) zgodnie z opisem instalacji dostępnym w artykułach Instalacja aplikacji serwerowej (dawnej web) w trybie ręcznym, Ręczna konfiguracja aplikacji WEB (nowej aplikacji web) oraz Instalacja aplikacji stacjonarnej w trybie ręcznym. Jeżeli użytkownik ma już zainstalowany Comarch DMS, wówczas nie ma potrzeby wykonywania nowej instalacji.

Import certyfikatu

Po zainstalowaniu Comarch BPM (dawniej DMS) należy zainstalować certyfikat administracyjny w kontekście całej maszyny.

Użytkownik CEE ma zainstalowany certyfikat w kontekście lokalnego użytkownika – za pomocą tego certyfikatu łączy się z CEE.

Certyfikat ten jest widoczny w wyskakującym okienku przy próbie przejścia na stronę CEE w przeglądarce.

Po poprawnym wpisaniu adresu URL i wyborze właściwego certyfikatu powinna zostać wyświetlona strona z listą dostępnych baz danych.

Instalowanie certyfikatu administracyjnego w kontekście całej maszyny

Należy w ramach wyszukiwania obok menu „Start” wpisać certlm.msc i uruchomić jako administrator.

W otwartym oknie należy kliknąć na strzałkę przy napisie „Osobisty”, a następnie na „Certyfikaty” – obok zostanie wyświetlona lista certyfikatów osobistych, w tym certyfikat do CEE.

Następnie należy kliknąć prawym przyciskiem myszki na wolnym polu pod listą certyfikatów, a na wyświetlonej liście wybrać „Wszystkie zadania”, a później „Importuj”.

Wtedy zostanie wyświetlone okno kreatora importu certyfikatów, gdzie należy wybrać przycisk „Dalej”.

Następnie należy nacisnąć „Przeglądaj”, wybrać plik z certyfikatem z odpowiedniej lokalizacji (jeżeli w folderze nie są widoczne pliki, należy zmienić typ pliku w dolnej części okna na „Wszystkie pliki”) i kliknąć „Otwórz”.

Następnie należy wybrać „Dalej”.

W kolejnym kroku należy wprowadzić hasło do klucza prywatnego i kliknąć „Dalej”.

W dalszej kolejności należy kliknąć „Dalej”.

Następnie należy wybrać przycisk „Zakończ”. Wyświetlony zostanie wówczas komunikat informujący o pomyślnym zakończeniu importu.

Po kliknięciu „OK” w oknie certlm można zauważyć, że dodane zostały nowe certyfikaty.

Łączenie certyfikatu z użytkownikiem puli aplikacji

Następnie należy połączyć certyfikat z użytkownikiem puli aplikacji. W tym celu konieczne jest pobranie narzędzia winhttpcertcfg.exe za pomocą linku https://www.microsoft.com/en-us/download/details.aspx?id=19801 i otworzenie pobranego pliku. Później w otwartym oknie należy kliknąć „Next”.

W kolejnym oknie należy zaznaczyć zgodę na umowę licencyjną i kliknąć „Next”.

Następnie należy wybrać „Install now”.

W kolejnym kroku odbywa się instalacja narzędzia. Po jej zakończeniu należy kliknąć „Finish” w końcowym oknie instalatora.

Następnie należy otworzyć wyszukiwanie przy menu „Start”, wpisać cmd i uruchomić konsolę jako administrator.

Później konieczne jest skopiowanie i wklejenie do wiersza poleceń poniższego polecenia:

cd C:\Program Files (x86)\Windows Resource Kits\Tools

i naciśnięcie “Enter”

Następnie należy wprowadzić polecenie:

winhttpcertcfg.exe -g -c LOCAL_MACHINE\MY -s "nazwa certyfikatu" -a "nazwa puli aplikacji, pod którą działa DMS"

W poniższym przykładzie polecenie to brzmi:

winhttpcertcfg.exe -g -c LOCAL_MACHINE\MY -s "DMSTEST" -a "DefaultAppPool"

Później należy nacisnąć “Enter”.

Wskazówka

Pulę aplikacji można odczytać w Menedżerze internetowych usług informacyjnych (IIS), po kliknięciu prawym przyciskiem myszki na daną aplikację DMS, a następnie wyborze „Zarządzaj aplikacją” i „Ustawienia zaawansowane”. Wówczas możliwe jest odczytanie nazwy puli aplikacji w wyświetlonym oknie.

 

 

Konfiguracja współpracy z CEE w aplikacji DMS

Po wykonaniu powyższych kroków należy otworzyć BPM (dawniej DMS) i zalogować się.

Następnie należy przejść do zakładki [Ustawienia] i w ramach sekcji „Połączenia z ERP” kliknąć [Dodaj], aby dodać nową spółkę. Następnie należy:

a później kliknąć w ikonkę [Zapisz].

W celu sprawdzenia poprawności konfiguracji współpracy BPM (dawniej DMS) z CEE po kliknięciu zakładki [Struktura organizacyjna] w aplikacji desktopowej BPM (dawniej DMS) należy wybrać spółkę, która współpracuje z CEE, a następnie kliknąć na sekcję „Pracownicy” i nacisnąć przycisk , aby zaimportować użytkownika z CEE. W wyszukiwarce należy wpisać początek nazwy użytkownika z CEE, a następnie wybrać wyświetloną nazwę. Taki użytkownik będzie mógł odtąd pracować w BPM (dawniej DMS) we współpracy z CEE.

Uwaga

Należy pamiętać, aby na zakładce „Schemat obiegu” na  etapie, na którym ma się odbyć inicjalizacja, na zakładce „Kontrolki” zaznaczyć parametr „Inicjalizacja SQL/C#”  przy danej kontrolce i  aby zapisać wszystkie wprowadzone zmiany  za pomocą przycisku [Zapisz] .

Skrypty C# kompilowane przez kontrolkę „Własna akcja” mogą być uruchomione w ramach procesu IIS lub w ramach niezależnego procesu.

Uruchomienie skompilowanego skryptu w ramach niezależnego procesu zalecane jest w przypadku kodów, które nie mogą działać na wielowątkowym procesie jakim jest IIS.

Wskazanie miejsca uruchomienia skryptu określa się za pomocą właściwości „Miejsce wykonania skryptu” znajdującego się na formatce edytora języka C# kontrolki „Własna akcja”.

string obj = Obiekt.Metoda();

 if (obj == "Ok") 

Globals.MainFrame.CustomAction1_CSSCRIPT.Text = "Operacja wykonana"; 

else 

Globals.MainFrame.CustomAction1_CSSCRIPT.Text = "Błąd";

Uwaga

Należy pamiętać, aby na zakładce „Schemat obiegu” na  etapie, na którym ma się odbyć inicjalizacja, na zakładce „Kontrolki” zaznaczyć parametr „Inicjalizacja SQL/C#”  przy danej kontrolce i  aby zapisać wszystkie wprowadzone zmiany  za pomocą przycisku [Zapisz] .

Kontrolka „Towar” posiada identyfikator numeryczny i tekstowy:

Globals.MainFrame. ERPArticle1.Id = 1;

Globals.MainFrame.ERPContractor1.IdText = "C14ECF1A-3076-45BC-9A86-
12A116A40161";

Możliwe rozwiązania:

W pliku konfiguracyjnym OptimaVatRegisterGenerator.exe.config należy zweryfikować czy klucz Server Uri został uzupełniony poprawnie – o adres do wersji serwerowej (dawna web) Comarch BPM (dawniej DMS).

Możliwe rozwiązania:

Jeżeli logi się nie tworzą, prawdopodobnie występuje problem z plikami generatora.

Naleźy zweryfikować, czy po aktualizacji Comarch DMS zostały wgrane odpowiednie pliki generatora zgodne z wersją Comarch ERP Optima.

Jeżeli konfiguracja kontrolki typu Własna akcja odbywa się przez plik wykonywalny, wówczas należy wgrać pliki generatora do plików desktopowych Comarch DMS.

Jeżeli konfiguracja kontrolki typu Własna akcja odbywa się przez IIS, wówczas należy wgrać pliki generatora do plików aplikacji serwerowej (dawnej web).