Запись в отчет

Урок 166 из 251
Автор: Марина Павлова
Сложность урока:
1 уровень - интуитивно все понятно из интерфейса, но почитать стоит.
1 из 5
Просмотров: 37176
Дата изменения: 14.11.2024
Недоступно в лицензиях:
Текущую редакцию Вашего 1С-Битрикс можно просмотреть на странице Обновление платформы (Marketplace > Обновление платформы).
Старт, Стандарт, Малый бизнес

Действие позволяет добавлять в журнал При разработке и использовании уже готовых процессов бывает необходимо узнать подробности выполнения того или иного процесса / действия. Для этого в системе предусмотрен журнал выполнения бизнес-процессов (лог).

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

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


  • Текст — укажите произвольный текст отчета. Обязательный параметр. В тексте доступно форматирование с использованием тегов bb-code BBCode — язык разметки, используемый для форматирования сообщений.

    Подробнее на Википедии
    : [url], [b], [i], [s], [u] и т.д. (будет ли работать тот или иной тег зависит от действия Например, тег [color] изменит цвет текста если вывести отчет в ленту Новостей, но не сработает в сообщении соц. сети. , которым будет выводиться отчет). Обратите внимание, что форматирование bb-code не работает для записей в логе;
  • Загрузить отчет для доступа из бизнес-процесса — опция позволяет получить содержимое всех отчетов, сформированных на текущий момент, в рамках бизнес-процесса для его дальнейшего использования в шаблоне (например, отправить такой отчет можно по почте или в уведомлении). Отчет доступен через форму «Вставка значения» При работе с бизнес-процессом в параметрах действий, параметрах шаблона и настройках статуса есть возможность указывать как собственный текст (заданный вручную), так и использовать различные переменные значения (поля документа и прочие данные, которые могут меняться и поэтому не задаются вручную). Для подстановки таких переменных значений используется специальная форма Вставка значения.

    Подробнее...
    (секция Дополнительные результаты). При отключенной опции информация записывается только в журнал выполнения бизнес-процесса (лог).
Обратите внимание, что в облачном Битрикс24 запись в журнал может быть отключена в настройках шаблона бизнес-процесса. В этом случае действие не отработает.
В форме настроек действия отображается напоминание:

  Пример настройки:

  Дополнительные результаты

Результаты выполнения действия Запись в отчет можно получить с помощью формы «Вставка значения» – Дополнительные результаты, в которой они становятся доступны сразу после добавления действия в шаблон.

Доступно:

  • Отчет

Для каждого использованного в шаблоне действия Запись в отчет создаётся своя запись Рекомендуем менять заголовки действий, чтобы легче различать их между собой в шаблоне и в форме Вставка значения. . Использование вставки этого значения имеет смысл только если в параметрах действия была отмечена опция Загрузить отчет для доступа из бизнес-процесса. С её помощью можно получить суммарный отчет по всем отчетам, что расположены до текущего действия и включая его. Таким образом отчет каждого последующего действия включает отчеты предыдущих действий.

Внимание: Переменная Отчет будет пустой, если опция Загрузить отчет для доступа из бизнес-процесса не была отмечена.

Пример использования опции: формирование суммарного отчета по данным из всех отчетов на этапе завершения бизнес-процесса без лишних запросов к базе.


  Пример

Для лучшего понимания как работает опция Загрузить отчет для доступа из бизнес-процесса рассмотрим очень простой пример. Создадим тестовый шаблон с тремя действиями Запись в отчет и одним уведомлением Сообщение соц.сети Действие отправляет уведомление модуля социальной сети.

Подробнее...
:

Параметры действий заполнены таким образом:

Запись в отчет 1
Запись в отчет 2
Запись в отчет 3

Мы хотим отправить в уведомлении информацию о всех трех записях. Поэтому в третьем отчете опция загрузки отчета включена. В уведомление добавим с помощью формы «Вставка значения» наш итоговый отчет:

Сообщение соц. сети

В результате запуска БП сформируется такое уведомление:

Как видно на скриншоте, сообщение содержит все три записи с указанием даты и времени.

В журнале (логе) бизнес-процесса каждый отчет будет записан отдельной строкой:

Примечание: Если в примере выше опцию загрузки отчета включить для Записи в отчет 2 и в сообщении добавить отчет этого действия, то получим данные по двум записям: первой и второй. Третьей записи в сообщении с отчетом не будет. А вот в логе отобразятся все три записи.


Нам жаль это слышать… Но мы постараемся быть лучше!

Мы благодарны Вам за помощь в улучшении документации.

Спасибо, мы рады что смогли помочь Вам. Ниже Вы можете оставить свой отзыв или пожелание :)
Мы стараемся сделать документацию понятнее и доступнее,
и Ваше мнение важно для нас
Курсы разработаны в компании «1С-Битрикс»