INPUT OTHER PROJECT

Operator INPUT OTHER PROJECT umożliwia wywołanie innego projektu GRAVITY w ramach bieżącego projektu oraz wprowadzenie na magistralę danych strumienia danych będącego wynikiem przetwarzania wskazanego projektu.

Operator INPUT OTHER PROJECT podobnie jak operator OTHER PROJECT CALL może zostać wykorzystany do podziału rozbudowanych procesów na kilka mniejszych procesów. Procesy te mogą zostać użyte również w innych procesach np. wydzielamy z procesu głównego sprawdzenie czy istnieje w bazie kontrahent o podanym nip do osobnego projektu. Można powiedzieć, że wydzielony projekt stał się “funkcją”, którą możemy teraz użyć w wielu różnych projektach, a jakąkolwiek zmianę tego wycinka systemu dokonujemy w jednym miejscu.

KONFIGURACJA OPERATORA

W operatorze INPUT OTHER PROJECT musisz zadeklarować inny projekt GRAVITY pole Concept model to call.

Projekt ten zostanie automatycznie przetworzony w trakcie realizacji aktualnego projektu w celu uzyskania strumienia danych początkowych.

Musisz również wskazać operator typu OUTPUT, czyli operator wyjściowy projektu wywoływanego, którego dane wyjściowe zostaną przesłane na magistralę wyjściową operatora wywołującego. Magistrala będzie zbudowana z dokładnie takich samych bitów jak wskazany operator OUTPUT projektu wywoływanego.

Pole Transaction mode pozwala na zdecydowanie w jaki sposób będą tworzone transakcje zakładane do połączeń bazodanowych wykorzystanych w projektach.

• Use transaction from main project → przekazuje wszystkie rozpoczęte transakcje do procesu podrzędnego, a wszystkie transakcje rozpoczęte w procesie podrzędnym zostaną przekazane do procesu nadrzędnego. Wszystkie transakcje są zatwierdzane po poprawnym zakończeniu procesu nadrzędnego, jak również wycofywane w przypadku zakończenia błędem.

Gdy wystąpi błąd w procesie nadrzędnym na jakimkolwiek etapie jego wykonania zmiany wprowadzone do baz danych w procesie podrzędnym zostaną wycofane.
• Use separate transaction → proces wywoływany sam zarządza swoimi transakcjami. Zakłada transakcje dla wszystkich połączeń do baz danych. Zatwierdza je, gdy kończy się powodzeniem i wycofuje, gdy błędem.

Gdy błąd wystąpi w procesie nadrzędnym po wywołaniu procesu podrzędnego zmiany wprowadzone do bazy danych przez proces podrzędny nie zostaną wycofane.

Więcej o sposobie zarządzania transakcjami w rozdziale Zarządzanie transakcjami baz danych w projekcie

MAPOWANIE PARAMETRÓW

Projekt wywoływany może posiadać parametry niezbędne do jego uruchomienia. Parametry te mogą mieć inną nazwę bądź nie występować w projekcie wywołującym. Należy powiązać parametry projektu wywoływanego z parametrami projektu głównego.

Jeśli w projekcje głównym nie używasz parametrów a dane, które chcesz użyć jako parametr wejściowy do projektu podrzędnego masz na magistrali danych, możesz użyć operatora OUTPUT PARAMETER aby przekonwertować je na parametry.

Aby zmapować parametry wybierz zakładkę Parameters mapping.

W polu Called parameter name wybierz z listy parametr wejściowy projektu wywoływanego i w polu Source wybierz odpowiadający mu parametr projektu głównego.

Pamiętaj, że typy parametrów muszą się zgadzać. W przeciwnym wypadku system informuje o niezgodności typów wykrzyknikiem.

Usunięcie wpisów możliwe jest po kliknięciu prawym przyciskiem myszy na rekordzie.

W przeciwieństwie do operatora OTHER PROJECT CALL wywołanie projektu podrzędnego nastąpi tylko jeden raz.

Jeśli projekt podrzędny z jakiegoś powodu zakończył się operatorem STOP PROCESS a nie operatorem wskazanym w polu Output, projekt główny będzie kontynuowany oraz rezultat wywołania projektu podrzędnego będzie przekazywany na magistralę tylko w następujących przypadkach:

• pole Transaction mode operatora wywołującego ma wartość Use separate transaction oraz pole Action na operatorze STOP PROCESS (w projekcie wywoływanym) ma ustawioną wartość Stop processing with success and commit lub Stop processing with error and rollback.
• pole Transaction mode operatora wywołującego ma wartość Use transaction from main project oraz pole Action na operatorze STOP PROCESS (w projekcie wywoływanym) ma ustawioną wartość Stop processing with success and commit.
• w pozostałych przypadkach projekt wywołujący zostanie przerwany i zostanie zwrócony rezultat wykonania zgodny z polem Action operatora STOP PROCESS.