# Uprawnienia dotyczące pól niestandardowych

Widoczność i możliwość edycji pól niestandardowych określona jest poprzez ustawienia `authority_restriction` i akcje `ACCESS_CUSTOM_FIELD`, `UPDATE_CUSTOM_FIELD`.

Opis działania `authority_restriction` można znaleźć [TUTAJ](<https://docs.logintegra.com/apollo-backend/6. Authorities &amp; Settings/authorities/action-authorities/%23index/index.md>).

W przypadku uprawnień dotyczących pól niestandardowych podczas dodania i edycji uprawnień wymagane jest uzupełnienie pola "Pole niestandardowe", które definiuje, które pola dotyczy uprawnienie.

Podczas tworzenia nowego pola niestandarowego

![](<https://docs.logintegra.com/apollo-backend/static/Transports/form/custom-fields/authorities/addCustomField.png>)

uprawnienia do niego przypisywane są automatycznie, o zakresach analogicznych do sekcji danych głównych lub sekcji awizacji (w zależności od ustawienia pola `Widoczne w formularzu awizacji`).

Przykład:

Jeśli przy tworzeniu pola niestandardowego (z wyłączoną opcją `Widoczne w formularzu awizacji`) rola `CARRIER` posiada ustawione uprawnienie edycji danych głównych na:

- `BEFORE_CHECKPOINT_BASED` - status: `Wjazd`

to stworzone pole niestandardowe będzie miało analogiczne ustawienie dla danej roli (`CARRIER`).

## Działanie uprawnień do edycji pól niestandardowych

### Tworzenie nowego transportu

Podczas tworzenia nowego transportu obowiązują następujące zasady:

- jeśli rola tworząca transport nie posiada żadnego wpisu w uprawnieniach (tabela: `authority_restriction`) nie może edytować wybranego pola
- jeśli rola tworząca transport posiada jakikolwiek wpis w uprawnieniach (tabela: `authority_restriction`) może ona edytować wybrane pole już podczas tworzenia transportu

### Edycja nowego transportu

Podczas edycji transportu obowiązują następujące zasady:

- jeśli rola edytująca transport posiada uprawnienia a stan edytowanego transportu spełnia warunki określone w tych uprawnieniach to edycja pola jest możliwa

### Przykład

Dla roli `Przewoźnik` oraz typu transportu `Dostawa` zdefiniowano następujące uprawnienia do edycji pola:

![](<https://docs.logintegra.com/apollo-backend/static/Transports/form/custom-fields/authorities/exampleAuthority1.png>)

![](<https://docs.logintegra.com/apollo-backend/static/Transports/form/custom-fields/authorities/exampleAuthority2.png>)

Ustawione uprawnienia określają, że:

- rola `Przewoźnik` przy tworzeniu transportu typu `Dostawa` będzie mogła edytować pole `Rodzaj naczepy` już podczas tworzenia transportu, ponieważ posiada jakikolwiek wpis w uprawnieniach danego pola niestandardowego:

![](<https://docs.logintegra.com/apollo-backend/static/Transports/form/custom-fields/authorities/exampleAuthority3.png>)

- rola `Przewoźnik` przy edycji transportu typu `Dostawa` będzie mogła edytować pole `Rodzaj naczepy` do momentu potwierdzenia statusu `Wjazd` w transporcie:

> przed potwierdzeniem statusu `Wjazd`:

![](<https://docs.logintegra.com/apollo-backend/static/Transports/form/custom-fields/authorities/exampleAuthority4.png>)

![](<https://docs.logintegra.com/apollo-backend/static/Transports/form/custom-fields/authorities/exampleAuthority5.png>)

> po potwierdzeniu statusu `Wjazd`:

![](<https://docs.logintegra.com/apollo-backend/static/Transports/form/custom-fields/authorities/exampleAuthority6.png>)

![](<https://docs.logintegra.com/apollo-backend/static/Transports/form/custom-fields/authorities/exampleAuthority7.png>)

## Widoczność custom fields w zależności od roli

Ogranicza widoczność danego custom field dla danej roli.

1. Włączanie roli:

- Wchodzimy do zakładki "Ustawienia".
- Wybieramy role z sekcji "Ustawienia ról użytkowników".
- Wchodzimy w uprawnienia zależne od typu transportu.
- Klikamy dodaj uprawnienie.

![](<https://docs.logintegra.com/apollo-backend/static/Transports/form/custom-fields/authorities/custom-field-visibility.png>)

2. Ustawienie widoczności

   I. Pole niestandardowe - Wybieramy jakiego pola niestandardowego ma sie tyczyć ustawienie. - Powinny być widoczne wszytkie pola przypisane do typu transportu.

   II. Zakres - Ustawiamy do jakiego momentu custom field ma nie byc widoczy dla danej roli.
