Spis treści
- Otwieranie pola i wybór atrybutów
- Nazwa rekordu, nagłówek i warunki uprawnień
- Historia zmian i informacja o odczytaniu
- Walidacja i przechowywanie tekstu
- Tekst jako telefon, adres lub dane uporządkowane
- Liczby, zakresy dat i planowanie
- Powiązania, obiekty zależne i chmura
- Kopiowanie i scalanie
- Systemowe powiązanie z dowolną klasą
- Atrybuty elementu — szczegółowe zasady
Atrybuty pola są ustawieniami definicji pola klasy, wspólnymi dla miejsc używających tego pola. Mogą wpływać na zapis danych, relacje, kopiowanie, historię oraz prezentację. Nie są tym samym co „Atrybuty elementu” na konkretnym formularzu ani „Atrybuty strony”.
Otwieranie pola i wybór atrybutów #
Otwórz menu „Opcje” i wybierz opcję menu „Administrator”. Wybierz opcję menu „klasy”, a w menu rozwijanym opcję „Twoje klasy”. Otwórz klasę, np. „Kontrahent”, i w sekcji „Pola” kliknij nazwę pola. Na stronie „Dane ogólne”, w sekcji „Ustawienia”, rozwiń pole „Atrybuty pola”. Zaznacz potrzebne warianty, zatwierdź przyciskiem „Ok”, a następnie zapisz definicję przyciskiem „Zapisz”.
Listę wariantów ogranicza metoda DefinicjaZmiennejAdmina::tabWariantyAtrybutyZmiennej(). Liczy się rodzaj pola, jego klasa, docelowa klasa powiązania oraz już zaznaczone atrybuty. Przykładowo pole liczbowe ma opcje procentów i czasu trwania, a pojedyncze powiązanie z użytkownikiem — opcję przekazania danych następcy. Nie przenoś ręcznie atrybutów z innego rodzaju pola do bazy.
Nazwa rekordu, nagłówek i warunki uprawnień #
| Atrybut | Dostępność | Działanie i przykład |
|---|---|---|
Użyj tego pola jako domyślnej nazwy rekordu domsnazw | Bez dodatkowego ograniczenia rodzaju w liście. | Wartość służy do budowania nazwy rekordu, m.in. w nagłówku i odnośnikach. Kilka niepustych pól z tym atrybutem może współtworzyć nazwę. Przykład: „Numer” i „Temat” zgłoszenia. Nie oznacza to wymagalności ani unikalności tych wartości. |
Wyświetlaj w nagłówku kartotek zmpoty | Lista jednokrotnego wyboru, lista wielokrotnego wyboru lub pojedyncze powiązanie. | Wykorzystuje wybrany wariant do opisu rodzaju obiektu w nagłówku. Nie zastępuje nazwy rekordu i nie tworzy automatycznie nowej klasy. Przykład: wariant „Klient” lub „Dostawca”. |
Uwzględniaj w uprawnieniach i przy opcjach dodawania uwzupr | Lista jednokrotnego wyboru, lista wielokrotnego wyboru lub pojedyncze powiązanie. | Udostępnia wartości pola przy definiowaniu dodatkowych warunków uprawnień i opcji dodawania. Samo zaznaczenie nie przyznaje nikomu dostępu; trzeba przygotować reguły. Przykład: różne uprawnienia dla etapów sprawy. Zobacz Zarządzanie uprawnieniami w bs4 core. |
pole określa status obiektu w procesie status_ob | Lista jednokrotnego wyboru. | Wskazuje pole statusu używane przy projektowaniu procesu. Po standardowym zapisie ten atrybut jest usuwany z innych pól tej samej klasy: jedno pole pełni tę rolę. Nie generuje samodzielnie przejść ani reguł procesu. Zobacz Proces biznesowy — statusy, etapy i przejścia między formularzami. |
pole główne wg AI wazpoai | Bez dodatkowego ograniczenia rodzaju w liście. | Oznacza pole jako ważne dla mechanizmów budujących konfigurację. Kod automatycznego dodawania kolumn i filtrów może wybierać takie pola w klasie zawierającej więcej pól. Nie jest ogólnym przełącznikiem obowiązkowego wyświetlania we wszystkich istniejących formularzach. |
Historia zmian i informacja o odczytaniu #
| Atrybut | Dostępność | Działanie i przykład |
|---|---|---|
Twórz zapis sys.zmian zapzms | Bez dodatkowego ograniczenia rodzaju w liście. | Standardowy zapis obiektu rejestruje zmianę zawartości pola w historii. Nie odtwarza zmian sprzed włączenia i nie oznacza śledzenia dowolnego bezpośredniego zapytania do bazy. Przykład: historia zmian opiekuna lub kwoty. |
Zapisuj dodanie/usunięcie w powiązanym obiekcie zappowin | Lista wariantów nie ogranicza rodzaju; praktycznie wymaga pola wskazującego obiekt i prawidłowej klasy powiązania. | Przy dodaniu lub usunięciu obiektu tworzy wpis także w historii obiektu wskazanego tym polem. Przykład: dodanie osoby odnotowane w kartotece kontrahenta. Nie jest to kopiowanie wszystkich zmian dowolnego pola do historii rodzica. |
Zapisuj w polu osobę, która widziała obiekt rej_wysw | pole z klasą docelową „Użytkownik” (2). | Otwarcie kartoteki zapisuje użytkownika w tym polu. Dla przechowywania wielu czytelników użyj powiązania wielokrotnego; pojedyncze nie zachowa całej listy. To rejestr wskazań użytkowników, a nie tabela dat i czasu każdego odczytu. Standardowy zapis pozostawia tylko jedno pole tej roli w klasie. |
Walidacja i przechowywanie tekstu #
| Atrybut | Dostępność | Działanie i przykład |
|---|---|---|
Zapisuj mimo przekroczenia ograniczeń ign_ogran | Linijka tekstu, długi tekst lub liczba. | Przy przekroczeniu maksymalnej długości tekst zostaje obcięty; tekst krótszy od minimum może zostać zapisany bez uzupełnienia. Liczba poza zakresem jest ustawiana na granicę minimum albo maksimum. Nie omija wszystkich reguł zapisu, np. unikalności i logiki triggerów. Szczegóły: Wartości domyślne i pola wymagane — konfiguracja poprawnego wprowadzania danych. |
Pozwól na HTML lub znaki mniejsze-większe pozwolhtm | Linijka tekstu lub długi tekst. | Pozwala zachować obsługiwany HTML oraz znaki mniejsze/większe, ale nadal stosuje oczyszczanie treści. Nie przełącza kontrolki automatycznie na edytor tekstu sformatowanego. Przykład: zapis krótkiego opisu zawierającego formatowanie. |
Pozwól na dowolną zawartość (także niebezpieczną) pozwolany | Linijka tekstu, długi tekst lub tekst dowolnie formatowany. | Pomija standardowe oczyszczanie HTML w ścieżce walidacji tego pola, także usuwanie niebezpiecznej treści. To nie jest zwykły wariant „zezwól na formatowanie”. Stosuj tylko dla świadomie przygotowanej funkcji z kontrolowanym źródłem danych; nie włączaj go dla treści wpisywanych swobodnie przez użytkowników. |
Akceptuj emotikony i znaki z rozszerzonego kodowania emoji | Linijka tekstu, długi tekst lub tekst dowolnie formatowany. | Rozszerza kodowanie fizycznego pola bazy, aby przechowywać m.in. emoji. Zapis tej zmiany modyfikuje strukturę tabeli. Wyłączenie nie jest tylko ukryciem ikony — ogranicza kodowanie przechowywanych znaków. |
Uwzględniaj wielkość liter przy szukaniu searchcs | Linijka tekstu, długi tekst lub tekst dowolnie formatowany. | Zmienia sposób porównywania tekstu w bazie na rozróżniający wielkość liter. Może wpływać nie tylko na wyszukiwarkę, ale także na porównania i rozpoznawanie duplikatów. Zmiana wymaga modyfikacji fizycznego pola; sprawdź reguły unikalności. |
Wymuś index przyśpieszający szukanie addindex | Lista wariantów nie zawęża rodzaju; fizyczny indeks musi być obsługiwany dla typu i tabeli. | Wymusza zwykły indeks przyspieszający wyszukiwanie, a nie wymagalność relacji ani unikalność. Indeksy tekstowe mają ograniczony prefiks, do 50 znaków; nadal sprawdzana jest pełna wartość warunku. Nowe pola daty, daty i czasu, liczby, listy pojedynczej oraz powiązania pojedynczego mogą otrzymać indeks automatycznie, jeśli pozwalają limity. Wyłączenie usuwa zwykłe indeksy tego pola w zakresie obsługiwanym przez mechanizm. Nie jest to zarządzanie dowolnymi indeksami złożonymi lub UNIQUE. |
Indeks może zostać odrzucony przez limity długości, liczby indeksów lub obsługiwany typ. Zmiana kodowania i porównywania również może oddziaływać na istniejące indeksy. Po zapisie sprawdź komunikaty programu i zachowaną konfigurację; zaznaczenie wariantu przed zapisem nie potwierdza utworzenia indeksu.
Tekst jako telefon, adres lub dane uporządkowane #
| Atrybut | Dostępność | Działanie i przykład |
|---|---|---|
pole na adres URL strony www padr_url | Linijka tekstu. | W obsługiwanym elemencie udostępnia otwarcie adresu WWW. Nie zamienia tekstu w stronę osadzoną i nie sprawdza biznesowej poprawności witryny. Zobacz Telefony, adresy e-mail i kontakty na formularzu. |
Zawiera nr telefonu – włącz link do telefonowania padr_tel | Linijka tekstu. | Oznacza treść jako numer telefonu dla obsługiwanych kontrolek i generowanych kolumn. Nie instaluje ani nie konfiguruje telefonii. Zobacz Telefony, adresy e-mail i kontakty na formularzu. |
Zawiera adres e-mail – włącz link padr_mail | Linijka tekstu. | Włącza obsługę adresu e-mail i odnośnika do przygotowania wiadomości. Sam atrybut nie wysyła wiadomości. Zobacz Telefony, adresy e-mail i kontakty na formularzu. |
Zawiera XML cont_xml | Długi tekst. | Wybiera kontrolkę/formę prezentacji XML. Nie zamienia dowolnego tekstu w poprawny dokument XML. |
Zawiera JSON cont_json | Długi tekst. | Wybiera prezentację i edycję JSON. Zawartość musi mieć prawidłową składnię JSON. Przykład: podgląd danych integracji. |
Zawiera CSV cont_csv | Długi tekst. | Wyświetla prawidłową treść CSV jako tabelę w obsługiwanym podglądzie. Nie uruchamia importu CSV do rekordów programu. |
Zawiera checklistę cont_check | Długi tekst. | Włącza kontrolkę checklisty. Enter dodaje pozycję, Shift+Enter nową linię w pozycji, Tab zwiększa wcięcie, Shift+Tab zmniejsza. Kontrolka zapisuje strukturę listy; nie jest to dowolny tekst z wizualnie dopisanymi kwadratami. |
Wybierz jeden odpowiadający zawartości format specjalny. Gdy zaznaczysz kilka takich wariantów równocześnie, kontrolka nie łączy ich funkcji; kod ustawia jeden format. Nie używaj łącznie np. „Zawiera JSON” i „Zawiera checklistę”.
Liczby, zakresy dat i planowanie #
Atrybuty godzm, co15m, pok_proc, trend_ziel_ros, trend_czer_mal, dodaj_wal i lp opisuje osobny poradnik Pola liczbowe — procenty, trendy, czas trwania i numer kolejny. Przedstawia jednostki danych, precyzję, przykłady procentów i nadawanie numerów.
| Atrybut | Dostępność | Działanie i przykład |
|---|---|---|
Początek zakresu dat datst | Data lub data+godzina; niedostępny do dołączenia, gdy to samo pole jest już końcem zakresu. | Oznacza początek zakresu. Standardowy zapis pozostawia jeden początek w klasie. Razem z końcem uczestniczy w kontrolce zakresu i korekcie chronologii: przy zbyt późnym początku zapis może skorygować go do istniejącego końca. |
Koniec zakresu dat datkon | Data lub data+godzina; niedostępny do dołączenia, gdy to samo pole jest już początkiem zakresu. | Oznacza koniec zakresu, jeden w klasie. Przy dodaniu lub zmianie końca wcześniejszego od początku program może ustawić koniec na początek. Nie jest to zwykłe odrzucenie zapisu. Reguły działają przy standardowej walidacji obiektu. |
Zadania w terminarzu, które muszą być wykonane wcześniej prevobsch | Powiązanie wielu obiektów z tą samą klasą, do której należy pole. | Wskazuje poprzedzające zadania rysowane połączeniami w terminarzu. Jeden taki atrybut w klasie po standardowym zapisie. Sam nie planuje terminów następnego zadania. Zobacz Strona typu „Terminarz”. |
Zaawansowanie wykonania zadania w terminarzu progresssch | Liczba. | Dostarcza do terminarza wartość postępu 0–100. Nie jest proporcją 0–1 używaną przy zwykłym formatowaniu procentowym. Jeden taki atrybut w klasie po standardowym zapisie. Ustaw także odpowiednie minimum i maksimum pola. Zobacz Strona typu „Terminarz”. |
Atrybuty początku i końca pola nie zastępują wskazania filtrów dat w konfiguracji kalendarza i terminarza. Krok wyboru godziny również nie jest ustawieniem minimalnego czasu wydarzenia.
Powiązania, obiekty zależne i chmura #
| Atrybut | Dostępność | Działanie i przykład |
|---|---|---|
Indeks musi mieć wpisaną wartość indexwym | Pojedyncze powiązanie. | Standardowa walidacja wymaga niepustego powiązania. Ten atrybut uczestniczy także w mechanizmie porządkowania przy usuwaniu: usunięcie wskazanego obiektu może usunąć rekord zawierający pole. Nie oznacza indeksu SQL. Zobacz Pola powiązań — łączenie obiektów i wybór danych na formularzu i Kasowanie danych. |
Usuń bieżący obiekt (klucz pojedynczy) lub wyczyść wartość (klucz wielokrotny), jeśli obiekt wskazany w tym polu jest usuwany. indkaspow | Powiązanie pojedyncze lub wielokrotne. | Gdy usuwany jest obiekt wskazany w pojedynczym powiązaniu, usuwany jest również rekord zawierający to pole. Przy powiązaniu wielokrotnym usuwane ID jest usuwane z listy, a rekord pozostaje. Kierunek jest istotny: atrybut na polu „Pozycja → Dokument” określa skutek usuwania dokumentu dla pozycji. |
Buduj drzewko z tego powiązania inddrz | Pojedyncze powiązanie do tej samej klasy. | pole wskazuje rodzica w hierarchii. Po standardowym zapisie pozostaje jedno takie pole w klasie. Nie ustawiaj go na relacji do innej klasy. Zobacz Strona typu „Drzewko” — hierarchia i kolejność obiektów. |
Udostępnij w kartotece obiekt powiązany po tym polu udpowoo | Pojedyncze powiązanie do innej klasy. | Udostępnia dodatkowy obiekt w kontekście kartoteki, aby formularz mógł zawierać jego pola. Przy pustym powiązaniu może przygotować nowy obiekt; uzupełnienie jego pól i zapis formularza może go dodać i powiązać. Dla danej pary klas mechanizm pozostawia jedno pole z tym atrybutem. Nie jest to tylko odnośnik do otwarcia drugiego okna. Zobacz Pola powiązań — łączenie obiektów i wybór danych na formularzu. |
Przypisuj automatycznie powiązanie do tego pola wppowkl | pole z niepustą klasą docelową powiązania. | Pozwala funkcjom automatycznego wiązania wybrać pole zgodne z klasą wskazywanego obiektu. Działa w miejscach korzystających z tej funkcji, np. przy rejestrowaniu aktywności lub redagowaniu wiadomości. Nie przypisuje samoczynnie wszystkich rekordów klasy do dowolnego obiektu. Przy kilku pasujących polach funkcja wybiera pierwsze; nie oznaczaj bez potrzeby wielu relacji do tej samej klasy. |
Wstawiaj dla powiązanego obiektu dodatkowy wpis w chmurze powiązań 12 | Pojedyncze powiązanie. | Gdy obiekt zawierający to pole zostanie wskazany jako cel chmury, do tej samej chmury dopisywany jest także obiekt wskazany tym polem. Przykład: wskazanie zadania dodaje również jego projekt. Nie tworzy kopii obiektu ani automatycznie wszystkich relacji odwrotnych. Zobacz Chmura powiązań na formularzu. |
Przy usuwaniu użytkownika podmień na następcę 5 | pole wskazujące klasę „Użytkownik” (2). | Oznacza pola proponowane do podmiany na następcę podczas usuwania/wyłączania konta użytkownika. Operacja wymaga wybrania następcy i pól w odpowiednim formularzu; samo wyłączenie użytkownika dowolną inną drogą nie jest taką podmianą. Zobacz zarządzanie użytkownikami. |
Kopiowanie treści z plików PDF/DOCX extxtdata | Długi tekst / tekst dowolnie formatowany albo pojedyncze powiązanie z plikiem. | Mechanizm wymaga dwóch pól jednej klasy: źródła wskazującego plik PDF/DOCX i pola tekstowego na wynik. Standardowa walidacja nie dopuszcza więcej niż dwóch pól z tym atrybutem. Nie dotyczy powiązania wielu plików ani automatycznego OCR dowolnego skanu. Zobacz Pliki i obrazy na formularzu — dodawanie, powiązania i podgląd. |
Kopiowanie i scalanie #
Przy kopiowaniu znaczenie mają Jeśli kopiujemy obiekt, to wartości tego pola nie kopiujemy (wstawiamy domyślną) (nkopkop) oraz Jeśli obiekt, do którego jest to klucz, jest kopiowany, skopiuj również ten wiersz, podmieniając index na ID primary kopii (indkopkop). Ich różny kierunek działania i przykłady opisano w instrukcji kopiowania. Dwa odrębne warianty scalania opisuje Scalanie obiektów — łączenie i uzupełnianie wartości pól. Kopiowanie tworzy nowy obiekt, a scalanie przenosi dane do już istniejącego — nie należy utożsamiać tych reguł.
Systemowe powiązanie z dowolną klasą #
| Atrybut | Dostępność | Działanie i przykład |
|---|---|---|
pole określa typ powiązania do dowolnej klasy factory typobfactr | pole z klasą docelową „Klasa” (208). | Systemowe oznaczenie pola przechowującego identyfikator klasy powiązanego obiektu. Współpracuje z osobnym polem identyfikatora obiektu i kodem konkretnej funkcji. |
pole zawiera id dowolnego obiektu factory idobfactr | Linijka tekstu. | Systemowe oznaczenie identyfikatora obiektu, którego klasę określa drugie pole. Nie jest samodzielnym zwykłym powiązaniem do jednej klasy. Nie dodawaj takiej pary do dowolnej klasy w oczekiwaniu automatycznego pełnego selektora; wymagana jest obsługa przez właściwą funkcję programu. |
Lista atrybutów dopuszcza niektóre warianty szerzej, niż ma to sens użytkowy. Na przykład zapis historii w powiązanym obiekcie wymaga rzeczywistej relacji. Wybór powinien wynikać z opisanej funkcji i rodzaju pola, a nie z samej obecności pozycji na liście. Ogólne rodzaje pól opisuje Klasy i pola w programie bs4 core.
Atrybuty elementu — szczegółowe zasady #
Ustawienia opisane w tym artykule dotyczą definicji pola klasy. Wymagalność konkretnej kontrolki, zapis po zmianie, pamiętanie wpisu, ikona schowka i wyłączenie edycji należą natomiast do pola „Atrybuty elementu” na formularzu. Zobacz Atrybuty elementów formularza — dostępność, zapis i wygląd.
