Для получения возможности редактирования объекта (осуществления 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 - имя колонки;
  • Объект — ссылка на обхект для которого создаётся колонка представления. Обычно это тот же объект, к которому привязано представление;
  • Заголовок — текст, выводимый в шапке колонки в списке экземпляров объекта;
  • Видимость — позволяет быстро скрыть колонку не удаляя её;
  • Свойство объекта — ссылка на свойство объекта, из которого будут браться данные для отображения в списке экземпляров;
  • Тип данных — обычно соответствует типу данных свойства объекта и определяет внешний вид отображаемых данных;
  • Имя поля — имя свойства в модели объекта;
  • Обработчик — зарегистрированный в системе скрипт особого типа, который отвечает за отображение данных в колонке представления;

Список колонок представления

27 июня 2013

Автор: Огнёв Иван

Комментарии (0)

Добавить комментарий