Классовая таблица данных
Данный компонент используется для редактирования и просмотра списка экземпляров класса. |  |
Классовая таблица данных, расположенная на инструментальной панели экземпляра класса, позволяет отображать подмножество экземпляров класса, связанных одной или несколькими связями. Создать связи между экземплярами можно с помощью диалогового окна Выберите связанные объекты, описанного ниже. Удаление связи между экземплярами выполняется путем выбора экземпляра и клика по кнопке удалить.
Элементы тулбара
Следующие элементы тулбара являются уникальными для компонента Классовая таблица данных.
Выберите связанные объекты
Данный элемент тулбара появляется в классовой таблице данных на инструментальной панели экземпляра класса когда основной класс настроен для создания связей многие ко многим, а свойство Показать кнопку создания связей имеет значение True.
 | Создать связи | Открывает окно, позволяющее создавать связи многие ко многим. |
Общие переменные (свойства)
[?]
Компонент Классовая таблица данных обладает следующими базовыми свойствами и группами свойств, которые являются общими для всех компонентов:
Имя, Дополнительные свойства, Свойства контейнера, Стили, Прелоадер, События, Привязки, Кебаб меню.
Наследуемые переменные (свойства)
Компонент Классовая таблица данных имеет в основе компонент Таблица данных, поэтому наследует общие с ним свойства.
Список экземпляров класса
Данное свойство определяет параметры списка экземпляров класса, которыми управляет данный компонент.
Имя переменной: | classInstanceListParameters |
Записи: | 1 |
Формат записи:
Имя поля | Тип поля | Примечания |
storageContext | String | Контекст хранилища. Путь к контексту хранилища экземпляров класса. |
storageView | String | Представление. Представление по умолчанию выбранного экземпляра класса. |
storageQuery | String | Пользовательский запрос. Пользовательский запрос на подготовку исходных данных. |
storageTable | String | Таблица. Пользовательский формат таблицы для выбранного экземпляра класса. |
storageFilter | Data Table | Фильтр. Определяет правила фильтрации для выбранного экземпляра класса. Вложенная таблица данных с несколькими полями:
|
storageSorting | Data Table | Сортировка. Определяет правила сортировки для выбранного экземпляра класса. Вложенная таблица данных с двумя полями:
|
relationField | String | Связь. Определяет поле, выбранное для связи с другими экземплярами класса. |
dropRelatedRecord | Boolean | Удалять связанную запись. Принимается во внимание, когда пользователь пытается удалить экземпляр класса из Классовой таблицы.
|
Связь и идентификатор экземпляра
Поведение компонента Классовая таблица данных изменяется в зависимости от настроек свойств relationField и instanceId. Понимание этого взаимодействия крайне важно при использовании компонента в инструментальных панелях, работающих со связанными экземплярами классов.
Если relationField не задано
Идентификатор экземпляра (instanceId) применяется непосредственно к классу, определенному параметром storageContext. Это фильтрует видимые экземпляры или ограничивает количество создаваемых экземпляров в зависимости от прав доступа и конфигурации пользовательского интерфейса.
Если установлено значение relationField
Тип отношений | Поведение при создании строк |
One-to-Many (1:N) | Поле, указанное в |
Many-to-Many (M:N) | В таблице связей создается запись, связывающая новый экземпляр с экземпляром, идентифицированным по |
 | Параметр relationField должен быть именем действительного поля в текущем классе. Если он неверен или отсутствует, экземпляр может быть создан со значением null или без надлежащей связи. |
Этот механизм позволяет компоненту выступать как в качестве контекстно-зависимого представления, так и в качестве редактора связей, в зависимости от конфигурации.
Идентификатор экземпляра
По умолчанию компонент отображает все экземпляры класса, связанного с основным экземпляром, идентификатор которого определен в параметре instanceId инструментальной панели. Кроме того, данное значение может быть переопределено путем установки другого идентификатора экземпляра instanceId в указанном параметре. Если указан действительный идентификатор экземпляра, компонент отобразит все экземпляры класса, связанные с экземпляром с установленным идентификатором.
Имя переменной: | instanceId |
Записи: | 1 |
Формат записи:
Имя поля | Тип поля | Примечания |
instanceId | String | Идентификатор экземпляра. Если поле заполнено, то его значение имеет приоритет над значением параметра идентификатор экземпляра в URL инструментальной панели. |
Показать кнопку добавления строки
Определяет, отображается ли кнопка Добавить строку, которая позволяет пользователям добавлять строки в класс через компонент. Строки можно добавлять, даже если включено свойство Только чтение.
Имя переменной: | enableAddRow |
Записи: | 1 |
Формат записи:
Имя поля | Тип поля | Примечания |
enableAddRow | Boolean | Показать кнопку добавления строки |
Показать кнопку удаления строки
Определяет, отображается ли кнопка Удалить строку, которая позволяет пользователям удалять выбранные строки из класса через компонент. Строки можно удалять, даже если включено свойство Только чтение.
Имя переменной: | enableDeleteRow |
Записи: | 1 |
Формат записи:
Имя поля | Тип поля | Примечания |
enableDeleteRow | Boolean | Показать кнопку удаления строки |
Активировать кнопку импорта таблицы
Определяет, включена ли кнопка Импорт, которая позволяет пользователю вставлять строки из файла в класс через компонент. Импорт может быть выполнен, даже если включено свойство Только чтение.
Имя переменной: | enableImport |
Записи: | 1 |
Формат записи:
Имя поля | Тип поля | Примечания |
enableImport | Boolean | Активировать импорт |
Показать кнопку создания связей
Определяет, включена ли кнопка Создать связи, при нажатии на которую открывается окно, позволяющее пользователям создавать связи Многие ко многим. Отображаемый экземпляр класса должен иметь по крайней мере одно отношение, определенное для другого экземпляра класса, чтобы кнопка появилась на компоненте.
Имя переменной: | enableCreateRelationsButton |
Записи: | 1 |
Формат записи:
Имя поля | Тип поля | Примечания |
enableCreateRelationsButton | Boolean | Показать кнопку создания связей |
Общие события
[?]
Наследуемые события
Компонент Классовая таблица данных имеет в основе компонент Таблица данных, поэтому наследует общие с ним события.
Пользовательские события
Ниже описанные пользовательские события классовой таблицы данных ведут себя аналогично тем же событиям таблицы данных с тем дополнением, что они возвращают поле instanceId соответствующей записи базы данных.
Ячейка обновлена
Данное событие генерируется когда пользователь обновляет значение ячейки класса.
Имя события: | cellUpdated |
Записи: | 1 |
Формат записи:
Имя поля | Тип поля | Примечания |
recordIndex | Integer | Индекс записи. Индекс записи обновленной ячейки. |
instanceId | String | Идентификатор экземпляра. Значение первичного ключа строки, содержащей обновленную ячейку. |
field | String | Поле. Имя поля обновленной ячейки. |
value | Data Table | Значение. Новое значение, введенное в ячейку. |
Добавлена строка
Данное событие генерируется когда пользователь добавляет строку в класс.
Имя события: | rowAdded |
Записи: | 0 |
Формат записи:
Имя поля | Тип поля | Примечания |
instanceId | Integer | Идентификатор экземпляра. Значение первичного ключа добавленной строки. |
Удалена строка
Данное событие генерируется когда пользователь удаляет строку из класса.
Имя события: | rowRemoved |
Записи: | 1 |
Формат записи:
Имя поля | Тип поля | Примечания |
recordIndex | Integer | Индекс записи. Индекс удаленной записи. |
instanceId | Integer | Идентификатор экземпляра. Значение первичного ключа удаленной строки. |
Was this page helpful?