Операции в таблице - на строку, групповые операции

В таблице можно делать некоторые кастомизированные операции (через использование своих хранимых процедур). Есть 3 вида операций: 

• групповые операции - кнопка в тулбаре для групповых операций
• операция со строкой - будет кнопка у строки
• кнопка в тулбаре

Настройки операций в таблице

Для добавления операции к таблице, необходимо создать операцию в разделе операции таблицы (ссылка Операции на форме редактирования таблицы). 

Для операции указываем: 

1. код - используется для построения имен хранимых процедур
2. название - выводится в таблице
3. иконка - иконка Font Awesome (подобрать нужную иконку вы можете в разделе  Статическое меню), например, fa fa-bars
4. текст подтверждения - если задан текст, то перед выполнением операции будет запрашиваться подтверждение операции с указанным текстом.  Подтверждение не запрашивается, если кастомная кнопка. При кастомной кнопке нужно в явном виде указывать  data-confirmtext="Подтвердите свой выбор".
5. сообщение - сообщение об успешном выполнении операции при успехе
6. Скрыть строку после выполнения операции - если ДА, то скрываем строку, для которой была вызвана операция
   (действует только для построчных операций)
7. Перезапуск страницы после выполнения операции - если ДА, то перезагрузка всей страницы при успешном выполнении. 
8. Пользователи, Роли - кто имеет доступ на выполнение этих операций
9. Тип - операция может быть: 
1. для строки (выводится тогда в строке), 
2. просто в тулбаре (кнопка вверху таблицы)
3. для групповых операций (появляется вверху таблицы, когда выбрана одна или более строк галочками -
   для этого необходимо у таблицы установить настройку Показывать галочки для групповых операций)

--имя строится как crud_{table}_{operationCode}_operation
CREATE PROCEDURE [dbo].[crud_newTableTest_newOperation_operation]
	@filters CRUDFilterParameter READONLY,
	@itemIDs nvarchar(256),
	@username nvarchar(32)
AS
BEGIN
	-- выполнение операции таблицы
	-- если это групповая операция то itemIDs содержит значение id через запятую

	--declare @filterFormID int -- для использования переменных переданных неявно (через URL)
	--select @filterFormID = try_cast(Value as int) from @filters where [Key] = 'formID'

	-- select value from dbo.split(@itemIDs, ',') перебор значений выбранных элементов
	declare @res bit = 0

	-- SELECT 1 msg, Result, Info
	if(@res=1) begin
		select 'Произошла ошибка' Msg, 0 Result
	end else begin
		select '' Msg, 1 Result, '' Info, '' RedirectUrl
	end

	-- SELECT 2 Вызов внешнего действия
	/*
	select 'email' type,   -- email, sms, notification, clearcache
    	'ru@rudensoft.ru' [to], 'sub1' subject, 'bodyXXX'+@itemIDs body,   ---EMAIL
    	'Text 1' msg, '723429234' [number],   												--- SMS
        '' prefix,																				--CLEAR CACHE
		'text1' text , 'ru@rudensoft.ru' [to], 'ticketExecutor' typeCode, 'http///' url, 'add111' additional -- notification
	*/

END

На входе: 

• @filters CRUDDictionaryParameter - фильтры таблицы (Key, Value) по аналогии с GetItems (необязательный параметр, обновление окт 2024). 
• @itemIDs - через запятую id строк таблицы. Eсли row операция - то id строки, для которой вызвана операция. Если group операция - то id (это колонки с PK=true) строк через запятую. Если toolbar операция - то пустое. 
• @username - текущий пользователь.
• @parameters ExtendedDictionaryParameter - опциональный параметр, в котором передаются langID, falconGuid, userIP и др.

На выходе: 

• SELECT 1 -
  • Result - результат операции (bit),
  • Msg - сообщение пользователю,
  • Icon - Поле Icon задает иконку результата в окне справа вверху, например, 'fa fa-code',
  • Info  - эта информация будет выводиться в диалоговом окне после выполнения операции (если указан type - то будет выведено окно alert справа наверху с разметкой из info),
  • RedirectUrl - если указан и операция выполнена успешно, то будет выполнен редирект на указанный адрес,
  • RefreshContainer - если указан селектор, то будет выполнено обновление компонентов в заданном контейнере.
  • Actions - JSON для действий в браузере. 
  • Color - можно установить цвет фона для выбранных строк (галочками для групповой операции или для операции на строке).
• SELECT 2 -  вызовы внешних действий (почта, смс, уведомление и т.д.). См. вызов внешних действий.

Примечание:

• Если вы планируете использовать формы для обработки выбранных строк (особенно в случае групповых операций): Кнопка модальной формы (as-form-modal) добавляется в groupOperationsToolbar для таблицы, в data-itemID кнопки автоматически при простановке галочек попадают itemID строк через запятую, например "123,456,789". В этом случае не нужно создавать отдельный элемент в Операции таблицы.
• Если указано RedirectUrl, то после успешного выполнения операции будет переход на указанный URL.