- Wartość domyślna pola klasy
- Wartość domyślna elementu formularza ma pierwszeństwo
- Pole wymagane na formularzu
- Ograniczenia definicji pola
- Pamiętanie poprzedniego wpisu
- Przykład: formularz nowego zgłoszenia
- Powiązane instrukcje szczegółowe
- Atrybuty pól — szczegóły konfiguracji
- Atrybut pola klasy nie zastępuje wymagania kontrolki
- Atrybuty elementu — szczegółowe zasady
Wartość domyślna przyspiesza wprowadzanie danych, a wymaganie i ograniczenia pola kontrolują ich kompletność. Ustawienia występują na dwóch poziomach: pola klasy i elementu formularza. Różnica ma znaczenie również podczas edycji istniejącego obiektu.
Wartość domyślna pola klasy #
W kartotece „Administrator” otwórz zakładkę „klasy”, wybierz klasę, a następnie pole w sekcji „Pola”. W polu „Wartość domyślna” ustaw propozycję dla nowych obiektów, np. początkowy etap współpracy. Dla listy wskazujesz wariant, dla powiązania — identyfikator obiektu.
Zwykła zmiana tej definicji nie stanowi operacji zbiorczej na istniejących danych. Wyjątek związany z dodaniem pierwszego wariantu listy jednokrotnej omawia poradnik o polach wyboru. Rodzaje pól opisuje Klasy i pola w programie bs4 core.
Wartość domyślna elementu formularza ma pierwszeństwo #
W edytorze elementu typu „pole” dostępna w ustawieniach zaawansowanych „Wartość domyślna” jest ustawieniem konkretnego elementu. Niepusta wartość jest używana do przygotowania zawartości kontrolki przed odczytem wartości obiektu. Może więc pojawić się także podczas edycji istniejącego rekordu, a następnie zostać zapisana z formularza.
Dlatego stałą propozycję dla nowego rekordu ustawiaj przede wszystkim w definicji pola klasy. Nadpisanie w elemencie stosuj świadomie na określonej stronie, np. osobnym formularzu dodawania. Wartość zawierająca znaczniki jest interpretowana w kontekście obiektu; tekst wpisany ręcznie przez użytkownika nie staje się przez to automatycznie szablonem.
pole wymagane na formularzu #
- Otwórz edytor strony i opcję menu „Elementy formularza”.
- Otwórz wybrany element typu „pole”.
- W sekcji „Atrybuty elementu” zaznacz „pole wymagane przy edycji”.
- Zapisz konfigurację i sprawdź zapis formularza z pustym polem.
Atrybut jest dostępny dla elementów typu „pole” i „pole dowolne (generic)”. Nie jest wspólną cechą wszystkich elementów formularza. To również nie to samo co globalna reguła obowiązująca wszystkie importy i automatyzacje. Sposób walidacji wartości zależy od rodzaju kontrolki; sprawdź także wariant „brak wyboru”, zero i puste powiązanie, jeśli występują w danym polu.
Ograniczenia definicji pola #
Dla tekstu można stosować parametry „Minimalna długość tekstu”, „Maksymalna długość tekstu” i — dla obsługiwanych pól — „Maska wprowadzania tekstu”. Dla liczby służą parametry „Wartość minimalna”, „Wartość maksymalna” oraz „Ilość miejsc po przecinku”. Dostępność ustawień zależy od rodzaju pola. Maska ułatwia wprowadzanie określonego formatu; nie zastępuje sprawdzenia biznesowego znaczenia danych.
Pamiętanie poprzedniego wpisu #
Atrybut „Pamiętaj ostatnią wprowadzoną wartość” jest mechanizmem konkretnego elementu. Przydaje się podczas seryjnego dodawania podobnych rekordów. Nie utożsamiaj go z domyślną wartością wspólną dla całej klasy. Jest udostępniany wybranym kontrolkom, m.in. tekstowym, liczbowym i listom wyboru; nie każdemu typowi elementu.
Przykład: formularz nowego zgłoszenia #
Ustaw status początkowy w definicji pola „Status”, wymagaj pola „Temat” na formularzu, a dla liczby sztuk ustaw odpowiedni zakres. Nie ustawiaj stałego statusu początkowego jako wartości elementu na formularzu edycji — otwarcie zakończonego zgłoszenia nie powinno sugerować cofnięcia go do początku.
Sprawdź nowy rekord, istniejący rekord z innymi wartościami, puste pole wymagane i granice dopuszczalnego zakresu. Wymagane pole musi dać się wypełnić użytkownikowi, którego uprawnienia lub warunki nie pozwalają edytować innych części formularza. Szczegóły kontrolek: 1. Edycja elementów formularza; reguły dostępu: Zarządzanie uprawnieniami w bs4 core.
Powiązane instrukcje szczegółowe #
- Pola wyboru — warianty, kolory, ikony i wartości domyślne
- Warunkowe formularze — pokazywanie pól, sekcji i przycisków
Atrybuty pól — szczegóły konfiguracji #
Atrybut pola klasy nie zastępuje wymagania kontrolki #
Wariant „Indeks musi mieć wpisaną wartość” (indexwym) z pola „Atrybuty pola” wymaga niepustej relacji pojedynczej podczas standardowej walidacji obiektu. To inny zakres niż „pole wymagane przy edycji” w konkretnym elemencie formularza. Ma również skutek przy usuwaniu wskazanego obiektu — zobacz Pola powiązań — łączenie obiektów i wybór danych na formularzu.
Wariant „Zapisuj mimo przekroczenia ograniczeń” (ign_ogran) jest dostępny dla linijki tekstu, długiego tekstu i liczby. Za długi tekst jest skracany do maksimum; za krótki może pozostać krótszy, bez dopisywania znaków. Liczba poza zakresem jest przesuwana do minimum lub maksimum. Przykład: dla zakresu 1–100 wartość 120 może zostać zapisana jako 100. Nie jest to zapis dowolnej wartości bez zmian i nie omija np. unikalności.
Puste teksty i zero mają odrębną obsługę walidacji, dlatego zakres długości lub liczby nie zastępuje reguły wymagalności. Pełny zakres ustawień opisuje Atrybuty pól — dostępność i działanie ustawień.
Pełny przewodnik: Atrybuty pól — dostępność i działanie ustawień.
Atrybuty elementu — szczegółowe zasady #
Co jest traktowane jako brak wymaganej wartości #
Atrybut „pole wymagane przy edycji” dotyczy elementów „pole” i „Generic (ogólne pole)”. W standardowej kontroli wymagalności kontrolki „Wprowadzanie liczby” także zero jest traktowane jako brak wartości. Dla „Zakres dat” i „Zakres dat i godzin” wymagane są oba końce zakresu. Zaznaczenie atrybutu na formularzu nie tworzy reguły obejmującej automatycznie wszystkie importy i triggery.
Dla zwykłych pól „Pamiętaj ostatnią wprowadzoną wartość” utrwala wybór użytkownika przy zapisie. W kartotece dodawania na tej samej stronie może zastąpić zwykłą wartość domyślną; pole ustawione przez przejście z innej opcji jest chronione przed takim podstawieniem. Sprawdź kolejny cykl dodawania na tym samym koncie. Nie zakładaj identycznej obsługi elementu Generic lub programowanego. Szczegóły: Atrybuty elementów formularza — dostępność, zapis i wygląd.
