From 9fd8afaf2bd5cb3b97bd6a4636aec6afe98a6929 Mon Sep 17 00:00:00 2001 From: wakadakawaka Date: Mon, 21 Jul 2025 23:00:18 +0500 Subject: [PATCH] =?UTF-8?q?=D0=B8=D0=B7=D0=BC?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../Записать в журнал регистрации (клиент).md | 40 +++++++++++++++++++ .../Записать в журнал регистрации (сервер).md | 17 ++++++++ .../Диалог выбора каталога.md | 2 +- .../Диалог выбора файла.md | 2 +- .../Загрузить файл во временное хранилище.md | 2 +- .../Загрузить файлы во временное хранилище.md | 2 +- .../Сохранить файл из временного хранилища.md | 2 +- .../Сохранить файлы из временного хранилища.md | 2 +- .../Уникальное имя файла.md | 2 +- 9 files changed, 64 insertions(+), 7 deletions(-) create mode 100644 src/content/docs/knowledge-base/Общие/Исключения, обработка ошибок/Записать в журнал регистрации (клиент).md create mode 100644 src/content/docs/knowledge-base/Общие/Исключения, обработка ошибок/Записать в журнал регистрации (сервер).md diff --git a/src/content/docs/knowledge-base/Общие/Исключения, обработка ошибок/Записать в журнал регистрации (клиент).md b/src/content/docs/knowledge-base/Общие/Исключения, обработка ошибок/Записать в журнал регистрации (клиент).md new file mode 100644 index 0000000..fa136bb --- /dev/null +++ b/src/content/docs/knowledge-base/Общие/Исключения, обработка ошибок/Записать в журнал регистрации (клиент).md @@ -0,0 +1,40 @@ + +# Шаг 1 - накапливаем сообщения +```bsl +// Записывает сообщение в журнал регистрации. +// Если параметр ЗаписатьСобытия = Истина, то запись выполняется сразу (обращение к серверу). +// Если ЗаписатьСобытия = Ложь (по умолчанию), то сообщение помещается в очередь, которая +// будет записана позднее (обычно в течение 60 сек), либо при следующем вызове этой процедуры +// с признаком ЗаписатьСобытия = Истина, либо при вызове процедуры ЗаписатьСобытияВЖурналРегистрации. +// +// Параметры: +// ИмяСобытия - Строка - имя события для журнала регистрации; +// ПредставлениеУровня - Строка - описание уровня события, по нему будет определен уровень события при записи на +// сервере; +// Например: "Ошибка", "Предупреждение". +// Соответствуют именам элементов перечисления УровеньЖурналаРегистрации. +// Комментарий - Строка - комментарий для события журнала; +// ДатаСобытия - Дата - точная дата возникновения события, описанного в сообщении. Будет добавлена в начало +// комментария; +// ЗаписатьСобытия - Булево - выполнить запись всех ранее накопленных сообщений в журнал регистрации (обращение к +// серверу). +// +// Пример: +// ЖурналРегистрацииКлиент.ДобавитьСообщениеДляЖурналаРегистрации(СобытиеЖурналаРегистрации(), "Предупреждение", +// НСтр("ru = 'Невозможно подключиться к сети Интернет для проверки обновлений.'")); +// +ЖурналРегистрацииКлиент.ДобавитьСообщениеДляЖурналаРегистрации(Знач ИмяСобытия, Знач ПредставлениеУровня = "Информация", + Знач Комментарий = "", Знач ДатаСобытия = "", Знач ЗаписатьСобытия = Ложь) Экспорт + +``` + +# Шаг 2 - вызов сервера для записи в журнал регистрации +```bsl + +// Записывает накопленные сообщения из очереди в журнал регистрации (обращение к серверу). +// Сообщения добавляются в очередь с помощью процедуры ДобавитьСообщениеДляЖурналаРегистрации. +// +ЖурналРегистрацииКлиент.ЗаписатьСобытияВЖурналРегистрации() Экспорт + + +``` \ No newline at end of file diff --git a/src/content/docs/knowledge-base/Общие/Исключения, обработка ошибок/Записать в журнал регистрации (сервер).md b/src/content/docs/knowledge-base/Общие/Исключения, обработка ошибок/Записать в журнал регистрации (сервер).md new file mode 100644 index 0000000..8cce90d --- /dev/null +++ b/src/content/docs/knowledge-base/Общие/Исключения, обработка ошибок/Записать в журнал регистрации (сервер).md @@ -0,0 +1,17 @@ +```bsl +// Процедура пакетной записи сообщений в журнал регистрации. +// После записи переменная СобытияДляЖурналаРегистрации очищается. +// +// Параметры: +// СобытияДляЖурналаРегистрации - СписокЗначений: +// * Значение - Структура: +// ** ИмяСобытия - Строка - имя записываемого события. +// ** ПредставлениеУровня - Строка - представление значений коллекции УровеньЖурналаРегистрации. +// Доступные значения: "Информация", "Ошибка", "Предупреждение", "Примечание". +// ** Комментарий - Строка - комментарий события. +// ** ДатаСобытия - Дата - дата события, подставляется в комментарий при записи. +// * Представление - Строка - не используется. +// +ЖурналРегистрации.ЗаписатьСобытияВЖурналРегистрации(СобытияДляЖурналаРегистрации) Экспорт + +``` \ No newline at end of file diff --git a/src/content/docs/knowledge-base/Общие/Работа с файловой системой/Диалог выбора каталога.md b/src/content/docs/knowledge-base/Общие/Работа с файловой системой/Диалог выбора каталога.md index a4fd639..5609c5a 100644 --- a/src/content/docs/knowledge-base/Общие/Работа с файловой системой/Диалог выбора каталога.md +++ b/src/content/docs/knowledge-base/Общие/Работа с файловой системой/Диалог выбора каталога.md @@ -16,6 +16,6 @@ slug: общие-работа-с-файловой-системой/диалог- // Заголовок - Строка - заголовок диалога выбора каталога. // Каталог - Строка - начальное значение каталога, предлагаемое по умолчанию. // -Процедура ВыбратьКаталог(ОбработчикЗавершения, Заголовок = "", Каталог = "") Экспорт +ФайловаяСистемаКлиент.ВыбратьКаталог(ОбработчикЗавершения, Заголовок = "", Каталог = "") Экспорт ``` \ No newline at end of file diff --git a/src/content/docs/knowledge-base/Общие/Работа с файловой системой/Диалог выбора файла.md b/src/content/docs/knowledge-base/Общие/Работа с файловой системой/Диалог выбора файла.md index f11495a..171a517 100644 --- a/src/content/docs/knowledge-base/Общие/Работа с файловой системой/Диалог выбора файла.md +++ b/src/content/docs/knowledge-base/Общие/Работа с файловой системой/Диалог выбора файла.md @@ -18,6 +18,6 @@ slug: общие-работа-с-файловой-системой/диалог- // # ДополнительныеПараметры - Произвольный - дополнительные параметры оповещения. // Диалог - ДиалогВыбораФайла - свойства см. в синтакс-помощнике. // -Процедура ПоказатьДиалогВыбора(ОбработчикЗавершения, Диалог) Экспорт +ФайловаяСистемаКлиент.ПоказатьДиалогВыбора(ОбработчикЗавершения, Диалог) Экспорт ``` \ No newline at end of file diff --git a/src/content/docs/knowledge-base/Общие/Работа с файловой системой/Загрузить файл во временное хранилище.md b/src/content/docs/knowledge-base/Общие/Работа с файловой системой/Загрузить файл во временное хранилище.md index da5fbb9..0784655 100644 --- a/src/content/docs/knowledge-base/Общие/Работа с файловой системой/Загрузить файл во временное хранилище.md +++ b/src/content/docs/knowledge-base/Общие/Работа с файловой системой/Загрузить файл во временное хранилище.md @@ -36,6 +36,6 @@ slug: общие-работа-с-файловой-системой/загруз // ПараметрыЗагрузки.ИдентификаторФормы = УникальныйИдентификатор; // ФайловаяСистемаКлиент.ЗагрузитьФайл(Оповещение, ПараметрыЗагрузки); // -Процедура ЗагрузитьФайл(ОбработчикЗавершения, ПараметрыЗагрузки = Неопределено, ИмяФайла = "", +ФайловаяСистемаКлиент.ЗагрузитьФайл(ОбработчикЗавершения, ПараметрыЗагрузки = Неопределено, ИмяФайла = "", АдресВоВременномХранилище = "") Экспорт ``` \ No newline at end of file diff --git a/src/content/docs/knowledge-base/Общие/Работа с файловой системой/Загрузить файлы во временное хранилище.md b/src/content/docs/knowledge-base/Общие/Работа с файловой системой/Загрузить файлы во временное хранилище.md index 61a9b24..685ffc1 100644 --- a/src/content/docs/knowledge-base/Общие/Работа с файловой системой/Загрузить файлы во временное хранилище.md +++ b/src/content/docs/knowledge-base/Общие/Работа с файловой системой/Загрузить файлы во временное хранилище.md @@ -43,6 +43,6 @@ slug: общие-работа-с-файловой-системой/загруз // ПараметрыЗагрузки.ИдентификаторФормы = УникальныйИдентификатор; // ФайловаяСистемаКлиент.ЗагрузитьФайлы(Оповещение, ПараметрыЗагрузки); // -Процедура ЗагрузитьФайлы(ОбработчикЗавершения, ПараметрыЗагрузки = Неопределено, ЗагружаемыеФайлы = Неопределено) Экспорт +ФайловаяСистемаКлиент.ЗагрузитьФайлы(ОбработчикЗавершения, ПараметрыЗагрузки = Неопределено, ЗагружаемыеФайлы = Неопределено) Экспорт ``` \ No newline at end of file diff --git a/src/content/docs/knowledge-base/Общие/Работа с файловой системой/Сохранить файл из временного хранилища.md b/src/content/docs/knowledge-base/Общие/Работа с файловой системой/Сохранить файл из временного хранилища.md index fcb221d..ba71bef 100644 --- a/src/content/docs/knowledge-base/Общие/Работа с файловой системой/Сохранить файл из временного хранилища.md +++ b/src/content/docs/knowledge-base/Общие/Работа с файловой системой/Сохранить файл из временного хранилища.md @@ -25,6 +25,6 @@ slug: общие-работа-с-файловой-системой/сохран // ПараметрыСохранения = ФайловаяСистемаКлиент.ПараметрыСохраненияФайла(); // ФайловаяСистемаКлиент.СохранитьФайл(Оповещение, Контекст.АдресСертификата, ИмяФайла, ПараметрыСохранения); // -Процедура СохранитьФайл(ОбработчикЗавершения, РасположениеФайла, ИмяФайла = "", +ФайловаяСистемаКлиент.СохранитьФайл(ОбработчикЗавершения, РасположениеФайла, ИмяФайла = "", ПараметрыСохранения = Неопределено) Экспорт ``` \ No newline at end of file diff --git a/src/content/docs/knowledge-base/Общие/Работа с файловой системой/Сохранить файлы из временного хранилища.md b/src/content/docs/knowledge-base/Общие/Работа с файловой системой/Сохранить файлы из временного хранилища.md index 60ca16c..9802808 100644 --- a/src/content/docs/knowledge-base/Общие/Работа с файловой системой/Сохранить файлы из временного хранилища.md +++ b/src/content/docs/knowledge-base/Общие/Работа с файловой системой/Сохранить файлы из временного хранилища.md @@ -27,6 +27,6 @@ slug: общие-работа-с-файловой-системой/сохран // ПараметрыСохранения = ФайловаяСистемаКлиент.ПараметрыСохраненияФайлов(); // ФайловаяСистемаКлиент.СохранитьФайлы(Оповещение, ПолучаемыеФайлы, ПараметрыСохранения); // -Процедура СохранитьФайлы(ОбработчикЗавершения, СохраняемыеФайлы, ПараметрыСохранения = Неопределено) Экспорт +ФайловаяСистемаКлиент.СохранитьФайлы(ОбработчикЗавершения, СохраняемыеФайлы, ПараметрыСохранения = Неопределено) Экспорт ``` \ No newline at end of file diff --git a/src/content/docs/knowledge-base/Общие/Работа с файловой системой/Уникальное имя файла.md b/src/content/docs/knowledge-base/Общие/Работа с файловой системой/Уникальное имя файла.md index 3136a49..1f21b12 100644 --- a/src/content/docs/knowledge-base/Общие/Работа с файловой системой/Уникальное имя файла.md +++ b/src/content/docs/knowledge-base/Общие/Работа с файловой системой/Уникальное имя файла.md @@ -14,6 +14,6 @@ slug: общие-работа-с-файловой-системой/уникал // Возвращаемое значение: // Строка - например, "C:\Документы\файл (2).txt", если "файл.txt" уже существует в указанной папке. // -Функция УникальноеИмяФайла(Знач ИмяФайла) Экспорт +Имя = ФайловаяСистемаКлиент.УникальноеИмяФайла(Знач ИмяФайла) Экспорт ``` \ No newline at end of file