Wprowadzenie
Jeżeli zdarzyło Ci się kiedyś zapisać formularz w Odoo i zobaczyć, że jakieś pole podświetliło się na czerwono, zetknąłeś się z mechanizmem pól obowiązkowych. To prosty, ale bardzo skuteczny sposób, by wymusić kompletność danych w codziennych procesach firmy.
Niezależnie od tego, czy konfigurujesz system dla działu sprzedaży, tworzysz własny model czy realizujesz projekt deweloperski, znajomość działania atrybutu required pozwoli Ci zaprojektować stabilniejsze i mniej zawodzące procesy.
Ten przewodnik wyjaśnia najważniejsze kwestie: jak pole zachowuje się w ramach Odoo, jak je ustawić przy użyciu Odoo Studio lub kodu Python, kiedy warto z niego korzystać i które błędy najczęściej się zdarzają.
Czym jest pole wymagane w Odoo
W Odoo atrybut required to ustawienie na poziomie pola, które blokuje zapis rekordu, jeśli pole nie posiada wartości. Dotyczy praktycznie wszystkich typów pól: tekstowych, liczbowych, wyboru, many2one, dat i innych.
To element rdzenia modelu danych Odoo i jedno z podstawowych narzędzi w customizacji. Oznaczenie pola jako obowiązkowego to pierwsza linia obrony przed brakami i niespójnościami w bazie danych.
Jak wygląda to w interfejsie
W interfejsie Odoo pola obowiązkowe są odróżniane wizualnie od opcjonalnych. W trybie edycji system pokazuje jasną wskazówkę, a jeśli użytkownik próbuje zapisać formularz bez wartości w takim polu, pole zostaje wyróżnione na czerwono i pojawia się komunikat ostrzegawczy.
Taka natychmiastowa informacja zwrotna w przeglądarce sprawia, że użytkownicy szybciej uzupełniają brakujące dane i rzadziej zapisują niekompletne rekordy.
Pola wymagane — statyczne i warunkowe
W Odoo możemy ustawić pole jako wymagane na stałe (zawsze obowiązkowe) albo warunkowo — gdy spełniony jest określony warunek zależny od innych pól rekordu.
Obie metody są powszechnie stosowane; wybór zależy od logiki biznesowej, którą chcesz odwzorować.
Jak działa to pole
Techniczne szczegóły działania required
Egzekwowanie na poziomie aplikacji
Ważna rzecz, która zaskakuje wiele osób: validacja pola required odbywa się na poziomie aplikacji Odoo, nie domyślnie na poziomie bazy danych. Oznacza to, że to warstwa ORM sprawdza wymóg przed zapisaniem rekordu.
Ustawienie required=True nie tworzy automatycznie ograniczenia NOT NULL w kolumnie PostgreSQL — weryfikacja odbywa się w Pythonie w warstwie Odoo ORM.
W praktyce oznacza to, że dane wprowadzone bezpośrednio do bazy (pomijając Odoo) nie zostaną sprawdzone względem tego ograniczenia. Dlatego zawsze warto korzystać z ORM lub oficjalnego API, aby zachować integralność danych.
Co się dzieje, gdy ograniczenie jest złamane
Przy próbie zapisu formularza z pustym polem wymaganym występują dwie obserwowalne rzeczy:
- pole zostaje wyróżnione w interfejsie i Odoo pokazuje komunikat walidacji,
- operacja zapisu jest zablokowana do momentu wypełnienia pola.
Jeśli walidacja uruchomiona jest programowo (np. przez XML-RPC lub akcję serwerową), ORM podniesie ValidationError z informacją, które pole jest puste.
Wymagane warunkowo przy użyciu wyrażeń w widoku
W Odoo można wymusić pole warunkowo na poziomie widoku za pomocą wyrażeń w atrybutach pól. W starszych wersjach robi się to przez attrs w XML widoku,
np. jako regułę sprawdzającą, kiedy pole ma być obowiązkowe względem wartości innego pola.
W nowszych wydaniach składnia widoków została uproszczona i dopuszcza bezpośrednie wyrażenia required w tagu pola,
co ułatwia czytelność i utrzymanie widoków.
Pamiętaj jednak: reguły umieszczone w widoku działają tylko w kontekście tego konkretnego widoku. Gdy potrzebujesz twardego, uniwersalnego wymogu, musisz ustawić required na poziomie modelu w Pythonie.
Jak to współgra z ORM i API
Przy wywołaniach create() i write() ORM sprawdza pola z required=True — jeśli brakuje wartości lub jest ona False, podniesiony zostanie ValidationError i operacja się nie wykona.
To samo dotyczy tworzenia rekordów przez XML-RPC: jeśli model wymaga pola, musisz je podać w danych przekazywanych do create(), inaczej dostaniesz błąd.
Przykłady zastosowań w firmie
Gdzie w praktyce warto używać pól obowiązkowych — pięć przykładów
1. CRM: segment klienta obowiązkowy na leadach
Zespół sprzedaży chce, by każdy lead miał przypisany segment klienta zanim trafi do lejka. Bez wymogu handlowcy często pomijają ten krok, co utrudnia późniejsze raportowanie.
Ustawienie pola wyboru "Segment klienta" jako obowiązkowego na formularzu leadu gwarantuje, że informacja zostanie złapana przy pierwszym kontakcie — bez segmentu nie zapiszesz leada.
2. Sprzedaż: adres dostawy obowiązkowy na zamówieniach
Firmy wysyłające towary muszą mieć pewność, gdzie wysyłają zamówienia. W niektórych konfiguracjach Odoo pole adresu dostawy może nie być domyślnie wymagane, co pozwala na potwierdzanie zamówień bez tej informacji.
Oznaczenie adresu dostawy jako obowiązkowego uniemożliwia potwierdzenie zamówienia bez danych logistycznych, co wyeliminuje częste błędy w realizacji wysyłek.
3. Magazyn: numer partii/seryjny wymagany przy przyjęciu
W branżach regulowanych (żywność, farmacja, elektronika) obowiązkowe śledzenie numerów partii jest koniecznością. Odoo obsługuje to natywnie przez ustawienia śledzenia produktu, co wymusza podanie numeru przy ruchach magazynowych.
Dla niestandardowych pól np. referencji kontroli jakości wartość obowiązkowa na formularzu przyjęcia gwarantuje, że zespół magazynowy nie pominie tej informacji.
4. Księgowość: centrum kosztów wymagane na fakturach zakupu
Działy finansowe często muszą przypisać każdy koszt do określonego centrum kosztów. Bez wymuszenia pole może pozostać puste, co psuje raporty budżetowe.
Dodanie many2one wskazującego na model centrum kosztów jako pola obowiązkowego na fakturze skutecznie blokuje księgowanie bez tej klasyfikacji — prosty zabieg o dużym wpływie na jakość danych.
5. HR: typ umowy wymagany przed onboardingiem
Działy HR chcą mieć pewność, że typ umowy jest zarejestrowany zanim pracownik zostanie w pełni wprowadzony do systemu. Obowiązkowe pole na karcie pracownika uniemożliwia zapisanie niekompletnego rekordu w pośpiechu.
Tworzenie i dostosowywanie pola
Sposoby ustawiania pola jako obowiązkowego
Dwa główne podejścia to użycie Odoo Studio (no-code) lub modyfikacja modelu w Pythonie (kod). Oba mają swoje miejsce w zależności od potrzeb.
Korzystanie z Odoo Studio
Odoo Studio pozwala w prosty sposób oznaczyć pole jako obowiązkowe — wystarczy włączyć przełącznik "Required" w panelu właściwości pola na formularzu.
To najszybsza metoda dla prostych przypadków, nie wymaga programowania i działa dla pól standardowych i tych dodanych przez Studio. Minusem jest ograniczenie do statycznego wymogu — dla warunkowego zachowania trzeba edytować XML widoku lub użyć podejścia technicznego.
Podejście techniczne: pola w Pythonie
W module niestandardowym pole oznacza się przez required=True w definicji pola — to standardowy sposób w deweloperskim kodzie Odoo.
Przykład definicji pokazuje, jak dodać pole wyboru i many2one z wymaganiem, by walidacja była egzekwowana na poziomie modelu.
Taka declaracja sprawia, że reguła obowiązuje niezależnie od tego, z którego widoku lub interfejsu rekord jest tworzony — nie da się jej łatwo obejść.
Wymóg warunkowy w XML widoku
Gdy pole powinno być obowiązkowe tylko w określonych sytuacjach, lepiej dodać regułę w widoku niż wymuszać ją na poziomie modelu.
W starszych wersjach używa się attrs z warunkami określającymi, kiedy pole jest wymagane.
W nowszych wersjach składnia widoku pozwala na prostsze wyrażenia required w tagu pola.
To rozwiązanie działa tylko, gdy użytkownik edytuje rekord przez widok zawierający tę definicję, dlatego jest mniej restrykcyjne niż required w Pythonie.
Tworzenie pól wymaganych przez API
Jeżeli automatycznie tworzasz pola przez XML-RPC, możesz ustawić required podczas wywołania create() na modelu ir.model.fields.
To przydatne w zautomatyzowanych procesach wdrożeniowych, gdzie pola są tworzone razem z wymogami walidacji.
Przykład ilustracyjny pokazuje strukturę danych wysyłanych do ir.model.fields z parametrem required=True.
Takie podejście umożliwia programatyczne tworzenie pól i od razu włączenie ochrony wymagalności w jednym kroku.
Zalecane praktyki
Zasady, które ułatwią pracę z polami wymaganymi
1. Wymagaj tylko tego, co faktycznie jest niezbędne
Najczęstszy błąd to nadmiar wymagań. Jeśli użytkownik nie ma zawsze dostępu do danej informacji przy pierwszym zapisie, będzie stosował obejścia (np. wpisywał placeholdery), co obniży jakość danych.
Zanim oznaczysz pole jako obowiązkowe, sprawdź: czy ta informacja jest dostępna zawsze przy tworzeniu rekordu? Jeśli nie, rozważ wymóg na późniejszym etapie (np. przy zatwierdzaniu) lub zastosuj wymóg warunkowy.
2. Walidacja etapowa zamiast od razu wszystkiego wymagać
W procesach wieloetapowych lepiej egzekwować wymagane pola przy konkretnych zmianach statusu zamiast od razu. Robi się to np. przez ograniczenia w Pythonie lub akcje automatyczne uruchamiane przy zmianie etapu.
To rozwiązanie jest bardziej elastyczne i przyjaźniejsze dla użytkowników.
3. Ustawiaj wartości domyślne tam, gdzie to sensowne
Jeśli pole jest zwykle uzupełniane tą samą wartością, nadaj mu default — obniży to potrzebę ręcznego wpisywania i zmniejszy opór użytkowników przy zapisie.
4. Wybieraj model-level required dla krytycznych danych
Dane naprawdę krytyczne (np. identyfikatory księgowe, informacje regulacyjne) lepiej chronić wymaganiem na poziomie modelu w Pythonie. Wymóg na poziomie widoku można obejść poprzez API lub inny widok.
5. Informuj użytkowników o zmianach
Jeśli dodajesz obowiązkowe pola do istniejących formularzy, ostrzeż użytkowników z wyprzedzeniem — inni mogą pracować na otwartych rekordach, które po zmianie będą już wymagać uzupełnienia.
6. Testuj z pustymi i częściowymi danymi
Przed wdrożeniem nowych wymogów przeprowadź testy z pustymi i częściowo wypełnionymi danymi przez web, API i integracje. To podstawowy krok przy wprowadzaniu zmian w modelu danych.
Typowe pułapki
Najczęstsze problemy związane z polami wymaganymi
Pułapka 1: dodanie required na modelu, który ma już dane
Jeśli aktywujesz required=True na modelu, który już zawiera tysiące rekordów bez wartości w tym polu, napotkasz problemy przy edycji istniejących rekordów — użytkownicy nie zapiszą zmian, dopóki nie uzupełnią nowego wymogu.
Przed wdrożeniem takiego ograniczenia sprawdź istniejące dane i rozważ migrację, aby najpierw wypełnić nowe pole.
Pułapka 2: mylenie wymogu w widoku z wymogiem w modelu
Oznaczenie pola jako wymagane tylko w widoku (Studio lub XML) nie chroni przed tworzeniem rekordów przez API, inny widok czy import — taki wymóg można obejść.
Jeżeli potrzebujesz twardej reguły, ustaw required=True w definicji pola w Pythonie.
Pułapka 3: pola wymagane w automatach i zadaniach harmonogramu
Automatyczne akcje i harmonogramy tworzące rekordy muszą dostarczać wartości dla wszystkich pól obowiązkowych. Jeśli skrypty powstały przed dodaniem wymogu, zaczną zawodzić lub generować błędy po jego wprowadzeniu.
Po dodaniu wymogu sprawdź i zmodyfikuj wszystkie miejsca, które programowo tworzą rekordy tego modelu.
Pułapka 4: importy danych bez wymaganych pól
Import CSV lub narzędziem Odoo nie powiedzie się, jeśli plik nie zawiera pól obowiązkowych. To poprawne zachowanie, ale może zaskoczyć osoby przyzwyczajone do częściowych importów.
Uwzględniaj zawsze pola obowiązkowe w szablonach importu i dokumentuj, które pola są wymagane.
Pułapka 5: używanie required zamiast złożonej walidacji w Pythonie
Atrybut required sprawdza jedynie obecność wartości, nie jej poprawność ani powiązania między polami. Dla bardziej skomplikowanych reguł (np. data musi być przyszła, wzajemna spójność pól) zastosuj @api.constrains w Pythonie.
Pole required nie zastąpi biznesowej logiki — próba jej zakodowania wyłącznie przez obowiązkowe pola prowadzi do sztywnych i trudnych w utrzymaniu rozwiązań.
Podsumowanie
Podsumowanie — dlaczego warto rozumieć pole required
Pole obowiązkowe to proste narzędzie, które znacząco wpływa na jakość danych. Gdy użyte rozsądnie, zapewnia, że krytyczne informacje są zbierane we właściwym momencie. Gdy użyte nieprzemyślanie, powoduje frustrację i prowizoryczne obejścia, które degradować będą dane.
Kluczowe jest rozróżnienie wymogów na poziomie modelu i widoku, staranne ustalenie, które pola naprawdę muszą być wymuszone, oraz przewidzenie skutków dla automatyzacji i integracji.
Potrzebujesz wsparcia przy wdrożeniu Odoo?
W Dasolo wspieramy firmy we wdrażaniu, adaptacji i optymalizacji Odoo na każdym etapie. Pomagamy projektować przejrzyste modele danych, wprowadzać poprawne reguły walidacji i budować moduły niestandardowe z myślą o stabilności i skalowalności.
Jeżeli masz pytania dotyczące pól wymaganych lub innych aspektów konfiguracji Odoo, chętnie pomożemy. Skontaktuj się z nami i porozmawiajmy o Twoim projekcie.