Publikowanie wersji

---

Platforma archITekt daje możliwość udostępnienia dostępu poprzez API do elementów biznesowych takich jak algorytmy, tabele, procesy oraz pakiety przetwarzania. Operacja ta wykonywana jest przez opublikowanie danego elementu w serwerze wersji.

W celu opublikowania dostępu do danego elementu

1. Wybierz panel Serwer wersji.
2. Zaznacz wersję (tabelę decyzyjną, algorytm lub proces, mikroproces).
3. Z menu kontekstowego wyświetlanego po kliknięciu prawego przycisku myszy wybierz opcję Publikuj.

Platforma umożliwia publikowanie dowolnej ilości elementów serwera wersji. Każdy opublikowany element widoczny jest w API jako nowe metody możliwe do wywołania przez zewnętrzne systemy.

Opublikowany element będzie dostępny poprzez API jako element aplikacji WWW:

1. jest dostępny poprzez API pod adresem: http(s)://[nazwa aplikacji ] /WebServices/EntryPoint.svc

Dla przykładu:

• Aby poprawnie zdefiniować adres przejdź do VSoft archITekt Launcher, rozwiń przycisk Open przy danym projekcie i wybierz opcję Start page, aby przejść do strony z adresami aplikacji.

Do adresu Main application: http(s)://localhost:44310/Sampleproject dodaj WebServices/EntryPoint.svc W tym przypadku opublikowane elementy będą dostępne pod adresem:

http(s)://localhost:44310/Sampleproject/WebServices/EntryPoint.svc

2. WSDL jest dostępny pod adresem http(s)://[nazwa aplikacji] /WebServices/EntryPoint.svc ?singleWSDL

ostrzeżenie

W przypadku opublikowania (cofnięcia publikacji) elementu lub jego modyfikacji, zmiany w API będą widoczne po restarcie serwisu WWW.

W zależności od opublikowanego elementu dostępne są różne metody:

Algorytmy i tabele decyzyjne

1. Algorytm: metoda Execute_[nazwa algorytmu] która uruchamia obliczenie algorytmu i zwraca jego dane wynikowe.
2. Tabela - metoda GetValue_[nazwa tabeli] która zwraca wartość tabeli.

ostrzeżenie

W przypadku wywołania tabeli i modelu konieczne jest przekazanie jako jednego z argumentów obiektu VersionSelector, który odpowiada za wybranie do obliczeń odpowiedniej wersji algorytmu/tabeli.

Dostępne implementacje tego typu to:

1. DateVersionSelector – wybiera do obliczeń wersję algorytmu/tabeli obowiązującą dla wskazanej daty.
2. SingleVersionSelector – pozwala na uruchomienie obliczeń algorytmu/tabeli, które posiadają jedną wersję. W przypadku, gdy algorytm/tabela posiadają dwie lub więcej wersji wywołanie zwraca wyjątek.
3. SpecificVersionSelector – umożliwia uruchomienie wybranej wersji algorytmu na podstawie jej identyfikatora.

Procesy (persystentne i niepersystentne)

Proces niepersystentny: metody Start_[nazwa procesu] oraz StartAsync_[nazwa procesu] uruchamiająca go i zwracająca jego wynik.

Proces persystentny:

1. metody Start_[nazwa procesu] oraz StartAsync_[nazwa procesu] uruchamiająca go i zwracająca instancję procesu.
2. metody Continue_[nazwa procesu] oraz ContinueAsync_[nazwa procesu] umożliwiające kontynuację wykonania procesu oczekującego na czynności Stan. Metody wymagają podania instancji procesu oraz kodu akcji. Więcej o czynności Stan patrz: Elementy procesu - czynności>Stan.

wskazówka

W przypadku metod umożliwiających operowanie na procesach dostępne są dwie wersje każdej metody: synchroniczna (standardowa) i asynchroniczna (z suffixem Async).

1. W przypadku metod synchronicznych Start Continue uruchomienie i kontynuowanie przebiegu procesu następuje w ramach aplikacji WWW (na serwerze IIS).
2. W przypadku metod asynchronicznych StartAsync ContinueAsuync uruchomienie i kontynuowanie przebiegu procesu następuje w ramach serwisu Workflow.

Miejsce wykonania/kontynuacji wykonania procesu należy dobrać odpowiednio, mając na uwadze czas wykonania czynności, które wykonuje proces:

1. W przypadku procesów (fragmentów procesów) z czynnościami, które wykonują się szybko należy je uruchamiać synchronicznie (w kontekście aplikacji WWW).
2. W przypadku procesów (fragmentów procesów) z czynnościami, które wykonują się długo (np. generowanie dokumentów, łączenie z zewnętrznymi systemami) należy uruchamiać je na serwisie Workflow.

Pakiety przetwarzania

1. Po opublikowaniu pakietu, przejdź do VSoft archITekt Launcher i zrestartuj TransformationServices.Host.
2. Najedź na wiersz TransformationServices.Host i wybierz przycisk Console, aby przejść do konsoli.

3. W konsoli będą widoczne informacje dotyczące adresu usługi.

Zobacz również

Drzewo Serwera Wersji

Wersjonowanie

Edytowanie wersji