Подсистема "COMExchange": консоль запросов в режиме «Консоль кода».

В обработке «Консоль запросов 1С+ADO» подсистемы «COMExchange» изначально была заложена поддержка «событий».
Событие в данном случае - это  произвольный исполняемый код на встроенном языке,
выполняемый в определенные моменты функционирования обработки.

В настоящий момент в консоли поддерживаются события двух видов:

1. События выполнения запросов: «ПередЗапросом», «ПослеЗапроса»;
2. События обработки выборки запроса: «ПередВыборкой», «Выборка», «ПослеВыборки»;

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

Основное назначение событий второго вида - реализация алгоритмов произвольной обработки выборки запроса.

Поддержка событий (выполнения произвольного кода) уже превращает обработку в своего рода «консоль кода».
Ведь нам ничто не запрещает использовать событие «ПередЗапросом» не по прямому назначению, а просто для выполнения любого пользовательского кода.
Установка же флага СтандартнаяОбработка = Ложь в обработчике события позволяет не выполнять обработку текста запроса (и даже не задавать его).
В этом случае запуск самого запроса на выполнение фактически не происходит, выполняются только обработчики событий выполнения запроса.

Чтобы сделать использование обработки «Консоль запросов 1С+ADO»  в качестве «консоли кода» более удобным
в версии обработки 8.1.1.3 сделаны следующие нововведения:

1.  Шаблоны заполнения запросов:

1. Шаблон «Запрос 'Консоль кода'»;
2. Шаблон «Запрос 'Консоль кода' (примеры)».
   
   Первый шаблон создает пустую «консоль кода» в текущей строке дерева списка запросов.
   Второй шаблон создает «консоль кода» с закомментаренными примерами использования.
   
   Выбор шаблона заполнения производится из контекстного меню,
   выводимого кликом правой клавишей мыши по «функциональной» кнопке «f(x)»;
   
   

2.  Встроенные функции модуля объекта обработки:

1. Функции для работы с «табло формул» - позволяют инициализировать «табло формул», вставлять и получать из «табло» результаты вычислений;
2. Функции для получения объектов отчетов и обработок – позволяет использовать в исполняемом коде отчеты и обработки (как встроенные, так и внешние).
   
   

Общее описание запроса в режиме «консоль кода»:

В заготовке запроса «консоль кода» в обработчике события «ПередЗапросом» выполняется инициализация таблицы значений
«табло формул», а также осуществляется замер общего времени выполнения кода. Эти фрагменты кода менять не рекомендуется.

Для вставки пользовательского кода предназначена область текста обработчика между комментариями
‘’// *** ИСПОЛНЯЕМЫЙ КОД ***’’ и ‘’// ^^^ ИСПОЛНЯЕМЫЙ КОД ^^^’’.

Предусмотрено определенное удобство для редактирования кода: при нажатии на «функциональную» кнопку «f(x)»
выводится контекстное меню для вставки в текст часто используемых фрагментов кода (см. рисунок выше).

Для выполнения пользовательского кода требуется просто любым предусмотренным для этого способом
«выполнить запрос» из нужной строки дерева списка.
При «выполнении запроса» таблица значений «табло формул» будет установлена в качестве «результата запроса».

При совместном использовании обработки с подсистемой "ViewValues" (которая входит в комплект поставки подсистемы «COMExchange»)
доступны расширенные возможности просмотра значений в «табло формул» при двойном клике мышью по ячейке с результатом.

Для этого в версиях подсистемы "ViewValues" 8.1.1.5 /8.2.1.5 значительно расширен список типов объектов, доступных для «просмотра».
Таким образом, теперь возможен «просмотр» табличных частей объектов, наборов записей регистров, строк табличных, записей регистров,
ключей записей регистров и многое другое (смотрите описание подсистемы).


Дополнительные возможности запроса в режиме «консоль кода»:

1. В дереве списка запросов можно создать любое количество «консолей кода».
   При этом при выполнении кода текущей «консоли кода» можно запускать на выполнение другие «консоли кода» по их имени в списке.
   После «выполнения» другой «консоли кода» можно использовать значения из ее «табло формул» в текущих вычислениях или
   помещать в это «табло» текущие результаты.
   Единственное ограничение – запрещен рекурсивный запуск запросов на выполнение (непосредственно или через цепочку вызовов).
2. В тексте кода с помощью встроенной функции getExecTime() можно засекать время выполнения фрагмента кода в миллисекундах
   и выводить его в «табло» (вместе с результатом);
3. В тексте кода можно обрабатывать ошибки времени исполнения в блоке Попытка – Исключение и
   выводить в «табло» информацию об ошибке (вместо результата);
4. Возможно выполнение «обычного» запроса из дерева списка и использование его результатов в текущих вычислениях;
5. Естественно список «консолей кода» может быть сохранен во внешнем файле (*.selx) для его повторного использования;

Материалы в комплекте поставки:

В архиве комплекта поставки подсистемы «COMExchange» в файле
..\COMExchange-8x.rar\\COMExchange-8x\Sampls\ПримерыКонсольКода.selx
находится список запросов с простыми примерами использования запросов в режиме «консоль кода».

Также примеры использования «консоли кода» можно посмотреть в запросе,
заполненном по шаблону «Запрос 'Консоль кода' (примеры)».