[AKCJA] Wstawienie unikatowego numeru

Jeśli masz problem ze zrozumieniem jak działa akcja, sprawdź opisy: Akcja, Wykonanie warunkowe, Parametry komponentów

Podstawowe informacje

Kategoria: Ogólne

Umiejscowienie akcji: Przycisk, Zmienna

Dostępna od wersji: 1.0.0

Opis

Akcja wstawia do zmiennej unikatowy numer, wygenerowany z wykorzystaniem sekwencji, w oparciu o podane formatowanie i nazwę sekwencji. Akcję wywołuje się na polu nagłówkowym.

Wywołanie akcji

Pozostawienie pustego pola wykonania warunkowego jest jednoznaczne z ustawieniem go na "prawdę".

Umiejscowienie akcji	Działanie parametru "Wykonanie warunkowe"	Warunek wywołania akcji
Przycisk	Uaktywnia akcję	Naciśnięcie przycisku
Zmienna	Wywołuje akcję	Parametr "Wykonanie warunkowe" zwróci "prawdę"

Parametry konfiguracyjne

Nazwa parametru	Od wersji	Opis	Typ parametru	Wartość domyślna	Rodzaj pola	Uwagi i ograniczenia
Format wygenerowanego numeru*	1.0.0	Format na podstawie którego zostanie wygenerowany numer. Typowy format składa się z trzech elementów: znacznika numeru, symbolu oddzielającego i znacznika roku. Cyfry w znacznikach numeru i roku oznaczają ilość cyfr, które mają zostać wygenerowane. Rok może być dwu- lub czterocyfrowy, ale może również zostać pominięty, podobnie jak symbol oddzielający.	Tekst	[N4]/[R2]	Pole edytowalne	Format musi posiadać znacznik numeru. Formatowanie może również zawierać stałe tekstowe. Przykładowy, domyślny format [N4]/[R2] pozwala, np., na wygenerowanie numeru 0001/17
Nazwa sekwencji*	1.0.0	Nazwa nowej lub istniejącej już sekwencji w bazie danych systemu.	Tekst		Pole edytowalne	Jeśli chcemy zadbać o resetowalność numeru z nowym rokiem, wystarczy, że nazwa zawierać będzie aktualny rok. Dynamiczne pobranie bieżącego roku umożliwia funkcja currentYear(). Przykładowa nazwa wykorzystująca funkcję może być zdefiniowana w następujący sposób: #concat(test_,toString(currentYear())).
Zmienna docelowa*	1.0.0	Zmienna, w której zapisany zostanie numer.	Zmienna	<zmienna na którą przeniesiono akcję> ( w przypadku umieszczenia na zmiennej)	Pole edytowalne/pole nieedytowalne ( w przypadku umieszczenia na zmiennej)	Zmienna powinna być typu tekstowego i umieszczona na formularzu (nie w tabeli dynamicznej).
Zamiana znaków specjalnych*	1.0.37	Określa czy znaki specjalne w nazwie sekwencji mają zostać zamienione na "_" (jedyny akceptowalny znak specjalny we wszystkich bazach oprócz MSSQL).	Logiczny	Nie	Pole edytowalne	Nazwa sekwencji w bazie Oracle nie może zaczynać się od żadnego znaku specjalnego (nawet "_")! Przy włączonej opcji zmiany znaków jeden symbol zostaje zamieniony na jeden podkreślnik. Dla przykładu "T$.st" = "T__st", a "T@#$e%st" = "T___e_st".