Поля та віджети¶
Поля структурують моделі бази даних. Якщо ви уявляєте модель у вигляді таблиці або електронної таблиці, поля - це стовпці, у яких зберігаються дані в записах (тобто рядки). Поля також визначають тип даних, які в них зберігаються. Спосіб представлення та форматування даних у UI визначається їхнім віджетом.
З технічної точки зору в Odoo існує 15 типів полів. Однак ви можете вибрати з 20 полів у Studio, оскільки деякі типи полів доступні кілька разів за допомогою іншого віджета за замовчуванням.
Прості поля¶
Прості поля містять основні значення, такі як текст, числа, файли тощо.
Примітка
Віджети не за замовчуванням, якщо вони доступні, представлені як маркери нижче.
Текст (char)¶
Поле Текст використовується для короткого тексту, що містить будь-який символ. При заповненні поля відображається один текстовий рядок.
Значок: відображає значення всередині округленої форми, схожої на тег. Значення не можна редагувати в інтерфейсі користувача, але можна встановити значення за умовчанням.
Копіювати в буфер обміну: користувачі можуть скопіювати значення, натиснувши кнопку.
Електронна пошта: значення стає посиланням mailto, яке можна натиснути.
Зображення: відображає зображення за допомогою URL-адреси. Значення не можна редагувати вручну, але можна встановити значення за умовчанням.
Примітка
Це працює інакше, ніж безпосередній вибір поля зображення, оскільки зображення не зберігається в Odoo під час використання поля Текст із віджетом Image. Наприклад, це може бути корисно, якщо ви хочете заощадити місце на диску.
Телефон: значення стає посиланням tel, яке можна натиснути.
Порада
Поставте прапорець Увімкнути SMS, щоб додати опцію надсилання SMS безпосередньо з Odoo поруч із полем.
URL: значення стає URL-адресою, яку можна натиснути.
Example
Багаторядковий текст (text)¶
Поле Багаторядковий текст використовується для довшого тексту, що містить символи будь-якого типу. Під час заповнення поля в інтерфейсі користувача відображаються два рядки тексту.
Копіювати в буфер обміну: користувачі можуть скопіювати значення, натиснувши кнопку.
Example
Ціле число (integer)¶
Поле Ціле число використовується для всіх цілих чисел (додатній, від’ємний або нуль, без десяткової дроби).
Відсоткова діаграма: відображає значення в колі відсотків, як правило, для обчисленого значення. Значення не можна редагувати в інтерфейсі користувача, але можна встановити значення за умовчанням.
Діаграма прогресу: відображає значення поруч із шкалою у відсотках, зазвичай для обчисленого значення. Поле не можна редагувати вручну, але можна встановити значення за умовчанням.
Перетягування: відображає піктограму маркера перетягування, щоб упорядкувати записи вручну в Представлення списку.
Example
Десятковий (float)¶
Поле Десятковий використовується для всіх десяткових чисел (позитивних, від’ємних чи нуля з десятковою дробом).
Примітка
Десяткові числа відображаються з двома десятковими знаками після коми в інтерфейсі користувача, але вони зберігаються в базі даних з більшою точністю.
Грошове: це схоже на використання поля Грошове. Рекомендується використовувати пізніший, оскільки він пропонує більше функцій.
Відсоток: відображає символ відсотка
%після значення.Відсоткова діаграма: відображає значення в колі відсотків, як правило, для обчисленого значення. Поле не можна редагувати вручну, але можна встановити значення за умовчанням.
Діаграма прогресу: відображає значення поруч із шкалою у відсотках, зазвичай для обчисленого значення. Поле не можна редагувати вручну, але можна встановити значення за умовчанням.
Час: значення має відповідати формату hh:mm, максимум 59 хвилин.
Example
Грошовий (monetary)¶
Поле Грошовий використовується для всіх грошових значень.
Примітка
Коли ви вперше додаєте поле Грошовий, вам буде запропоновано додати поле Валюта, якщо воно ще не існує в моделі. Odoo пропонує додати для вас поле Валюта. Після додавання знову додайте поле Грошовий.
Example
Html (html)¶
Поле Html використовується для додавання тексту, який можна редагувати за допомогою HTML-редактора Odoo.
Багаторядковий текст: вимикає редактор HTML Odoo, щоб дозволити редагувати необроблений HTML.
Example
Дата (date)¶
Поле Дата використовується для вибору дати в календарі.
Дні, що залишилися: відображається кількість днів, що залишилася до вибраної дати (наприклад, Через 5 днів) на основі поточної дати.
Example
Дата й час (datetime)¶
Поле Дата й час використовується для вибору дати в календарі та часу на годиннику. Якщо час не встановлено, автоматично використовується поточний час користувача.
Дата: використовується для запису часу без його відображення в інтерфейсі користувача.
Дні, що залишилися: відображає кількість днів, що залишилися до вибраної дати (наприклад, Через 5 днів), на основі поточної дати та часу.
Example
Прапорець („boolean`)¶
Поле Прапорець використовується, коли значення має бути лише істинним або хибним, що вказується встановленням або зняттям прапорця.
Кнопка: відображає перемикач. Віджет працює без переходу в режим редагування.
Перемикач: відображає кнопку перемикання. Віджет працює без переходу в режим редагування.
Example
Вибір (selection)¶
Поле Вибір використовується, коли користувачі повинні вибрати одне значення з групи попередньо визначених значень.
Значок: відображає значення всередині округленої форми, схожої на тег. Значення не можна редагувати в інтерфейсі користувача, але можна встановити значення за умовчанням.
Значки: відображає всі значення, які можна вибрати, одночасно всередині прямокутних форм, організованих горизонтально.
Пріоритет: замість значень відображає символи зірочок, які можна використовувати, наприклад, для позначення важливості чи рівня задоволення. Це має той самий ефект, що й вибір пріоритетного поля, хоча для останнього вже визначено чотири значення пріоритету.
Прапорець: відображає всі доступні для вибору значення одночасно з прапорцями.
Порада
За замовчуванням прапорці організовані вертикально. Позначте відображати горизонтально, щоб змінити спосіб їх відображення.
Example
Пріоритет (selection)¶
Поле Пріоритет використовується для відображення тризіркової системи оцінювання, яка може бути використана для визначення важливості або рівня задоволення. Цей тип поля є Поле вибору з віджетом Пріоритет, вибраним за замовчуванням і чотирма попередньо визначеними значеннями пріоритету. Отже, віджети Значок, Значки, Прапорець і Вибір мають такі самі ефекти, як описано в Вибір.
Порада
Щоб змінити кількість доступних зірочок шляхом додавання чи видалення значень, натисніть Змінити значення. Зауважте, що перше значення дорівнює 0 зіркам (тобто, якщо не зроблено жодного вибору), тому наявність чотирьох значень призводить, наприклад, до трьохзіркової системи оцінювання.
Example
Файл (binary)¶
Поле Файл використовується для завантаження будь-якого типу файлу або підписання форми (Підпис віджет).
Зображення: користувачі можуть завантажувати файл зображення, який потім відображається у Представлення форми. Це має той самий ефект, що й використання Поля зображення.
Перегляд PDF: користувачі можуть завантажити файл PDF, який потім можна переглядати з Представлення форми.
Підпис: користувачі можуть підписати форму електронно. Це має той самий ефект, що й вибір Поля підписа.
Example
Зображення (binary)¶
Поле Зображення використовується для завантаження зображення та його відображення у Представлення форми. Цей тип поля є Поле файлу з віджетом Зображення, вибраним за замовчуванням. Отже, віджети Файл, Переглядач PDF і Підпис мають такі самі ефекти, як описано в Файл.
Порада
Щоб змінити розмір відображення завантажених зображень, виберіть Маленький, Середній або Великий у параметрі Розмір.
Підпис (binary)¶
Поле Підпис використовується для електронного підпису форми. Цей тип поля є Поле файлу з віджетом Підпис, вибраним за умовчанням. Отже, віджети Файл, Зображення та Перегляд PDF мають такі самі ефекти, як описано в Файл.
Порада
Щоб надати користувачам опцію Автоматично під час створення свого підпису, виберіть одне з доступних полів Автозаповнення з (Текст, Many2One та Пов’язане поле лише для моделі). Підпис створюється автоматично з використанням даних із вибраного поля.
Реляційні поля¶
Реляційні поля використовуються для зв’язування та відображення даних із записів іншої моделі.
Примітка
Віджети не за замовчуванням, якщо вони доступні, представлені як маркери нижче.
Many2One (many2one)¶
Поле Many2One використовується для зв’язування іншого запису (з іншої моделі) із записом, який редагується. Назва запису з іншої моделі потім відображається на записі, який редагується.
Example
У моделі Замовлення на продаж поле Клієнт є полем Many2One, яке вказує на модель Контакт. Це дозволяє зв’язати багато замовлень на продаж з одним контактом (клієнтом).
Порада
Щоб заборонити користувачам створювати новий запис у пов’язаній моделі, поставте прапорець Вимкнути створення.
Щоб заборонити користувачам відкривати записи у спливаючому вікні, поставте прапорець Вимкнути відкриття.
Щоб допомогти користувачам вибрати правильний запис, натисніть Домен, щоб створити фільтр.
Значок: відображає значення всередині округленої форми, схожої на тег. Значення не можна редагувати в інтерфейсі користувача.
Прапорець: відображає всі доступні для вибору значення одночасно з прапорцями.
One2Many (one2many)¶
Поле One2Many використовується для відображення існуючих зв’язків між записом поточної моделі та кількома записами іншої моделі.
Example
Ви можете додати поле One2Many до моделі Контакт, щоб переглянути багато замовлень на продаж одного клієнта.
Примітка
Щоб використовувати поле One2Many, дві моделі вже повинні бути пов’язані за допомогою поля Many2One. Відношення One2Many не існують незалежно: виконується зворотний пошук існуючих зв’язків Many2One.
Рядки (one2many)¶
Поле Рядки використовується для створення таблиці з рядками та стовпцями (наприклад, рядки продуктів у замовленні на продаж).
Порада
Щоб змінити стовпці, клацніть поле Рядки, а потім Редагувати представлення список. Щоб редагувати форму, яка з’являється, коли користувач натискає Додати рядок, клацніть натомість Редагувати представлення форми.
Example
Many2Many (many2many)¶
Поле Many2Many використовується для зв’язування кількох записів з іншої моделі з кількома записами в поточній моделі. Поля Many2Many можуть використовувати Вимкнути створення, Вимкнути відкриття, Домен, як і Поля Many2One.
Example
У моделі Завдання поле Виконавці є полем Many2Many, яке вказує на модель Контакт. Це дозволяє одному користувачеві призначати багато завдань, а багатьом користувачам призначати одне завдання.
Прапорці: користувачі можуть вибрати кілька значень за допомогою прапорців.
Теги: користувачі можуть вибирати кілька значень, що відображаються в закруглених формах, також відомих як теги. Це має той самий ефект, що й вибір поля Теги.
Теги (many2many)¶
Поле Теги використовується для відображення кількох значень з іншої моделі, що з’являються в округлих формах, також відомих як теги. Цей тип поля є полем Many2Many з віджетом Теги, вибраним за замовчуванням. Отже, віджети Прапорці і Many2Many мають такі самі ефекти, як описано в Many2Many.
Порада
Щоб відображати теги з різними кольорами тла, поставте прапорець Використовувати кольори.
Example
Властивості¶
Невидимий: якщо користувачам не потрібно переглядати поле в інтерфейсі користувача, поставте прапорець Невидимий. Це допомагає очистити інтерфейс користувача, показуючи лише важливі поля залежно від конкретної ситуації.
Example
У представленні Форма моделі Контакт поле Назва з’являється лише тоді, коли вибрано Індивідуальний, оскільки це поле не буде корисним для контакту Компанія.
Примітка
Атрибут Невидимий також застосовується до Studio. Щоб переглянути приховані поля в Studio, клацніть на вкладці представлення Представлення і встановіть прапорець Показати невидимі елементи.
Обов’язково: якщо користувач має завжди заповнювати поле, перш ніж мати можливість продовжити, позначте Обов’язково.
Лише читання: якщо користувачі не повинні мати можливість змінювати поле, поставте прапорець Лише читання.
Примітка
Ви можете застосувати ці три властивості лише до певних записів, натиснувши Умовний і створивши фільтр.
Мітка: Мітка - це назва поля в інтерфейсі користувача.
Примітка
Це не те саме ім’я, яке використовується в базі даних PostgreSQL. Щоб переглянути та змінити останній, активуйте режим розробника та відредагуйте Технічна назва.
Довідкова підказка: щоб пояснити призначення поля, напишіть опис у Довідкова підказка. Він відображається у вікні спливаючої підказки, якщо навести вказівник миші на позначку поля.
Заповнювач: щоб надати приклад того, як має бути заповнене поле, напишіть його під Заповнювач. Воно відображається світло-сірим кольором замість значення поля.
Віджет: щоб змінити типовий вигляд або функціональність поля, виберіть один із доступних віджетів.
Значення за замовчуванням: Щоб додати значення за замовчуванням до поля під час створення запису, використовуйте Значення за замовчуванням.
Обмежити видимість груп: щоб обмежити, які користувачі можуть бачити поле, виберіть групу доступу користувача.