GetItem - вывод данных формы

GetItem - Хранимая процедура извлечения данных формы

CREATE PROCEDURE [dbo].[fm_tatest_getItem]
@itemID int, --Стандартные параметры, они всегда приходят в эту процедуру.
@username nvarchar(256)
AS BEGIN -- инициализация формы данными. Названия вывода 1 SELECT должны совпадать с элементами формы
  if(@itemID>0) begin --Перед началом можно проверить права данного username -- 1 SELECT значения элементов формы
     select * from as_trace t1 where id = @itemID -- 2 SELECT дополнительные параметры настройки формы
/* select 'Редактирование "'+header+'"' Title, '' Subtitle, 'Сохранить' ButtonText, 'success' Background */
-- 3 SELECT некие табличные данные в свободном формате для вывода в форме через JS Render
  end else
  begin
     select 1
  end
select '' Title, '' Subtitle, 'h2' HeaderTag, 1 LineLabel
END

На входе: 

1. username - текущий пользователь
2. itemID - что передано в data-itemID сниппета формы (может быть и строкой, по умолчанию int)/ 
3. в процедуру может передаваться необязательный параметр @parameters ExtendedDictionaryParameter в котором передаются системные параметры:

1. 1. langID - текущий язык пользователя
   2. falconGuid - guid пользователя, хранящийся у него в куки (работает для всех пользователей, в том числе неавторизованных), также в этом параметре передаются параметры URL страницы, на которой находится форма

На выходе следующие SELECT:

1. SELECT 1 - данные формы (колонки). 

Также в этом запросе указываются метаданные к колонкам:

• возможные дополнительные CSS классы к элементам ставятся через class_{colCode}
• для списковых полей можно задать через параметр dict_{colCode} список возможных значений для элемента в формате Value1,Text1||Value2,Text2||...
• блокировать поле можно через установку в 1 для disabled_{colCode}
• disableXSS_{colCode}. Если 1 то отключает проверку XSS на данном поле
• можно указать что поле можно одиночно редактировать через префикс edt_{colCode}
• можно указать дополнительные подсказки для поля (при клике на них будет меняться значение поля)  example_{colCode}. В качестве значения можно указать несколько значений через "||", например value1||value2||value3
• у поля можно указать гибкие настройки через JSON в поле options_{colCode}. Более подробно про настройки по каждому типу поля - /docs/formy--upravlenie-nastroykami-polya-cherez-options--polya
• подмена названия поля title_{colCode}
• тип поля можно переопределить через type_{colCode}

2. SELECT 2 - Настройки формы.

• AlertOptions - JSON настройки для системного уведомления о заполнении формы (ОК или Fail).  См. подробнее...
• Background (код фона формы, напр success) - задает фон формы.
• ButtonText - текст у кнопки действия (Сохранить).
• ChangeFontSize - если 1, то вверху появляются кнпоки для изменения размера шрифта.
• ChangeTriggerFieldOnLoad - если указано поле формы (или поля формы через запятую), то при загрузке будет вызвано событие изменения поля (например, чтобы прогрузить некоторые данные через процедуру CheckItemField).
• CopyClipboard - некий текст. Если он указан, то вверху формы возникает значок Буфера обмена, при клике происходит копирование этого текста в буфер обмена. 
• DisableAntiXSS  - если 1, то для полей ввода будет отключена обработка HTML Encode (т.е. защита от XSS будет отключена и ее надо частично будет реализовать в коде SQL).
• DisableCheckField - если 1, то проверка полей при изменении через процедуру CheckField отключена.
• DisableFocusOnLoad - если 1, то при загрузке формы по умолчанию не будет ставиться фокус ввода на 1 поле формы (актуально когда несколько форм на странице). 
• DisableSaveStateChecking - если 1, то для формы не будет выполняться проверка на изменения формы перед случайным закрытием или переходом на другую страницу. По умолчанию такая проверка есть для всех форм - если что-то меняли, то при случайном переходе на другую страницу будет возникать предупреждение о несохраненных данных. 
• DropdownPanel, DropdownPanelText - настройка выпадающей панели вверху рядом с названием формы. См. подробнее. 
• EditableSuccessMessage - задает текст сообщения об успешном изменении одиночного поля.
• EnablePrint - если 1, то появляется кнопка отправки на печать (печатается только форма, а не вся страница).
• EnterKeyMode - как будет обрабатываться нажатие на Enter на поле. save - сохраняем форму. next -переход к следующему полю (но некоторые поля пропускают - Переключатель, HTML editor и другие сложные поля).
• HeaderTag - h1, h2, h3, h4, h5, h6 - позволяет указать тег для вывода заголовка формы.
• HelpLink - если указано поле формы Помощь, то выведется ссылка с названием в этом параметре (по умолчанию текст "Как это работает") - при клике будет выведена помощь по форме внизу слева.  Обновление Май 2025.
• Hide - если 1, то компонент совсем не выведется (пустой div и установка класса hide).
• LineLabel - если 1, то при дефолтовой разметке формы метки полей будут выводиться на отдельной строке (по умолчанию они выводятся слева от элемента управления).
• NoForm - JSON настройки для вывода сообщения (например, нет доступа). При этом форма не показывается совсем - только вывод сообщения. Настройки: 
  • title - заголовок
  • text - текст сообщения
  • type - стилизация окна (success,warning,primary, info и т.д.)
  • icon - вывод иконки 
  • alert - если true, то будет выводиться не разметка в форме, а alert окошко справа вверху (в случае модальной формы - модальное окно будет закрываться)

• Subtitle - разметка под заголовком формы.
• Title - заголовок формы.
• TitleTooltip - подсказка-значок рядом с Title формы.        

3. SELECT 3 - дополнительные табличные данные (произвольные колонки) для вывода через jsRender разметку
   
   
4. SELECT 4 - вызов внешних действий. См. вызов внешних действий