Карточки объектов

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

Настройка состава карточки

Для настройки состава карточки используется два системных справочника Типы карточек и Карточки:

_images/cards_lists.png

Справочник «Тип карточек»

_images/cards_list_types.png

Справочник Тип карточек - задает идентификатор для карточки определенного состава. Например, «Карточка сотрудника», «Карточка организации» - это разные типы карточек. Идентификатор карточки - используется для формирования URL, по которому будут открываться карточки объектов (см. далее), поэтому в качестве идентификатора рекомендуется использовать слово из латинских букв, например «person» или «company».

Справочник «Карточки»

_images/cards_list_cards.png

В справочнике Карточки описывается состав карточки для конкретного типа. Например, то что Карточка сотрудника должна содержать Имя, Фамилию, Отчество сотрудника, а Карточка организации - Адрес и Контактную информацию будет описано именно в этом справочнике. Кроме того, здесь же определяется расположение полей карточки на странице.

Каждая запись в справочнике описывает поле в соответствующем типе карточки:

  • Тип карточки определяет какой тип карточки описывается.

  • Строка карточки, Столбец карточки и Порядковый номер определяют положение поля в карточке.

  • Показатель, Отчет, Реестр, Форма, График, Дашборд определяют содержимое данного поля (может быть заполнено только одно из них).

  • Обязательно для заполнения - обязательность поля-показателя для заполнения при редактировании и создании объекта через карточку.

При формировании карточки сначала учитывается «Строка карточки», потом в рамках строки «Столбец карточки», и в рамках фиксированной строки и столбца - порядковый номер.

Например:

---------------------------
| п. номер   |  п. номер  |
| п. номер   |            |  <- строка карточки с двумя столбцами
---------------------------
|        |        |       |  <- строка карточки с тремя столбцами
---------------------------
|                         |  <- строка карточки с одним столбцом
---------------------------
  • Все элементы с одинаковой Строка карточки будут расположены горизонтально на одном уровне

  • Все элементы в рамках одной строки с одинаковым Столбцом карточки будут расположены визуально вертикально на одном уровне в рамках строки карточки. Все столбцы будут иметь равную ширину в рамках строки.

  • В рамках одной «Строки карточки» и одного столбца карточки элементы располагаются в соответствии с Порядковым номером

Примечание

Системный показатель «Название» всегда по умолчанию добавляется в карточку в виде заголовка.

Работа с карточкой

Просмотр информации об объекте

При переходе по адресам вида:

/card/Идентификатор типа карточки/id любого объекта/
/card/Идентификатор типа карточки/set/id справочника/id элемента справочника/

открывается карточка объекта на просмотр.

Например, при переходе по адресу:

/card/test/438/

откроется страница, на которой в соответствии со структурой, заданной в справочнике «Карточки» для типа карточки с идентификатором test, отобразится информация об объекте 438:

_images/cards_sample_view.png

Создание объекта

Нажатие на кнопку «создать» при просмотре карточки или переход по адресам вида:

/card/Идентификатор типа карточки/new/
/card/Идентификатор типа карточки/set/id справочника/new/

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

_images/cards_sample_new.png

После заполнения обязательных полей (обозначены красными звездочками, определяются полем Обязательно для заполнения в справочнике Карточки) и нажатия на кнопку Сохранить, объект сохраняется в системе и становится доступен на просмотр. При этом если карточка строится по справочнику (есть /set/id справочника/ в адресе), то объект сохраняется, как элемент соответствующего справочника.

Редактирование объекта

Нажатие на кнопку «Редактирование» или переход по адресам вида:

/card/Идентификатор типа карточки/id любого объекта/edit/
/card/Идентификатор типа карточки/set/id справочника/id элемента справочника/edit/

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

_images/cards_sample_edit.png

После заполнения обязательных полей (обозначены красными звездочками, определяются полем Обязательно для заполнения в справочнике Карточки) и нажатия на кнопку Сохранить, у объекта изменяются значения соответствующих показателей.

Удаление объекта

Нажатие на кнопку «удалить» полностью удаляет объект из системы. Объект не может быть удален, если он используется в каких-то других сущностях или данных.

Варианты использования карточек

После задания структуры карточки с помощью справочников Типы карточек и Карточки в системе становятся доступны адреса (url) вида:

/card/Идентификатор типа карточки/new/
/card/Идентификатор типа карточки/id любого объекта/
/card/Идентификатор типа карточки/id любого объекта/edit/
/card/Идентификатор типа карточки/set/id справочника/new/
/card/Идентификатор типа карточки/set/id справочника/id элемента справочника/
/card/Идентификатор типа карточки/set/id справочника/id элемента справочника/edit/

где

  • Идентификатор типа карточки - соответствующее поле из справочника Типы карточек

  • id любого объекта - это числовой идентификатор любого объекта в системе

  • id справочника - числовой идентификатор любого справочника

  • id элемента справочника - числовой идентификатор элемента справочника из предыдущего пункта

Ссылки с указанием конкретного справочника (содержащие «set») отличаются следующими функциями

  • в панели навигации будет отображаться кнопка открытия другого элемента справочника и кнопки для перехода к предыдущему и следующему элементу справочника

  • в отчеты, формы, реестры, графики и дашборды элемент по которому строится карточка будет подставлен в параметры если у сущности есть параметр с выбором из данного справочника.

Вывод картотеки в пункт меню

Карточку объектов можно вывести в пункт меню. Для этого необходимо добавить соответствующую строку в справочник Дерево меню. Кроме того, можно добавить возможность создания нового объекта через стандартный виджет «+». Подробнее см. Настройка главного меню.

Примечание

Для картотеки в главном меню желательно использовать карточки по справочникам (ссылки, содержащие «set»), для того чтобы пользователь мог свободно перемещаться по элементам при просмотре.

Переход на карточку из реестра

Карточку можно использовать как расширенную информацию по объекту в реестре, либо как форму для редактирования объекта в реестре. Для этого достаточно добавить соответствующую ссылку на столбец реестра, по клику на которую пользователь будет попадать на карточку. Подробнее см. Настройка источников