Включить пользовательский режим логирования

Описание

Блок включает пользовательский режим логирования окна выполнения: в заголовке окна фиксируется указанный текст, и он больше не заменяется названиями выполняемых блоков. Последующие шаги робота либо показываются как дочерние строки под заголовком, либо скрываются - в зависимости от флага Показывать последующие шаги.

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

Ограничение

Блок работает только при запуске робота через окно выполнения: из студии с включённым параметром Отображать окно в настройках проекта либо из исполняемого файла, собранного с настройкой отображения Окно выполнения. При запуске без окна выполнения блок ничего не делает и не вызывает ошибок.

Примечание

Под заголовком отображаются три последние строки. Пары сообщений «Выполняется …» / «Выполнено …» одного блока занимают одну строку.

---

Описание параметров

Блок имеет ряд параметров:

1. Заголовок - текст, который фиксируется в заголовке окна выполнения;

   Тип данных: str (Строка)

   Пример: Обработка заявок из Excel

2. Показывать последующие шаги - признак, определяющий, отображаются ли шаги робота под заголовком:

   Тип данных: checkbox (Чекбокс)

   Пример: ✔

   • включён - названия выполняемых блоков показываются дочерними строками под заголовком;
   • выключен - шаги робота скрываются до отключения режима; под заголовком показываются только сообщения блока Сообщение в окно выполнения.

---

Пример использования

В данном примере робот обрабатывает заявки, а в окне выполнения вместо названий блоков отображается понятный пользователю заголовок этапа и число обработанных заявок. Для наглядности обработка одной заявки заменена блоком Задержка.

1. В начало процесса добавляется блок Включить пользовательский режим логирования с заголовком Обработка заявок из Excel; флаг Показывать последующие шаги снимается, чтобы технические шаги не отвлекали пользователя;
2. Создаётся переменная counter со значением 0;
3. В цикле повторить 3 раз выполняется Задержка (обработка заявки), значение counter увеличивается на 1, после чего блок Сообщение в окно выполнения выводит текст Обработано заявок: + counter (блок создать текст из);
4. После цикла добавляется блок Отключить пользовательский режим логирования - окно возвращается к отображению шагов робота;
5. Процесс запускается с включённым окном выполнения.

Результат

Пока выполняется цикл, в окне выполнения зафиксирован заголовок «Обработка заявок из Excel»; блоки Задержка и увеличить не показываются, под заголовком отображаются только сообщения со счётчиком обработанных заявок: