Zadanie zapisu statusu do pól własnych Subiekta nexo (zdarzenia)

Zadanie służy do automatycznego zapisywania wartości w polach własnych dokumentów w systemie Subiekt nexo.

Sposób działania #

1. PP Mag Automat pobiera do wykonania zadania typu ZapisDoPolWlasnych w liczbie określonej w konfiguracji zadania.
2. System kolejno dla każdego dokumentu uruchamia proces zapisu do pól własnych:
   1. System odczytuje pola własne i wartości wskazane w parametrach zadania.
   2. Wartości są zapisywane w wybranych polach własnych dokumentu w systemie Subiekt nexo.
   3. Jeżeli w konfiguracji wskazano kilka pól, wszystkie wartości są zapisywane w ramach jednej transakcji.
   4. System dodaje nowe zdarzenie do dokumentu z wynikiem operacji.

Wykonanie zapisu w jednej transakcji oznacza, że wszystkie skonfigurowane pola są aktualizowane razem. Jeżeli zapis jednego z pól zakończy się niepowodzeniem, pozostałe zmiany również nie zostaną zatwierdzone.

Konfiguracja parametrów wykonania zadania #

Parametry zapisu do pól własnych ustawia się bezpośrednio w definicji zadania automatycznego.

Po wybraniu typu zadania przeznaczonego do zapisu w polach własnych system udostępnia dedykowane okno edycji parametrów.

W oknie konfiguracji można dodać jedno lub kilka pól własnych, które mają zostać uzupełnione podczas wykonywania zadania.

Konfiguracja pól #

Dla każdego dodanego pola należy określić:

• nazwę pola własnego w systemie Subiekt nexo,
• wartość, która ma zostać zapisana w polu,
• atrybut lub stałą wartość, z której system pobierze dane.

Wartość zapisywaną w polu należy wybrać z dostępnych atrybutów zadania. Można w tym celu wykorzystać wartość pochodzącą z dokumentu lub dodać stały tekst.

Konfiguracja pola słownikowego #

Przed skonfigurowaniem zapisu do własnego pola słownikowego należy utworzyć odpowiedni słownik w systemie Subiekt nexo oraz zdefiniować jego wartości.

Następnie w konfiguracji pól własnych odpowiedniego typu dokumentu, na przykład wydania zewnętrznego, należy:

1. dodać nowe pole własne typu słownikowego,
2. wskazać utworzony wcześniej słownik własny w polu własnym dokumentu,
3. zapisać konfigurację pola.

Po wykonaniu tej konfiguracji na dokumencie będzie dostępne pole w formie listy rozwijanej zawierającej wartości z wybranego słownika.

Podczas konfiguracji zadania dla pola słownikowego należy przekazać nazwę wartości słownikowej jako tekst. Nie należy przekazywać identyfikatora wartości.

Aby ustawić wartość pola słownikowego:

1. otwórz okno wyboru atrybutów,
2. dodaj stałą wartość tekstową,
3. wpisz tekst dokładnie odpowiadający nazwie wartości zdefiniowanej w słowniku,
4. przypisz przygotowaną wartość do odpowiedniego pola własnego.

Przykład konfiguracji #

Jeżeli w systemie Subiekt nexo utworzono słownik zawierający wartość „Dostarczone”, w parametrach zadania należy dodać stałą wartość tekstową do pola własnego w atrybutach o treści:

Dostarczone

Następnie wartość należy przypisać do pola własnego skonfigurowanego jako pole słownikowe.

Generowane zdarzenia dokumentu #

Podczas wykonywania zadania system generuje następujące zdarzenia:

• ProbaZapisuDoPolWlasnych – generowane, gdy zapis wartości do pól własnych zakończy się niepowodzeniem.
• ZapisDoPolWlasnych – generowane po prawidłowym zapisaniu wartości w polach własnych dokumentu.

Wymagania #

• Dokument musi pochodzić z Subiekta nexo.
• Pola własne wskazane w konfiguracji zadania muszą istnieć dla danego typu dokumentu w systemie Subiekt nexo.
• W przypadku pola słownikowego odpowiedni słownik oraz jego wartości muszą być wcześniej zdefiniowane w systemie Subiekt nexo.

Serwer Sfery (Sfera Nexo .NET Serwer Automatyczne) powinien być uruchomiony i działać w tle podczas wykonywania zadania.