Для получения возможности редактирования объекта (осуществления CRUD-операций) в системе управления ygin необходимо создать представление. Один объект может иметь множество представлений. Представление хранит информацию о свойствах объекта, отображаемых в списке экземпляров, а также о порядке их сортировки.
Создание представления возможно двумя способами:
- Автоматизированно через редактирование объекта;
- Вручную последовательно создавая представление и его свойства.
В большинстве случаев проще всего создать представление автоматизированно, а затем скорректировать его вручную, поэтому мы рекомендуем именно такую последовательность действий.
Автоматизированное создание представления
Чтобы автоматизированно создать представление объекта необходимо сперва создать сам объект со всеми его свойствами, а затем перейти к редактированию объекта. После нажатия на кнопку "Дополнительные характеристики", ставим галочку "Создать представление".
Заполняем название представления, которое будет отображаться в меню в системе управления и отмечаем галочками свойства, которые войдут в это представление. После нажатия на "Сохранить" новое представление будет создано. В случае, когда у объекта только одно представление, можно не заполнять поле "Название представления", тогда отмечаемые свойства будут добавлены к существующему представлению.
При формировании представления списка экземпляров объекта стоит воздержаться от добавления свойств типа HTML-редактор или Текстовое поле, т.к. они потенциально могут содержать большие объёмы данных и перегружать список выводимой информацией.
Ручное создание и редактирование представления
Для того, чтобы увидеть список всех представлений объекта и отредактировать нужно, самым простым способом является переход к ним через связанные сущности от самого объекта.
Рассмотрим характеристики самого представления:
id
— идентификатор представления на латинице, например: ygin.news.view.main, где ygin - название проекта, news - название объекта, main - название представления;css-класс иконки
— класс, добавляемый тегу представления в меню системы управления ygin. Это может быть как класс иконки из Twitter Bootstrap, так и произвольный класс, определяемый разработчиком;Иерархия по полю
— не известно;Имя представления
— название представления на любом языке, которое будет отображаться в меню в системе управления ygin, например, Новости;Видимость
— определяет видимость представления в меню системы управления. В случае отсутствия видимости, представление остаётся доступным по прямой ссылке;SELECT
— ручное определение списка полей базы данных или иные данные, которые будут вставлены в запрос вместо стандартных свойств представления;FROM
— ручное определение условия FROM, которое будет вставлено в запрос вместо стандартного;WHERE
— ручное определение условия WHERE, которое будет вставлено в запрос при формировании списка экземпляров объекта вместо стандартного;ORDER BY
— ручное определение направления порядка, которое будет вставлено в запрос при формировании списка экземпляров объекта вместо стандартного, например, date DESC;Экземпляров на странице
— определяет количество отображаемых экземпляров объекта на одной странице;
Ручное добавление/редактирование свойств представления
Колонки представления, отображаемые в списке экземпляров объекта, проще всего редактировать через связанные сущности от экземпляра представления.
Каждая колонка представления имеет ряд характеристик, определяющих её отображение.
id
— идентификатор колонки представления на латинице, например: ygin.news.view.main.title, где ygin - название проекта, news - название объекта, main - название представления, title - имя колонки;Объект
— ссылка на обхект для которого создаётся колонка представления. Обычно это тот же объект, к которому привязано представление;Заголовок
— текст, выводимый в шапке колонки в списке экземпляров объекта;Видимость
— позволяет быстро скрыть колонку не удаляя её;Свойство объекта
— ссылка на свойство объекта, из которого будут браться данные для отображения в списке экземпляров;Тип данных
— обычно соответствует типу данных свойства объекта и определяет внешний вид отображаемых данных;Имя поля
— имя свойства в модели объекта;Обработчик
— зарегистрированный в системе скрипт особого типа, который отвечает за отображение данных в колонке представления;
Комментарии (0)