Создание атрибута класса

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

Чтобы создать атрибут класса:

В проекте выберите файл DataModel.mdmodel.
На боковой панели нажмите значок и выберите раздел Классы.
В списке классов выберите класс, в котором вы хотите добавить атрибут.

В правой части рабочей области отображается подробная информация о выбранном классе. Вкладка Атрибуты выбрана по умолчанию.
Справа от имени вкладки Атрибуты нажмите +.
В окне Атрибут, которое открывается, укажите следующие параметры:
- Имя (обязательный параметр): введите имя атрибута. Вы можете использовать символы кириллицы и латиницы, а также цифры. Имя атрибута используется для отображения в DevTools и не используется для именования сущностей в базе данных, которая будет создана согласно выбранной модели данных.
- Описание (необязательный параметр): введите описание атрибута. Вы можете использовать любые символы.
- Псевдоним (обязательный параметр): введите псевдоним атрибута. Псевдоним будет использоваться для именования атрибута в GraphQL-типах.
  
  При вводе значения этого параметра руководствуйтесь следующими требованиями:
  - используйте латинские буквы, цифры и знак подчеркивания;
  - не используйте цифру в качестве первого символа;
  - вводите строку длиной не более 63 символов;
  - не используйте системные имена C#.
- Тип атрибута (обязательный параметр): из раскрывающегося списка выберите один из следующих типов атрибута и укажите дополнительные параметры, соответствующие выбранному типу атрибута:
  - boolean: выберите для хранения какого-либо признака, например, принадлежности или наличия и укажите следующие параметры:
    - Значение по умолчанию: с помощью кнопки выбора выберите значение Истина или Ложь, которое должен принимать параметр по умолчанию. По умолчанию атрибуту будет присвоено значение Истина.
    - Значение может быть не определено: установите флажок, если вы хотите разрешить запись значения NULL в качестве значения этого атрибута.
  - string: выберите для хранения фрагмента текста и укажите следующие параметры:
    - Индексировать: установите флажок, если вы хотите, чтобы значение атрибута было проиндексировано с целью дальнейшего использования при полнотекстовом поиске.
    - Значение может быть не определено: установите флажок, если вы хотите разрешить запись значения NULL в качестве значения этого атрибута.
    - Записывать идентификатор пользователя: включите переключатель, если вы хотите записывать идентификатор пользователя разработанного приложения в качестве значения этого атрибута.
    - в блоке Длина строки укажите следующие параметры:
      - От (необязательный параметр): минимальная длина строки, которую можно ввести в качестве значения этого атрибута. Минимальная длина строки может составлять ноль символов, то есть строка может быть пустой.
      - До (необязательный параметр): максимальная длина строки, которую можно ввести в качестве значения этого атрибута. Максимальная длина строки может составлять 10485760 символов.
      Если вы не укажете значения параметров От и До, по умолчанию максимальная длина строки будет составлять 255 символов.
    - Регулярное выражение (необязательный параметр): введите шаблон для строки. Например, вы можете использовать следующие шаблоны:
      - ^((\+?7|8)[ \-] ?)?(($\d{3}$)|(\d{3}))?([ \-])?(\d{3}[\- ]?\d{2}[\- ]?\d{2})$ для российского номера телефона;
      - /[-a-zA-Z0-9@:%_\+.~#?&//=]{2,256}\.[a-z]{2,4}\b(\/[-a-zA-Z0-9@:%_\+.~#?&//=]*)?/gi для URL-адреса.
  - text: выберите для хранения фрагмента текста неограниченной длины более 10485760 символов и укажите следующие параметры:
    - Индексировать: установите флажок, если вы хотите, чтобы значение атрибута было проиндексировано с целью дальнейшего использования при полнотекстовом поиске.
  - integer: выберите для хранения целого числового значения со знаком и укажите следующие параметры:
    - Значение может быть не определено: установите флажок, если вы хотите разрешить запись значения NULL в качестве значения этого атрибута.
    - в блоке Диапазон значений укажите следующие параметры:
      - От (необязательный параметр): минимальное число, которое можно будет ввести в качестве значения этого атрибута.
      - До (необязательный параметр): максимальное число, которое можно будет ввести в качестве значения этого атрибута.
    Если вы не укажете значения параметров От и До, по умолчанию в качестве значения атрибута, можно будет хранить число в диапазоне от -2147483648 до +2147483647.
  - long: выберите для хранения числового значения со знаком и укажите следующие параметры:
    - Значение может быть не определено: установите флажок, если вы хотите разрешить запись значения NULL в качестве значения этого атрибута.
    - в блоке Диапазон значений укажите следующие параметры:
      - От (необязательный параметр): минимальное число, которое можно будет ввести в качестве значения этого атрибута.
      - До (необязательный параметр): максимальное число, которое можно будет ввести в качестве значения этого атрибута.
    Если вы не укажете значения параметров От и До, по умолчанию в качестве значения атрибута, можно будет хранить число в диапазоне от -9223372036854775808 до +9223372036854775807.
  - double: выберите для хранения числа с плавающей запятой с двойной точностью и укажите следующие параметры:
    - Значение может быть не определено: установите флажок, если вы хотите разрешить запись значения NULL в качестве значения этого атрибута.
    - Десятичных знаков (обязательный параметр): количество десятичных знаков числа. Вы можете указать до 15 знаков.
    - в блоке Диапазон значений укажите следующие параметры:
      - От (необязательный параметр): минимальное число, которое можно будет ввести в качестве значения этого атрибута.
      - До (необязательный параметр): максимальное число, которое можно будет ввести в качестве значения этого атрибута.
    Если вы не укажете значения параметров От и До, по умолчанию в качестве значения атрибута, можно будет хранить число в диапазоне от -10³⁰⁷ до +10³⁰⁸.
  - dateTime: выберите для хранения даты и времени и укажите следующие параметры:
    - Дата: включите переключатель, если вы хотите хранить только дату.
    - Дата и время: включите переключатель, если вы хотите хранить дату и время.
    - Значение может быть не определено: установите флажок, если вы хотите разрешить запись значения NULL в качестве значения этого атрибута.
    - Tекущее время (необязательный параметр): включите переключатель, если вы хотите в качестве значения этого атрибута записывать текущую системную метку времени, содержащую год, месяц, день, час, минуты и секунды, используя локальный часовой пояс. Этот параметр атрибута может использоваться, если в разрабатываемом приложении нужно фиксировать, например, момент создания заказа или момент изменения статуса заказа.
    - Игнорировать временную зону: установите флажок, если вы хотите хранить значение атрибута согласно стандарту UTC.
  - enum: выберите для хранения одного из значений ранее созданного перечисления и укажите следующие параметры:
    - Перечисление (обязательный параметр): из раскрывающегося списка выберите имя перечисления, созданного в текущем экземпляре Атомкод.
    - Значение по умолчанию: из раскрывающегося списка выберите значение указанного перечисления, которое будет использоваться по умолчанию.
    - Значение может быть не определено: установите флажок, если вы хотите разрешить запись значения NULL в качестве значения этого атрибута.
  - MLString: выберите для хранения локализованных значений атрибута в зависимости от локали браузера, в котором будет запущено разработанное приложение.
  - Money: выберите для хранения денежных величин и укажите следующие параметры:
    - в блоке Диапазон значений укажите следующие параметры:
      - От (необязательный параметр): минимальное число, которое можно будет ввести в качестве значения этого атрибута.
      - До (необязательный параметр): максимальное число, которое можно будет ввести в качестве значения этого атрибута.
    - Значение по умолчанию: значение, которое будет присвоено атрибуту, если значение атрибута не будет указано при вводе.
    - Значение может быть не определено: установите флажок, если вы хотите разрешить запись значения NULL в качестве значения этого атрибута.
    Если вы не укажете значения параметров От и До, по умолчанию в качестве значения атрибута можно будет хранить число в диапазоне от -10³⁸ + 1 до 10³⁸ - 1.
  - guid: выберите для присваивания и хранения уникальных значений в виде 128-битного идентификатора. Вы можете использовать этот тип, например, для хранения кодов изделий. Укажите следующие параметры:
    - Значение по умолчанию: значение, которое будет присвоено атрибуту, если значение атрибута не будет указано при вводе.
    - Значение может быть не определено: установите флажок, если вы хотите разрешить запись значения NULL в качестве значения этого атрибута.
  - <имя пользовательского типа>: выберите для хранения значения пользовательского типа, который вы определили в модели данных проекта.
    
    Если вы хотите, чтобы значение атрибута было проиндексировано с целью дальнейшего использования при полнотекстовом поиске, установите флажок Индексировать.
  - array: выберите для хранения массива значений и укажите следующие параметры:
    - Тип данных элементов (обязательный параметр): по аналогии с раскрывающимся списком для параметра Тип атрибута (см. описание выше) выберите значение из раскрывающегося списка. Список содержит те же типы, что и типы атрибутов, за исключением MLString и array. Если в качестве типов данных элементов вы выбрали text или string, укажите также следующий параметр:
    - Индексировать: установите флажок, если вы хотите, чтобы значение атрибута было проиндексировано с целью дальнейшего использования при полнотекстовом поиске.
Нажмите Создать.

Окно Атрибут закрывается.

Созданный атрибут класса отображается в области подробной информации о классе. Теперь на основе созданных атрибутов вы можете создавать индексы и/или связывать классы.