Программный продукт «QP8.Framework» (стр. 7 )

Изменение свойств виртуального контента

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

в контекстном меню виртуального контента выбрать пункт «Свойства» (Properties), в списке виртуальных контентов выбрать требуемый контент и нажать кнопку «Свойства» (Properties). Удаление виртуального контента

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

в контекстном меню виртуального контента выбрать пункт «Удалить» (Remove), в списке виртуальных контентов выбрать требуемый контент и нажать кнопку «Удалить» (Remove).
Поле (Field)

После создания контента необходимо задать его структуру. Для этого применяются поля.

Примечание: при создании контента автоматически создаётся необязательное поле Title типа Строка. Допускается его изменение или удаление.

В ГПИ бэкенда и контекстного меню доступны следующие функции управления сайтами:

создание нового поля, копирование поля, изменение свойств поля, удаление поля. Создание нового поля

Создание поля выполняется одним из следующих способов:

выбрать раздел «Поля» (Fields), нажать «Добавить новое поле» (New Field); в контекстном меню раздела «Поля» выбрать пункт «Новое поле» (New Field).

Существует возможность автоматически расположить новое поле в списке полей после другого существующего поля.

Примечание: в форме создания поля будет автоматически задано значение свойства «Разместить» (Place).

Для создания смежного поля в контекстном меню существующего поля необходимо выбрать пункт «Новое смежное поле» (New Adjacent Field).

Свойства поля

Общие свойства (Basic parameters)

Название	Описание
Имя (Name)	Имя поля контента. Примечание: значение должно быть уникально в пределах контента.
Дружественное имя (Friendly Name)	Используется для задания понятного пользователю имени поля. Используется только в ГПИ бекэнда, выводится вместо значения «Имя поля».
Описание (Description)	Описание поля.
Тип поля (Field Type)	Выбор типа поля из списка поддерживаемых типов. При изменении существующего поля в списке возможных типов отображаются только совместимые типы.
Разместить (Place)	Расположение поля в списке полей в ГПИ бекэнда. Задаётся относительно существующих полей.
Использовать в фильтре дочернего контента (Use in child content filter)	Указатель, что поле должно быть доступно в качестве параметра фильтрации для фильтра данных в списке статей дочернего контента.
Является полем локализации (Is localization field)	Указатель, что поле требуется использовать в мультиязычном окружении. Примечание: используется при генерации классов LINQ to SQL.
Обязательное (Required)	Указатель, что пользователю перед сохранением статьи обязательно будет нужно заполнить поле. Поддерживается для всех типов полей, кроме: «Булевый», «Динамическое изображение». Опция поддерживается QP8 API.
Только чтение (Read-only)	Включает режим «Только чтение». Доступно только в ГПИ бекэнда.
Уникальное (Unique)	После установки данного флага значения поля в статьях будут проверяться на уникальность в пределах контента. Примечание: Уникальность поля проверяется в действующих контентах. Т. е. в архивных контентах уникальность не проверяется. Пустое поле также считается уникальным
В комбинации с (In combination with)	Позволяет задать правило уникальности на несколько полей.
Индексированное (Indexed)	Создает индекс на поле. Работает для всех типов полей, кроме: «Булевый», «Текстовое окно», «Визуальный редактор», «Связь» типа М2М. Примечание: для поля «Связь» типа О2М индекс создается всегда. Примечание: в SQL Server существует ограничение на максимальный размер индекса (900 байт, 450 символов в строке NVARCHAR).
Просмотреть в списке (View in list)	Позволяет выводить значение поля на странице со списком статей контента. Примечание: для полей «Текстовое окно» и «Визуальный редактор» выводятся первые 500 символов значения. Примечание: для полей «Связь» выводятся первые 4 значения (сортировка по идентификатору).
Разрешить OnScreen (Enable OnScreen)	Внимание: режим OnScreen существует только в предыдущих версиях продукта. Указатель, должна ли быть возможность работы с полем в режиме OnScreen. Включена по умолчанию для полей типа: «Строка», «Текстовое окно», «Визуальный редактор». ГПИ выводится при каждом вызове метода Field. Если это нежелательно, то следует использовать метод FieldNS. Режим доступен всех типов полей, кроме: «Связь» типа М2М, «Динамическое изображение».
Пересобрать виртуальные контенты (Rebuild virtual contents	Внимание: отключение автоматической пересборки виртуальных контентов требует оперативной пересборки содержащего поле контента в ручном режиме (из контекстного меню для контента). Указатель, требуется ли выполнять автоматическую пересборку виртуальных контентов, для которых поле является базовым.

Параметры отображения в LINQ-классы (LINQ Mapping Parameters)

Название	Описание
Отображать как LINQ-свойство (Map as LINQ Property)	Указатель, что требуется генерация свойства для поля.
Имя LINQ-свойства (LINQ Property Name)	Допустимое в С# имя поля. Используется в качестве названия свойства.

Для поля «Связь» типа M2M доступны следующие дополнительные свойства:

Название	Описание
Отображать узловую таблицу как класс (Map Junction Table as Class)	При включённой опции производится генерация класса для узловой таблицы.
Имя узлового LINQ-класса (единственное) (LINQ Junction Class Name (singular))	Допустимое в С# имя узловой таблицы, хранящей данные M2M-связи (в единственном числе). Используется в качестве названия класса.
Имя узлового LINQ-класса (множественное) (LINQ Junction Class Name (plural))	Допустимое в С# имя узловой таблицы, хранящей данные M2M-связи (во множественном числе). Используется в качестве названия свойства контекстного класса, с которого начинается построение запроса LINQ to SQL.

Параметры, зависящие от типа (Type-specific parameters)

Название

Описание

Значение по умолчанию (Default Value)

Значение, которое должно автоматически задаваться в поле при создании новой статьи. Используется для всех типов полей, кроме: «Связь» типа М2М, «Динамическое изображение». Опция поддерживается QP8 API. Примечание: для того чтобы присвоить значение по умолчанию полю для всех статей контента, необходимо вызвать контекстное меню поля, у которого задано в свойствах значение по умолчанию, и выбрать пункт «Apply Default Value»

Строка (String)

Короткое текстовое поле. Внутренний SQL-тип – NVARCHAR.

Примечание: следует помнить об ограничении в SQL Server на размер индексированного поля (900 байт или 450 символов NVARCHAR). Для больших объёмов текстовых данных рекомендуется использовать тип поля «Текстовое окно» или «Визуальный редактор».

Название	Описание
Размер поля (Size)	Максимальное количество символов для значения поля. Значение по умолчанию – 255 символов.
Использовать маску ввода (Use Input Mask)	Указатель, что для поля требуется применять маску ввода.
Тип маски ввода (Input Mask Type)	Выбор типа маски ввода: «Базовый» (Basic), «Настраиваемый» (Custom).
Маска ввода (Input Mask)	Для типа маски «Базовый» предлагается сделать выбор из готовых масок: «E-mail», «No white space», «Numbers only with spaces», «Numbers only without spaces», «Letters only with spaces», «Letters only without spaces». Для типа маски «Настраиваемый» предлагается задать собственное регулярное выражение для маски. Поддерживается QP8 API.

Число (Numeric)

Текстовое поле для ввода целых и вещественных чисел. Внутренний SQL-тип – NUMERIC.

Название	Описание
Целое (Integer)	Указатель, что число является целым.
Десятичные знаки (Decimal Places)	Количество знаков после запятой. Примечание: значение по умолчанию – 2.

Булевый (Boolean)

Поле с возможными значениями «Да» и «Нет». Внутренний SQL-тип – NUMERIC.

Дата (Date)

Поле допускает только календарную дату. Внутренний SQL-тип – DATETIME.

Время (Time)

Поле допускает только время. Внутренний SQL-тип – DATETIME.

Дата & время (Date & Time)

Поле, объединяющее возможности двух предыдущих типов. Внутренний SQL-тип – DATETIME.

Файл (File)

Позволяет привязать к статье файл. Внутренний SQL-тип – NVARCHAR(255).