# TODO

[A-8391](<https://youtrack.logintegra.com/issue/A-8391>) Dokumentacja | `Transports` -\> `form` -\> `custom-fields` -\> `#index.md`

ogólny opis CF - jakie są, gdzie mogą się wyświetlać, co się da tam ustawić "podstawowo"

(poniżej wklejam istniejącą, częściową dokumentację - domyślną wartość pola niestandardowe)

# Domyślna wartość pola niestandardowego

> Aktualnie ustawienie domyślnej wartości dla pola niestandardowego jest możliwe wyłącznie dla pól typu: "Pole wyboru".

## Ustawienie domyślnej wartości pola niestandardowego

W celu ustawienia domyślnej wartości należy wejść w ustawienia wybranego pola:

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

następnie należy zaznaczyć pole `Domyślna wartość pola wyboru`:

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

oraz wybrać wartość z pola wyboru opcji przypisanych do wybranego pola niestandardowego:

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

po wybraniu odpowiedniej opcji należy zapisać ustawienia pola.

## Automatyczne wypełnianie się formularza domyślną wartością pola niestandardowego

Po wybraniu domyślnej wartości pola niestandardowego, pole to będzie uzupełniało się automatycznie podczas otworzenia odpowiedniego formularza (tego, do którego przypisane jest pole — formularz transportu, formularz awizacji itp.):

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

## Wartość automatyczna

> Ustawienie wartości automatycznej dla pola niestandardowego zostało przewidziane dla pól typu: "Tekst" i "Pole wyboru". W obecnej formie wartość automatyczna generowana jest po zapisaniu zmian w formularzu

### Ustawienie aliasów dla pól niestandardowych

W celu ustawienia aliasów należy wejść w ustawienia wybranego pola, następnie należy uzupełnić pole `Alias`, na podstawie wartości podanej w tym polu będziemy wyszukiwać pola do wartości automatycznej.

![img\_3.png](<https://docs.logintegra.com/apollo-backend/static/Transports/form/custom-fields/automatic-value/automatic-value-cf-alias.png>)

### Ustawienie aliasów dla opcji pól niestandardowych

W polach typu wyboru, należy dodatkowo podać alias/wartość ukrytą dla każdej z opcji pola niestandardowego - teskt podany w tym polu zostanie użyty do generowanej wartości automatycznej

![img\_2.png](<https://docs.logintegra.com/apollo-backend/static/Transports/form/custom-fields/automatic-value/automatic-value-cf-options-alias.png>)

### Ustawienie wartości automatycznej

W celu ustawienia domyślnej wartości należy wejść w ustawienia wybranego pola, następnie należy zaznaczyć pole `Wartość automatyczna` oraz w polu `Zdefiniuj wartość` podać frazę składającą się z aliasów przypisanych do pól niestandardowych, z których mamy zamiar skorzystać. Każdy użyty w tym miejscu alias musi zostać poprzedzony znakami `/$`, natomiast każdy inny tekst niebędący aliasem znakiem `%`

![img\_4.png](<https://docs.logintegra.com/apollo-backend/static/Transports/form/custom-fields/automatic-value/automatic-value-definition.png>)

### Przykład:

- Alias pola tekstowego to `AliasPolaTekstowego` =\> w formularzu w tym polu wpisuje: `Będzie`
- Alias pola wyboru to `AliasPolaWyboru`
- Alias pierwszej opcji w/w pola ma wpisane `_Źle`
- Alias drugiej opcji w/w pola wpisane `_Dobrze` =\> w formularzu w tym polu wybieram drugą opcję
- Stały tekst do wartości automatycznej: `_ApolloFTW_`
- W polu `Zdefiniuj wartość` podaję `/$AliasPolaTekstowego/$AliasPolaWyboru%_ApolloFTW`
- Wynikiem powinien być wpisany tekst w polu `Będzie_Dobrze_ApolloFTW`

![img\_5.png](<https://docs.logintegra.com/apollo-backend/static/Transports/form/custom-fields/automatic-value/automatic-value-example.png>)
