Модификация базового отчета - История изменений

AZykov в 10:45, 3 сентября 2025

2025-09-03T10:45:19Z

← Предыдущая версия		Версия от 10:45, 3 сентября 2025
Строка 161:		Строка 161:
	"fillEmptyGroups": true		"fillEmptyGroups": true
	}		}
	</syntaxhighlight>В данном примере источником данных является класс callcenter/seances/ArchiveSeances (className), к нему применена группировка по дате с форматом YYYYMMDD (defaultGroupBy), ~~аггрегация~~ по количеству (defaultAggr), фильтр по интервалу (defaultInrerval), а так же набор дополнительных фильтров по значению (defaultFilter).		</syntaxhighlight>В данном примере источником данных является класс callcenter/seances/ArchiveSeances (className), к нему применена группировка по дате с форматом YYYYMMDD (defaultGroupBy), агрегация по количеству (defaultAggr), фильтр по интервалу (defaultInrerval), а так же набор дополнительных фильтров по значению (defaultFilter).

	Если в рамках модификации отчета, необходимо добавить новые фильтры, то в родительском layout-контроле описывается необходимый фильтр, а в данном JSON он добавляется в defaultFilter с привязкой к имени параметра:		Если в рамках модификации отчета, необходимо добавить новые фильтры, то в родительском layout-контроле описывается необходимый фильтр, а в данном JSON он добавляется в defaultFilter с привязкой к имени параметра:
Строка 167:		Строка 167:
	["parameter", "parameter_name"]		["parameter", "parameter_name"]

	Для построения структуры фильтра рекомендуется использовать инструмент REST Sandbox в приложении Builder. Он позволяет ~~виузально~~ настроить фильтр, после чего скопировать его JSON-описание.		Для построения структуры фильтра рекомендуется использовать инструмент REST Sandbox в приложении Builder. Он позволяет визуально настроить фильтр, после чего скопировать его JSON-описание.

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

	Сервис при получении запроса от отчета, будет собирать и обрабатывать данные произвольным образом, и возвращать их в необходимом формате в контрол.		Сервис при получении запроса от отчета, будет собирать и обрабатывать данные произвольным образом, и возвращать их в необходимом формате в контрол.
Строка 176:		Строка 176:

	= Шаг 4. Подмена контрола базового отчета =		= Шаг 4. Подмена контрола базового отчета =
	Модифицированный отчет можно ~~использвовать~~ тремя способами:		Модифицированный отчет можно использовать тремя способами:

	* Добавить контрол в собственное приложение		* Добавить контрол в собственное приложение

AZykov: /* Настройка логики получения и обработки данных */

2025-09-02T11:36:24Z

Настройка логики получения и обработки данных

← Предыдущая версия		Версия от 11:36, 2 сентября 2025
Строка 91:		Строка 91:
	Получение и обработка данных отчета описывается с помощью JSONа в свойстве data.		Получение и обработка данных отчета описывается с помощью JSONа в свойстве data.

	Пример базовой настройки (значение в defaultFilter сокращено):<syntaxhighlight lang="json">		Пример базовой настройки ('''значение в defaultFilter сокращено'''):<syntaxhighlight lang="json">
	{		{
	"allowActions": false,		"allowActions": false,

AZykov: /* Шаг 1. Поиск контрола базового отчета */

2025-09-02T11:35:27Z

Шаг 1. Поиск контрола базового отчета

← Предыдущая версия		Версия от 11:35, 2 сентября 2025
Строка 46:		Строка 46:
	Если необходимо добавить дополнительный фильтр в отчеты, то нужно скопировать (и при необходимости, подменить) все три контрола - В родительском необходимо добавить сам фильтр, а в дочерних - добавить применение нового фильтра к выборке данных.		Если необходимо добавить дополнительный фильтр в отчеты, то нужно скопировать (и при необходимости, подменить) все три контрола - В родительском необходимо добавить сам фильтр, а в дочерних - добавить применение нового фильтра к выборке данных.

	Далее, разберем копирование и замещение контрола на примере "дочернего" ~~creomate_tutorial~~/reports/seances/ArchiveSeancesByDateChart, который выводит график в правой части отчета.		Далее, разберем копирование и замещение контрола на примере "дочернего" callcenter/reports/seances/ArchiveSeancesByDateChart, который выводит график в правой части отчета.

	= Шаг 2. Копирование контрола =		= Шаг 2. Копирование контрола =

AZykov: /* Настройка логики получения и обработки данных */

2025-09-02T11:31:18Z

Настройка логики получения и обработки данных

← Предыдущая версия		Версия от 11:31, 2 сентября 2025
Строка 167:		Строка 167:
	["parameter", "parameter_name"]		["parameter", "parameter_name"]

			Для построения структуры фильтра рекомендуется использовать инструмент REST Sandbox в приложении Builder. Он позволяет виузально настроить фильтр, после чего скопировать его JSON-описание.

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

AZykov: /* Шаг 4. Подмена контрола базового отчета */

2025-09-02T11:29:28Z

Шаг 4. Подмена контрола базового отчета

@@ Строка 184: / Строка 184: @@
 Первый вариант удобен тогда, когда вы создаете своё приложение, в котором пользователи будут постоянно работать. Если же пользователям ради одного отчета необходимо будет открывать отдельное приложение, то это будет неудобно и рекомендуется рассмотреть остальные варианты реализации.
-[[Подмены классов|Механизм подмен]] (shifts) позволяет подменить базовый класс/контрол/редактор/приложение/компонент сценария на собственный.
+[[Подмены классов|Механизм подмен]] (shifts) позволяет подменить базовый ''класс/контрол/редактор/приложение/компонент сценария'' на собственный.
 [[Категория:Курс Разработка приложений]]
 [[Категория:Практика]]

AZykov: /* Настройка логики получения и обработки данных */

2025-09-02T11:19:49Z

Настройка логики получения и обработки данных

← Предыдущая версия		Версия от 11:19, 2 сентября 2025
Строка 166:		Строка 166:

	["parameter", "parameter_name"]		["parameter", "parameter_name"]



Строка 173:		Строка 174:

	Разработка сервиса для отчета описана в [[Разработка отчётов\|данной статье курса по разработке приложений]]. Также полезным будет изучить работу с [[Работа с универсальным источником данных\|универсальным источником данных]].		Разработка сервиса для отчета описана в [[Разработка отчётов\|данной статье курса по разработке приложений]]. Также полезным будет изучить работу с [[Работа с универсальным источником данных\|универсальным источником данных]].

			= Шаг 4. Подмена контрола базового отчета =
			Модифицированный отчет можно использвовать тремя способами:

			* Добавить контрол в собственное приложение
			* Подменить базовый контрол новым модифицированным
			* Подменить приложение отчетов и добавить модифицированный контрол как новый отчет

			Первый вариант удобен тогда, когда вы создаете своё приложение, в котором пользователи будут постоянно работать. Если же пользователям ради одного отчета необходимо будет открывать отдельное приложение, то это будет неудобно и рекомендуется рассмотреть остальные варианты реализации.

			[[Подмены классов\|Механизм подмен]] (shifts) позволяет подменить базовый класс/контрол/редактор/приложение/компонент сценария на собственный.
	[[Категория:Курс Разработка приложений]]		[[Категория:Курс Разработка приложений]]
	[[Категория:Практика]]		[[Категория:Практика]]

AZykov: /* Настройка логики получения и обработки данных */

2025-09-02T11:14:40Z

Настройка логики получения и обработки данных

← Предыдущая версия		Версия от 11:14, 2 сентября 2025
Строка 172:		Строка 172:
	Сервис при получении запроса от отчета, будет собирать и обрабатывать данные произвольным образом, и возвращать их в необходимом формате в контрол.		Сервис при получении запроса от отчета, будет собирать и обрабатывать данные произвольным образом, и возвращать их в необходимом формате в контрол.

	Разработка сервиса для отчета описана в [[Разработка отчётов\|данной статье курса по разработке приложений]].		Разработка сервиса для отчета описана в [[Разработка отчётов\|данной статье курса по разработке приложений]]. Также полезным будет изучить работу с [[Работа с универсальным источником данных\|универсальным источником данных]].
	[[Категория:Курс Разработка приложений]]		[[Категория:Курс Разработка приложений]]
	[[Категория:Практика]]		[[Категория:Практика]]

AZykov: /* Настройка логики получения и обработки данных */

2025-09-02T11:14:01Z

Настройка логики получения и обработки данных

← Предыдущая версия		Версия от 11:14, 2 сентября 2025
Строка 166:		Строка 166:

	["parameter", "parameter_name"]		["parameter", "parameter_name"]


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

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

			Разработка сервиса для отчета описана в [[Разработка отчётов\|данной статье курса по разработке приложений]].
	[[Категория:Курс Разработка приложений]]		[[Категория:Курс Разработка приложений]]
	[[Категория:Практика]]		[[Категория:Практика]]

AZykov: /* Настройка логики получения и обработки данных */

2025-09-02T11:11:24Z

Настройка логики получения и обработки данных

← Предыдущая версия		Версия от 11:11, 2 сентября 2025
Строка 91:		Строка 91:
	Получение и обработка данных отчета описывается с помощью JSONа в свойстве data.		Получение и обработка данных отчета описывается с помощью JSONа в свойстве data.

	Пример ~~JSON'а~~:<syntaxhighlight lang="json">		Пример базовой настройки (значение в defaultFilter сокращено):<syntaxhighlight lang="json">
	{		{
	"allowActions": false,		"allowActions": false,
Строка 161:		Строка 161:
	"fillEmptyGroups": true		"fillEmptyGroups": true
	}		}
	</syntaxhighlight>		</syntaxhighlight>В данном примере источником данных является класс callcenter/seances/ArchiveSeances (className), к нему применена группировка по дате с форматом YYYYMMDD (defaultGroupBy), аггрегация по количеству (defaultAggr), фильтр по интервалу (defaultInrerval), а так же набор дополнительных фильтров по значению (defaultFilter).

			Если в рамках модификации отчета, необходимо добавить новые фильтры, то в родительском layout-контроле описывается необходимый фильтр, а в данном JSON он добавляется в defaultFilter с привязкой к имени параметра:

			["parameter", "parameter_name"]
	[[Категория:Курс Разработка приложений]]		[[Категория:Курс Разработка приложений]]
	[[Категория:Практика]]		[[Категория:Практика]]

AZykov: /* Настройка логики получения и обработки данных */

2025-09-02T11:06:37Z

Настройка логики получения и обработки данных

← Предыдущая версия		Версия от 11:06, 2 сентября 2025
Строка 128:		Строка 128:
	]		]
	],		],
	~~,,,~~		...
			[filter]
	],		],
	"defaultGroupby": {		"defaultGroupby": {