← Powrót do listy dostępnych akcji

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

Kategoria: Ogólne

Umiejscowienie akcji: Przycisk, Zmienna

Dostępna od wersji: 1.0.0

 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.

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

Umiejscowienie akcjiDziałanie parametru "Wykonanie warunkowe"Warunek wywołania akcji
Przycisk

Uaktywnia akcję

Naciśnięcie przycisku

ZmiennaWywołuje akcję

Parametr "Wykonanie warunkowe" zwróci "prawdę"

Nazwa parametruOd wersjiOpisTyp parametruWartość domyślnaRodzaj polaUwagi i ograniczenia
Format wygenerowanego numeru*1.0.0Format 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.0Nazwa 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.0Zmienna, 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.37Określa czy znaki specjalne w nazwie sekwencji mają zostać zamienione na "_" (jedyny akceptowalny znak specjalny we wszystkich bazach oprócz MSSQL).Logiczny NiePole edytowalne
  1. Nazwa sekwencji w bazie Oracle nie może zaczynać się od żadnego znaku specjalnego (nawet "_")!
  2. 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".

Parametr*- pole wymagane

1.0.0

  • Dodanie komponentu

1.0.1

  • Dodanie możliwości generowania unikatowego numeru pod przyciskiem

1.0.37

  • Dodanie parametru "Zamiana znaków specjalnych" i naprawa błędu

1.0.56

  • Modyfikacja dynamicznego formularza

Powiązane zadania

Aktualne

Archiwalne