Сообщение в окно выполнения

Описание

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

Ограничение

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

Примечание

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

Блок не записывает сообщение в лог-файл. Для записи в файл используется блок Записать лог в файл.

---

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

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

1. Сообщение - текст, который отображается в окне выполнения. Значение другого типа (например, число из переменной) преобразуется в строку;

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

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

---

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

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

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

Результат

Под заголовком «Обработка заявок» вперемешку с шагами робота (Задержка, Увеличить значение переменной) появляются строки с актуальным числом обработанных заявок: