This commit is contained in:
wakadakawaka 2025-07-21 23:00:18 +05:00
parent 19af675bd5
commit 9fd8afaf2b
9 changed files with 64 additions and 7 deletions

View File

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

View File

@ -0,0 +1,17 @@
```bsl
// Процедура пакетной записи сообщений в журнал регистрации.
// После записи переменная СобытияДляЖурналаРегистрации очищается.
//
// Параметры:
// СобытияДляЖурналаРегистрации - СписокЗначений:
// * Значение - Структура:
// ** ИмяСобытия - Строка - имя записываемого события.
// ** ПредставлениеУровня - Строка - представление значений коллекции УровеньЖурналаРегистрации.
// Доступные значения: "Информация", "Ошибка", "Предупреждение", "Примечание".
// ** Комментарий - Строка - комментарий события.
// ** ДатаСобытия - Дата - дата события, подставляется в комментарий при записи.
// * Представление - Строка - не используется.
//
ЖурналРегистрации.ЗаписатьСобытияВЖурналРегистрации(СобытияДляЖурналаРегистрации) Экспорт
```

View File

@ -16,6 +16,6 @@ slug: общие-работа-с-файловой-системой/диалог-
// Заголовок - Строка - заголовок диалога выбора каталога.
// Каталог - Строка - начальное значение каталога, предлагаемое по умолчанию.
//
Процедура ВыбратьКаталог(ОбработчикЗавершения, Заголовок = "", Каталог = "") Экспорт
ФайловаяСистемаКлиент.ВыбратьКаталог(ОбработчикЗавершения, Заголовок = "", Каталог = "") Экспорт
```

View File

@ -18,6 +18,6 @@ slug: общие-работа-с-файловой-системой/диалог-
// # ДополнительныеПараметры - Произвольный - дополнительные параметры оповещения.
// Диалог - ДиалогВыбораФайла - свойства см. в синтакс-помощнике.
//
Процедура ПоказатьДиалогВыбора(ОбработчикЗавершения, Диалог) Экспорт
ФайловаяСистемаКлиент.ПоказатьДиалогВыбора(ОбработчикЗавершения, Диалог) Экспорт
```

View File

@ -36,6 +36,6 @@ slug: общие-работа-с-файловой-системой/загруз
// ПараметрыЗагрузки.ИдентификаторФормы = УникальныйИдентификатор;
// ФайловаяСистемаКлиент.ЗагрузитьФайл(Оповещение, ПараметрыЗагрузки);
//
Процедура ЗагрузитьФайл(ОбработчикЗавершения, ПараметрыЗагрузки = Неопределено, ИмяФайла = "",
ФайловаяСистемаКлиент.ЗагрузитьФайл(ОбработчикЗавершения, ПараметрыЗагрузки = Неопределено, ИмяФайла = "",
АдресВоВременномХранилище = "") Экспорт
```

View File

@ -43,6 +43,6 @@ slug: общие-работа-с-файловой-системой/загруз
// ПараметрыЗагрузки.ИдентификаторФормы = УникальныйИдентификатор;
// ФайловаяСистемаКлиент.ЗагрузитьФайлы(Оповещение, ПараметрыЗагрузки);
//
Процедура ЗагрузитьФайлы(ОбработчикЗавершения, ПараметрыЗагрузки = Неопределено, ЗагружаемыеФайлы = Неопределено) Экспорт
ФайловаяСистемаКлиент.ЗагрузитьФайлы(ОбработчикЗавершения, ПараметрыЗагрузки = Неопределено, ЗагружаемыеФайлы = Неопределено) Экспорт
```

View File

@ -25,6 +25,6 @@ slug: общие-работа-с-файловой-системой/сохран
// ПараметрыСохранения = ФайловаяСистемаКлиент.ПараметрыСохраненияФайла();
// ФайловаяСистемаКлиент.СохранитьФайл(Оповещение, Контекст.АдресСертификата, ИмяФайла, ПараметрыСохранения);
//
Процедура СохранитьФайл(ОбработчикЗавершения, РасположениеФайла, ИмяФайла = "",
ФайловаяСистемаКлиент.СохранитьФайл(ОбработчикЗавершения, РасположениеФайла, ИмяФайла = "",
ПараметрыСохранения = Неопределено) Экспорт
```

View File

@ -27,6 +27,6 @@ slug: общие-работа-с-файловой-системой/сохран
// ПараметрыСохранения = ФайловаяСистемаКлиент.ПараметрыСохраненияФайлов();
// ФайловаяСистемаКлиент.СохранитьФайлы(Оповещение, ПолучаемыеФайлы, ПараметрыСохранения);
//
Процедура СохранитьФайлы(ОбработчикЗавершения, СохраняемыеФайлы, ПараметрыСохранения = Неопределено) Экспорт
ФайловаяСистемаКлиент.СохранитьФайлы(ОбработчикЗавершения, СохраняемыеФайлы, ПараметрыСохранения = Неопределено) Экспорт
```

View File

@ -14,6 +14,6 @@ slug: общие-работа-с-файловой-системой/уникал
// Возвращаемое значение:
// Строка - например, "C:\Документы\файл (2).txt", если "файл.txt" уже существует в указанной папке.
//
Функция УникальноеИмяФайла(Знач ИмяФайла) Экспорт
Имя = ФайловаяСистемаКлиент.УникальноеИмяФайла(Знач ИмяФайла) Экспорт
```