Instalacja Comarch DMS

W pierwszym kroku należy zainstalować Comarch 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 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ć 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 DMS z CEE po kliknięciu zakładki [Struktura organizacyjna] w aplikacji desktopowej 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 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 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).

Oprócz funkcji dostępnych z poziomu bocznego menu, użytkownik ma dostęp do  funkcji [Panel użytkownika], prezentowanej w prawym górnym rogu aplikacji.

W oknie widoczna jest nazwa i spółka zalogowanego operatora, znajduje się tam również opcja [Wyloguj się], która umożliwia wylogowanie operatora z aplikacji.

Jeżeli dany operator ma uprawnienia do pracy z modułem Repozytorium, wówczas na lewo od ikony panelu użytkownika widoczna jest ikona [Wykonywane akcje] związana z działaniami wykonywanymi w module Repozytorium (zob. Okno „Wykonywane akcje”).

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 „Lista” posiada identyfikatory numeryczne i tekstowe.

Rodzaj używanego identyfikatora zależy od właściwości „Rodzaj identyfikatora”, którą ustawia się na definicji danej kontrolki typu Lista.

Globals.MainFrame.List1.AddItem(1,"Poczta"); 

Globals.MainFrame.List1.AddItem(2,"Kurier"); 

Globals.MainFrame.List1.AddItem(3,"Odbiór osobisty");

Globals.MainFrame.List1.AddItem("1","Samochód");

Globals.MainFrame.List1.AddItem("2","Pociąg");

Globals.MainFrame.List1.AddItem("3","Autobus");

Zwracane wyniki:
0 – element został dodany do kolekcji
1 – identyfikator elementu już istnieje w kolekcji
2 – niewłaściwy typ identyfikatora dodawanej pozycji
3 – błąd dodawania pozycji

Globals.MainFrame.List1.AddItem("1","Samochód");
Globals.MainFrame.List1.AddItem("2","Pociąg");
Globals.MainFrame.List1.AddItem("3","Autobus");
Globals.MainFrame.List1.Clear();
Globals.MainFrame.List1.AddItem("4","Tramwaj");
Globals.MainFrame.List1.AddItem("5","Samolot");

Globals.MainFrame.List1.Clear();
Globals.MainFrame.List1.AddItem("4","Tramwaj");
Globals.MainFrame.List1.AddItem("5","Samolot");

Globals.MainFrame.List1.AddItem(1,"Poczta"); 
Globals.MainFrame.List1.AddItem(2,"Kurier"); 
Globals.MainFrame.List1.AddItem(3,"Odbiór osobisty");
Globals.MainFrame.List1.SetSelectedItem(2);

Globals.MainFrame.List1.AddItem("1","Samochód");

Globals.MainFrame.List1.AddItem("2","Pociąg");

Globals.MainFrame.List1.AddItem("3","Autobus");
Globals.MainFrame.List1.SetSelectedItem("1");

Zwracane wyniki:
0 – pozycja została ustawiona
1 – nie odnaleziono pozycji
2 – zastosowano argument niewłaściwego typu

Globals.MainFrame.List1.AddItem("1","Samochód");

Globals.MainFrame.List1.AddItem("2","Pociąg");

Globals.MainFrame.List1.AddItem("3","Autobus");
Globals.MainFrame.List1.SetSelectedItem("1");
Globals.MainFrame.List1.ClearSelectedItem();

Globals.MainFrame.String2.Text=Globals.MainFrame.List1.SelectedText;

Możliwe rozwiązania:

Należy zweryfikować, czy w momencie generowania dokumentów do Comarch ERP Optima,  dostępne są wolne licencje.