InsERT nexo – Jak uruchomić przykładowe rozwiązanie własne?

Uwaga! Przed wykonaniem poniższych czynności zalecane jest przeprowadzenie archiwizacji podmiotu. Proces został opisany w artykule e-Pomocy technicznej dostępnym tutaj.

SDK (Specjalistyczna dokumentacja techniczna) programów InsERT nexo zawiera przykłady dedykowanych rozwiązań własnych rozszerzających funkcjonalność systemu. W artykule przedstawiono sposób przygotowania wybranego przykładu, jego kompilacji oraz instalacji w programach InsERT nexo.​

Uwaga! W przypadku trudności z osiągnięciem oczekiwanego efektu zachęcamy do kontaktu z lokalnym serwisantem.

Do przeprowadzenia opisanych czynności niezbędne jest zainstalowanie:

• InsERT nexo SDK,

• .NET 8 SDK.

Proces zostanie przedstawiony z wykorzystaniem programu Visual Studio, jednak część opisanych czynności można wykonać również bez jego użycia.

Uwaga! W przykładach SDK znajdują się zarówno rozwiązania wymagające kompilacji, np. pluginy rozszerzające funkcjonalność systemu, jak i rozwiązania niewymagające kompilacji, np. przykładowe funkcje importu plików XML, które można wskazać podczas pracy z kreatorem wdrożeniowym. Dostępne są również samodzielne aplikacje wykorzystujące Sferę, np. aplikacje konsolowe lub desktopowe, takie jak EksportRaportu oraz GeneratorDanych.

• InsERT nexo – Przykłady dedykowanych rozwiązań własnych dostępnych w SDK
  

Spis treści

1. Uruchomienie i dostosowanie rozwiązania do własnych potrzeb w Visual Studio

2. Kompilacja
   

   1. z wykorzystaniem Visual Studio

   2. z wykorzystaniem .NET CLI

3. ​Instalacja w InsERT nexo

Uruchomienie i dostosowanie rozwiązania do własnych potrzeb w Visual Studio

Aby to zrobić, należy:

1. Uruchomić pobrany plik instalacyjny nexoSDK.

2. W wyświetlonym oknie kliknąć Extract. Po zakończeniu procesu zostanie utworzony katalog z plikami SDK.

 

 

3. Przejść do katalogu Przykłady, otworzyć folder zawierający wybrane rozwiązanie, a następnie uruchomić znajdujący się w nim plik z rozszerzeniem .sln.

Uwaga! Posiadanie programu Visual Studio nie jest wymagane, jednak jest to zalecany sposób pracy ze względu na dostępne narzędzia i wygodę obsługi projektu. Alternatywnie pliki projektu można otworzyć i edytować za pomocą wybranego edytora kodu lub tekstu.

 

4. Dostosować projekt do własnych potrzeb. Przykładowe rozwiązanie może zawierać wiele klas odpowiadających za różne funkcjonalności. Informacja o tym, które z nich zostaną uwzględnione podczas kompilacji, znajduje się w pliku .plugin, więc należy w nim pozostawić wyłącznie pozycje odnoszące się do funkcjonalności, które mają zostać zainstalowane. Pozostałe wpisy można usunąć. Jeżeli dane klasy nie będą wykorzystywane przez inne elementy rozwiązania, odpowiadające im pliki klas (.cs) również można usunąć z projektu.

Uwaga! W przypadku trudności z dostosowaniem rozwiązania do własnych potrzeb zachęcamy do kontaktu z lokalnym serwisantem.

Przykładowo rozwiązanie KseFPluginy zawiera kilka rozszerzeń realizowanych przez odrębne klasy. Jeżeli zainstalowana ma zostać wyłącznie funkcjonalność związana z Korektą zbiorczą, w pliku .plugin należy pozostawić tylko wpis odnoszący się do klasy odpowiedzialnej za tę funkcjonalność. Pozostałe pozycje można usunąć wraz z niewykorzystanymi klasami projektu.

 

Kompilacja z wykorzystaniem Visual Studio

W tym celu należy skorzystać z opcji Kompilowanie – Kompiluj rozwiązanie znajdującej się w górnym menu programu. Rezultat zależy od typu wybranego rozwiązania. W większości przypadków ścieżka do utworzonego instalatora zostanie wyświetlona w oknie Dane wyjściowe.

 

Jeśli lokalizacja pliku nie została wskazana, należy ponownie przejść do katalogu przykładu, a następnie do folderu bin\Debug\Instalator, w którym powinien znajdować się utworzony instalator rozwiązania.​

 

Kompilacja z wykorzystaniem .NET CLI

Aby to zrobić, należy:

1. Uruchomić terminal w katalogu, w którym znajduje się plik rozwiązania .sln. Można w tym celu przejść do odpowiedniego katalogu w Eksploratorze plików, wpisać cmd w polu ścieżki znajdującym się w górnej części okna, a następnie nacisnąć Enter.

 

2. Wprowadzić poniższe polecenie i nacisnąć Enter.

dotnet build

 

Polecenie przywróci wymagane zależności i rozpocznie kompilację rozwiązania. Informacje o przebiegu procesu zostaną wyświetlone bezpośrednio w terminalu.

 

Jeśli lokalizacja instalatora nie została wskazana, należy ponownie przejść do katalogu przykładu, a następnie do folderu bin\Debug\Instalator, w którym powinien znajdować się utworzony instalator rozwiązania.

 

Instalacja w InsERT nexo

Aby to zrobić, należy:

Uwaga! Proces instalacji należy przeprowadzić przy zamkniętych programach InsERT nexo.

1. Uruchomić utworzony wcześniej instalator i kliknąć Dalej >.

 

2. Kliknąć Dalej >.

 

3. Uzupełnić parametry połączenia z serwerem SQL, a następnie kliknąć Połącz.

 

4. Zaznaczyć odpowiedni podmiot na liście i kliknąć Dalej >.

 

5. Kliknąć Zakończ.

 

6. Uruchomić program, kliknąć ikonę ≡, przejść do zakładki Operacje, a następnie wybrać Opieka posprzedażna – kontakt i informacje.

 

7. W wyświetlonym oknie, w sekcji Informacje o rozszerzeniach, zweryfikować, czy dodatek został prawidłowo załadowany.

Uwaga! W tym miejscu wyświetlane są wyłącznie rozszerzenia typu plugin. Aplikacje korzystające z bibliotek InsERT nexo, takie jak zewnętrzne aplikacje konsolowe lub okienkowe, które nie rozszerzają żadnego interfejsu punktu rozszerzeń nie będą widoczne na tej liście.