## Alt identifier

`Alt identifier` jest alternatywnym wobec `erp identifier` numerem zlecenia. Jego widoczność w formularzu zlecenia określają dwie flagi w typie transportu:

- `allows_alt_identifier` (widoczność pola),
- `requires_alt_identifier` (widoczność + obowiązkowość).

### Automatyczne generowanie numeru `alt_identifier`

W przypadku ustawienia w typie transportu flagi `alt_identifier_is_created_automatically` na `true` numer ten będzie generowany automatycznie w systemie. Jednocześnie nie będzie on możliwy do edycji z poziomu platformy.

Sposób automatycznego generowania numeru `alt_identifier` określają dwie zmienne w typie transportu:

- `alt_identifier_format`,
- `alt_identifier_sequence_name`.

### Format automatycznie generowanego numeru `alt_identifier`

Szablon numeru `alt_identifier` znajduje się w zmiennej `alt_identifier_format`. Może zawierać ona:

- stały tekst (dowolny), np. `IN`, `OUT`, `AOHE`
- fragment daty - możliwe do zakodowania wartości to:

  - `YY` - dwie ostatnie cyfry roku,
  - `YYYY` - wszystkie cyfry roku,
  - `MM` - numer miesiąca
- kolejny numer sekwencji, zapisany jako `$sequence`; nazwa sekwencji, która zostanie wykorzystana, znajduje się w zmiennej `alt_identifier_sequence_name`
- separator poszczególnych fragmentów; **UWAGA! musi być to znak `/`**

Przykładowe wartości zmiennej `alt_identifier_format`:

| `alt_identifier_format` | Przykładowy numer (maj 2020) |
| --- | --- |
| `OUT/$sequence/MM/YY` | OUT/1/05/20 |
| `IN/$sequence/MM/YY` | IN/1/05/20 |
| `TR/$sequence/MM/YY` | TR/1/05/20 |
| `$sequence/AOHE/YYYY` | 1/AOHE/2020 |

### Resetowanie numeru sekwencji

Numery sekwencji podane jako `alt_identifier_sequence` dla któregoś z typów transportu są okresowo resetowane. Moment wyzerowania wszystkich sekwencji pryncypała określa setting `ALT_IDENTIFIER_RESET_INTERVAL`. Może on przyjmować dwie wartości:

- `m` - restart sekwencji co miesiąc,
- `y` - restart sekwencji co rok.

Job resetujący sekwencje wykonuje się każdego pierwszego dnia miesiąca i resetuje sekwencje miesięczne, a także roczne (jeśli pierwszy dzień miesiąca jest też pierwszym dniem w roku, a więc mamy styczeń).

## Automatyczne generowanie `alt_identifier` w zależności od wartości custom fielda [(A-11227)](<https://youtrack.logintegra.com/issue/A-11227>)

JAK TO DZIAŁA?

W zależności od wybranej wartości w CF'ie dodajemy zmienną do generowanej automatycznie sekwencji.

W przypadku edycji CF'a podmieniamy tą część również w `altIdentifier`, nie zmieniając numeru.

![](<https://docs.logintegra.com/apollo-backend/static/Transports/form/regular-fields/regular-fields/alt-identifier-cf.png>)

JAK USTAWIĆ?

1. Flaga o automatycznym tworzeniu alt zlecenia
2. Zdefiniować nazwę sekwencji w bazie (tutaj `outform_sequence`)
3. Wpisac nazwe sekwencji w ustawieniach typu transportu
4. Wpisać ID CF'a na podstawie którego ma być generowany `alt` → `$cfd_XXXXXXXX$sequence`

![](<https://docs.logintegra.com/apollo-backend/static/Transports/form/regular-fields/regular-fields/alt-identifier-cf-2.png>)
