kb-personal/src/content/docs/knowledge-base/Общие/Исключения, обработка ошибок/Записать в журнал регистрации (клиент).md
wakadakawaka b4274e4e56 edit
2025-07-23 18:15:14 +05:00

44 lines
3.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
title: Записать в журнал регистрации (клиент)
slug: общие-исключения-обработка-ошибок/записать-в-журнал-регистрации-клиент
---
# Шаг 1 - накапливаем сообщения
```bsl
// Записывает сообщение в журнал регистрации.
// Если параметр ЗаписатьСобытия = Истина, то запись выполняется сразу (обращение к серверу).
// Если ЗаписатьСобытия = Ложь (по умолчанию), то сообщение помещается в очередь, которая
// будет записана позднее (обычно в течение 60 сек), либо при следующем вызове этой процедуры
// с признаком ЗаписатьСобытия = Истина, либо при вызове процедуры ЗаписатьСобытияВЖурналРегистрации.
//
// Параметры:
// ИмяСобытия - Строка - имя события для журнала регистрации;
// ПредставлениеУровня - Строка - описание уровня события, по нему будет определен уровень события при записи на
// сервере;
// Например: "Ошибка", "Предупреждение".
// Соответствуют именам элементов перечисления УровеньЖурналаРегистрации.
// Комментарий - Строка - комментарий для события журнала;
// ДатаСобытия - Дата - точная дата возникновения события, описанного в сообщении. Будет добавлена в начало
// комментария;
// ЗаписатьСобытия - Булево - выполнить запись всех ранее накопленных сообщений в журнал регистрации (обращение к
// серверу).
//
// Пример:
// ЖурналРегистрацииКлиент.ДобавитьСообщениеДляЖурналаРегистрации(СобытиеЖурналаРегистрации(), "Предупреждение",
// НСтр("ru = 'Невозможно подключиться к сети Интернет для проверки обновлений.'"));
//
ЖурналРегистрацииКлиент.ДобавитьСообщениеДляЖурналаРегистрации(Знач ИмяСобытия, Знач ПредставлениеУровня = "Информация",
Знач Комментарий = "", Знач ДатаСобытия = "", Знач ЗаписатьСобытия = Ложь) Экспорт
```
# Шаг 2 - вызов сервера для записи в журнал регистрации
```bsl
// Записывает накопленные сообщения из очереди в журнал регистрации (обращение к серверу).
// Сообщения добавляются в очередь с помощью процедуры ДобавитьСообщениеДляЖурналаРегистрации.
//
ЖурналРегистрацииКлиент.ЗаписатьСобытияВЖурналРегистрации() Экспорт
```