Установка значений атрибутов по умолчанию

Значения по умолчанию, заданные для атрибутов каких-либо классов, используются для автозаполнения соответствующих полей на формах редактирования. Ранее значение по умолчанию для одного из атрибутов было указано при создании диаграммы классов - была указана текущая дата для атрибута “CreateDate” класса “Document”:

Класс Document

Такой синтаксис использутся для указания значения по умолчанию, которое будет использоваться в том случае, если соответствующее поле на форме редактирования не заполнено. Чаще всего такая потребность возникает при создании новой записи, у которой часть полей заполняется таким образом автоматически.

Помимо даты создания документа при создании нового заявления или накладной потребуется также проставлять им уникальный номер и автоматически устанавливать статус “Новый”. Для этого откроем список атрибутов класса “Документ”:

Document → [ПКМ] → ORM: Редактировать свойства → Атрибуты

Дефолтное значение даты создания класса Document

В открывшейся форме мы можем увидеть заданное по умолчанию значение для атрибута “CreateDate”. Установим следующие свойства для атрибута “Number”:

DefaultValue → 1,
Autoincrement → +,
NotNull → + (обязательно для автоинкремента).

Дефолтные значения атрибутов класса Document

После сохранения свойств атрибута “Number” класс на диаграмме будет иметь следующий вид:

Класс Document с автозаполнением


Самостоятельно измените свойства атрибутов следующих классов:

Order

Status ‒ New

Invoice

Status ‒ New

Storehouse

Number ‒ с 1, инкремент

Product

ProductCode ‒ с 1, инкремент

Employee

Number ‒ с 1, инкремент


После выполнения всех описанных выше действий диаграмму классов можно использовать для генерации как фронтенда, так и бэкенда. Не забудьте сохранить её по окончании работы.

Настройка вычислимых атрибутов

Ранее мы также создавали вычислимый атрибут на диаграмме классов ‒ это атрибут “TotalSum” (Стоимость заказа) класса “Order” (Заказ). Он помечен символом “/”:

Нехранимый атрибут TotalSum класса Order

Данный атрибут не будет храниться в БД. Но в нашем примере нехранимые атрибуты мы использовать не будем, т.к. как минимум в “Накладной” мы будем обращаться к подобным свойствам из кода. Поэтому проще их сохранять, чем пересчитывать каждый раз.

Сделаем свойство TotalSum у класса Order хранимым:

Возвращение хранимости атрибута TotalSum класса Order

Настройка типов данных

Настройка типов данных у атрибутов классов ‒ важный шаг, который определяет сопоставление типов данных для классов на диаграмме с классами в коде приложения или таблицами в базе данных, а также генерацию правил валидации в приложении. Рассмотрим в качестве примера класс “Invoice” (Накладная):

Поле ShipmentDateTime класса Invoice

В данном классе у атрибута “ShipmentDateTime” (“Дата и время отгрузки”) указан тип “DateTime”. В связи с этим, если при сохранении модели на бэкенде это поле будет пустым, то оно по умолчанию будет заполнено значением “01.01.1901”. Это связано с тем, что в C# значение типа “DateTime” не может принимать нулевые (null) значения: в момент сохранения записи происходит автоприсвоение минимального валидного значения (01.01.1901). Нас такое поведение не устраивает, так как это поле в принципе может быть пустым (не по каждой накладной может быть осуществлена отгрузка в заданный момент времени).

Для решения описанной выше проблемы необходимо сопоставить тип данных на диаграмме класов с типом данных “DateTime?” при генерации приложения на языке C#.

Проверим, есть ли такой вариант среди типов, доступных “из коробки” во Flexberry Designer. Для этого откроем карту типов:

Стадия (ember) → Ember → [ПКМ] → Свойства модели → Карта типов

Свойства модели

Карта типов модели

Мы можем увидеть, что в карте типов имеется три Nullable-типа: для даты, а также для целого и вещественного типа. Их можно использовать для решения подобной задачи, но, во-первых, не всегда необходимые Nullable-типы будут существовать в карте типов, а, во-вторых, всё-таки рекомендуется использовать стандартные типы языка C#, которые допускают значение null. Поэтому на примере данной ситуации разберем, как добавить свой собственный тип.

Добавим для новых типов данных отдельную диаграмму классов (Типы данных):

Создание диаграммы классов "Типы данных"

На созданной диаграмме создадим новый класс с именем “tDateTime” и стереотипом “typedef” (данный класс можно сразу свернуть, т.к. у него не будет никаких атрибутов и методов):

Создание типа данных tDateTime

Теперь нужно определить, с какими типами данных наш новый тип будет сопоставляться при генерации приложения. Для этого снова перейдем к карте типов:

Стадия (ember) → [ПКМ] → Ember → Свойства модели → Карта типов

Карта типов модели с типом tDateTime

После создания класса со стереотипом “typedef”, в карте типов появился соответствующий тип данных. Назначим ему значение System.DateTime? в поле “отображается в”. Поле “файл со сборкой” оставим пустым (для системных типов это поле заполнять не требуется).

Аналогичные действия нужно выполнить и в карте типов для базы данных (требуется указать сопоставление нового типа данных с типом TIMESTAMP(3)):

Стадия (ember) → [ПКМ] → Ember → Storage → PostgreSQL → Настройка БД → Карта типов

Карта типов БД PostgreSQL

Далее заменим соответствующие типы данных у атрибутов на диаграмме классов:

Карта типов БД

Итог

В результате всех проделанных ранее действий мы доработали диаграмму классов для генерации приложений и базы данных: настроены заголовки, порядок полей на формах, видимость полей на формах и т.п. Итоговый вариант диаграммы классов перед генерацией приложений и базы данных выглядит следующим образом:

Диаграмма классов "Сущности"

Перейти