Присоединенные и связанные свойства. Табличные данные в классах - История изменений

Elena в 13:00, 17 марта 2025

2025-03-17T13:00:33Z

← Предыдущая версия		Версия от 13:00, 17 марта 2025
Строка 50:		Строка 50:

	Предыдущая статья курса: [[Задание 3. Настройка ролей]]		Предыдущая статья курса: [[Задание 3. Настройка ролей]]
	[[Категория:Курс "Разработка приложений"]]		[[Категория:Курс Разработка приложений]]

AZykov: /* Присоединенные классы */

2025-01-20T16:04:45Z

Присоединенные классы

← Предыдущая версия		Версия от 16:04, 20 января 2025
Строка 40:		Строка 40:
	[[Файл:Настройки присоединенного свойства.png\|мини\|Настройки присоединенного свойства "один к одному"\|222x222пкс]]		[[Файл:Настройки присоединенного свойства.png\|мини\|Настройки присоединенного свойства "один к одному"\|222x222пкс]]
	'''Присоединенные свойства''' позволяют связать существующие объекты по имеющимся полям класса. Данные свойства описываются в классе, в коллекции свойств joined. При этом, данные свойства не влияют на струткуру класса в хранилище. Данные в этих свойствах будут автоматически найдены и заполнены при запросе к объекту класса. Поиск и вывод данных осуществляется согласно настройкам присоединенного свойства. [[Файл:Присоединенный объект один к одному.png\|мини\|Пример отображения присоединенного класса "один к одному"\|218x218пкс]]		'''Присоединенные свойства''' позволяют связать существующие объекты по имеющимся полям класса. Данные свойства описываются в классе, в коллекции свойств joined. При этом, данные свойства не влияют на струткуру класса в хранилище. Данные в этих свойствах будут автоматически найдены и заполнены при запросе к объекту класса. Поиск и вывод данных осуществляется согласно настройкам присоединенного свойства. [[Файл:Присоединенный объект один к одному.png\|мини\|Пример отображения присоединенного класса "один к одному"\|218x218пкс]]
	'''Присоединенные классы''' <u>один к одному</u> - свойства классов в коллекции joined, преобразуемые во время работы с классом во вложенный объект с помощью операции, аналогичной [https://ru.wikipedia.org/wiki/Join_(SQL) JOIN в SQL]. При обращении к данным класса, согласно настройкам joined-свойства будет осуществлен поиск записи в присоединенном классе. Запись должна соответствовать заданному в настройках свойства фильтру (т.е. указанная колонка в присоединяемом классе должна иметь совпадающее значение с указанной колонкой в основном классе). В интерфейсе присоединенный класс будет отображаться как блок полей этого класса. С точки зрения кода, этот присоединенный класс будет выглядеть как свойство основного класса, значением которого будет объект присоединенного класса.		'''Присоединенные классы''' <u>один к одному</u> - свойства классов в коллекции joined, преобразуемые во время работы с классом во вложенный объект с помощью операции, аналогичной [https://ru.wikipedia.org/wiki/Join_(SQL) JOIN в SQL]. При обращении к данным класса, согласно настройкам joined-свойства будет осуществлен поиск записи в присоединенном классе. Запись должна соответствовать заданному в настройках свойства фильтру (т.е. указанная колонка в присоединяемом классе должна иметь совпадающее значение с указанной колонкой в основном классе). В интерфейсе присоединенный класс будет отображаться как блок полей этого класса, т.е. аналогично связанному свойству с признаком cardContents=expand. С точки зрения кода, этот присоединенный класс будет выглядеть как свойство основного класса, значением которого будет объект присоединенного класса.
	[[Файл:Пример присоединенного класса "один ко многим".png\|мини\|Пример присоединенного класса "один ко многим"\|217x217пкс]]		[[Файл:Пример присоединенного класса "один ко многим".png\|мини\|Пример присоединенного класса "один ко многим"\|217x217пкс]]
	'''Присоединенные классы''' <u>один ко многим</u> - свойства классов в коллекции joined, преобразуемые во время работы с классом в коллекцию объектов. По логике работы совпадает с присоединенными классами один к одному, однако в результате обращения к классу будет присоединена не одна запись, а коллекция записей, подходящая по фильтру. Данный подход позволяет связывать табличные данные с классами, например таблицу с составом заказа к карточке заказа.		'''Присоединенные классы''' <u>один ко многим</u> - свойства классов в коллекции joined, преобразуемые во время работы с классом в коллекцию объектов. По логике работы совпадает с присоединенными классами один к одному, однако в результате обращения к классу будет присоединена не одна запись, а коллекция записей, подходящая по фильтру. Данный подход позволяет связывать табличные данные с классами, например таблицу с составом заказа к карточке заказа.

AZykov: /* Связанные классы */

2025-01-20T13:50:51Z

Связанные классы

← Предыдущая версия		Версия от 13:50, 20 января 2025
Строка 31:		Строка 31:
	* ''selectexpand'' - отображение и выпадающего списка для выбора и группы полей выбранной записи		* ''selectexpand'' - отображение и выпадающего списка для выбора и группы полей выбранной записи

	Одно из этих значений можно выбрать для свойства в поле cardContents (вкладка UI). Для наглядности перенесем свойство question на вкладку Прочее (задав для него tabCaption, более подробно см. далее) и посмотрим на внешний вид этой вкладки для каждого варианта		Одно из этих значений можно выбрать для свойства в поле cardContents (вкладка UI). Для наглядности перенесем свойство question на вкладку Прочее (задав для него tabCaption, более подробно см. далее) и посмотрим на внешний вид этой вкладки для каждого варианта. Данная настройка влияет только на визуализацию класса, при обращении по API, будет возвращаться только идентификатор записи.

	Отметим, что загрузка с сервера связанных объектов требует существенных ресурсов, поэтому осуществляется только при открытии карточки. Следовательно, в таблице значения вычислимых полей, зависящих от связанных объектов, отображаться не будут. Если эти значения необходимы в таблице, можно рассмотреть вариант включения полного клиентского кэша для связанного класса.		Отметим, что загрузка с сервера связанных объектов требует существенных ресурсов, поэтому осуществляется только при открытии карточки. Следовательно, в таблице значения вычислимых полей, зависящих от связанных объектов, отображаться не будут. Если эти значения необходимы в таблице, можно рассмотреть вариант включения полного клиентского кэша для связанного класса.

AZykov: /* Связанные классы */

2025-01-20T13:40:59Z

Связанные классы

← Предыдущая версия		Версия от 13:40, 20 января 2025
Строка 27:		Строка 27:
	'''Связанные свойства''' могут отображаться на карточке в одном из трех вариантов:		'''Связанные свойства''' могут отображаться на карточке в одном из трех вариантов:

	* select - выпадающий список		* ''select'' - выпадающий список для выбора значений
	* expand		* ''expand'' - отображение группы полей выбранной записи класса (работает аналогично присоединенным классам, однако изменения в основном классе не внесут изменения в связанный)
	* selectexpand		* ''selectexpand'' - отображение и выпадающего списка для выбора и группы полей выбранной записи

	Одно из этих значений можно выбрать для свойства в поле cardContents (вкладка UI). Для наглядности перенесем свойство question на вкладку Прочее (задав для него tabCaption, более подробно см. далее) и посмотрим на внешний вид этой вкладки для каждого варианта		Одно из этих значений можно выбрать для свойства в поле cardContents (вкладка UI). Для наглядности перенесем свойство question на вкладку Прочее (задав для него tabCaption, более подробно см. далее) и посмотрим на внешний вид этой вкладки для каждого варианта

AZykov: /* Связанные классы */

2025-01-20T13:37:16Z

Связанные классы

← Предыдущая версия		Версия от 13:37, 20 января 2025
Строка 31:		Строка 31:
	* selectexpand		* selectexpand

	Одно из этих значений можно выбрать для свойства в поле cardContents. Для наглядности перенесем свойство question на вкладку Прочее (задав для него tabCaption, более подробно см. далее) и посмотрим на внешний вид этой вкладки для каждого варианта		Одно из этих значений можно выбрать для свойства в поле cardContents (вкладка UI). Для наглядности перенесем свойство question на вкладку Прочее (задав для него tabCaption, более подробно см. далее) и посмотрим на внешний вид этой вкладки для каждого варианта

	Отметим, что загрузка с сервера связанных объектов требует существенных ресурсов, поэтому осуществляется только при открытии карточки. Следовательно, в таблице значения вычислимых полей, зависящих от связанных объектов, отображаться не будут. Если эти значения необходимы в таблице, можно рассмотреть вариант включения полного клиентского кэша для связанного класса.		Отметим, что загрузка с сервера связанных объектов требует существенных ресурсов, поэтому осуществляется только при открытии карточки. Следовательно, в таблице значения вычислимых полей, зависящих от связанных объектов, отображаться не будут. Если эти значения необходимы в таблице, можно рассмотреть вариант включения полного клиентского кэша для связанного класса.

AZykov в 13:30, 20 января 2025

2025-01-20T13:30:39Z

← Предыдущая версия		Версия от 13:30, 20 января 2025
Строка 50:		Строка 50:

	Предыдущая статья курса: [[Задание 3. Настройка ролей]]		Предыдущая статья курса: [[Задание 3. Настройка ролей]]
			[[Категория:Курс "Разработка приложений"]]

AZykov: /* Присоединенные классы */

2025-01-20T13:26:48Z

Присоединенные классы

← Предыдущая версия		Версия от 13:26, 20 января 2025
Строка 38:		Строка 38:

	= Присоединенные классы =		= Присоединенные классы =
	'''Присоединенные свойства''' позволяют связать существующие объекты по имеющимся полям класса. Данные свойства описываются в классе, в коллекции свойств joined. При этом, данные свойства не влияют на струткуру класса в хранилище. Данные в этих свойствах будут автоматически найдены и заполнены при запросе к объекту класса. Поиск и вывод данных осуществляется согласно настройкам присоединенного свойства. ~~[[Файл:Настройки присоединенного свойства.png\|мини\|Настройки присоединенного свойства "один к одному"\|222x222пкс]]~~		[[Файл:Настройки присоединенного свойства.png\|мини\|Настройки присоединенного свойства "один к одному"\|222x222пкс]]
	[[Файл:Присоединенный объект один к одному.png\|мини\|Пример отображения присоединенного класса "один к одному"\|218x218пкс]]		'''Присоединенные свойства''' позволяют связать существующие объекты по имеющимся полям класса. Данные свойства описываются в классе, в коллекции свойств joined. При этом, данные свойства не влияют на струткуру класса в хранилище. Данные в этих свойствах будут автоматически найдены и заполнены при запросе к объекту класса. Поиск и вывод данных осуществляется согласно настройкам присоединенного свойства. [[Файл:Присоединенный объект один к одному.png\|мини\|Пример отображения присоединенного класса "один к одному"\|218x218пкс]]
	'''Присоединенные классы''' <u>один к одному</u> - свойства классов в коллекции joined, преобразуемые во время работы с классом во вложенный объект с помощью операции, аналогичной [https://ru.wikipedia.org/wiki/Join_(SQL) JOIN в SQL]. При обращении к данным класса, согласно настройкам joined-свойства будет осуществлен поиск записи в присоединенном классе. Запись должна соответствовать заданному в настройках свойства фильтру (т.е. указанная колонка в присоединяемом классе должна иметь совпадающее значение с указанной колонкой в основном классе). В интерфейсе присоединенный класс будет отображаться как блок полей этого класса. С точки зрения кода, этот присоединенный класс будет выглядеть как свойство основного класса, значением которого будет объект присоединенного класса.		'''Присоединенные классы''' <u>один к одному</u> - свойства классов в коллекции joined, преобразуемые во время работы с классом во вложенный объект с помощью операции, аналогичной [https://ru.wikipedia.org/wiki/Join_(SQL) JOIN в SQL]. При обращении к данным класса, согласно настройкам joined-свойства будет осуществлен поиск записи в присоединенном классе. Запись должна соответствовать заданному в настройках свойства фильтру (т.е. указанная колонка в присоединяемом классе должна иметь совпадающее значение с указанной колонкой в основном классе). В интерфейсе присоединенный класс будет отображаться как блок полей этого класса. С точки зрения кода, этот присоединенный класс будет выглядеть как свойство основного класса, значением которого будет объект присоединенного класса.
	[[Файл:Пример присоединенного класса "один ко многим".png\|мини\|Пример присоединенного класса "один ко многим"\|217x217пкс]]		[[Файл:Пример присоединенного класса "один ко многим".png\|мини\|Пример присоединенного класса "один ко многим"\|217x217пкс]]

AZykov в 13:26, 20 января 2025

2025-01-20T13:26:28Z

← Предыдущая версия		Версия от 13:26, 20 января 2025
Строка 45:		Строка 45:

	Подробно, настройка joined-свойств описана в статье [[Хранение данных. Классы. Поля и действия]]		Подробно, настройка joined-свойств описана в статье [[Хранение данных. Классы. Поля и действия]]
	[[Файл:Связь с присоединенным объектом через ID.png\|мини\|206x206пкс\|Связь с присоединямемым объектом через ID. У присоединяемого объекта в поле client должна быть ссылка на основной объект.]]		[[Файл:Связь с присоединенным объектом через ID.png\|мини\|206x206пкс\|Связь с присоединямемым объектом через ID. У присоединяемого объекта в поле client должна быть ссылка на основной объект.]]<blockquote>Для построения join'ов можно использовать любые пары свойств у классов. В случае если присоединение происходит с помощью связанных свойств (идентификаторов), необходимо использовать постфикс _id. Пример присоедениения через идентификатор представлен на последнем скриншоте в данной статье.</blockquote>
	Для построения join'ов можно использовать любые пары свойств у классов. В случае если присоединение происходит с помощью связанных свойств (идентификаторов), необходимо использовать постфикс _id. Пример присоедениения через идентификатор представлен на последнем скриншоте в данной статье.


	Следующая статья курса: [[Задание 4. Взаимодействие классов]]		Следующая статья курса: [[Задание 4. Взаимодействие классов]]

	Предыдущая статья курса: [[Задание 3. Настройка ролей]]		Предыдущая статья курса: [[Задание 3. Настройка ролей]]

AZykov в 13:26, 20 января 2025

2025-01-20T13:26:09Z

← Предыдущая версия		Версия от 13:26, 20 января 2025
Строка 2:		Строка 2:

	= Общая информация =		= Общая информация =
	[[Файл:Связанный класс. Выпадающий список в интерфейсе.png\|мини\|Связанный класс. Выпадающий список в интерфейсе]]
	При разработке приложений, одной из главных задач стоит организация взаимодействия классов между собой. Классы могут иметь свойства, являющиеся ссылками на другой класс, некоторые из классов могут содержать служебную информацию для других, либо служить источниками данных (например, интеграционных).		При разработке приложений, одной из главных задач стоит организация взаимодействия классов между собой. Классы могут иметь свойства, являющиеся ссылками на другой класс, некоторые из классов могут содержать служебную информацию для других, либо служить источниками данных (например, интеграционных).

	Существует три основных способа взаимодействия классов в платформе Эра:		Существует три основных способа взаимодействия классов в платформе Эра:

	'''Связанные классы''' - свойства классов в коллекции data, хранящие ссылку на объект (запись) другого класса. Стандартный подход, по сути отражающий ссылки.		* Связанные классы
	[[Файл:Настройки присоединенного свойства.png\|мини\|Настройки присоединенного свойства "один к одному"]]		* Присоединенные классы один к одному
	[[Файл:Присоединенный объект один к одному.png\|мини\|Пример отображения присоединенного класса "один к одному"]]		* Присоединенные классы один ко многим

			= Связанные классы =
			[[Файл:Связанный класс. Выпадающий список в интерфейсе.png\|мини\|Связанный класс. Выпадающий список в интерфейсе]]'''Связанные классы''' - свойства классов в коллекции data, хранящие ссылку на объект (запись) другого класса. Стандартный подход, по сути отражающий ссылки. В хранилище класса будут храниться '''идентификаторы''' объектво (записей) классов.

			Для связанных полей в базе данных автоматически создается свойство вида responsibleUser_id, где responsibleUser это имя свойства класса, а _id добавляется автоматически системой.

			Иногда бывает необходимо использовать в качестве идентификатора объекта другое поле, как правило уникальное.

			Например, сценарии удобно привязывать не по идентификатору, а по текстовому полю code. Это позволяет сохранять связь между объектами при их пересоздании – в частности, можно удалить сценарий и создать новый с таким же значением поля code.

			Для реализации такого принципа связи объектов нужно:

			* выставить флажок unique свойству code. Система не позволит создать два объекта с одинаковым значением свойства;
			* выставить флажок lookup свойству code. Это приведет к созданию индекса в базе данных и обеспечит возможность быстрого поиска объектов по code;
			* в поле keyPropertyName класса указать code. После этого поля связанных классов будут иметь вид _code вместо _id.

			'''Связанные свойства''' могут отображаться на карточке в одном из трех вариантов:

			* select - выпадающий список
			* expand
			* selectexpand

			Одно из этих значений можно выбрать для свойства в поле cardContents. Для наглядности перенесем свойство question на вкладку Прочее (задав для него tabCaption, более подробно см. далее) и посмотрим на внешний вид этой вкладки для каждого варианта

			Отметим, что загрузка с сервера связанных объектов требует существенных ресурсов, поэтому осуществляется только при открытии карточки. Следовательно, в таблице значения вычислимых полей, зависящих от связанных объектов, отображаться не будут. Если эти значения необходимы в таблице, можно рассмотреть вариант включения полного клиентского кэша для связанного класса.

			Также, важно отметить что редактирование полей вложенных объектов приводит к изменению именно в них, так как дублирования данных нет – в объекте Заявка хранится только идентификатор типового вопроса.

			= Присоединенные классы =
			'''Присоединенные свойства''' позволяют связать существующие объекты по имеющимся полям класса. Данные свойства описываются в классе, в коллекции свойств joined. При этом, данные свойства не влияют на струткуру класса в хранилище. Данные в этих свойствах будут автоматически найдены и заполнены при запросе к объекту класса. Поиск и вывод данных осуществляется согласно настройкам присоединенного свойства. [[Файл:Настройки присоединенного свойства.png\|мини\|Настройки присоединенного свойства "один к одному"\|222x222пкс]]
			[[Файл:Присоединенный объект один к одному.png\|мини\|Пример отображения присоединенного класса "один к одному"\|218x218пкс]]
	'''Присоединенные классы''' <u>один к одному</u> - свойства классов в коллекции joined, преобразуемые во время работы с классом во вложенный объект с помощью операции, аналогичной [https://ru.wikipedia.org/wiki/Join_(SQL) JOIN в SQL]. При обращении к данным класса, согласно настройкам joined-свойства будет осуществлен поиск записи в присоединенном классе. Запись должна соответствовать заданному в настройках свойства фильтру (т.е. указанная колонка в присоединяемом классе должна иметь совпадающее значение с указанной колонкой в основном классе). В интерфейсе присоединенный класс будет отображаться как блок полей этого класса. С точки зрения кода, этот присоединенный класс будет выглядеть как свойство основного класса, значением которого будет объект присоединенного класса.		'''Присоединенные классы''' <u>один к одному</u> - свойства классов в коллекции joined, преобразуемые во время работы с классом во вложенный объект с помощью операции, аналогичной [https://ru.wikipedia.org/wiki/Join_(SQL) JOIN в SQL]. При обращении к данным класса, согласно настройкам joined-свойства будет осуществлен поиск записи в присоединенном классе. Запись должна соответствовать заданному в настройках свойства фильтру (т.е. указанная колонка в присоединяемом классе должна иметь совпадающее значение с указанной колонкой в основном классе). В интерфейсе присоединенный класс будет отображаться как блок полей этого класса. С точки зрения кода, этот присоединенный класс будет выглядеть как свойство основного класса, значением которого будет объект присоединенного класса.
	[[Файл:Пример присоединенного класса "один ко многим".png\|мини\|Пример присоединенного класса "один ко многим"]]		[[Файл:Пример присоединенного класса "один ко многим".png\|мини\|Пример присоединенного класса "один ко многим"\|217x217пкс]]
	'''Присоединенные классы''' <u>один ко многим</u> - свойства классов в коллекции joined, преобразуемые во время работы с классом в коллекцию объектов. По логике работы совпадает с присоединенными классами один к одному, однако в результате обращения к классу будет присоединена не одна запись, а коллекция записей, подходящая по фильтру. Данный подход позволяет связывать табличные данные с классами, например таблицу с составом заказа к карточке заказа.		'''Присоединенные классы''' <u>один ко многим</u> - свойства классов в коллекции joined, преобразуемые во время работы с классом в коллекцию объектов. По логике работы совпадает с присоединенными классами один к одному, однако в результате обращения к классу будет присоединена не одна запись, а коллекция записей, подходящая по фильтру. Данный подход позволяет связывать табличные данные с классами, например таблицу с составом заказа к карточке заказа.

	Подробно, настройка joined-свойств описана в статье [[Хранение данных. Классы. Поля и действия]]		Подробно, настройка joined-свойств описана в статье [[Хранение данных. Классы. Поля и действия]]
			[[Файл:Связь с присоединенным объектом через ID.png\|мини\|206x206пкс\|Связь с присоединямемым объектом через ID. У присоединяемого объекта в поле client должна быть ссылка на основной объект.]]
			Для построения join'ов можно использовать любые пары свойств у классов. В случае если присоединение происходит с помощью связанных свойств (идентификаторов), необходимо использовать постфикс _id. Пример присоедениения через идентификатор представлен на последнем скриншоте в данной статье.

AZykov в 12:41, 20 января 2025

2025-01-20T12:41:46Z

← Предыдущая версия		Версия от 12:41, 20 января 2025
Строка 7:		Строка 7:
	Существует три основных способа взаимодействия классов в платформе Эра:		Существует три основных способа взаимодействия классов в платформе Эра:

	'''Связанные классы''' - свойства классов в коллекции data, хранящие ссылку на объект (запись) другого класса. Стандартный подход, по сути отражающий ссылки		'''Связанные классы''' - свойства классов в коллекции data, хранящие ссылку на объект (запись) другого класса. Стандартный подход, по сути отражающий ссылки.
	[[Файл:Настройки присоединенного свойства.png\|мини\|Настройки присоединенного свойства "один к одному"]]		[[Файл:Настройки присоединенного свойства.png\|мини\|Настройки присоединенного свойства "один к одному"]]
	[[Файл:Присоединенный объект один к одному.png\|мини\|Пример отображения присоединенного класса "один к одному"]]		[[Файл:Присоединенный объект один к одному.png\|мини\|Пример отображения присоединенного класса "один к одному"]]