Для получения возможности редактирования объекта (осуществления 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)