---
title: Zadanie zapisu statusu do pól własnych Subiekta nexo (zdarzenia)
description: "Zadanie służy do automatycznego zapisywania wartości w polach własnych dokumentów w systemie Subiekt nexo.   Zadanie automatyczne jest obsługiwane wyłącznie w systemie Subiekt nexo. Może być wykonywane dla wszystkich typów dokumentów. ## Sposób działania 1. PP Mag Automat pobiera do…"
url: "https://ppmag.pl/docs/zadanie-zapisu-statusu-do-pol-wlasnych-subiekta-nexo-zdarzenia/"
updated: "2026-07-22"
category: PP Mag Automat / Zadania Biznesowe
---

# 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.

 

 Zadanie automatyczne jest obsługiwane wyłącznie w systemie Subiekt nexo. Może być wykonywane dla wszystkich typów dokumentów.

## 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.

![Widok konfiguracji pól własnych do zadania automatycznego.](https://ppmag.pl/wp-content/uploads/2026/07/image-34.png)

### 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.

 Pole należy wskazać za pomocą jego nazwy widocznej w systemie Subiekt nexo, a nie za pomocą technicznego oznaczenia, na przykład `s1`.

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.

 Nazwa pola własnego oraz wartość słownikowa muszą być przekazywane jako tekst. Wartość słownikowa musi być zgodna z nazwą wartości zdefiniowaną w słowniku systemu Subiekt nexo.

### 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.

![Widok konfiguracji atrybutów.](https://ppmag.pl/wp-content/uploads/2026/07/image-35.png)

## 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.